java - 如何从 Java 中的 WADL 文件访问方法？

Question

我有一个 REST 服务，我有一个 WADL 文件。我想引用这个文件并从中访问方法。 WADL 文件内容如下:

<resource path="/loadPerson">
    <method id="loadPerson" name="GET">
        <request>
            <param xmlns:xs="http://www.w3.org/2001/XMLSchema" name="personId" style="query" type="xs:int"/>
        </request>
        <response>
            <ns2:representation xmlns:ns2="http://wadl.dev.java.net/2009/02" xmlns="" element="person" mediaType="application/xml"/>
            <ns2:representation xmlns:ns2="http://wadl.dev.java.net/2009/02" xmlns="" element="person" mediaType="application/json"/>
        </response>
    </method>
</resource>

实际上我不知道如何处理它，因为我以前从未玩过 WADL 文件。我该怎么办？

Answer 1

<resource>标识您将以 RESTful 方式与之交互的 URL(相对于在外部 base 元素上指定为 <resources> 属性的基本 URL，您未显示)。 <method>有一个 name GET 的属性，这意味着要使用该特定操作，您需要对资源 URL 执行 GET。内部<request>有一个 <param>所以我们知道在 GET URL 中添加一个查询参数；在这种情况下，它将是 personId=123 (或其他一些整数)。 <response>告诉我们可以返回 XML 或 JSON 形式的答案；我们应该使用 HTTP 内容协商来说明哪个。

WADL 中有一个小错误，它指定了 <resource>以 / 开头的 URL ;这很可能会导致工具在尝试组装正确的 URL 时出现问题，但我们仍然可以说出 URL 是什么(从了解 RESTful webapps 往往如何实现)。

假设外<resources>说基本 URL 是 http://example.org/foobar (并且没有中间 <resource> 元素；WADL 允许)那么 WADL 表示如果您在 http://example.org/foobar/loadPerson?personId=123 上执行 GET如果您的 HTTP 客户端配置为首选 XML，您将获得 <person>元素作为 HTTP 响应的主体返回(或错误，例如，如果没有匹配这样的 personId 或者您无权查找)。