Web services 使用WADL记录POST参数

看着，我不太明白如何记录POST请求参数（使用

application/x-www-form-urlencoded

encoding）

我在野外见过这样的东西：

<resource path="/path1">
<!-- default is mediaType="application/x-www-form-urlencoded" -->
    <method name="POST">
        <request>
            <name="param1" style="query"/>
        </request>
    </method>
</resource>

但是，对于用作

的子级的

，：

指定一个URI查询参数 按照以下规则表示： 查询组件媒体类型 由queryType属性指定

“URI查询”这一点让我很反感，因为对我来说，它建议将参数附加到URI中，而不是包含在主体中

另一方面，对于用作

子级的

，规范有：

指定对象的组件 表示为名称-值对 按照规则格式化 媒体类型。通常用于 媒体类型 “应用程序/x-www-form-urlencoded”或 “多部分/表单数据”

我是否必须使用

元素来显式地记录将作为POST正文的一部分以编码方式发送的参数

<resource path="/path1">
    <method name="POST">
        <request>
            <representation mediaType="application/x-www-form-urlencoded">
                <name="param1" style="query"/>
            </representation>
        </request>
    </method>
</resource>

<resource path="/path1">
    <method name="POST">
        <request>
            <representation mediaType="application/x-www-form-urlencoded">
                <name="param1" style="query"/>
            </representation>
        </request>
    </method>
</resource>

---

这看起来太过分了。我假设我应该能够使用前者，即使规范提到了“URI查询”。

现在我看到我实际上应该使用后一种形式。即使仅仅记录一些POST参数看起来有点过分，但最好明确记录参数是body==表示的一部分这一事实

第三方编辑 后者可能是指这个