Emberjs中JSONAPISerializer的常用API

摘要：默认使用，在我们的项目中也是使用所以只是涉及关于的相关内容。这样来达到前后端通信的要求。这个方法可以在中定义特定的来针对调用。同理，其他的更新删除相似至此的相关属性与已解释完成。

Emberjs 默认使用 JSONAPISerializer ，在我们的项目中也是使用JSONAPISerializer.所以只是涉及关于 JSONAPISerializer 的相关内容。
@[TOC]

在目前的版本中，后端我们使用 大驼峰法命名，但是前端基本使用都是 驼峰法，导致有所差异，在数据获取展示过程中，需要统一 key 的名称。这时就可以使用 keyForAttribute 这个方法来实现我们的需求，比如：

//    后端数据
{
    "data": [{
    "type":  "people",
    "id":  "123",
    "attributes": {
        "FirstName":  "Jeff",
        "LastName":  "Atwood",
        "Birthday":  new  Date().getTime()
        }
    }, {
    "type":  "people",
    "id":  "124",
    "attributes": {
        "FirstName":  "Yehuda",
        "LastName":  "Katz",
        "Birthday":  new  Date("2011-11-11 11:11:11").getTime()
        }
    }]
};

而在前端 我们定义的属性名为:

//    person/model.js
import DS from  "ember-data";

export  default  DS.Model.extend({
    firstName:  DS.attr("string"),
    lastName:  DS.attr("string"),
    birthday:  DS.attr("date")
});

前端使用的是 常用的驼峰命名法，在这样的情形下(前后端属性名字不一致)，我们就需要修改向后端申请的属性名称来将后端数据合理的传递到我们前端定义的属性名上来：

//    person/serializer.js
import DS from  "ember-data";
import { camelize, capitalize } from  "@ember/string";
  
export  default  DS.JSONAPISerializer.extend({
    keyForAttribute(key) {
        let newKey = camelize(key);
        return capitalize(newKey);
    }
});

keyForAttribute 这个方法接受 前端 定义的属性名称为参数，如当下的firstName等，经过转换为后端相同的属性名，如FirstName 。这样来达到前后端通信的要求。

在上面我们可以看到，后端返回数据中的 type为people，但是前端寻找的type 却为person，这是因为 Ember Data 中的约定的关系，但是如果我们就想让它寻找的type 为 people呢？那我们就需要用到 modelNameFromPayloadKey 这个方法：

//    people/serilizer.js
import DS from  "ember-data";
import { camelize, capitalize } from  "@ember/string";
  
export  default  DS.JSONAPISerializer.extend({
    modelNameFromPayloadKey(key) {
        return key;
    },
    keyForAttribute(key) {
        let newKey =  camelize(key);
        return  capitalize(newKey);
    }
});

通过复写这个方法就可以禁止 modelName 的单复数转换了。
目前我们是在多带带的 model 下执行的这个 serializer 的几个方法，如果需要在全局则需要将 serializer.js文件写在 application 下¹。
相应的，还会有payloadKeyFromModelName

## IDs
在 JSONAPI 中 每个条目都应该使用 id 中的值来作为为一标识，前后端都应如此，如果后端没有将 id 作为唯一标识，那么就可以使用 primaryKey 这个属性来定义一个唯一标识：
这是前端定义的:

//    people/serilizer.js
import DS from  "ember-data";
import { camelize, capitalize } from  "@ember/string";
  
export  default  DS.JSONAPISerializer.extend({
    primaryKey: "pKey",
    modelNameFromPayloadKey(key) {
        return key;
    },
    keyForAttribute(key) {
        let newKey = camelize(key);
        return capitalize(newKey);
    }
});

而后端传来的数据即可变更为：

//    后端数据
{
    "data": [{
    "type":  "people",
    "pKey":  "123",
    "attributes": {
        "FirstName":  "Jeff",
        "LastName":  "Atwood",
        "Birthday":  new  Date().getTime()
        }
    }, {
    "type":  "people",
    "pKey":  "124",
    "attributes": {
        "FirstName":  "Yehuda",
        "LastName":  "Katz",
        "Birthday":  new  Date("2011-11-11 11:11:11").getTime()
        }
    }]
};

在日常工作中的难题之一就是命名，而往往后端的命名和前端的不太一致，如果我们做了大量的展示工作，再更换名称那就有点比较麻烦，这时候我们可以使用 attrs属性来达到我们的目的：
后端传输的数据中有一:

    //    ...
    ThePersonSelfHeight:176
    // ...

前端认为这个名字过于复杂所以想alias：

