WADL2JAVA 命令
wadl2java 命令行工具用于处理现有 Web 应用程序描述语言 (WADL) 文件,并生成开发 Java™ API for RESTful Web Services (JAX-RS) Web Service 应用程序所必需的工件。wadl2java 命令行工具支持使用自顶向下的方法开发 JAX-RS Web Service。从现有 WADL 文件开始时,请使用 wadl2java 命令行工具生成所需 JAX-RS 工件。
Web 应用程序描述语言 (WADL)
WADL 是一种以资源为中心的描述语言,它旨在促进完成 RESTful Web 应用程序的建模、描述和测试。有关更多信息,请参阅 Web 应用程序描述语言。语法
命令语法如下所示:
wadl2java --[options]
wadl2java -wadlns wadl-namespace -p package-name -sp [schema-namespace =]package-name -tMap schema-type=java-type * -repMap media-type=class-name * -resource resource-name -b binding-file-name * -catalog catalog-file-name -d output-directory -interface -impl -async methodNames * -generateEnums -inheritResourceParams -noTypes -noVoidForEmptyResponses -noAddressBinding -supportMultipleXmlReps -generateResponseIfHeadersSet -generateResponseForMethods methodNames * -async methodNames * -xjc xjc-argumentsv * -encoding encoding -h|-?|-help -version|-v -verbose|-V -quiet|-q|-Q wadl
参数
下列 options 值可用于 wadl2java 命令:
- -wadlns wadl-namespace
- 指定 WADL 名称空间。
- -p package-name
- 指定要用于所生成的表示 WADL 资源元素的代码的 Java 包名称。
- -sp [schema-namespace =]package-name
- 指定要用于所生成的表示 WADL 语法元素的代码的 Java 包名称。可以选择指定名称空间到 Java 包名称的映射。
- -tMap schema-type=java-type *
- 指定 WADL 参数或表示模式类型与定制 Java 类型之间的可选映射。
- -repMap media-type=class-name *
- 指定不具有 wadl:element 属性的 WADL 表示与 Java 类之间的可选映射。
- -resource resource-name
- 指定要用于所生成的代码的简单类名,该代码表示不具有 id 属性的 WADL 资源。
- -b binding-file-name *
- 指定外部 jaxb 绑定文件。对于每个绑定文件,请使用一个 -b 标志。
- -catalog catalog-file-name
- 指定用于映射导入的 wadl 或模式的目录文件。
- -d output-directory
- 指定代码将放入的目录。
- -interface
- 指定将生成接口。
- -impl
- 指定将生成虚拟服务实现。
- -async methodNames *
- 指定需要支持暂挂异步调用的方法名称或标识的逗号分隔列表。
- -generateEnums
- 指定可以生成枚举类来表示具有多个选项的参数。
- -inheritResourceParams
- 指定资源级(路径或矩阵)参数可以由子资源继承。
- -noTypes
- 关闭生成类型
- -noVoidForEmptyResponses
- 对不具有响应表示的方法使用“JAX-RS 响应”返回类型。
- -noAddressBinding
- 指定生成器可以不使用地址 jaxb 绑定文件将 wsa:EndpointReferenceType 或 wsa:EndpointReference 映射到 javax.xml.ws.wsaddressing.W3CEndpointReference。
- -supportMultipleXmlReps
- 指定当一种方法包含多个请求 XML 表示时,将针对每种表示生成单独的方法。在生成了服务器端 JAX-RS 代码的情况下,请勿启用此选项。对于这种情况,缺省情况下,将生成一种包含 javax.xml.transform 源输入参数的方法。
- -generateResponseIfHeadersSet
- 如果“WADL 响应”元素具有“header”参数,请使用“JAX-RS 响应”返回类型。
- -generateResponseForMethods methodNames *
- 指定需要生成“JAXRS 响应”返回类型的方法名称或标识的逗号分隔列表。
- -async methodNames *
- 指定需要支持暂挂异步调用的方法名称或标识的逗号分隔列表。
- -xjc xjc-argumentsv *
- 指定使用 JAXB 数据绑定时直接传递到 XJC 的自变量的逗号分隔列表。此选项将使得 XJC 装入额外的扩充代码生成的插件。例如,要装入用于将 toString() 方法添加到所有已生成类型的 toString(ts) 插件,可以使用以下自变量:-xjc-Xts。通过使用 -xjc-X 可以获取可用 XJC 插件的列表。
- -encoding encoding
- 指定生成 Java 源代码时要使用的字符集编码。
- -h|-?|-help
- 显示选项的详细信息。
- -version|-v
- 显示工具的版本。
- -verbose|-V
- 指定生成器以详细方式运行。
- -quiet|-q|-Q
- -quiet|-q|-Q
- wadl
- wadl-url