发布于 2015-08-18 16:40:07 | 400 次阅读 | 评论: 0 | 来源: 网络整理
模型是一个定义了需要呈现给用户的数据的属性和行为的类。任何用户往返于应用(或者刷新页面)能看到的内容都需要使用模型来表示。
应用中所有的模型,都继承与DS.Model:
1 |
App.Person = DS.Model.extend(); |
在定义了一个模型类之后,就可以开始查询或者创建一个属于这个类型的记录。当与仓库进行交互时,需要使用模型的名称来指定记录的类型。例如,仓库的find()方法需要一个字符串类型的值作为第一个参数,用于指定需要查询的记录类型:
1 |
store.find('person', 1);
|
下表说明了模型名称是如何映射到模型的类的。
| 模型名称 | 模型类 |
|---|---|
photo |
App.Photo |
adminUserProfile |
App.AdminUserProfile |
模型的属性是通过DS.attr来进行声明的。
1 2 3 4 5 6 7 |
var attr = DS.attr;
App.Person = DS.Model.extend({
firstName: attr(),
lastName: attr(),
birthday: attr()
});
|
属性主要由两个作用,其一是用于转换从服务器返回的JSON数据到记录;其二是序列化一个被修改的记录,将其变动保存到服务器端。
属性(Attribute)可以跟其他属性(Property)一样看待,包括计算属性。应用中经常需要使用计算属性来联合或者转换一个原生属性(Attribute)的值。
1 2 3 4 5 6 7 8 9 10 |
var attr = DS.attr;
App.Person = DS.Model.extend({
firstName: attr(),
lastName: attr(),
fullName: function() {
return this.get('firstName') + ' ' + this.get('lastName');
}.property('firstName', 'lastName')
});
|
关于如何为类添加计算属性,可以参看计算属性。
如果没有指定属性的类型,属性类型与服务器端返回的保持一致。可以通过attr设定属性的类型type,来确保将服务器返回的数据强制转换为指定的类型。
1 2 3 |
App.Person = DS.Model.extend({
birthday: DS.attr('date')
});
|
默认情况下,REST 适配器支持的属性类型有string, number, boolean和date。 传统的适配器会提供额外的属性类型,并支持你注册自定义的属性类型。 详情请查看documentation section on the REST Adapter。
DS.attr第二个参数是一个可选的哈希对象,当前支持的选项是:
defaultValue:传入一个字符串或者将被调用来设置属性的初始值的函数。
示例
1 2 3 4 5 6 7 8 9 10 |
var attr = DS.attr;
App.User = DS.Model.extend({
username: attr('string'),
email: attr('string'),
verified: attr('boolean', {defaultValue: false}),
createdAt: DS.attr('string', {
defaultValue: function() { return new Date(); }
})
});
|
Ember Data 包括了几个内置的关联类型,以帮助你确定你的模型如何相互关联的。
使用DS.belongsTo在两个模型间声明一对一的关系。
1 2 3 4 5 6 7 |
App.User = DS.Model.extend({
profile: DS.belongsTo('profile')
});
App.Profile = DS.Model.extend({
user: DS.belongsTo('user')
});
|
使用DS.belongsTo结合DS.hasMany来声明两个模型间的一对多关系,示例如下:
1 2 3 4 5 6 7 |
App.Post = DS.Model.extend({
comments: DS.hasMany('comment')
});
App.Comment = DS.Model.extend({
post: DS.belongsTo('post')
});
|
使用DS.hasMany来声明两个模型间的多对多关系。
1 2 3 4 5 6 7 |
App.Post = DS.Model.extend({
tags: DS.hasMany('tag')
});
App.Tag = DS.Model.extend({
posts: DS.hasMany('post')
});
|
Ember Data会尽最大努力去自动发现关联关系的映射关系。在上例的一对多的情况下,修改了comments会自动更新post,应为这是唯一的一个关联模型。
但是,有时候对同一个类型有多个belongsTo/hasMany关联关系。这时可以通过指定在反向端使用DS.hasMany的inverse选项来指定其关联的模型:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
var belongsTo = DS.belongsTo,
hasMany = DS.hasMany;
App.Comment = DS.Model.extend({
onePost: belongsTo("post"),
twoPost: belongsTo("post"),
redPost: belongsTo("post"),
bluePost: belongsTo("post")
});
App.Post = DS.Model.extend({
comments: hasMany('comment', {
inverse: 'redPost'
})
});
|
当然也可以在belongsTo一侧指定,它将按照预期那样工作。