EmberJS中文手册
> EmberJS中文手册 > Ember model简介

Ember官网用了大篇幅来介绍model，相比之前的controller简直就是天壤之别啊！

从本篇开始学习Ember的模型，这一章也是Ember基础部分的最后一章内容，非常的重要（不管你信不信反正我是信了）。

在开始学习model之前先做好准备工作： 重新创建一个Ember项目，仍旧使用的是Ember CLI命令创建。

ember new chapter6_models
cd chapter6_models
ember server

在浏览器执行项目，看到如下信息说明项目搭建成功。 Welcome to Ember

本章演示所用到的代码都可以从Https://github.com/ubuntuvim/my_emberjs_code/tree/master/chapter6_models获取。

在介绍model之前先在项目中引入firebase。相关的配置教材请移步这里（如果无法加载页面请先在https://www.firebase.com/注册用户）。firebase的官网提供了专门用于Ember的版本，还提供了非常简单的例子。从安装到整合都给出了非常详细代码教程。 下面是我的整合步骤（命令都是在项目目录下执行的）：

  • 安装

    ember install emberfire

    安装完成之后会自动创建adapter（app/adapters/application.js），对于这个文件不需要做任何修改，官网提供的代码也许跟你的项目的代码不同，应该是官网的版本是旧版的。

  • 配置config/environment.js 修改第八行firebase: 'https://YOUR-FIREBASE-NAME.firebaseio.com/'。这个地址是你注册用户时候得到的。你可以从这里查看你的地址。比如下图所示位置

Ember model简介

  • 再在config/enviroment.js的APP:{}(大概第20行)后面新增如下代码 
    APP: {
  // Here you can pass flags/options to your application instance
  // when it is created
},
contentSecurityPolicy: {
  'default-src': "'none'",
  'script-src': "'self' 'unsafe-inline' 'unsafe-eval' *",
  'font-src': "'self' *",
  'connect-src': "'self' *",
  'img-src': "'self' *",
  'style-src': "'self' 'unsafe-inline' *",
  'frame-src': "*"
}

    然后再注释掉第7行原有属性（安装firebase自动生成的，但是配置不够完整）：contentSecurityPolicy。

或者你可以参考我的配置文件：

/* jshint node: true */

module.exports = function(environment) {
  var ENV = {
    modulePrefix: 'chapter6-models',
    environment: environment,
    // contentSecurityPolicy: { 'connect-src': "'self' https://auth.firebase.com wss://*.firebaseio.com" },
    firebase: '你的firebase连接',
    baseURL: '/',
    locationType: 'auto',
    EmberENV: {
      FEATURES: {
        // Here you can enable experimental features on an ember canary build
        // e.g. 'with-controller': true
      }
    },

    APP: {
      // Here you can pass flags/options to your application instance
      // when it is created
    },
    contentSecurityPolicy: {
      'default-src': "'none'",
      'script-src': "'self' 'unsafe-inline' 'unsafe-eval' *",
      'font-src': "'self' *",
      'connect-src': "'self' *",
      'img-src': "'self' *",
      'style-src': "'self' 'unsafe-inline' *",
      'frame-src': "*"
    }
  };

  // 其他代码省略……
  return ENV;
};

如果不做这个配置启动项目之后浏览器会提示一堆的错误。主要是一些访问权限问题。配置完之后需要重启项目才能生效！

1，简介

model是一个用于向用户呈现底层数据的对象。不同的应用有不同的model，这取决于解决的问题需要什么样的model就定义什么样的model。

model通常是持久化的。这也就意味着用户关闭了浏览器窗口model数据不应该丢失。为了确保model数据不丢失，你需要存储model数据到你所指定的服务器或者是本地数据文件中。
一种非常常见的情况是，model数据会以json的格式通过HTTP发送到服务器并保存在服务中。Ember还未开发者提供了一种更加简便的方式：使用IndexedDB（使用在浏览器中的数据库）。这种方式是把model数据保存到本地。或者使用Ember Data，又或者使用firebase，把数据直接保存到远程服务器上，后续的文章我将引入firebase，把数据保存到远程服务器上。

Ember使用适配器模式连接数据库，可以适配不同类型的后端数据库而不需要修改任何的网络代码。你可以从emberobserver上看到几乎所有Ember支持的数据库。

