使用（现在默认）Ember Data JSON-API 适配器处理错误

我使用的是 Ember 1.13.7 和 Ember Data 1.13.8，它们默认使用 JSON-API 标准来格式化发送到 API 和从 API 接收的有效负载。

我想使用 Ember Data 的内置错误处理来向用户显示红色“错误”表单字段。我已根据 JSON-API 标准格式化了我的 API 错误响应，例如

{"errors":[
    {
        "title":"The included.1.attributes.street name field is required.", 
        "code":"API_ERR", 
        "status":"400", 
    }
]}

当我尝试保存模型时，错误回调正在正确执行。如果我查看 Ember 检查器，我可以看到模型的“isError”值设置为 true，但我看不到 Ember 数据应该如何知道模型中的哪个字段处于错误状态？我从官方 JSON-API 页面看到（http://jsonapi.org/format/#errors http://jsonapi.org/format/#errors）您可以在错误响应中包含“源”对象：

source：包含对错误源的引用的对象， 可选地包括以下任何成员：

指针：指向请求文档中关联实体的 JSON 指针 [RFC6901] [例如。 “/data”表示主数据对象，或“/data/attributes/title” 对于特定属性]。

参数：一个字符串，表示哪个查询 参数导致错误。

但这是我应该做的，以便告诉 Ember Data 哪些字段应该标记为处于错误状态？

如果有人能帮助阐明这一点，我将不胜感激。

Thanks.

请注意，以下答案基于以下版本：

DEBUG: -------------------------------
ember.debug.js:5442DEBUG: Ember                     : 1.13.8
ember.debug.js:5442DEBUG: Ember Data                : 1.13.9
ember.debug.js:5442DEBUG: jQuery                    : 1.11.3
DEBUG: -------------------------------

不幸的是，错误处理文档目前分散在各处，因为处理不同适配器（Active、REST、JSON）的错误的方式都有点不同。

在您的情况下，您想要处理表单的错误，这可能意味着验证错误。 JSON API 指定的错误格式可以在此处找到：http://jsonapi.org/format/#error-objects http://jsonapi.org/format/#error-objects

您会注意到，API 仅指定在由以下键控的顶级数组中返回错误errors所有其他错误属性都是可选的。看来 JSON API 所需的全部内容如下：

{
    "errors": [
     {}
    ]
}  

当然，这不会真正做任何事情，因此为了使 Ember Data 和 JSONAPIAdapter 的错误能够开箱即用，您至少需要包含detail属性和source.pointer属性。这detail属性是设置为错误消息和source.pointerattribute 让 Ember Data 找出模型中的哪个属性导致了问题。因此，Ember Data 所需的有效 JSON API 错误对象（如果您使用的是现在默认的 JSONAPI）如下所示：

{
    "errors": [
     {
        "detail": "The attribute `is-admin` is required",
        "source": {
             "pointer": "data/attributes/is-admin"
         }
     }
    ]
}  

注意detail不是复数（对我来说是一个常见的错误），source.pointer不应包含前导正斜杠，并且属性名称应采用破折号。

最后，您必须使用 HTTP 代码返回验证错误422这意味着“不可处理的实体”。如果您不返回422代码，那么默认情况下 Ember Data 将返回一个AdapterError并且不会在模型上设置错误消息errors哈希。这让我困惑了一段时间，因为我使用的是 HTTP 代码400（错误请求）向客户端返回验证错误。

ember 数据区分两种类型错误的方式是验证错误返回一个InvalidError目的 （http://emberjs.com/api/data/classes/DS.InvalidError.html http://emberjs.com/api/data/classes/DS.InvalidError.html）。这将导致errors要设置的模型上的哈希值，但不会设置isError标记为 true （不确定为什么会出现这种情况，但记录如下：http://emberjs.com/api/data/classes/DS.Model.html#property_isError http://emberjs.com/api/data/classes/DS.Model.html#property_isError）。默认情况下，HTTP 错误代码不是422将导致AdapterError被退回并且isError标志设置为true。在这两种情况下，都会调用 Promise 的拒绝处理程序。

model.save().then(function(){
    // yay! it worked
}, function(){
    // it failed for some reason possibly a Bad Request (400)
    // possibly a validation error (422)
}

默认情况下，如果返回的 HTTP 代码是422并且您拥有正确的 JSON API 错误格式，然后您可以通过访问模型的错误哈希来访问错误消息，其中哈希键是您的属性名称。哈希值以驼峰格式的属性名称为关键字。

例如，在我们上面的 json-api 错误示例中，如果出现错误is-admin您将像这样访问该错误：

model.get('errors.isAdmin');

这将返回一个包含错误对象的数组，其格式如下：

[
   {
      "attribute": "isAdmin",
      "message": "The attribute `is-admin` is required"
    }
]

本质上detail被映射到message and source.pointer被映射到attribute。如果单个属性出现多个验证错误，则会返回一个数组（JSON API 允许您返回多个验证错误，而不是仅返回第一个失败的验证）。您可以直接在模板中使用错误值，如下所示：

{{#each model.errors.isAdmin as |error|}}
    <div class="error">
      {{error.message}}
    </div>
{{/each}}

如果没有错误，那么上面的内容将不会显示任何内容，因此它非常适合执行表单验证消息。

如果您的 API 不使用 HTTP422验证错误的代码（例如，如果它使用400）然后您可以通过覆盖来更改 JSONAPIAdapter 的默认行为handleResponse自定义适配器中的方法。这是一个返回新值的示例InvalidError任何 HTTP 响应状态代码的对象400.

import DS from "ember-data";
import Ember from "ember";

export default DS.JSONAPIAdapter.extend({
  handleResponse: function(status, headers, payload){
    if(status === 400 && payload.errors){
      return new DS.InvalidError(payload.errors);
    }
    return this._super(...arguments);
  }
});

在上面的示例中，我检查 HTTP 状态是否为400并确保存在错误属性。如果是这样，那么我创建一个新的DS.InvalidError并返回。这将导致与期望的默认行为相同的行为422HTTP 状态代码（即，将处理您的 JSON API 错误并将消息放入模型上的错误哈希中）。