Node.js--sequelize定义表结构

当我们用sequlize.define(),定义表结构的时候，有时会遇到一些字段，你如说年龄字段，年龄不能为负数吧，比如说摸一个字段不能为空或者只能为字母或者输入长度不能超过50，这些问题都不是问题，我们在定义表结构的时候，可以设置一些属性，对其经行约束。

 

如上所示，列的定义可以是字符串、一个预定义的Sequelize构造函数、或是一个对象。在定义列时，我们可以指定数据类型，也可以指定默认值、主键/外键等约束，还可以自定义访问器（getter）和设置器（setter）。

//创建表 定义表结构
 const User = sequelize.define('user', {
   firstName: {
     type: Sequelize.STRING,
     validate:{
       is:["[a-z]",'i'],//只允许数字
     },
     allowNull:false,//非空验证
     defaultValue:'郭',//给该列设置默认值
     unique:false,//设置为true的时候，会为该列添加一个unique唯一约束
     primaryKey:false,//指定该列是不是主键
     field:firstName,//设置数据库中的字段名字，设置后sequlize会自动映射到数据库中，一般情况下默认即可，不用设置
     autoincrement:false,//是否为自增 
     references:{
       model:{
        //指定从表
       },
       key:id,//该列表示到外键列的引用
     },
     onDelete:'NO ACTION',//当被引用的外键更新时
     onUpdate:'NO ACTION',//当被引用的外键被删除时候
   },
   lastName: {
     type: Sequelize.STRING
   }
 },
 {
   omitNull:true,//是否忽略空值
   timestamps:true,//两个时间戳字段 createdAt updatedAt
   paranoid:true,//逻辑删除，当调用destroy的，不会删除，而是多出一列，叫做deletedAt，将其设置为true,从而表示删除真实项目中，我们没有真删除，都是逻辑删除
   freezeTableName:treu,//如果不将freezeTableName设置为true的话，那么数据库表明和模型实体类名不一致
   createdAt:false,
   updatedAt:false,//设置成false后，将不会在数据库表中生成默认列
   initialAutoIncrement:'id',
   hooks:{
     //钩子函数，主要是在某些事件发生的前或后，或者某些生命周期某些事件发生的前后调用触发
     afterDelete:()=>{
       console.log('==========================');
       console.log('删除完成后触发执行');
       console.log('==========================');
       
     },
   },
   validate:{
     //模型广泛验证对象，一般不用吧....
   }
 });

定义表结构时，设置的一些属性，大家可以做参考

名称        类型     说明

modelName String 模型名，在sequelize.models属性中会使用这个名称；如果没有在options中指定表名，数据库中也会使用此属性做为表名。

attributes Object 一个对象，其每个属性对应表中的一个列，每个列可以使用一个预定义的DataType、字符串或类型描述对象定义：

attributes.column String | DataType | Object 数据库中的列描述

attributes.column.type String | DataType DataType或字符串，表示列的数据类型

[attributes.column.allowNull=true] Boolean 设置为false时，会给添加NOT NULL（非空）约束，数据保存时会进行非空验证

[attributes.column.defaultValue=null] Any 字面默认值, JavaScript函数, 或一个 SQL 函数 (查看 sequelize.fn)

[attributes.column.unique=false] String | Boolean 设置为true时，会为列添加唯一约束

[attributes.column.primaryKey=false] Boolean 指定是否是主键

[attributes.column.field=null] String 设置在数据库中的字段名。设置后会，Sequelize会将属性名映射到数据库中的不同名称

[attributes.column.autoIncrement=false] Boolean 是否自增

[attributes.column.comment=null] String 字段描述（自1.7+后，此描述不再添加到数据库中）

[attributes.column.references=null] String | Model 引用对象

[attributes.column.references.model] String | Model 如果列引用到另一个表，可以通过这个属性设置模型或字符串。

[attributes.column.references.key='id'] String 该列表示到表外键列的引用