//    people/serilizer.js
import DS from  "ember-data";
 
export  default  DS.JSONAPISerializer.extend({
    primaryKey: "pKey",
    attrs: {
        height: "ThePersonSelfHeight"
    },
    // ...
});

同时也需要在model.js 文件进行相应的修改：

//    people/model.js
// ...
    height:  DS.attr("number")
// ...

即可在页面中使用.height展示ThePersonSelfHeight 属性的值。

在工作中，后端传回来的数据往往会有些许嵌套或者是后端人员有自己的思考方式导致数据的结构和我们设想的有些许不同。这个时候我们可以通过 serialize() 以及 normalizeResponse() 这两个方法来实现我们的需求。
比如后端传给我们的数据有:

data: {
    type:  "phone",
    id:  1,
    attributes: {
        brand:  "Nokia",
        capacity:  64,
        size: {
            width:  70.9,
            height:  143.6,
            depth:  7.7,
            weight:  177
        },
        display:  5.8
    }
}

而我们在数据显示中希望能直接展示的depth，而不想从size中取:

//    phone/model.js
import DS from  "ember-data";

export  default  DS.Model.extend({
    brand:  DS.attr("string"),
    capacity:  DS.attr("number"),
    depth:  DS.attr("number"),
    display:  DS.attr("number")
});

我们可以通过 serializer.js 中的 normalizeResponse()方法来实现我们的需求:

// phone/serializer.js
// ...
normalizeResponse(store, primaryModelClass, payload, id, requestType) {
    payload.data.attributes.depth = payload.data.attributes.size.depth;
    delete payload.data.attributes.size;
    return  this._super(...arguments);
}

之后在 route.js 中我们请求数据:

//    route.js
// ...
model() {
    return this.get("store").queryRecord("phone",{})
}

这样页面中我们就可以直接获取 depth的值了:

    {{model.brand}}
    {{model.capacity}}
    {{model.depth}}
    {{model.display}}

除了 normalizeResponse()方法，还有其他的几个方法，如:

//    phone/serializer.js
// ...
normalize(typeClass, hash) {
    hash.attributes.depth = hash.attributes.size.depth;
    delete hash.attributes.size;
    return  this._super.apply(this, arguments);
}

也可以起到相同的作用。这个方法可以在application中定义特定的 typeClass来针对调用。

在本文中我们获取数据使用了 queryRecord()，所以我们还可以使用:

//    phone/serializer.js
// ...
normalizeQueryRecordResponse(store, primaryModelClass, payload, id, requestType) {
    payload.data.attributes.depth = payload.data.attributes.size.depth;
    delete payload.data.attributes.size;
    return  this._super(...arguments);
},

相同的也可以联想，当我们获取数据为:

// route.js
    mode() {
        return this.get("store").findAll("phone");
    }

这种情况的时候，可以使用:

//    phone/serializer.js
normalizeFindAllResponse(store, primaryModelClass, payload) {
    let data = payload.data.attributes;
 
    payload.data.attributes.depth = data.size ? data.size.depth : data.depth;
    delete payload.data.attributes.size;
    return  this._super(...arguments);
}

依然可以达到我们的目的。Emberjs 还提供其他的 normalize hook:

normalizeFindBelongsToResponse()

normalizeFindHasManyResponse()

normalizeFindManyResponse()

normalizeFindRecordResponse()

normalizeQueryResponse()

等其他修改创建的请求。

这个 hook 的使用需要从 创建一个 record 说起:

//    arcicle/route.js or controller.js
let articles =  this.get("store").createRecord("article", {
    id:  new  Date().getTime(),
    title:  "how to use serialize",
    body:  "let try"
});

在创建了 record 之后，可以在 EmberInspector 中的 Data 中查看到相应的 data。同时在 serializer.js中添加 normalizeCreateRecordResponse():

//    article/serializer.js
import DS from  "ember-data";

export  default  DS.JSONAPISerializer.extend({
    normalizeCreateRecordResponse(store, primaryModelClass, payload, id, requestType) {
        console.log(payload);
        return  this._super(...arguments);
    }
});

这时在浏览器看到这个 hook 并没有执行。这个hook 执行的时机时在 保存 record 的时候:

//    article/route.js or controller.js
// ...
articles.save()

刷新后即可看到 normalizeCreateRecordResponse() 此钩子已经被执行。
同理，其他的更新/删除相似:

normalizeDeleteRecordResponse

normalizeSaveResponse

normalizeUpdateRecordResponse

至此 DS.JSONAPISerialize 的相关属性与method 已解释完成。

Written By FrankWang.