一、概述
1. 模型是一个类,它定义了你呈现给用户的数据的属性和行为。用户希望如果他们离开你的应用程序,并返回后(或如果他们刷新页面)看到的任何东西应该被一个model代表。
2. 确保在ember.js后引入ember-data.js:
<script type="text/javascript" src="ember.js"></script> <script type="text/javascript" src="ember-data.js"></script>
3. 对应用程序中的每个模型来说,创建一个DS.Model的子类:
app/models/person.js
export default DS.Model.extend();
4. 在你定义了一个model类之后,你可以开始为这个类型查找和创建records。当与store交互时,你需要使用model name来指定一个record的type。例如,store的find()方法期望有一个字符串作为它的第一个参数,告诉它查找什么类型的record:
store.findRecord(‘person‘, 1);
5. 下面的表格展示了模型的名字如何映射模型文件的路径:
Model Name | Model Class |
---|---|
photo |
app/models/photo.js |
admin-user-profile |
app/models/admin-user-profile.js |
二、Defining attributes
1. 你可以通过使用DS.attr来指定一个modle有哪些属性。app/models/person.js
export default DS.Model.extend({ firstName: DS.attr(), lastName: DS.attr(), birthday: DS.attr() });
2. 当把一个从服务器返回的JSON转换为一个record,在它被修改后当序列化一个record保存到服务器时属性被使用。
3. 你也可以使用属性像其他属性一样,包括作为计算属性的一部分。往往,你会希望定义一个计算属性,它结合或者转换原始属性。
app/models/person.js
export default DS.Model.extend({ firstName: DS.attr(), lastName: DS.attr(), fullName: Ember.computed(‘firstName‘, ‘lastName‘, function() { return this.get(‘firstName‘) + ‘ ‘ + this.get(‘lastName‘); }) });
4. 如果你不指定属性的类型,它将会是服务器提供的任何类型。你可以确定一个属性通常通过type或者attr被强制为特定的类型:
app/models/person.js
export default DS.Model.extend({ birthday: DS.attr(‘date‘) });
5. 默认的adapter提供string, number, boolean和date属性类型。自定义的adapters可能提供其他的属性类型,并且新类型可以被注册为变换式。请查看documentation section on the REST Adapter。
6. 请注意Ember Data根据ISO 8601序列化和反序列化日期。例如:2014-05-27T12:54:01
8. Options
DS.attr用一个可选择的hash作为第二个参数:
(1) defaultValue: 如果没有提供的话,传递一个字符串或者一个被调用的function来设置为属性的默认值。
(2) example:
app/models/user.js
export default DS.Model.extend({ username: DS.attr(‘string‘), email: DS.attr(‘string‘), verified: DS.attr(‘boolean‘, {defaultValue: false}), createdAt: DS.attr(‘string‘, { defaultValue() { return new Date(); } }) });
三、Defining Relationships
Ember Data包含几个内置的关系类型,帮助我们定义你的模型是如何相互联系的。
1. one-to-one
使用DS.belongsTo在两个模型间声明一对一关系:
app/models/user.js
export default DS.Model.extend({ profile: DS.belongsTo(‘profile‘) });
app/models/profile.js
export default DS.Model.extend({ user: DS.belongsTo(‘user‘) });
2. one-to-many
使用DS.belongsTo和DS.hasMany结合来声明两个模型之间的一对多关系:
app/models/post.js
export default DS.Model.extend({ comments: DS.hasMany(‘comment‘) });
app/models/comment.js
export default DS.Model.extend({ post: DS.belongsTo(‘post‘) });
3. many-to-many
使用DS.hasMany来声明两个模型之间的多对多关系:
app/models/post.js
export default DS.Model.extend({ tags: DS.hasMany(‘tag‘) });
app/models/tag.js
export default DS.Model.extend({ posts: DS.hasMany(‘post‘) });
4. explicit inverses(显式倒转)
(1) Ember Data将尽其所能发现映射到另一个的关系。在上面的one-to-many代码中,例如,Ember Datak可以找出,改变comments的关系应该相反的更新post关系,因为post是唯一到该model的关系。
(2) 然而,有些时候对同一个类型你可能有许多个belongsTo/hasMany。你可以使用DS.hasMany的inverse选项指定在相关的模型中哪一个是倒转的:
app/models/comment.js
export default DS.Model.extend({ onePost: DS.belongsTo(‘post‘), twoPost: DS.belongsTo(‘post‘), redPost: DS.belongsTo(‘post‘), bluePost: DS.belongsTo(‘post‘) });
app/models/post.js
export default DS.Model.extend({ comments: DS.hasMany(‘comment‘, { inverse: ‘redPost‘ }) });
你也可以指定在一个belgongsTo上指定一个倒转,它可以像你期望的那样工作。
5. reflexive relation(自关联关系)
当你想定义一个自关联关系,你必须明确定义另一方,并且设置相应的显示倒转,如果你不需要另一方,设置为null。
app/models/folder.js
export default DS.Model.extend({ children: DS.hasMany(‘folder‘, { inverse: ‘parent‘ }), parent: DS.belongsTo(‘folder‘, { inverse: ‘children‘ }) });
app/models/folder.js
export default DS.Model.extend({ parent: DS.belongsTo(‘folder‘, { inverse: null }) });