我正在构建一个 REST api 并讨论我应该使用什么格式来表示 xml。我知道它可以在内部定义,但格式也有很多。wadl 看起来很有趣,但似乎有关于它的争论,而且它也是新的。
有什么建议(最佳实践)?
只要它是有效的 XML 就可以了。我对简单 REST/XML 服务的一般策略如下:
对于解析,您几乎肯定需要一个始终存在的单个根节点,例如“response”,它可以包含结果元素或错误元素。例如:
<response>
<result>
<answer>5</answer>
</result>
</response>
构建结果的方式取决于您。您可以决定是否将元素中的数据保存为 CDATA(文本注释,如上所示)或作为必需的属性,例如
<answer value="5"/>
有时有用的另一件事是在响应中包含您的原始查询,例如:
<response query="operation=add&a=2&b=3"> .. </response>
这样,如果您有多个未完成的查询,您可以将它们匹配回原始请求。