orm2 中文文档 3. 定义模型

译者：飞龙

来源：Defining Models

在[连接](1. Connecting to Database.md)之后，你可以使用连接对象（db）来定义你的模型。你需要指定模型的名称，一个用于描述的属性和一些（可选的）选项。下面是一个简短的例子：

var Person = db.define('person', {id:      {type: 'serial', key: true}, // the auto-incrementing primary keyname:    {type: 'text'},surname: {type: 'text'},age:     {type: 'number'}
}, {methods : {fullName: function() {return this.name + ' ' + this.surname;}}
});

这个模型叫做person（通常也是数据库里面表的名称），它有三个属性（name和surname为文本，age为数值）。如果你自己不指定任何键的话，默认的id: { type: 'serial', key: true }会添加进来。在这个例子中，有个模型方法叫做fullName。下面是这个模型的使用方法的示例：

Person.get(73, function(err, person) {if (err) throw err;console.log('Hi, my name is ' + person.fullName());
});

这会获取id=73的person对象，并且打印出它的名字和姓氏。其它类型的可用属性请见[这里](3.1 Model Properties.md)。

API

/*** @param {Object} props Property definitions* @param {Object} opts Options*/
db.define(props, opts)

db.define()接收的第一个对象（第二个参数）被称为属性对象，它定义了所有的[属性](3.1 Model Properties.md)。

第二个对象指定了额外的选项：

选项名称	类型	描述
`collection`	`String`	覆写数据库中表的名称
`methods`	`Object`	模型实例上的额外方法，它会被设置到实例上。
`hooks`	`Object`	用户定义的[钩子或回调](3.3 Model Hooks.md)
`validations`	`Object`	用户定义的[验证器](3.2 Model Validations.md)
`id`	`Array`	为了支持在`properties`上设置`key: true`而不提倡使用
`cache`	`Boolean`	允许你开启或者禁用单例行为。它叫做`cache`，但是和缓存毫无关系。
`autoSave`	`Boolean`	不推荐。在属性修改时自动保存模型。
`autoFetch`	`Boolean`	是否自动获取关联
`autoFetchLimit`	`Number`	自动获取关联的深度
`cascadeRemove`	`Boolean`	删除实例时是否要删除关联

orm2 中文文档 3. 定义模型相关推荐

orm2 中文文档 3.3 模型钩子
译者:飞龙来源:Model Hooks 如果你想要监听发生在模型实例上的事件,你可以附带一个函数,它会在发生时调用. 现在支持下面这些事件: afterLoad:(无参数)加载和准备所用实例之后: ...
orm2 中文文档 3.2 模型验证器
译者:飞龙来源:Model Validations Enforce模块用于验证数据.对于使用以前的验证器的用户,还可以继续使用,它们中的一部分整合到了enforce,剩余部分还没有.推荐你开始使用o ...
orm2 中文文档 3.1 模型属性
译者:飞龙来源:Model Properties 模型和一些关联具有一个或多个属性,每个属性有类型以及一些可选设置,你可以自行选择它们(或使用默认设置). 类型受支持的类型是: text:文本字符 ...
orm2 中文文档 4. 定义关联
译者:飞龙来源:Defining Associations 关联是一个或多个[模型之间](3. Defining Models.md)的关系. 关联的类型: [hasOne(一对多)](4.1 ha ...
orm2 中文文档 5. 同步和删除模型
译者:飞龙来源:Syncing and dropping models 同步是一项功能方法,可以在数据库里为你的模型和关联创建所需的表来工作.现存的表并不会被替换,它们只会在不存在的时候被创建. 同 ...
orm2 中文文档 4.1 hasOne（多对一关系）
译者:飞龙来源:hasOne hasOne关联是一种多对一的关系,意思是你定义的模型可以有多个实例指向一个其它的实例(所属相同模型或不同模型). 用法 Animal.hasOne(associati ...
orm2 中文文档 2. 设置
译者:飞龙来源:Settings 设置用于储存键值对.设置对象是orm(默认值)上的实例,之后会为每个db连接和每个定义过的Model建立快照.所以orm.settings上的更改只会作用于更改之后 ...
orm2 中文文档 1. 连接到数据库
译者:飞龙来源:Connecting to Database 在连接之前,你需要一个受支持的驱动.下面是一些测试过的驱动及其版本,把你所需要的加入到package.json中. 驱动 npm 包版 ...
orm2 中文文档 8. 聚合
译者:飞龙来源:Aggregation 如果你需要从一个模型中获取一些聚合值,你可以使用Model.aggregate().下面通过一个例子来展示: Person.aggregate({ surna ...

orm2 中文文档 3. 定义模型

API

orm2 中文文档 3. 定义模型相关推荐

最新文章

热门文章