文章来源:模型,保存数据到数据库

  1. 环境搭建以及使用Ember.js创建第一个静态页面
  2. 引入计算属性、action、动态内容

继续为读者介绍如何使用Ember构建一个完整的、复杂的项目。

第一个Ember.js模型

在前面两篇中实现了如何获取界面输入的邮箱值,但是并没有真正保存到数据,仅仅只是获取界面输入的值并显示出来。在本篇中将为读者演示如何保存数据到数据库中。但是我并不会去创建一个数据库,而是使用firebase,更多有关firebase的信息请自行查阅资料学习(如果访问firebase官网很慢或者是无法访问那么你需要fanqiang)!

言归正传,回到Ember的模型介绍中来。简单讲Ember的模型其实就是一个与数据表对应的一个实体类,与Java中的JavaBean有点类似。
创建一个模型也非常简单,可以直接使用Ember CLI命令创建,下面的命令就是用于创建模型类,并在模型中增加一个string类型的属性email

ember g model invitation email:string

命令执行完毕之后可以在项目对应目录下看到创建的文件app/models/invitaction.js,文件内如如下:

// app/models/invitation.js

import DS from 'ember-data';

export default DS.Model.extend({
  email: DS.attr('string')
});

有了模型类之后修改控制器index.js的代码,加入模型,通过模型来保存数据对象。

// app/controller/index.js

import Ember from 'ember';

export default Ember.Controller.extend({

    headerMessage: 'Coming Soon',

    responseMessage: '',  // 设置默认值为空字符串

    emailAddress: '',  // 设置默认值为空字符串
    //  使用正则表达式判断邮箱格式,如果正确则返回true反之返回false
    isValid: Ember.computed.match('emailAddress', /^.+@.+\..+$/),
    // 把计算属性isValid绑定到isDisabled上
    isDisabled: Ember.computed.not('isValid'),  //当`disabled=false`时按钮可用,所以正好需要取反

    actions: {
        saveInvitation: function() {
            const email = this.get('emailAddress');
            //  创建一个模型对象
            const newInvitaction = this.store.createRecord('invitation', { email: email });
            newInvitaction.save();  //保存模型对象到store中
            this.set('responseMessage', `Thank you! We've just saved your email address: ${this.get('emailAddress')}`);
            //  情况输入框内容
            this.set('emailAddress', '');
        }
    }
});

等待项目重新启动,在界面输入正确的邮箱,点击按钮,可以在浏览器控制台看到如下错误信息:

错误信息

为何会出现这些错误呢??其实很简单,我们并没有对应的后台服务区处理数据,目前仅仅是提交了数据而已,那么怎么处理呢?我们引入一个非常好用的数据库——firebase。firebase为Ember提交了非常丰富的API,我们不需要再自己写后台的处理程序,可以直接调用firebase提供的API即可完成数据的CRUD操作。更多有关firebase的使用教程请看EmberFire Guide,在这个参考文档上详细介绍了firebase如何与Ember整合,Ember如何调用firebase提供的API。

下面简单介绍如何把firebase整合到本项目中。

  1. 安装 ember install emberfire,会自动创建文件app/adapters/application.js
  2. 在firebase官网注册一个用户,并创建一个APP(如下图1位置创建APP)然后会得到一个管理连接(比如:luminous-xxx-xxx.firebaseIO.com)
  3. 修改项目中config/environment.js,在文件中增加firebase的配置。

图1
图1

config/environment.js配置代码如下:

var ENV = {
    modulePrefix: 'library-app',
    environment: environment,
    contentSecurityPolicy: { 'connect-src': "'self' https://auth.firebase.com wss://*.firebaseio.com" },
    firebase: 'https://YOUR-FIREBASE-NAME.firebaseio.com/',  //改成自己在firebase上APP的地址
    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
    }
  };
//  ……其他代码省略

注意上述代码中的第5行,firebase属性的值是自己在firebase申请的APP的URL。一定记得要修改!!!

修改完成之后手动重启项目,记得是手动关闭终端运行的项目(ctrl+c关闭),然后再使用命令ember s启动项目。否则新安装的emberfire无法起作用。

