44.3. java2ws

摘要

从 Java 代码生成 WSDL 文档

synopsis

<plugin>
  <groupId>org.apache.cxf</groupId>
  <artifactId>cxf-java2ws-plugin</artifactId>
  <version>version</version>
  <executions>
    <execution>
      <id>process-classes</id>
      <phase>process-classes</phase>
      <configuration>
        <className>className</className>
        <option>...</option>
         ...
      </configuration>
      <goals>
        <goal>java2ws</goal>
      </goals>
    </execution>
  </executions>
</plugin>

描述

java2ws 任务采用服务端点实施(SEI)，并生成用于实施 Web 服务的支持文件。它可生成以下内容：

  • WSDL 文档
  • 将服务部署为 POJO 所需的服务器代码
  • 用于访问该服务的客户端代码
  • 打包程序和故障 bean

所需的配置

该插件要求 className 配置元素存在。元素的值是要处理的 SEI 的完全限定名称。

可选配置

下表中列出的配置元素可用于微调 WSDL 生成。

element描述

frontend

指定用于处理 SEI 的前端并生成支持类。jaxws 是默认值。也支持 简单。

databinding

指定用于处理 SEI 并生成支持类的数据绑定。使用 JAX-WS 前端时的默认设置是 jaxb。使用简单前端时的默认设置是 aegis。

genWsdl

指示 工具在设置为 true 时生成 WSDL 文档。

genWrapperbean

当设置为 true 时，指示 工具生成 wrapper bean 和 fault Bean。

genClient

指示 工具在设置为 true 时生成客户端代码。

genServer

指示 工具在设置为 true 时生成服务器代码。

outputFile

指定生成的 WSDL 文件的名称。

classpath

指定处理 SEI 时的 classpath 搜索。

soap12

指定在设置为 true 时生成的 WSDL 文档包含 SOAP 1.2 绑定。

targetNamespace

指定要在生成的 WSDL 文件中使用的目标命名空间。

serviceName

指定生成的 service 元素的 name 属性的值。