[attributes.column.onUpdate] String 当被引用的键更新时的操作，可选值是：CASCADE, RESTRICT, SET DEFAULT, SET NULL 或 NO ACTION 之一

[attributes.column.onDelete] String 当被引用的键删除时的操作，可选值是：CASCADE, RESTRICT, SET DEFAULT, SET NULL 或 NO ACTION 之一

[attributes.column.get] Function 为列自定义一个访问器。使用this.getDataValue(String)时调用的值

[attributes.column.set] Function 为列自定义一个设置器。使用this.setDataValue(String, Value)时调用的值

[attributes.validate] Object 模型每次保存时调用的验证对象。可是validator.js中的验证函数(参见 DAOValidator)、或自定义的验证函数。

[options] Object 提供给Sequelize 构造函数的一些默认值

[options.defaultScope={}] Object 定义使用此模型的默认搜索范围。作用范围与提供给 find / findAll 的选项形式相同

[options.scopes] Object 更多范围，定义 defaultScope 的定义形式相同。关于限制范围的定义请参考Model.scope

[options.omitNull] Boolean 是否忽略空值，这意味着，所有列的空值将不会被保存

[options.timestamps=true] Boolean 为模型添加 createdAt 和 updatedAt 两个时间戳字段

[options.paranoid=false] Boolean 使用逻辑删除。设置为true后，调用 destroy 方法时将不会删队模型，而是设置一个 deletedAt 列。此设置需要 timestamps=true

[options.underscored=false] Boolean 转换列名的驼峰命名规则为下划线命令规则

[options.underscoredAll=false] Boolean 转换模型名的驼峰命名规则为表名的下划线命令规则

[options.freezeTableName=false] Boolean 设置为true时，sequelize不会改变表名，否则可能会按其规则有所调整

[options.name] Object 允有singular 和 plural两个属性的对象，在模型与其它模型关联时使用

[options.name.singular=inflection.singularize(modelName)] String

[options.name.plural=inflection.pluralize(modelName)] String

[options.indexes] Array.<Object> 要建立的索引

[options.indexes[].name] String 索引名，默认为模型名 + '_' + 字段名

[options.indexes[].type] String 索引类型，仅用于 mysql，其值为：UNIQUE、 FULLTEXT 或 SPATIAL之一

[options.indexes[].method] String 创建索引的方法(SQL中的USING 声明)。BTREE 或 HASH 可以在 mysql 和 postgres中支持，postgres中支持，还支持 GIST 和 GIN

[options.indexes[].unique=false] Boolean 设置索引是否唯一，设置后会自动触发UNIQUE设置

[options.indexes[]

concurrently=false] Boolean PostgreSQL 中在创建索引时不使用任务写锁定。仅 Postgres 适用

[options.indexes[].fields] Array.<String | Object> 建立索引的字段数组。每个字段可以是一个字段名，sequelize 对象 (如 sequelize.fn)，

或一个包含：attribute (字段名)、length (创建前缀字符数)、order (列排序方向)、collate (较验的字段集合 (排序))

[options.createdAt] String | Boolean 如果为字符串，则使用提供的值代替 createdAt 列的默认名，设置为flase则不添加这个字段。

[options.updatedAt] String | Boolean 如果为字符串，则使用提供的值代替 updatedAt 列的默认名，设置为flase则不添加这个字段

[options.deletedAt] String | Boolean 如果为字符串，则使用提供的值代替 deletedAt 列的默认名，设置为flase则不添加这个字段

[options.tableName] String 模型所对应表的表名，设置freezeTableName 为 true时，才会严格使用模型名

[options.getterMethods] Object 提供给 getter 调用的方法，与每列定义的访问器一样。如果为列定义了一个相同名称的 getter 方法，那么会通过这个方法获取值；如果未定义的名称与列不匹配，这将做为一个虚拟访问器；也用于设置多个值，但不能用在。

[options.setterMethods] Object 提供给 setter 调用的方法，与每列定义的设置器一样。如果为列定义了一个相同名称的 setter 方法，那么会通过这个方法设置值；如果未定义的名称与列不匹配，这将做为一个虚拟访设置；也用于匹配多个值，但不用于逻辑删除。

