使用 CXF 和 wsdl2java 生成代码时解决冲突

Question

在使用 wsdl2java 通过 cxf-codegen-plugin 和 Maven 从一堆 WSDL 文件生成代码期间，我遇到了一些冲突。 WSDL 声明了同一系统的不同 API，并且生成的代码有一些重叠（尤其是模型类）。外部系统和 WSDL 来自第三方，因此不受我们控制。

我遇到的第一个问题是由其中一个 WSDL 引起的 ObjectFactory 类中的一个命名冲突。它定义了一个名为 Foo 的 complexType，其中包含一个名为 Status 的元素，它还定义了一个名为 FooStatus 的元素。在生成代码时，JAXB 会抛出一个合适的结果，因为 ObjectFactory 将有两个名称为 createFooStatus(...) 的工厂方法，并且我在运行时最终会遇到异常。我尝试向 wsdl2java 提供选项 -autoNameResolution 无济于事。我查看了"Two declarations cause a collision in the ObjectFactory class" 和"Applying external JAXB binding file to schema elements imported from WSDL"，并基于它们编写了一个外部绑定文件，该文件重命名了其中一个工厂方法。如后面的链接所示，我在绑定文件中使用 SCD 而不是 XPath，因为我在 XPath 上遇到了与作者相同的问题。这可行，但前提是我单独处理 WSDL 文件并将绑定文件仅应用于导致冲突的 WSDL。 Maven 配置如下所示：

<plugin>
  <groupId>org.apache.cxf</groupId>
  <artifactId>cxf-codegen-plugin</artifactId>
  <version>3.0.0-milestone1</version>
  <executions>
    <execution>
      <id>generate-proxies</id>
      <phase>generate-sources</phase>
      <configuration>
        <wsdlOptions>
          <wsdlOption>
            <wsdl>${basedir}/First.wsdl</wsdl>
            <bindingFiles>
              <bindingFile>${basedir}/bindings.xml</bindingFile>
            </bindingFiles>
          </wsdlOption>
          <wsdlOption>
            <wsdl>${basedir}/Second.wsdl</wsdl>
          </wsdlOption>
          <wsdlOption>
            <wsdl>${basedir}/Third.wsdl</wsdl>
          </wsdlOption>
          ... More wsdlOption declarations ...
        </wsdlOptions>
      </configuration>
      <goals>
        <goal>wsdl2java</goal>
      </goals>
    </execution>
  </executions>
</plugin>

现在，如果我这样做，我会遇到另一个问题，因为从不同 WSDL 文件生成的代码使用相同的包结构。这在实践中意味着ObjectFactory 类在处理后续的 WSDL 文件时会被覆盖，这意味着在插件执行后只有从最后一个 WSDL 生成的那个将存在。我知道我可以更改目标包结构，但是从不同 WSDL 生成的代码有很多重叠，复制它会感觉很愚蠢。我也尝试过使用-keepwsdl2java 选项，但这似乎没有任何作用（或者至少ObjectFactory 类仍然被覆盖）。我的理解是，解决方案是使用这样的 Maven 配置一次性处理所有 WSDL（仅显示配置部分，其他所有内容保持不变）：

<configuration>
  <defaultOptions>
    <bindingFiles>
      <bindingFile>${basedir}/bindings.xml</bindingFile>
    </bindingFiles>
  </defaultOptions>
  <wsdlRoot>${basedir}</wsdlRoot>
  <includes>
    <include>*.wsdl</include>
  </includes>
</configuration>

但是，这会导致 com.sun.istack.SAXParseException2，表示我的 SCD 表达式不匹配任何架构组件（因为架构组件仅存在于一个 WSDL 中）。

如果我修改 WSDL 文件本身并使用后面的 Maven 配置而不使用绑定文件，我可以获得我想要的结果。通过这样做，生成的ObjectFactory 是在使用第一个 Maven 配置单独处理 WSDL 时创建的合并。但是，我宁愿不这样做，而是想使用外部绑定文件来管理它。我应该如何解决这个问题？如果找不到匹配的架构组件，我可以编写/应用绑定文件以便不引发异常吗？或者我可以单独处理 WSDL 而不覆盖 ObjectFactory 类吗？还是我只需要吸收它，或者从不同的 WSDL 生成代码到不同的包，或者自己编辑 WSDL 文件？以防万一，我当前的绑定文件如下所示（WSDL 位于我的项目中，与绑定文件位于同一目录中）：

<bindings scd="x-schema::tns" xmlns:tns="NamespaceOfFoo" xmlns="http://java.sun.com/xml/ns/jaxb" version="2.1">
  <bindings scd="tns:FooStatus">
    <factoryMethod name="FooStatusType"/>
  </bindings>
</bindings>

Answer 1

经过更多的谷歌搜索和阅读论坛帖子后，我最终自己解决了这个问题。我设法使用 XPath（而不是 SCD）以仅针对我感兴趣的节点的方式编写外部绑定文件，而在处理其他 WSDL 文件时不会出错。最初阻止我使用 XPath 定位 WSDL 中的节点的主要混淆来源是 JAXB 和 JAXWS 命名空间的类似 XML 模式（两者都定义元素“绑定”，我在这里看到的大多数教程都使用 JAXB 版本我必须使用 JAXWS 版本）。生成的绑定文件如下所示：

<jaxws:bindings xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
                xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
                xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
                wsdlLocation="First.wsdl"
                version="2.1">
  <jaxws:bindings node="wsdl:definitions/wsdl:types/xsd:schema/xsd:element[@name='FooStatus']">
    <jaxb:factoryMethod name="FooStatusType"/>
  </jaxws:bindings>
</jaxws:bindings>