Maven 用于构建 SOA 服务和客户端？

Question

我更改了标题以概括这个问题，该问题实际上并非特定于 Axis2。我最终完全放弃了 Axis2，转而使用 Metro/JAX-WS，但现在我正在认真考虑放弃两者并转而使用 OpenSAML。我在这里努力寻求答案的真正问题是，如何构建实际可用的复杂的、基于标准的 SOA 服务。

最初的措辞是：有人可以粘贴一个 Maven pom 的工作示例来调用 Axis2 java2wsdl 以及我可以接受的默认值吗？这是一个表现良好的命令行咒语。

  -o target/generated-sources/java2wsdl \
  -l "http://localhost:9763/services/PolicyService" \
  -tn urn:sesgg:sc:security:1.0.spec.PolicyService \
  -tp ps \
  -stn urn:oasis:names:tc:SAML:2.0:protocol \
  -stp samlp \
  -of PolicyService.wsdl \
  -sn PolicyService \
  -cp "../../Schema/target/Schema-1.0-SNAPSHOT.jar target/PolicyService-1.0-SNAPSHOT.jar" \
  -cn com.technica.pbac.ps.PolicyService \

我所做的一切最终都会得到非常奇怪的结果；例如奇怪的反向命名空间（例如http://xmldsig._09._2000.w3.org/xsd）。您能解释一下这是为什么以及如何阻止它吗？

似乎有很多 java2wsdl 期望完全不同的参数，命令行和 maven pom 之间几乎没有一致性。

Answer 1

没有回复，所以我将发布我自己的实验的当前结果来帮助其他人
类似的问题。在测试完成之前不能保证这是正确的，但至少现在我得到了可以在 Eclipse 中查看的结果：

