Web服务API设计:XML元素与属性

这个问题在这里已经有一个答案:> XML attribute vs XML element20个
我正在为一个Web服务设计一个API,我无法决定使用XML属性,元素或混合体系结构.

让我举个例子.我们假设我有一个名为Domain的对象.这个模型有3个属性(tld,sld,trd和name本身),一个方法有效?如果域有效,则返回true.

# I'm using ruby but 
# consider this as pseudo-code
class Domain
  attr_accessor :tld,:sld,:trd,:name

  def valid?
    true # force true
  end
end

我的api称为/ domain / parser在输入中接收一个域,并返回解析的响应.第一种可能性是为每个域属性使用一个元素.

<result>
  <domain>
    <name>www.google.it</name>
    <tld>it</tld>
    ...
    <valid>true</true>
  </domain>
</result>

但是一些接口使用属性.

<result>
  <domain tld="it" sld="google.com" trd="www" rule="*.foo" name="www.google.it" valid="true" />
</result>

不要忘记属性和价值.

<result>
  <domain tld="it" sld="google.com" trd="www" rule="*.foo" name="www.google.it" valid="true">
    www.google.it
  </domain>
</result>

在你看来,哪个是更强大,灵活和富有表现力的选择?另外,考虑回应将以XML和JSON(很快)提供.

解决方法

我使用的模式是:

>元素用于数据
属性用于元数据(即关于数据的数据)

如果您使用XSD架构的最多(如果不是全部)您的元数据应该在那里,但如果你没有属性是它的好地方.

所以你的例子我可能会这样做:

<result>
  <domain valid="true">
    <name>www.google.it</name>
    <tld>it</tld>
    ...
  </domain>
</result>

相关文章

vue阻止冒泡事件 阻止点击事件的执行 &lt;div @click=&a...
尝试过使用网友说的API接口获取 找到的都是失效了 暂时就使用...
后台我拿的数据是这样的格式: [ {id:1 , parentId: 0, name:...
JAVA下载文件防重复点击,防止多次下载请求,Cookie方式快速简...
Mip是什么意思以及作用有哪些