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