Node.js--sequelize定义表结构
当我们用sequlize.define(),定义表结构的时候,有时会遇到一些字段,你如说年龄字段,年龄不能为负数吧,比如说摸一个字段不能为空或者只能为字母或者输入长度不能超过50,这些问题都不是问题,我们在定义表结构的时候,可以设置一些属性,对其经行约束。
![](https://img2020.cnblogs.com/blog/1138955/202012/1138955-20201212141924906-177252306.png)
如上所示,列的定义可以是字符串、一个预定义的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文件,这里就需要模型导入了。
![](https://img2020.cnblogs.com/blog/1138955/202012/1138955-20201212142701238-300036912.png)
![](https://img2020.cnblogs.com/blog/1138955/202012/1138955-20201212142709552-2122016975.png)
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!') } }