<build>
    <plugins>
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-compiler-plugin</artifactId>
            <version>2.3.2</version>
            <configuration>
                <source>1.6</source>
                <target>1.6</target>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.jvnet.jaxb2.maven2</groupId>
            <artifactId>maven-jaxb2-plugin</artifactId>
            <version>0.7.5</version>
            <configuration>
                <schemaExcludes>
                    <exclude>*saml*.xsd</exclude>
                </schemaExcludes>
                <strict>true</strict>
                <extension>true</extension>
            </configuration>
            <executions>
                <execution>
                    <goals>
                        <goal>generate</goal>
                    </goals>
                </execution>
            </executions>
        </plugin>
        <plugin>
            <groupId>org.apache.axis2</groupId>
            <artifactId>axis2-java2wsdl-maven-plugin</artifactId>
            <version>1.5.4</version>
            <executions>
                <execution>
                    <goals>
                        <goal>java2wsdl</goal>
                    </goals>
                </execution>
            </executions>
            <configuration>
                <id>Generate WSDL based on PolicyService Interface</id>
                <serviceName>PolicyService</serviceName>
                <className>com.technica.pbac.ps.PolicyServiceImpl</className>
                <targetNamespace>http://sesgg/sc/security/1.0/spec/PolicyService</targetNamespace>
                <targetNamespacePrefix>sesgg</targetNamespacePrefix>
                <schemaTargetNamespace>http://sesgg/sc/security/1.0/spec/PolicyService</schemaTargetNamespace>
                <schemaTargetNamespacePrefix>sesgg</schemaTargetNamespacePrefix>
                <elementFormDefault>qualified</elementFormDefault>
                <extension>false</extension>
                <package2Namespace>
                    <property>
                        <name>urn:sesgg:sc:security:1.0:spec:PolicyService</name>
                        <value>http://sesgg/sc/security/1.0/spec/PolicyService</value>
                    </property>
                    <property>
                        <name>com.technica.pbac.ps</name>
                        <value>http://com.technica.pbac.ps</value>
                    </property>
                    <property>
                        <name>oasis.names.tc.saml._2_0.protocol.xsd</name>
                        <value>http://oasis/names/tc/saml/2.0/protocol</value>
                    </property>
                    <property>
                        <name>oasis.names.tc.saml._2_0.protocol</name>
                        <value>http://oasis/names/tc/saml/2.0/protocol</value>
                    </property>
                </package2Namespace>
                <episodes>
                    <episode>
                        <groupId>Technica-PBAC</groupId>
                        <artifactId>Schema-1.0-SNAPSHOT.jar</artifactId>
                    </episode>
                </episodes>
                <outputFileName>target/generated-sources/java2wsdl/PolicyService.wsdl</outputFileName>
                <filename>target/generated-sources/java2wsdl/services.xml</filename>
                <locationUri>http://localhost:9763/services/PolicyService</locationUri>
            </configuration>
        </plugin>
        <plugin>
            <groupId>org.apache.axis2</groupId>
            <artifactId>axis2-wsdl2code-maven-plugin</artifactId>
            <version>1.5.4</version>
            <executions>
                <execution>
                    <goals>
                        <goal>wsdl2code</goal>
                    </goals>
                    <configuration>
                        <wsdlFile>target/generated-sources/java2wsdl/PolicyService.wsdl</wsdlFile>
                        <packageName>com.technica.pbac.ps</packageName>
                        <outputDirectory>target/generated-sources/wsdl2java</outputDirectory>
                        <unwrap>true</unwrap>
                        <allPorts>true</allPorts>
                        <databindingName>adb</databindingName>
                        <generateServerSide>true</generateServerSide>
                        <generateAllClasses>true</generateAllClasses>
                        <generateServicesXml>true</generateServicesXml>
                        <generateTestcase>true</generateTestcase>
                        <overWrite>true</overWrite>
                        <serviceName>PolicyService</serviceName>
                        <syncMode>sync</syncMode>
                        <backwardCompatible>false</backwardCompatible>
                    </configuration>
                </execution>
            </executions>
        </plugin>
    </plugins>
    <pluginManagement>
        <plugins>
            <plugin>
                <groupId>org.apache.axis2</groupId>
                <artifactId>axis2-java2wsdl-maven-plugin</artifactId>
                <version>1.5.4</version>
            </plugin>
            <plugin>
                <groupId>org.apache.axis2</groupId>
                <artifactId>axis2-wsdl2code-maven-plugin</artifactId>
                <version>1.5.4</version>
            </plugin>
        </plugins>
    </pluginManagement>
</build>

一个警告：我真的怀疑它在单个阶段中运行 jaxb、java2wsdl、wsdl2java 和编译阶段的正确性pom。目前 java2wsdl 在 wsdl2java 之后运行，这显然是不正确的。这个 pom 是双重可疑的，因为 java2wsdl 需要一个已编译的 jar 才能运行，并且似乎正在使用之前运行留下的 jar。 mvn clean 后重新开始工作真是太痛苦了。我可能最终会将它分成几个 pom，并在这样做时调整这个答案。

Answer 2

我答应用一些近似“正确”的东西来扩展这个答案。这是迄今为止的进展，我仍然不能完全确定它是否 100% 正确。稍后会详细介绍。

这一切都基于 Oasis 发布的用于定义 XACML 和 SAML-P 的 XACML 标准的架构堆栈。 XSD 已被收集到 Commons-Schema 模块（未显示）中，经过调整以修复多个 Oasis 错误，并使用 JAX-B 编译为 Java 类。这些类是下述服务的基础。 schema.episode.path 和 schema.catalog.path 属性指向此模块中的文件。

