44.2. cxf-codegen-plugin

以下 POM 提取显示了如何配置 Maven cxf-codegen-plugin 来处理 myService.wsdl WSDL 文件的简单示例：

<plugin>
  <groupId>org.apache.cxf</groupId>
  <artifactId>cxf-codegen-plugin</artifactId>
  <version>3.3.6.fuse-7_11_1-00015-redhat-00002</version>
  <executions>
    <execution>
      <id>generate-sources</id>
      <phase>generate-sources</phase>
      <configuration>
        <sourceRoot>target/generated/src/main/java</sourceRoot>
        <wsdlOptions>
          <wsdlOption>
            <wsdl>src/main/resources/wsdl/myService.wsdl</wsdl>
          </wsdlOption>
        </wsdlOptions>
      </configuration>
      <goals>
        <goal>wsdl2java</goal>
      </goals>
    </execution>
  </executions>
</plugin>

在前面的示例中，您可以自定义以下配置设置

wsdl2java 任务采用 WSDL 文档，并从中生成经过完整注解的 Java 代码以实施服务。WSDL 文档必须具有有效的 portType 元素，但不需要包含 绑定 元素 或服务 元素。使用可选参数，您可以自定义生成的代码。

配置插件需要至少一个 wsdlOptions 元素。wsdlOptions 元素的 wsdl child 是必需的，并指定了由插件处理的 WSDL 文档。除了 wsdl 元素外，wsdlOptions 元素也可取多个可自定义 WSDL 文档的处理方式的子项。

插件配置中可以列出多个 wsdlOptions 元素。每一元素配置单个 WSDL 文档以用于处理。

defaultOptions 元素是一个可选元素。它可用于设置所有指定的 WSDL 文档中使用的选项。

要指定通用代码生成选项（与 Apache CXF wsdl2java 命令行工具支持的交换机），您可以添加 extraargs 元素作为 wsdlOption 元素的子项。例如，您可以添加 -impl 选项和 -verbose 选项，如下所示：

...
<configuration>
  <sourceRoot>target/generated/src/main/java</sourceRoot>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
      <!-- you can set the options of wsdl2java command by using the <extraargs> -->
      <extraargs>
        <extraarg>-impl</extraarg>
        <extraarg>-verbose</extraarg>
      </extraargs>
    </wsdlOption>
  </wsdlOptions>
</configuration>
...

如果交换机使用参数，您可以使用后续 extraarg 元素来指定这些参数。例如，要指定 jibx 数据绑定，您可以配置插件，如下所示：

...
<configuration>
  <sourceRoot>target/generated/src/main/java</sourceRoot>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
      <extraargs>
        <extraarg>-databinding</extraarg>
        <extraarg>jibx</extraarg>
      </extraargs>
    </wsdlOption>
  </wsdlOptions>
</configuration>
...

要指定一个或多个 JAX-WS 绑定文件的位置，您可以添加 bindingFiles 元素作为 wsdlOption的子项，例如：

...
<configuration>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
      <bindingFiles>
        <bindingFile>${basedir}/src/main/resources/wsdl/async_binding.xml</bindingFile>
      </bindingFiles>
    </wsdlOption>
  </wsdlOptions>
</configuration>
...

要指定生成代码的 WSDL 服务的名称，您可以将 serviceName 元素添加为 wsdlOption 的子项（默认值是，在 WSDL 文档中为每个服务生成代码：

...
<configuration>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
      <serviceName>MyWSDLService</serviceName>
    </wsdlOption>
  </wsdlOptions>
</configuration>
...

要为多个 WSDL 文件生成代码，只需为 WSDL 文件插入额外的 wsdlOption 元素。如果要指定适用于所有 WSDL 文件的一些常用选项，请将 common 选项放在 defaultOptions 元素中，如下所示：

<configuration>
  <defaultOptions>
      <bindingFiles>
          <bindingFile>${basedir}/src/main/jaxb/bindings.xml</bindingFile>
      </bindingFiles>
      <noAddressBinding>true</noAddressBinding>
  </defaultOptions>
  <wsdlOptions>
      <wsdlOption>
          <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
          <serviceName>MyWSDLService</serviceName>
      </wsdlOption>
      <wsdlOption>
          <wsdl>${basedir}/src/main/resources/wsdl/myOtherService.wsdl</wsdl>
          <serviceName>MyOtherWSDLService</serviceName>
      </wsdlOption>
  </wsdlOptions>
</configuration>

也可以使用通配符匹配指定多个 WSDL 文件。在这种情况下，使用 wsdlRoot 元素指定包含 WSDL 文件的目录，然后使用 include 元素选择所需的 WSDL 文件，它支持使用 * 字符进行通配符。例如，要从 src/main/resources/wsdl root 目录中选择以 Service.wsdl 结尾的所有 WSDL 文件，您可以配置插件，如下所示：

<configuration>
  <defaultOptions>
      <bindingFiles>
          <bindingFile>${basedir}/src/main/jaxb/bindings.xml</bindingFile>
      </bindingFiles>
      <noAddressBinding>true</noAddressBinding>
  </defaultOptions>
  <wsdlRoot>${basedir}/src/main/resources/wsdl</wsdlRoot>
  <includes>
      <include>*Service.wsdl</include>
  </includes>
</configuration>

要直接从 Maven 存储库下载 WSDL 文件，请添加 wsdlArtifact 元素作为 wsdlOption 元素的子项，并指定 Maven 工件的协调，如下所示：

...
<configuration>
  <wsdlOptions>
    <wsdlOption>
      <wsdlArtifact>
        <groupId>org.apache.pizza</groupId>
        <artifactId>PizzaService</artifactId>
        <version>1.0.0</version>
      </wsdlArtifact>
    </wsdlOption>
  </wsdlOptions>
</configuration>
...

（需要 JAXB 2.2） 来指定用于生成的 Java 文件的字符编码(Charset)，添加 编码 元素作为 配置元素 的子级，如下所示：

...
<configuration>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
    </wsdlOption>
  </wsdlOptions>
  <encoding>UTF-8</encoding>
</configuration>
...

您可以通过添加 fork 元素作为配置元素的子项，将 codegen 插件配置为生成代码的单独 JVM。fork 元素可设置为以下值之一：

如果 codegen 插件配置为对一个独立的 JVM（即 fork 选项被设置为非错误值）进行分叉，您可以通过 additionalJvmArgs 元素为 fork 的 JVM 指定额外的 JVM 参数。例如，以下片段将 codegen 插件配置为 fork 一个 JVM，它限制为只从本地文件系统访问 XML 模式（通过设置 javax.xml.accessExternalSchema 系统属性）：

...
<configuration>
  <wsdlOptions>
    <wsdlOption>
      <wsdl>${basedir}/src/main/resources/wsdl/myService.wsdl</wsdl>
    </wsdlOption>
  </wsdlOptions>
  <fork>once</fork>
  <additionalJvmArgs>-Djavax.xml.accessExternalSchema=jar:file,file</additionalJvmArgs>
</configuration>
...

下表描述了用于管理代码生成过程的选项。