Question

我正在利用ResWebservice进行一些基本业务,如创建/研究。请求xml研究类似情况

<customer> 
    <name/>
  .....
 </customer>

For a successful operation I return the same customer XML with extra fields populated in it(eg. systemId etc which we blank in the request) . with Response.Status=2000

For an unsuccessful operation i return something like this with different error codes . e.g Response.Status = 422(Unprocessable entity) Response.Status= 500(Internal Server Error) and few others..

<errors>
<error> An exception occurred while creating the customer</error>
<error> blah argument is not valid.</error>
</errors>

现在我不清楚,这是向客户发送错误的正确方式。或许应该站在答复的头脑中。

I will really appreciate any help. Thanks!

Answer 1

我在“请求”或“反应”包装中总结XML。

例如,

<customerrequest>
  <customer>
    ..
  </customer>
</customerrequest>

更重要的是:

<customerresponse>
  <status>success | failure</status>
  <customer> <!-- If success -->
     ...
  </customer>
  <errors> <!-- If failure -->
     <!-- never underestimate the value of having a machine-friendly error code 
          for each possible error, or critical/non-critical errors -->
     <error code="0001">An error occurred</error>
  </errors>
</customerresponse>

这也意味着,随着您的服务成熟,你可以在请求/答复中增加额外的非数据领域。或参考编号。或认证细节。

如果你使用SOAP,你可以使用SOAP已经形成的现有错误处理方法,尽管我个人发现这种错误相当有限(我没有深入调查)。

Answer 2

纠正错误的REST做法是使用吉大港山区地位法(正如你一样)。其中有一阵列(,你可能会惊讶地看到,有多少人可能适合最常见的情况。

就友好错误信息而言,你有2项选择。首先,你可以在吉大港定居地安置点答复中说明地位法(。这份案文由服务器确定,而不是由吉大港山区开发方案的规格确定,使您在发出的具体信息方面有一定的灵活性;大多数服务方框架使你能够以方案方式确定这一案文。然而, 这不是滥用地位法描述的一种最佳做法,因为你不能保证用户的网络客户能够读到该词(只读地位法,使用“吉大港”标准描述)。如果你的地位描述简单,你控制服务器和客户(你知道你正在做什么),我只建议采用这种做法。在我的经验中,这一办法在5xx系列的法典中发挥了很好的作用,但我却不使用这种方法。

你的第二种选择是你已经做些什么:回归错误地位法,描述错误作为电文体。这是最佳做法;如果它为你工作,就不需要改变。也许应当将这一信息视为“错误的附加信息”,而不是错误信息本身(这是《吉大港山区行动计划》答复中地位法之后的案文)。

友情链接