前面在《 Ember.js 项目开发之 Ember Data 》介绍了Ember Data,本文将继续介绍模型的定义。
模型是定义呈现给用户的数据的属性和行为的类。如果用户离开应用后再回来(或者刷新页面),他们希望看到的任何东西都应该由模型来表示。
当为应用程序创建一个新模型时,需要在 models
文件夹下创建一个新文件并从 Model
扩展。使用 Ember CLI 的生成器命令可以方便地完成这一操作。例如,下面创建一个 person
模型:
ember generate model person
这将生成以下文件:app/models/person.js
import Model from '@ember-data/model'; export default class PersonModel extends Model { }
定义模型类后,就可以开始查找并使用该类型的记录。
Ember Data
模型通常以单数形式设置(这就是为什么在本文使用person
而不是people
的原因)
定义属性
生成 person
模型后没有任何属性,下面开始增加一些属性:
import Model, { attr } from '@ember-data/model'; export default class PersonModel extends Model { @attr firstName; @attr lastName; @attr birthday; }
当将从服务器返回的JSON有效负载转换为记录时,以及在修改记录后序列化记录以保存回服务器时,将使用属性。
可以像使用其他任何属性一样使用属性,包括从getter
函数中使用。
import Model, { attr } from '@ember-data/model'; export default class PersonModel extends Model { @attr firstName; @attr lastName; get fullName() { return `${this.firstName} ${this.lastName}`; } }
Transforms
可能会发现服务器返回的属性类型与要在JavaScript代码中使用的类型不匹配。Ember Data 允许为称为转换的属性类型定义简单的序列化和反序列化方法。可以通过提供转换名称作为方法的第一个参数,来指定要为属性运行转换 attr
。Ember Data 支持的属性类型string
,number
,boolean
,和date
,这些类型将值强制转换为与其名称匹配的JavaScript类型。
import Model, { attr } from '@ember-data/model'; export default class PersonModel extends Model { @attr('string') name; @attr('number') age; @attr('boolean') admin; @attr('date') birthday; }
日期转换将 ISO 8601
字符串转换为JavaScript日期对象。
布尔值转换可以处理 true
或 false
以外的值。字符串"true"
或"t"
任何大写字母,和"1"
数字 1
都将强制转换为 true
,反之为 false
。
转换不是必需的,如果没有指定转换名称,Ember Data
将不会对该值进行额外的处理。
自定义Transforms
可以使用 Ember CLI
的 transform
生成器创建自定义转换:
ember generate transform dollars
这是一个简单的转换,可在美分和美元之间转换价值。
import Transform from '@ember-data/serializer/transform'; export default class DollarsTransform extends Transform { deserialize(serialized) { return serialized / 100; // returns dollars } serialize(deserialized) { return deserialized * 100; // returns cents } }
转换有两个功能:序列化 serialize
和反序列化 deserialize
。反序列化将值转换为客户端期望的格式。序列化则相反,将值转换为持久层所期望的格式。
以下使用自定义 dollars
转换:
import Model, { attr } from '@ember-data/model'; export default class ProductModel extends Model { @attr('dollars') spent; }
选项Options
attr
也可以将选项的哈希作为第二个参数。目前唯一可用的选项是 defaultValue
,它可以使用一个值或一个函数来设置属性的默认值(如果没有提供的话)。
在下面的例子中,定义了 verified
的默认值为 false
,而 createdAt
的默认值为模型创建时的当前日期:
import Model, { attr } from '@ember-data/model'; export default class UserModel extends Model { @attr('string') username; @attr('string') email; @attr('boolean', { defaultValue: false }) verified; @attr('date', { defaultValue() { return new Date(); } }) createdAt; }
Read-only属性
当API返回一个深度嵌套的只读对象或数组时,不需要创建多个具有 attr('hasMany')
或 attr('belongsTo')
关系的模型。这可能会导致大量不必要的代码,可以访问模板中的这些对象,而不需要对它们进行转换。这可以通过使用 @attr
来完成,而无需指定转换:
import Model, { attr } from '@ember-data/model'; export default class PlaceModel extends Model { @attr location; // a read-only object @attr tags; // a read-only array }
{{@model.location.latitude}}