orm2 中文文档 3. 定义模型

译者：飞龙

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

var Person = db.define('person', {
  id:      {type: 'serial', key: true}, // the auto-incrementing primary key
  name:    {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)。

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