使用 WADL 记录 POST 参数

Question

查看WADL 提案的当前版本，我不太清楚如何记录POST 请求参数（使用 application/x-www-form-urlencoded 编码）。

我在野外见过这样的事情：

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

但是，对于用作 子级的 ，< a href="http://www.w3.org/Submission/wadl/#x3-270002.12.2" rel="noreferrer">规范将其描述为：

指定 URI 查询参数 根据以下规则表示 查询组件媒体类型 由queryType属性指定。

“URI 查询”位让我感到困惑，因为对我来说，它建议将参数附加到 URI，而不是包含在正文中。

另一方面，对于用作 子级的 ，规范具有：

指定一个组件 表示为名称值对 根据规则格式化 媒体类型。通常与 媒体类型 'application/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>

这看起来有点矫枉过正。我假设我应该能够使用前者，尽管规范提到了“URI 查询”。

Answer 1

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

3rd party edit

后一个可能意味着这个

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