Ember Data 之模型定义

简介: 前面在《 Ember.js 项目开发之 Ember Data 》介绍了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 支持的属性类型stringnumberboolean,和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日期对象。

布尔值转换可以处理 truefalse 以外的值。字符串"true""t"任何大写字母,和"1"数字 1 都将强制转换为 true,反之为 false

转换不是必需的,如果没有指定转换名称,Ember Data 将不会对该值进行额外的处理。

自定义Transforms

可以使用 Ember CLItransform 生成器创建自定义转换:

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}}


相关文章
|
3月前
|
JavaScript 前端开发 数据格式
Cesium案例解析(四)——3DModels模型加载
Cesium案例解析(四)——3DModels模型加载
266 0
|
6月前
|
JSON 移动开发 前端开发
Mr_HJ / form-generator项目学习-增加自定义的超融组件(一)
Mr_HJ / form-generator项目学习-增加自定义的超融组件(一)
62 3
|
6月前
|
移动开发 前端开发
Mr_HJ / form-generator项目学习-增加自定义的超融组件(二)
Mr_HJ / form-generator项目学习-增加自定义的超融组件(二)
60 3
|
6月前
|
JavaScript 前端开发
js开发:请解释什么是ES6的Generator函数,以及它的用途。
ES6的Generator函数是暂停/恢复功能的特殊函数,利用yield返回多个值,适用于异步编程和流处理,解决了回调地狱问题。例如,一个简单的Generator函数可以这样表示: ```javascript function* generator() { yield 'Hello'; yield 'World'; } ``` 创建实例后,通过`.next()`逐次输出"Hello"和"World",展示其暂停和恢复的特性。
40 0
Zp
|
JavaScript
Vue里的data声明方式:data{},data(){}
Vue里的data声明方式:data{},data(){}
Zp
223 0
两步教你用Vue3+TS实现input组件的v-model属性
使用过一些ui框架的同学应该都知道input里面的值有一个绑定的v-model属性,这篇文章教大家如何给自己定义的input组件写一个v-model的绑定属性 第一步
630 0
两步教你用Vue3+TS实现input组件的v-model属性
|
JavaScript 开发者
组件-组件中的 data|学习笔记
快速学习组件-组件中的 data
103 0
组件-组件中的 data|学习笔记
|
JavaScript 开发者
组件-为什么组件的 data 必须是一个 function|学习笔记
快速学习组件-为什么组件的 data 必须是一个 function
113 0