问题标签 [wadl]

这个问题有点长，请多多包涵。在 REST 中，我认为我们不应该需要 WADL 或任何 IDL。而是隐含地涵盖其概念的东西。我的想法是当我们（人类）上网时，当我们第一次访问一个网站时，我们不知道它提供什么服务。你发现那些在 html 主页（或帮助部分中的站点地图页面）上的那些，或者可能只是主页上的主菜单。如果你打个比方，主页或站点地图对我们人类来说就像 WSDL 对 WS-* 或 WADL 对 REST 服务一样。只是它就像任何其他 html 内容一样。我认为在 REST 中，以下是做事的好方法，尊重 HATEOS 范式。拥有一个顶级（或默认）资源，其中列出了指向您的其他资源的链接。对于图书馆的例子，说 RestLibrary.com/ 它可能是这样的：

请注意，假定媒体类型“application/vnd.libraryml+xml”是定义的标准或（可能只是专有词汇）名为 libraryml。此外，客户端应该能够理解这个“主页”资源（元素根、资源和链接）。这是可以用来代替 WADL 的部分：任何客户都应该可以理解的抽象词汇表。例如，您可以使用像 Atom 这样的现有标准。但主要思想是要有一个任何客户都能理解的抽象词汇。那为什么不用WADL呢？wadl 仅用于服务发现。这里的想法是拥有一个轻量级的抽象词汇，作为超媒体的基础。一个“根”词汇。就像在 owl 中一样，我们有 owl:thing...etc 现在如果客户端知道“libraryml” 标准它可以跟随链接到它理解的东西（在解析媒体类型属性和 xmlns 之后）。如果没有，那就不会了。

当我无法理解如何处理 REST 架构中的某些内容时，我倾向于了解我们人类如何在 Web 中进行处理。在 Web 中，我们拥有 HTML 的通用语言，它使站点构建者能够交付任何特定内容，而不管其对客户端（用户）的含义如何，浏览器理解 HTML，但不理解其内容的“含义”。理解（特定领域）内容的是用户。如果我去说 QuantumPhysics.org，我的浏览器可以呈现主页（毕竟它只是 html），我可以阅读主页。如果我了解量子，那么我可以继续浏览。如果我不这样做，我就出去（除非我想学习硬路:)）

• 在 RetsLibrary.com 示例中，客户端应用程序就像我 + 我的浏览器一样
• 在 QuantumPhysics.org 上。媒体类型“application/vnd.libraryml+xml”是量子物理学（知识）。
• http 在这两个示例中都是 http。
• 现在 QuantumPhysics.org 的 HTML 在 RestLibrary.com 是 XML + 那个小小的抽象词汇（根资源和链接，你可以用 Atom 之类的东西代替）。

那么这种方法有什么价值吗？难道我们不需要一个根微型超词汇表，这样我们就可以通过超媒体和“初始 URI”概念取得成功吗？

编辑 是啊，为什么不将 RDF 作为根词汇！

据我了解，我需要使用WADL来描述一个 RESTful Web 服务。尽管如此，我还是在相关帖子中阅读了很多答案，其中用户强烈反对使用 WADL。

WADL的缺点是什么？有没有替代的解决方案？

我正在对 REST API 进行建模，API 的一部分将表示资源，这些资源被组织成具有值和子节点的任意节点层次结构（有点像文件系统或 Windows 注册表）。

我很想创建一个 WADL 文件，以便为 API 生成 JAX-RS 样板，但我不确定如何在 WADL 中表示这种情况。

我可以只使用一个字符串作为模板参数，但我不确定如何检测到该字符串参数允许在其值中包含斜杠并正确生成 JAX-RS @Path 注释。

创建一个可重复的模板参数并期望这种功能是否合法？例如

HTTP GET http://my.service.com/registry/path/to/my/node

其中重复的模板参数是“路径”、“到”、“我的”、“节点”？

我正在尝试使用 wadl2java 命令行工具为我提供的 wadl 生成客户端存根，但出现 JClass name empty 错误。谁能帮我解决这个问题？我似乎找不到太多关于此的故障排除信息。

全栈跟踪是

