orm2 中文文件 3. 定義模型

譯者：飛龍

來源：Defining Models

在[連線](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)。

第二個物件指定了額外的選項：