[options.instanceMethods] Object 提供给每个实例（DAO）的方法。如果通过sequelize对方法进行了重写，可以通过"this.constructor.super_.prototype"来调用原方法，如：this.constructor.super_.prototype.toJSON.apply(this, arguments)

[options.classMethods] Object 添加到Model的类方法，如果通过sequelize对方法进行了重写，可以通过 this.constructor.prototype来调用原方法，如：this.constructor.prototype.find.apply(this, arguments)

[options.schema='public'] String

[options.engine] String

[options.charset] String

[options.comment] String

[options.collate] String

[options.initialAutoIncrement] String MySQL中设置 AUTO_INCREMENT （自增）的初始值

[options.hooks] Object 一个包含钩子函数的对象，这些函数会在生生命周期内某些事件发生之前或之后被调用。可添加的钩子函数有：beforeValidate, afterValidate, beforeBulkCreate, beforeBulkDestroy, beforeBulkUpdate, beforeCreate, beforeDestroy, beforeUpdate, afterCreate, afterDestroy, afterUpdate, afterBulkCreate, afterBulkDestory 和 afterBulkUpdate。每个属性可以是一个函数，或是一个包含一组函数的数组。

[options.validate] Object 模型广泛验证对象。该验证会通过this。如果验证函数中有参数，则会被认为是异步的，并通过一个包含可选错误的回调函数形式的的调。

 

接下来说一下模型导入，我们一个项目中，如果只用一个数据库，但一个数据库中有好多张表，为了方便管理，我们最好将一个模型放一个js文件，独立编写，这样也方便分工合作，之后，可以把大家写的独立的model 合到我们的index.js文件，这里就需要模型导入了。

 

 

Validations - 验证

模型验证，让我们可以模型的每个属性执行验证。

我们通过模型列属性的validate属性来添加验证，这些验证会在模型实例执行create、update和save自动执行。也可以通过instance.validate()方法，来手工验证模型实例。

var ValidateMe = sequelize.define('foo', {

foo: {

type: Sequelize.STRING,

validate: {

is: ["^[a-z]+",′i′],//只允许字母is:/[a−z]+/i, // 只允许字母

not: ["[a-z]",'i'], // 不能使用字母

isEmail: true, // 检测邮箱格式 (foo@bar.com)

isUrl: true, // 检查Url格式 (http://foo.com)

isIP: true, // 检查 IPv4 或 IPv6 格式

isIPv4: true, // 检查 IPv4

isIPv6: true, // 检查 IPv6

isAlpha: true, // 不能使用字母

isAlphanumeric: true, // 只允许字母数字字符

isNumeric: true, // 只能使用数字

isInt: true, // 只能是整数

isFloat: true, // 只能是浮点数

isDecimal: true, // 检查数字

isLowercase: true, // 检查小写字母

isUppercase: true, // 检查大写字母

notNull: true, // 不允许null

isNull: true, // 只能为null

notEmpty: true, // 不能空字符串

equals: 'specific value', // 只能使用指定值

contains: 'foo', // 必须包含子字符串

notIn: [['foo', 'bar']], // 不能是数组中的任意一个值

isIn: [['foo', 'bar']], // 只能是数组中的任意一个值

notContains: 'bar', // 不能包含子字符串

len: [2, 10], // 值的长度必在 2 和 10 之间

isUUID: 4, // 只能是UUID

isDate: true, // 只能是日期字符串

isAfter: "2011-11-05", // 只能使用指定日期之后的时间

isBefore: "2011-11-05", // 只能使用指定日期之前的时间

max: 23, // 允许的最大值

min: 23, // 允许的最小值

isArray: true, // 不能使用数组

isCreditCard: true, // 检查是有效的信用卡

 

// 也可以自定义验证:

isEven: function(value) {
    if(parseInt(value) % 2 != 0) {
        throw new Error('Only even values are allowed!')
    }
}