我将每个服务（本例中为 PolicyService）拆分为两个 Maven 模块。 PolicyService-Svc 是服务，其 pom 如下所示：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxws-maven-plugin</artifactId>
  <executions>
    <execution>
      <id>Generate WSDL</id>
      <phase>generate-resources</phase>
      <goals>
        <goal>wsgen</goal>
      </goals>
      <configuration>
        <sei>com.technica.pbac.ps.PolicyService</sei>
        <genWsdl>true</genWsdl>
        <keep>true</keep>
        <verbose>true</verbose>
        <extension>true</extension>
        <catalog>${schema.catalog.path}</catalog>
        <xjcArg>-episode</xjcArg>
        <xjcArg>${schema.episode.path}</xjcArg>
        <xjcArg>-catalog</xjcArg>
        <xjcArg>${schema.catalog.path}</xjcArg>
      </configuration>
    </execution>
  </executions>
</plugin>

PolicyService-Proxy 是任何客户端或服务都可以用来调用该服务的通用代理代码（更多有关此问题的信息请参见下文）。它的 pom 看起来像这样：

<plugin>
  <groupId>org.codehaus.mojo</groupId>
  <artifactId>jaxws-maven-plugin</artifactId>
  <executions>
    <execution>
      <!-- <phase>generate-sources</phase> -->
      <goals>
        <goal>wsimport</goal>
      </goals>
      <configuration>
        <wsdlFiles>
          <wsdlFile>localhost_8080/PolicyService-Svc/PolicyService.wsdl</wsdlFile>
        </wsdlFiles>
        <wsdlLocation>http://localhost:8080/PolicyService-Svc/PolicyService?WSDL</wsdlLocation>
        <sourceDestDir>${project.build.directory}/generated-sources/jaxws</sourceDestDir>
        <genWsdl>true</genWsdl>
        <verbose>true</verbose>
        <extension>true</extension>
        <catalog>${schema.catalog.path}</catalog>
        <xjcArg>-episode</xjcArg>
        <xjcArg>${schema.episode.path}</xjcArg>
      </configuration>
    </execution>
  </executions>
</plugin>

现在是问题，我非常感谢您的建议。尽管 Commons-Schema 为所有模式提供了已编译的 java 类，但 wsgen 坚持使用新生成的 xsd 生成 wsdl，这些 xsd 在各种方面略有不同且略有不正确。

作为不正确和不同的一个示例，SAML 定义了一个与另一个模式中的相同名称冲突的扩展元素。所以我在基本 Commons-Schema 中修复了它，如下所示：

<element name="Extensions" type="samlp:ExtensionsType">
    <annotation>
        <appinfo>
        <jxb:class name="Extensions-SAML"/>
       </appinfo>
</annotation>
</element>

但是 wsgen/wsimport 忽略了此更正，因此冲突再次出现。令人愤怒并且对构建绝对致命。

另一个是省略必需的包含，因此 Eclipse 验证将它们报告为错误，直到手动更正。我的解决方法是定期将生成的 wsdl 和 xsd 从目标文件夹复制到 src/main/webapp/WEB-Inf/wsdl，手动修复它们，并调整 poms 以使用此文件夹而不是生成的内部目标。这适用于从非服务客户端调用服务。我将相同的 wsdls 和 xsd 复制到类似的客户端文件夹，并确保 pom 引用这些文件，而不是 jaxws 在该模块中生成的文件。

当任何服务需要通过其代理调用另一个服务时，就会出现我无法解决的问题。调用服务的代理 jar（其重要基础类的版本略有不同）现在与调用服务 jar（基于 Commons-Schema 的 JAXB 生成的类）混合在一起，这会导致无穷无尽的麻烦。

有人可以建议吗？谢谢！

Answer 3

这个问题的最终答案确实是放弃尝试修复损坏的模式和工具，转而使用 OpenSAML，它已经做到了这一点。这对于 XACML 2.0 编译器和基于它的 Web 服务来说效果很好。但 XACML 3.0 编译器的表现却很糟糕，因为 OpenSAML 不支持 XACML 3.0 并且没有计划这样做，所以我必须自己处理这个问题。但凭借 XACML 2.0 的经验，我最终让两者都工作起来。这个项目比原本要痛苦得多，而“强大”的工具只会让事情变得更加困难。