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/'
。这个地址是你注册用户时候得到的。你可以从这里查看你的地址。比如下图所示位置
- 再在
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会自动为你定义。
<h2>{{model.title}}</h2>
<div class="body">
{{model.body}}
</div>
页面加载之后可以看到获取到的数据。
下面是我的firebase上的部分数据截图。
可以看到成功获取到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
的实例,包含了从服务器端加载而来的数据。应用本身也可以创建新的记录,以及将新记录保存到服务器端。
记录由以下两个属性来唯一标识:
- 模型类型
- 一个全局唯一的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
表示。
如上图所示,适配器有时不能立即返回请求的记录。这时适配器必须向服务器发起一个异步的请求,当请求完成加载后,才能通过返回的数据创建的记录。
由于存在这样的异步性,store
会从find()
方法立即返回一个承诺(promise
)。另外,所有请求需要store
与适配器发生交互的话,都会返回承诺。
一旦发给服务器端的请求返回被请求记录的JSON数据时,适配器会履行承诺,并将JSON
传递给store
。
store
这时就获取到了JSON
,并使用JSON
数据完成记录的初始化,并使用新加载的记录来履行已经返回到应用的承诺。
下面将介绍一下当store
已经缓存了请求的记录时会发生什么。
在这种情形下,store
已经缓存了请求的记录,不过它也将返回一个承诺,不同的是,这个承诺将会立即使用缓存的记录来履行。此时,由于store
已经有了一份拷贝,所以不需要向适配器去请求(没有与服务器发生交互)。
models
、records
、adapters
、store
是你必须要理解的概念。这是Ember Data最核心的东西。
有关于上述的概念将会在后面的文章一一用代码演示。理解了本文model
这一整章的内容都不是问题了!!!
博文完整代码放在Github(博文经过多次修改,博文上的代码与github代码可能有出入,不过影响不大!),如果你觉得博文对你有点用,请在github项目上给我点个star
吧。您的肯定对我来说是最大的动力!!
更多建议: