#6 记录入库

英文原版：https://guides.emberjs.com/v2.14.0/models/pushing-records-into-the-store/

认知store的其中一种方法是将它作为已读取的记录的缓存。如果route或controller需要获得记录，那么store可以立即返回已被缓存的记录；否则store会向适配器索取记录，这通常意味着将会向服务器发起一个请求。

相对于等待从远端获取记录，你也可以将一条记录推送到store的缓存中。

如果用户在某个步骤后立即要使用这条记录，那么这会非常有用。当用户点击一个超链接，与其等待完成一个请求，Ember可以立即渲染一个新模版。这会在瞬间完成。

另一个可以利用此机制的场景是，你的应用通过流链接到服务器，并且如果一条记录被创建或被编辑，你想立即更新UI。

推送记录

通过调用store的push()可以将一条记录推入store。

例子，假设我们想在应用一启动的时候从store预加载一些数据。

我们可以利用application路由实现这个功能。application路由在路由层级的顶层，并且它的model钩子函数会在应用启动的时候就被调用。

app/models/album.js

import DS from 'ember-data';

export default DS.Model.extend({
  title: DS.attr(),
  artist: DS.attr(),
  songCount: DS.attr()
});

app/routes/application.js

import Ember from 'ember';

export default Ember.Route.extend({
  model() {
    this.get('store').push({
      data: [{
        id: 1,
        type: 'album',
        attributes: {
          title: 'Fewer Moving Parts',
          artist: 'David Bazan',
          songCount: 10
        },
        relationships: {}
      }, {
        id: 2,
        type: 'album',
        attributes: {
          title: 'Calgary b/w I Can\'t Make You Love Me/Nick Of Time',
          artist: 'Bon Iver',
          songCount: 2
        },
        relationships: {}
      }]
    });
  }
});

store的push()是一个低等级的API，它遵循的JSON API文档与JSONAPISerializer 遵循的JSON API文档有一些区别。JSON API数据格式中的type名必须与定义model的文件名一致；属性名和关系名称必须与model类中的定义一致。

如果你希望数据在被推入store之前需要被默认的模型序列化器规范化，你可以使用store.pushPayload() 方法：

app/serializers/album.js

import DS from 'ember-data';

export default DS.RestSerializer.extend({
  normalize(typeHash, hash) {
    hash['songCount'] = hash['song_count']
    delete hash['song_count']
    return this._super(typeHash, hash);
  }

})

app/routes/application.js

import Ember from 'ember';

export default Ember.Route.extend({
  model() {
    this.get('store').pushPayload({
      albums: [
        {
          id: 1,
          title: 'Fever Moving Parts',
          artist: 'David Bazan',
          song_count: 10
        },
        {
          id: 2,
          title: 'Calgary b/w I Can\'t Make You Love Me/Nick Of Time',
          artist: 'Bon Iver',
          song_count: 2
        }
      ]
    });
  }
});

在你使用复杂的终端时push()方法也很重要。你可能会发现你的应用会执行一些业务逻辑，然后创建一些记录。这可能不会清晰的映射到Ember Data现有的save()方法。相反的，你需要自定义AJAX请求并且将响应数据推入store，以至于可以让应用的其他部分访问它。

app/routes/confirm-payment.js

import Ember from 'ember';

export default Ember.Route.extend({
  actions: {
    confirm: function(data) {
      $.ajax({
        data: data,
        method: 'POST',
        url: 'process-payment'
      }).then((digitalInventory) => {
        this.get('store').pushPayload(digitalInventory);
        this.transitionTo('thank-you');
      });
    }
  }
});

在模型中定义但在规范化的JSON API文档对象中省略的属性将不会更新。 包含在规范化的JSON API文档对象中但未在模型中定义的属性将被忽略。

本节完