java调用wadl_Java中的WADL：温和的介绍

java调用wadl

WADL（ Web应用程序描述语言 ）对REST而言，WSDL对SOAP而言。 这种语言的存在引起了很多争议（请参阅： 我们需要WADL吗？ 或者 需要 WADL还是不需要WADL ）。 我可以想到使用WADL的一些合法用例，但是如果您已经在这里，则可能不打算再进行讨论。 因此，让我们继续前进到WADL本身。

原则上，WADL与WSDL类似，但是语言的结构有很大不同。 尽管WSDL定义了消耗或产生其中一些消息和操作的平面列表，但WADL强调了RESTful Web服务的分层性质。 在REST中，主要工件是资源。 每个资源（名词）都表示为URI。 每个资源都可以定义CRUD操作（动词，作为HTTP方法实现）和嵌套资源。 嵌套资源与父资源有很强的关系，通常代表所有权。

一个简单的示例是表示书籍列表的http://example.com/api/books资源。 您可以（HTTP）获取此资源，这意味着检索整个列表。 您还可以获取http://example.com/api/books/7资源，以在books资源中获取第7本书的详细信息。 或者，您甚至可以使用相同的URI放入新版本或完全删除资源。 您不仅限于单一的嵌套层次：获取http://example.com/api/books/7/reviews?page=2&size=10将会检索第二本书（最多10本书）的第二页（最多10条）。 显然，您也可以在书籍旁边放置其他资源，例如http://example.com/api/readers

就像WSDL人员能够做到的那样，要求正式而精确地描述每个可用资源，方法，请求和响应。 WADL是描述“可用URI”的选项之一，尽管有些人认为编写良好的REST服务应该是自我描述的（请参阅HATEOAS ）。 但是，这是一个简单的空WADL文档：

<application xmlns="http://wadl.dev.java.net/2009/02">
    <resources base="http://example.com/api"/>
</application>

这里没什么好看的。 请注意， <resources>标记定义了基本API地址。 我们将要添加的所有命名资源都相对于该地址。 您还可以定义几个<resources>标记来描述多个API。 因此，让我们添加一个简单的资源：