等待项目启动完成,如果启动过程中没有出现错误,说明emberfire安装成功!

然后激动的时刻到了,在首页输入正确的邮箱,点击按钮,可以看到浏览器控制来不会报错了!并且在firebase官网的APP中看到刚刚新增的邮箱!!

注意:点击按钮提交后可能看到界面没有任何反应,先别急,由于firebase是外国的东西,在天朝访问都是比较慢,你懂的。提交后到响应回来可能比较慢。

从浏览器控制台打印的日志可以看出向firebase发送请求,截图如下:

向firebase发送请求截图

并且在界面上提示了保存成功的信息!

最后在firebase官网上可以查看到刚刚提交数据。

提交到firebase的数据

可以感受到firebase的强大了吧!我们几乎没有做任何处理数据就直接保存到firebase了,并且会自动根据模型创建数据,不过需要注意的是我们在模型定义中并不需要定义id属性,firebase会自动生成一个唯一的id属性值,截图中的-KEr3XwUQjgLjb5yx0dp就是id属性值。

到此,数据的保存工作完成了,借助firebase大大简化了自己需要处理的东西,不需要自己创建数据库、数据表、以及保存数据sql等等!不知道你是否看明白了,如果有疑问请及时给我留言,我会尽力为你解答!

promise和this

promise(承诺)在JavaScript中是一个异步特性。这个特性还在完善之中,更多有关promise的介绍请看promises-book或者Mozilla MDN Promise

在前面保存数据的代码中save()方法返回值就是一个promise,我们可以根据save()方法的返回值做不同的处理,比如保存失败时候的处理。

        saveInvitation: function() {
            const email = this.get('emailAddress');
            //  创建一个模型对象
            const newInvitaction = this.store.createRecord('invitation', { email: email });
             //保存模型对象到store中
            newInvitaction.save().then(function(msg) {
                console.log('保存成功。');
            }, function(reason) {
                console.log('保存失败!');
            });
            this.set('responseMessage', `Thank you! We've just saved your email address: ${this.get('emailAddress')}`);
            //  情况输入框内容
            this.set('emailAddress', '');
        }

如果你看过有关promise的介绍那么理解上述代码应该是很简单的,在方法then()中第一个函数(参数)会在save()执行成功的时候执行,第二个函数(参数)会在save()执行失败的时候执行。明白这个之后我们再修改控制器index.js的代码。我们把提示信息放在save()执行成功的时候执行方法中。

        saveInvitation: function() {
            const email = this.get('emailAddress');
            //  创建一个模型对象
            const newInvitaction = this.store.createRecord('invitation', { email: email });
             //保存模型对象到store中
            newInvitaction.save().then(function(msg) {
                this.set('responseMessage', `Thank you! We've just saved your email address: ${this.get('emailAddress')}`);
                //  情况输入框内容
                this.set('emailAddress', '');
            }, function(reason) {
                this.set('responseMessage', `Saved: ${this.get('emailAddress')} failed!`);
                //  情况输入框内容
                this.set('emailAddress', '');
            });
        }

等待项目自动重启完成,在界面输入正确邮箱,提交数据,此时并没有出现任何反应,并且会在浏览器控制台看到如下错误,

错误信息

这又是什么原因呢?其实原因很简单,因为this作用域问题,由于是在then()内部使用了this导致此时的this指向的并不是控制器类了,只有在Ember的上下文中才能使用set()方法!我们用一个临时变量解决这个问题,代码修改为如下:

// app/controller/index.js

import Ember from 'ember';

export default Ember.Controller.extend({

    headerMessage: 'Coming Soon',

    responseMessage: '',  // 设置默认值为空字符串

    emailAddress: '',  // 设置默认值为空字符串
    //  使用正则表达式判断邮箱格式,如果正确则返回true反之返回false
    isValid: Ember.computed.match('emailAddress', /^.+@.+\..+$/),
    // 把计算属性isValid绑定到isDisabled上
    isDisabled: Ember.computed.not('isValid'),  //当`disabled=false`时按钮可用,所以正好需要取反

    actions: {
        saveInvitation: function() {
            const email = this.get('emailAddress');
            //  创建一个模型对象
            const newInvitaction = this.store.createRecord('invitation', { email: email });
            var _this = this;
             //保存模型对象到store中
            newInvitaction.save().then(function(msg) {
                _this.set('responseMessage', `Thank you! We've just saved your email address: ${_this.get('emailAddress')}`);
                //  情况输入框内容
                _this.set('emailAddress', '');
            }, function(reason) {
                _this.set('responseMessage', `Saved: ${_this.get('emailAddress')} failed!`);
                //  情况输入框内容
                _this.set('emailAddress', '');
            });
        }
    }

});

