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

Question

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

我遇到的第一个问题是由其中一个 WSDL 引起的其中一个生成的 ObjectFactory 类中的命名冲突。它定义了一个名为 Foo 的复杂类型，其中包含一个名为 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" ，并基于这些我编写了一个重命名其中一个工厂方法的外部绑定(bind)文件。如后一个链接所示，我在绑定(bind)文件中使用 SCD 而不是 XPath，因为我和作者在 XPath 方面遇到了同样的问题。这有效，但前提是我单独处理 WSDL 文件并将绑定(bind)文件仅应用于导致冲突的 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 生成的代码有很多重叠，复制它会让人觉得很愚蠢。我也尝试过使用 -keep wsdl2java 选项，但这似乎没有任何作用(或者至少 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 文件本身并使用没有绑定(bind)文件的后者 Maven 配置，我可以获得我想要的结果。通过这样做，生成的 ObjectFactory 是与使用第一个 Maven 配置单独处理 WSDL 时创建的对象的合并。但是，我宁愿不这样做，而是想使用外部绑定(bind)文件来管理它。我应该如何解决这个问题？我可以编写/应用绑定(bind)文件，以便在找不到匹配的架构组件时不会引发异常吗？或者我可以单独处理 WSDL 而不覆盖 ObjectFactory 类吗？还是我只需要吸收它并从不同的 WSDL 生成代码到不同的包或自己编辑 WSDL 文件？以防万一，我当前的绑定(bind)文件如下所示(WSDL 位于我的项目中，与绑定(bind)文件位于同一目录中):

<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)以一种只针对我感兴趣的节点的方式编写外部绑定(bind)文件，而不会在处理其他 WSDL 文件时给出错误。最初阻止我使用 XPath 将 WSDL 中的节点作为目标的主要混淆来源是 JAXB 和 JAXWS namespace 的相似 XML 模式(两者都定义了元素“绑定(bind)”，而我在这里看到的大多数教程都使用了 JAXB 版本我不得不使用 JAXWS 版本)。生成的绑定(bind)文件如下所示:

<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>