如果你想把你的Ember应用与你的远程服务器整合，几遍远程服务器API返回的数据不是规范的JSON数据也不要紧，Ember Data可以配置任何服务器返回的数据。

Ember Data还支持流媒体服务器，比如WebSocket。你可以打开一个socket连接远程服务器，获取最新的数据或者把变化的数据推送到远程服务器保存。

Ember Data为你提供了更加简便的方式操作数据，统一管理数据的加载，降低程序复杂度。
对于model与Ember Data的介绍就到此为止吧，官网用了大量篇幅介绍Model，在此我就不一一写出来了！太长了，写出来也没人看的！！！如果有兴趣自己看吧！点击查看详细信息。
下面先看一个简单的例子，由这个例子延伸出有关于model的核心概念。这些代码是旧版写法，仅仅是为了说明问题，本文也不会真正执行。

//  app/components/list-of-drafts.js
export default Ember.Component.extend({
    willRender() {
        // ECMAScript 6语法
        $.getJSON('/drafts').then(data => {
            this.set('drafts', data);
        });
    }
});

定义了一个组件类。并在组件类中获取json格式数据。 下面是组件对应的模板文件。


<ul>
    {{#each drafts key="id" as |draft|}}
    <li>{{draft.title}}</li>
    {{/each}}
</ul>

再定义另外一个组件类和模板

//  app/components/list-button.js
export default Ember.Component.extend({
    willRender() {
        // ECMAScript 6语法
        $.getJSON('/drafts').then(data => {
            this.set('drafts', data);
        });
    }
});

{{#link-to ‘drafts’ tagName=’button’}}
Drafts ({{drafts.length}})
{{/link-to}}

组件list-of-drafts类和组件list-button类是一样的，但是他们的对应的模板却不一样。但是都是从远程服务器获取同样的数据。如果没有Store（model核心内容之一）那么每次这两个模板渲染都会是组件类调用一次远程数据。并且返回的数据是一样的。这无形中增加了不必要的请求，暂用了不必要的宽带，用户体验也不好。但是有了Store就不一样了，你可以把Store理解为仓库，每次执行组件类时先到Store中获取数据，如果没有再去远程获取。当在其中一个组件中改变某些数据，数据的更改也能理解反应到另一个获取此数据的组件上（与计算属性自动更新一样），而这个组件不需要再去服务请求才能获取最新更改过的数据。

下面的内容将为你一一介绍Ember Data最核心的几个东西：models、records、adapters、store。

2，核心概念

声明：下面简介内摘抄至http://www.emberjs.cn/guides/models/#toc_。

1，store

store是应用存放记录的中心仓库。你可以认为store是应用的所有数据的缓存。应用的控制器和路由都可以访问这个共享的store；当它们需要显示或者修改一个记录时，首先就需要访问store。

DS.Store的实例会被自动创建，并且该实例被应用中所有的对象所共享。

store可以看做是一个缓存。在下面的cache会结合store介绍。

下面的例子结合firebase演示： 创建路由和model：

ember g route store-example
ember g model article
//   app/models/article.js

import DS from 'ember-data';

export default DS.Model.extend({
    title: DS.attr('string'),
    body: DS.attr('string'),
    timestamp: DS.attr('number'),
    category: DS.attr('string')
});

这个就是model，本章要讲的内容就是它！为何没有定义id属性呢？Ember会默认生成id属性。

我们在路由的model回调中获取远程的数据，并显示在模板上。

//  app/routes/store-example.js

import Ember from 'ember';

export default Ember.Route.extend({
    model: function() {
        // 从store中获取id为JzySrmbivaSSFG6WwOk的数据，这个数据是我在我的firebase中初始化好的
        return this.store.find('article', '-JzySrmbivaSSFG6WwOk');
    }
});

find方法的第一个参数是model类名，第二个参数对象的id属性值。记得id属性不需要在model类中手动定义，Ember会自动为你定义。

<h1>{{model.title}}</h1>

<div class="body">
{{model.body}}
</div>

页面加载之后可以看到获取到的数据。

Ember model简介

下面是我的firebase上的部分数据截图。

Ember model简介

可以看到成功获取到id为-JzySrmbivaSSFG6WwOk的数据。更多关于数据的操作在后面会详细介绍。

2，model

有关model的概念前面的简介已经介绍了，这里不再赘述。 model定义：

model是由若干个属性构成的。attr方法的参数指定属性的类型。

export default DS.Model.extend({
    title: DS.attr('string'),  //  字符串类型
    flag: DS.attr('boolean'), //  布尔类型
    timestamp: DS.attr('number'),  //  数字类型
    birth: DS.attr(‘date’)  //日期类型
});

模型也声明了它与其他对象的关系。例如，一个Order可以有许多LineItems，一个LineItem可以属于一个特定的Order。

App.Order = DS.Model.extend({
  lineItems: DS.hasMany('lineItem')
});

App.LineItem = DS.Model.extend({
  order: DS.belongsTo('order')
});

这个与数据的表之间的关系是一样的。

3，record

record是model的实例，包含了从服务器端加载而来的数据。应用本身也可以创建新的记录，以及将新记录保存到服务器端。

记录由以下两个属性来唯一标识：

  1. 模型类型
  2. 一个全局唯一的ID

比如前面的实例article就是通过find方获取。获取到的结果就是一个record。

4，adapter

适配器是一个了解特定的服务器后端的对象，主要负责将对记录(record)的请求和变更转换为正确的向服务器端的请求调用。

例如，如果应用需要一个ID为1的person记录，那么Ember Data是如何加载这个对象的呢？是通过HTTP，还是Websocket？如果是通过HTTP，那么URL会是/person/1，还是/resources/people/1呢？

适配器负责处理所有类似的问题。无论何时，当应用需要从store中获取一个没有被缓存的记录时，应用就会访问适配器来获取这个记录。如果改变了一个记录并准备保存改变时，store会将记录传递给适配器，然后由适配器负责将数据发送给服务器端，并确认保存是否成功。

5，cache

store会自动缓存记录。如果一个记录已经被加载了，那么再次访问它的时候，会返回同一个对象实例。这样大大减少了与服务器端的往返通信，使得应用可以更快的为用户渲染所需的UI。

例如，应用第一次从store中获取一个ID为1的person记录时，将会从服务器端获取对象的数据。

但是，当应用再次需要ID为1的person记录时，store会发现这个记录已经获取到了，并且缓存了该记录。那么store就不会再向服务器端发送请求去获取记录的数据，而是直接返回第一次时候获取到并构造出来的记录。这个特性使得不论请求这个记录多少次，都会返回同一个记录对象，这也被称为Identity Map（标识符映射）。

使用标识符映射非常重要，因为这样确保了在一个UI上对一个记录的修改会自动传播到UI其他使用到该记录的UI。同时这意味着你无须手动去保持对象的同步，只需要使用ID来获取应用已经获取到的记录就可以了。

3，架构简介

应用第一次从store获取一个记录时，store会发现本地缓存并不存在一份被请求的记录的副本，这时会向适配器发请求。适配器将从持久层去获取记录；通常情况下，持久层都是一个HTTP服务，通过该服务可以获取到记录的一个JSON表示。

Ember model简介

如上图所示，适配器有时不能立即返回请求的记录。这时适配器必须向服务器发起一个异步的请求，当请求完成加载后，才能通过返回的数据创建的记录。

由于存在这样的异步性，store会从find()方法立即返回一个承诺（promise）。另外，所有请求需要store与适配器发生交互的话，都会返回承诺。 一旦发给服务器端的请求返回被请求记录的JSON数据时，适配器会履行承诺，并将JSON传递给store。 store这时就获取到了JSON，并使用JSON数据完成记录的初始化，并使用新加载的记录来履行已经返回到应用的承诺。

Ember model简介

下面将介绍一下当store已经缓存了请求的记录时会发生什么。

Ember model简介

在这种情形下，store已经缓存了请求的记录，不过它也将返回一个承诺，不同的是，这个承诺将会立即使用缓存的记录来履行。此时，由于store已经有了一份拷贝，所以不需要向适配器去请求（没有与服务器发生交互）。

models、records、adapters、store是你必须要理解的概念。这是Ember Data最核心的东西。

有关于上述的概念将会在后面的文章一一用代码演示。理解了本文model这一整章的内容都不是问题了！！！
博文完整代码放在Github（博文经过多次修改，博文上的代码与github代码可能有出入，不过影响不大！），如果你觉得博文对你有点用，请在github项目上给我点个star吧。您的肯定对我来说是最大的动力！！

下一篇：