等待项目自动重启完成,在页面输入正确的邮箱并提交,可以看到此时效果与之前是一样的,然后去firebase查看结果,也是可以看到新增的数据。

虽然是用临时变量方式可以解决由于this作用域问题,但是还有更加优美的解决办法,如今几乎所有新版的浏览器引擎已经支持ES2015,可以使用ES2015的=>操作符解决this作用域问题,请看下面的处理代码:

saveInvitation: function() {
    const email = this.get('emailAddress');
    //  创建一个模型对象
    const newInvitaction = this.store.createRecord('invitation', { email: email });
    
     //保存模型对象到store中
    newInvitaction.save().then((response) => {
        console.log('response = ' + response);
        this.set('responseMessage', `Thank you! We've just saved your email address: ${response.get('id')}`);
        //  情况输入框内容
        this.set('emailAddress', '');
    }, (reason) => {
        this.set('responseMessage', `Saved: ${this.get('emailAddress')} failed!`);
        //  情况输入框内容
        this.set('emailAddress', '');
    });
}

使用ES2015的特性之后不仅解决了this作用域问题,而且连关键字function都不需要了,使用=>操作会自动把外层this所指的对象传递到函数内部,并且修改了保存成功时的提示信息,使用${response.get('id')}从firebase响应的数据中获取到保存成功后返回的id值,返回的response就是一个模型invitation的对象,可以使用get()方法获取对象值。
再次测试,如果项目代码没有误那么你可以得到如下截图的提示信息(id值跟你的是不一样的),

使用ES2015后保存截图

如果你对this不是很懂,请看认真看下面文章的解释:

  1. Mozilla MDN this
  2. Javascript的this用法

创建管理页面

前面已经介绍了如何整合firebase到项目中,并且已经成功保存增加的数据。可以在firebase上看到所有数据,我们创建一个后台页面去管理这些数据。

下面创建一个子路由和路由对应的模板页面,仍然是使用Ember CLI命令创建,命令如下:

ember g route admin/invitaction

命令执行完毕后会得到一个路由文件(app/routes/admin/invitaction.js)和一个模板文件(app/templates/admin/invitaction.hbs),命令会自动创建文件夹admin,子路由和子模板会放在子子目录下。
然后在首页增加菜单链接,修改navbar.hbs模板。

