Ember Data 之模型定义

关注

发布于: 刚刚

前面在《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}}

复制代码

完

发布于: 刚刚阅读数: 2

原文链接:【http://xie.infoq.cn/article/7bdf903d4cbae7d87cb5cd238】。

devpoint

关注

细节的追求者 2011.11.12 加入

专注前端开发，用技术创造价值！

发布

暂无评论

创作场景

Ember Data 之模型定义

定义属性

Transforms

自定义 Transforms

选项 Options

Read-only 属性

完

devpoint

评论