线程“主”java.lang.IllegalArgumentException 中的异常：com.sun.codemodel.JDefinedClass.(JDefinedClass.java:194) 处 com.sun.codemodel.JDefinedClass.(JDefinedClass.java:154) 处的 JClass 名称为空。 sun.codemodel.JDefinedClass._class(JDefinedClass.java:631) 在 com.sun.codemodel.JDefinedClass._class(JDefinedClass.java:606) 在 org.jvnet.ws.wadl2java.ResourceClassGenerator.generateClass(ResourceClassGenerator.java:132)在 org.jvnet.ws.wadl2java.Wadl2Java.generateSubClass(Wadl2Java.java:406) 在 org.jvnet.ws.wadl2java.Wadl2Java.generateEndpointClass(Wadl2Java.java:384) 在 org.jvnet.ws.wadl2java.Wadl2Java.process (Wadl2Java.java:146) 在 org.jvnet.ws.wadl2java.Main.main(Main.java:120)

我的 pom 文件中有以下依赖项：-

jar文件存在于系统中，依赖可以解决。但是当代码运行时，它在 java.lang.ClassNotFoundException: org.jvnet.ws.wadl.util.DSDispatcher 上失败。DSDispatcher 存在于 jar 文件和正确的包中。谁能提出问题可能是什么？我尝试将 wadl-core pom 中的所有依赖项添加到我的 pom 中，但没有帮助，我尝试了依赖项的各种范围。

谢谢！

我已经构建了一个 RESTful Web 服务（我使用的是 asp.net 4、MVC 2）并且我想公开一个 WADL。是否有任何内置或其他工具可以用来构建它？我不打算（还）生成类来使用它我正在严格寻找可以生成 WADL 文件本身的东西。

谢谢。

我使用 WCF 通过 .svc 文件在 .NET 中创建了一个安静的 Web 服务。Web 应用程序自动生成一个 WSDL 文件。AFAIK，WADL 对于宁静的 Web 服务来说更自然。

如何在 .NET（最好使用 wcf）中创建一个生成 WADL 描述的宁静服务？

注意只要您指出合适的手册/教程，就可以接受像“RTFM”这样的答案。

我读过《Restful Web services》这本书。在那本书中，它描述了 WADL，其目的是描述 RESTful Web 应用程序。

那本书写于 2007 年，当时使用 WADL 的 Web 应用程序并不多。

我想知道这是否已经改变。有多少 Web 应用程序以及哪些流行的 Web 应用程序使用 WADL 来描述它的 RESTful API？

我正在构建一个 REST api 并讨论我应该使用什么格式来表示 xml。我知道它可以在内部定义，但格式也有很多。wadl 看起来很有趣，但似乎有关于它的争论，而且它也是新的。

有什么建议（最佳实践）？

我需要使用下面的 wadl 文件测试身份验证过程：

将此文件导入soapUI Pro后，单击“请求”没有任何操作。原因是soapUI Pro 没有看到xsd 中出现的元素“sis:user”，并且认为它只是一些具有未定义类型的单个元素。你能建议 wadl 文件有什么问题吗？

下面是使用的 sis.xsd 模式：

<?xml version="1.0" encoding="utf-8"?> <xs:schema id="SIS" targetNamespace="http://sis.thecompany.com/" elementFormDefault="qualified" xmlns="http://sis.thecompany.com/" xmlns:mstns="http://sis.thecompany.com/" xmlns:xs="http://www.w3.org/2001/XMLSchema" version="1.0"> <xs:element name="application"> <xs:complexType> <xs:all> <xs:element name="user" minOccurs="0"> <xs:xs:complexType> <xs:all minOccurs="1"> <xs:element name="login" type="xs:string" /> <xs:element name="password" type="xs:string" /> </xs:all> </xs:complexType> </xs:element> </xs:all> </xs:complexType> </xs:element> </xs:schema>

还有下一个问题。如果soapUI Pro 将正确解析来自xsd 的complexType 元素用户 - 来自soapUI Pro 的POST 数据将是下一个：

但是由于附加前缀“sis:”，这将被服务器拒绝。服务器只支持下一种格式

请指教。