<!-- app/templates/navbar.hbs -->
<nav class="navbar navbar-inverse">
  <div class="container-fluid">
    <div class="navbar-header">
      <button type="button" class="navbar-toggle collapsed" data-toggle="collapse" data-target="#main-navbar">
        <span class="sr-only">Toggle navigation</span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
        <span class="icon-bar"></span>
      </button>
      {{#link-to 'index' class="navbar-brand"}}Library App{{/link-to}}
    </div>

    <div class="collapse navbar-collapse" id="main-navbar">
      <ul class="nav navbar-nav">
            {{#link-to 'index' tagName="li"}}<a href>Home</a>{{/link-to}}
            {{#link-to 'about' tagName="li"}}<a href>About</a>{{/link-to}}
            {{#link-to 'contact' tagName="li"}}<a href>Contact</a>{{/link-to}}
      </ul>
      <!-- 后台管理页面链接 -->
      <ul class="nav navbar-nav navbar-right">
          <li class="dropdown">
              <a class="dropdown-toggle" data-toggle="dropdown" role="button" aria-haspopup="true" aria-expanded="false">Admin<span class="caret"></span></a>
              <ul class="dropdown-menu">
                  {{#link-to 'admin.invitation' tagName="li"}}<a href="">Invitations</a>{{/link-to}}
              </ul>
          </li>
      </ul>
    </div><!-- /.navbar-collapse -->
  </div><!-- /.container-fluid -->
</nav>

代码{{#link-to 'admin.invitation' tagName="li"}}<a href="">Invitations</a>{{/link-to}}admin.invitation是一个嵌套路由或者说是子路由。更多有关路由嵌套问题请看Ember.js 入门指南之十三{{link-to}} 助手

在模板中使用表格遍历显示所有的邮箱数据。修改模板invitaction.hbs

<!-- app/templates/admin/invitations.hbs -->

<h1>Invitations</h1>

<table class="table table-bordered table-striped">
    <thead>
      <tr>
          <th>ID</th>
          <th>E-mail</th>
      </tr>
    </thead>
    <tbody>
    {{#each model as |invitation|}}
        <tr>
            <th>{{invitation.id}}</th>
            <td>{{invitation.email}}</td>
        </tr>
    {{/each}}

    </tbody>
</table>

上述代码中{{#each}}{{/each}}是Ember提供的遍历表达式,此表达式用于遍历数组数据。本例子中用户遍历从路由的model回调中返回的数据。更多有关此表达式的介绍请看Ember.js 入门指南之十handlebars遍历标签
修改路由app/routes/admin/invitations.jsmodel回调中获取服务器(firebase)上的数据。

// app/routes/admin/invitations.js
import Ember from 'ember';

export default Ember.Route.extend({

  model() {
    return this.store.findAll('invitation');
  }

});

等待项目重启完成,可以在项目首页导航栏的右侧看到可以点击下拉的Admin菜单项,点击菜单看到子菜单项“Invitation”,点击“Invitation”进入到http://localhost:4200/admin/invitation
在界面上可以看到之前新增的所有邮箱信息和firebase自动生成的ID属性值(由于firebase是老外的东西获取数据会比较慢,数据显示自然也会比较慢,稍等一会就在界面上看到了!)。如果你项目代码没问题也可以看到如下的截图。

Invitation数据截图

数据的CRUD操作

到这一步我们已经可以完整的从服务器获取数据,并以列表形式显示在界面上。本教程的目标是创建一个简单的图书管理系统,前面的文章已经完成了类似于用户注册的功能,接下来我们创建一个library模型,用于保存书库信息。
同样是使用Ember CLI命令创建模型。

ember g model library name:string address:string phone:string

上述命令创建了一个包含三个属性的模型,这三个属性都是string类型的数据。创建完模型之后再继续创建三个模板,分别用户显示library列表新建library数据。

ember g template libraries
ember g template libraries/index
ember g template libraries/new

模板创建完毕之后手动在router.js中增加路由配置,这次我们不采用Ember CLI命令创建了!!!

// app/router.js

import Ember from 'ember';
import config from './config/environment';

var Router = Ember.Router.extend({
  location: config.locationType
});

Router.map(function() {

  this.route('about');
  this.route('contact');

  this.route('admin', function() {
    this.route('invitation');
  });

  this.route('libraries', function() {
    this.route('new');
  });
});

export default Router;

再更新首页模板navbar.hbs,增加一个菜单项“libraries”,其他代码不变。

<ul class="nav navbar-nav">
    {{#link-to 'index' tagName="li"}}<a href="">Home</a>{{/link-to}}
    {{#link-to 'libraries' tagName="li"}}<a href="">Libraries</a>{{/link-to}}
    {{#link-to 'about' tagName="li"}}<a href="">About</a>{{/link-to}}
    {{#link-to 'contact' tagName="li"}}<a href="">Contact</a>{{/link-to}}
</ul>

修改模板libraries.hbs,增加菜单链接。

<!-- app/templates/libraries.hbs -->
<h1>Libraries</h1>

<div class="well">
    <ul class="nav nav-pills">
      {{#link-to 'libraries.index' tagName="li"}}<a href="">List all</a>{{/link-to}}
      {{#link-to 'libraries.new' tagName="li"}}<a href="">Add new</a>{{/link-to}}
    </ul>
</div>
<!-- 子模板new.hbs、index.hbs会渲染到outlet上 -->
{{outlet}}

等待项目重启完成,进入http://localhost:4200/libraries。可以看到如下图的界面

libraries界面

此时点击界面的上的“List all”和“Add new”除了看到URL变化之外还没任何效果,因为我们的子模板libraries/index.hbslibraries/new.hbs还没有任何内容,下面在这两个模板中增加一些代码。

<!-- app/templates/libraries/index.hbs -->
<h2>List</h2>

{{#each model as |library|}}
    <div class="panel panel-default">
        <div class="panel-heading">
            <h3 class="panel-title">{{library.name}}</h3>
        </div>
        <div class="panel-body">
            <p>Address: {{library.address}}</p>
            <p>Phone: {{library.phone}}</p>
        </div>
    </div>
{{/each}}
<!-- app/templates/libraries/new.hbs -->
<h2>Add a new local Library</h2>

<div class="form-horizontal">
    <div class="form-group">
        <label class="col-sm-2 control-label">Name</label>
        <div class="col-sm-10">
            {{input type="text" value=model.name class="form-control" placeholder="The name of the Library"}}
        </div>
    </div>
    <div class="form-group">
        <label class="col-sm-2 control-label">Address</label>
        <div class="col-sm-10">
            {{input type="text" value=model.address class="form-control" placeholder="The address of the Library"}}
        </div>
    </div>
    <div class="form-group">
        <label class="col-sm-2 control-label">Phone</label>
        <div class="col-sm-10">
            {{input type="text" value=model.phone class="form-control" placeholder="The phone number of the Library"}}
        </div>
    </div>
    <div class="form-group">
        <div class="col-sm-offset-2 col-sm-10">
            <button type="submit" class="btn btn-default" {{action 'saveLibrary' model}}>Add to library list</button>
        </div>
    </div>
</div>

模板new.hbs是一个表单,用于新增数据,通过点击按钮“Add to library list”提交表单数据,表单数据由路由libraries/new.js中的saveLibrary方法处理,此时此方法还没定义,在接下来的代码中会定义。
{{action}}表达式中传递了一个参数model到处理的后台,表单中的其他属性会以model的属性方式传递到后台,之所以可以这样做是因为在模板对应的路由中返回了一个空的library对象,在接下来的路由libraries/new.js将看到。
等待项目重启完,在点击“List all”和“Add new”可以看到这两个子模板的内容渲染到父模板libraries.hbs{{outlet}}上。不过由于并没有在路由中获取模型library的数据所以“List all”页面还没有任何数据,“Add new”页面是第一个新增数据吧表单。
下面在路由libraries/index.js中获取library的数据,并在model回调中返回到模板中遍历显示。
使用Ember CLI命令创建路由,创建过程会询问是否覆盖已经存在的模板文件,输入n选择否。

ember g route libraries/index
ember g route libraries/new

路由创建完成之后分别在这两个路由中增加获取数据的代码。

// app/routes/libraries/index.js
import Ember from 'ember';

export default Ember.Route.extend({

  model() {
    return this.store.findAll('library');
  }

});
// app/routes/libraries/new.js
import Ember from 'ember';

export default Ember.Route.extend({

  model() {
    return this.store.createRecord('library');
  },

  actions: {
    //  处理模板上输入的数据
    saveLibrary(newLibrary) {
      newLibrary.save().then(() => this.transitionTo('libraries'));
    },

    willTransition() {
      // rollbackAttributes() removes the record from the store
      // if the model 'isNew'
      this.controller.get('model').rollbackAttributes();
    }
  }
});

在此路由的model回调中我们创建了一个空的library对象,并返回到模板页面。这也是为什么能在模板中传递参数model的原因。
代码中方法willTransition()是Ember提供的内置方法,此方法的作用是当用户离开当前URL时会清空未保存到服务器的library数据,如果不重置modelEmber会在路由切换的时候自动保存数据到服务器上。
保存数据的方法saveLibrary()写的比较简洁,它的作用是:先调用save()方法保存数据,如果保存成功在调用方法transitionTo()跳转到路由libraries下(library首页),有关=>语法的介绍请看Mozill MDN Arrow_functions
在上述代码中多次是用了this.controller,但是在路由中并没有这个属性controller而且也没有控制器文件app/controllers/libraries/new.js,运行项目并不会报错!这是为什么呢?这是因为Ember会自动生成一个虚拟的控制器并在保存在内存中,根据Ember的命名规则会自动生成一个与路由同名的控制器,
为了验证这个说法,打开浏览器的控制台,在打开标签“Ember”然后点击左侧的“/# Routes”,找到路由libraries这一块,可以看到如下截图的信息。

自动生成控制器

可以看到每个路由都对应着一个同名的控制器。

等待项目重启完毕,开始验证代码是否实现了所设想的要求。
首先在新增页面输入如下截图信息,然后点击按钮保存数据。

新增library数据

稍等片刻,等待数据保存完毕,可以看到界面顺利跳转到了http://localhost:4200/libraries下,如下图所示,并且看到了刚刚新增的数据,为了验证数据是否真的保存到服务器中,我们进入到firebase的APP中查看,可以看到数据以及保存到里library下。

libraries页面

library数据列表页面截图

firebase页面

firebase上保存的library数据截图

此时,如果你注释了方法willTransition()结果会是怎么样的呢!!如果没有这个方法去重置model,当你每次在“Add new”页面输入输入并且没有点击“Add to library list”保存数,然后切换到其他路由下(比如点击“List all”切换到路由libraries下)会自动保存一条数据到服务器。

  • 在“Add new”页面输入如下截图数据

未提交保存的数据

  • 点击按钮“List all”切换到路由libraries下,可以看到在“Add new”页面添加的数据,如下图所示,但是如果你手动刷新页面后可以发现这条数据不见了,并且在firebase上也没有这条数据,可见这条数据仅仅是保存到Ember的store中,并没有真正保存到服务器上。这样的体验是非常糟糕的!!

显示为提交保存的数据

其中,实现重置model的方式还有另外一种更加合适的方法,代码如下:

willTransition() {
  // rollbackAttributes() removes the record from the store
  // if the model 'isNew'
//   this.controller.get('model').rollbackAttributes();

  let model = this.controller.get('model');

  if (model.get('isNew')) {
    model.destroyRecord();
  }
}

本篇的内容到此全部介绍完毕!本篇我们实现了数据的保存、显示,特别是library数据的保存。数据的保存、显示都需要与模型关联,模型在Ember是一个非常重要的内容!希望读者好好掌握模型。

家庭作业

下面两个作业完成其中之一即可。本篇选择第一个,第二个请读者自行完成!动手才是真理。

增强contact的功能

  1. 创建一个包括两个属性emailmessage的模型contact参考代码
  2. 修改路由app/routes/contact.js返回一个空对象到模板上,参考代码
  3. 修改控制器contact.js,保存数据到firebase,参考代码
  4. 把放在控制器中的校验代码移动到模型app/models/contact.js中,参考代码
  5. 创建一个管理contact的后台页面http://localhost:4200/admin/contacts参考代码
  6. 在项目首页的导航菜单上增加一个菜单项“Contacts”,点击菜单进入http://localhost:4200/admin/contact参考代码
  7. 使用表格展示所有的contact数据,参考代码

使用路由和模型重构有关contact的代码

  1. 把有关contact的检验放到模型类中
  2. 把控制器contact.js中保存数据的代码移动到同名的路由中
  3. 测试通过后删除控制器contact.js

作业演示结果

新增contact信息

当输入的邮箱格式正确,并且message长度大于6时按钮“send”才可用。

新增contact信息成功

保存成功后情况输入框,并且显示提示信息。当切换路由后再进入到http://localhost:4200/contact会清空保存成功的提示信息。

后台Contact列表

后台页面成功显示了新增的数据,即使手动刷新页面数据也不会丢失,可见数据已经保存到firebase,在此不再贴firebase上的数据截图了!



为了照顾懒人我把完整的代码放在GitHub上,如有需要请参考参考。博文经过多次修改,博文上的代码与github代码可能有出入,不过影响不大!如果你觉得博文对你有点用,请在github项目上给我点个star吧。您的肯定对我来说是最大的动力!!


ember_teach
209 声望28 粉丝

致力于为您提供最权威、最前沿的Ember技术教程。