java - jax-ws ri 2.2.1 没有为 amazon ecs wsdl 文件生成枚举

Question

我正在尝试为以下亚马逊 wsdl 生成工件:
http://webservices.amazon.com/AWSECommerceService/AWSECommerceService.wsdl

使用以下 Ant 任务:

<taskdef name="wsimport" classname="com.sun.tools.ws.ant.WsImport">
    <classpath>
        <pathelement location="${BUILD_LIBS}/jaxws-ri/lib/jaxws-tools.jar"/>
    </classpath>
</taskdef>

<target name="wsimport" depends="init">
    <delete dir="${generated.src}" />
    <mkdir dir="${generated.src}"/>
    <wsimport
        debug="true"
    keep="true"
    verbose="true"
    destdir="${generated.src}"
    package="com.amazon.webservices.ecs"
    wsdl="wsdl/AWSECommerceService.wsdl"/>
</target>

但没有为以下元素生成 java 工件，如下所示:

<xs:element name="Condition">
    <xs:simpleType>
        <xs:restriction base="xs:string">
            <xs:enumeration value="All"/>
            <xs:enumeration value="New"/>
            <xs:enumeration value="Used"/>
            <xs:enumeration value="Collectible"/>
            <xs:enumeration value="Refurbished"/>
       </xs:restriction>
   </xs:simpleType>
</xs:element>

即使生成所有其他元素，基本上也不会生成枚举。有没有人见过这个问题？我正在使用 jax-ws ri 2.2.1 http://jax-ws.java.net/2.2.1/
谢谢

Answer 1

如 Puspendu 所引用，绑定(bind)的 JAXB 客户端定制完全/非常接近您的需要——您需要为您的示例使用 JAX-WS 客户端定制。 JAXB 和 JAX-WS 定制本质上允许您为您不控制的 WSDL/模式增加模式元素的定义。您可以完成许多不同的事情，例如将 xml 元素名称映射到自定义 java 元素、更改生成的 API 以及回答您的问题、为受枚举限制的元素生成类型安全的枚举类。

有两种方法/部分可以为 JAX-WS 进行客户端定制。

1) 如果 WSDL 导入外部模式文件 2) 如果 WSDL 包含没有任何导入的整个模式定义

如果 wsdl 导入了一个外部模式文件，

基本上，您需要创建一个新文件(通常带有 jxb 扩展名，但这并不重要)，您将与要为其生成客户端 stub /api 的 wsdl 一起维护该文件。通常我将这些文件命名为 schema-file-name_clientcustomization.jxb

每次您获得更新的 wsdl 时，您应该验证您的 JXB 文件对于该 wsdl 仍然有效。我发现要寻找的最重要的东西，尤其是枚举限制，是限制值更改、 namespace 更改、类型名称更改等。

这个新文件的内容看起来类似于:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<jxb:bindings 
  xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
  xmlns:jxb="http://java.sun.com/xml/ns/jaxb"     
  targetNamespace="http://java.sun.com/xml/ns/jaxb" 
   version="1.0">

    <jxb:bindings schemaLocation="NameOfYourSchemaFile.xsd" 
         node="/xsd:schema[@targetNamespace='SCHEMANAMESPACE']">
        <jxb:schemaBindings>
            <jxb:package name="com.amazon.webservices.ecs" />
        </jxb:schemaBindings>

        <jxb:bindings node="xsd:element[@name='Condition']/xsd:simpleType">
            <jxb:typesafeEnumClass name="ConditionEnum" >
                <jxb:typesafeEnumMember value="All" name="ALL" />
                <jxb:typesafeEnumMember value="New" name="NEW" />
                <jxb:typesafeEnumMember value="Used" name="USED" />
                <jxb:typesafeEnumMember value="Collectible" name="COLLECTIBLE" />
                <jxb:typesafeEnumMember value="Refurbished" name="REFURBISHED" />
            </jxb:typesafeEnumClass>
        </jxb:bindings>
         </jxb:bindings>
</jxb:bindings>

本质上，该文件定义了应该对引用的 xsd 文件进行的扩充。此文件中的所有绑定(bind)元素都有一个节点属性，它是一个 XPATH 表达式，用于选择要扩充的模式项。在示例中，我没有任何 namespace 或其他信息，因此我指定 XPATH 以仅选择元素的简单类型声明。在该绑定(bind)中，我们定义了 typesafeenumclass，这会导致 jaxb/wsimport 生成一个枚举类来表示引用的简单类型。因为它是一个匿名的简单类型，所以这有效地为引用的元素定义了一个类。生成的类将是一个 ENUM，其成员由 typesafeEnumMember 元素的“name”属性定义。

要使用这个 JXB 文件，您需要在您的 ant 任务中引用它，如下所示:

<wsimport
        debug="true"
    keep="true"
    verbose="true"
    destdir="${generated.src}"
    package="com.amazon.webservices.ecs"
    wsdl="wsdl/AWSECommerceService.wsdl">

    <binding dir="wsdl" includes="*.jxb"/>

</wsimport>

如果 WSDL 在内部定义了整个模式，那么您需要使用 JAX-WS 自定义文件。这种情况与您的问题相符。

http://jax-ws.java.net/nonav/2.1.7/docs/customizations.html

JAX-WS 客户端定制与 JAXB 定制非常相似。这个想法是相同的，在大多数情况下，定制文件的 JAX-WS 部分将改变生成的与 WSDL 特别相关的工件，而嵌入式 JAXB 定制执行与外部定制文件相同的功能:它改 rebase 于在架构上。

最大的不同在于，您无需告诉 JAXB 解析器架构文件的位置，而是提供一个绑定(bind)部分来选择您要对其应用自定义的架构定义(使用 XPATH)。

这个例子我实际测试和验证为你问的元素生成一个 Enum 类，所以你可以逐字复制这个 JAX-WS 定制例子。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<jaxws:bindings
        wsdlLocation="AWSECommerceService.wsdl" 
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
    xmlns:jaxws="http://java.sun.com/xml/ns/jaxws"
    xmlns:jaxb="http://java.sun.com/xml/ns/jaxb"
    >

    <jaxws:bindings node="wsdl:definitions/wsdl:types/xsd:schema[@targetNamespace='http://webservices.amazon.com/AWSECommerceService/2010-11-01']">
        <jaxb:schemaBindings>
            <jaxb:package name="com.amazon.webservices.ecs"/>
        </jaxb:schemaBindings>


        <jaxb:bindings node="xsd:element[@name='Condition']/xsd:simpleType">
            <jaxb:typesafeEnumClass name="ConditionEnum" >
                <jaxb:typesafeEnumMember value="All" name="ALL" />
                <jaxb:typesafeEnumMember value="New" name="NEW" />
                <jaxb:typesafeEnumMember value="Used" name="USED" />
                <jaxb:typesafeEnumMember value="Collectible" name="COLLECTIBLE" />
                <jaxb:typesafeEnumMember value="Refurbished" name="REFURBISHED" />
            </jaxb:typesafeEnumClass>
        </jaxb:bindings>

    </jaxws:bindings>

</jaxws:bindings>

然后您可以像引用 JXB 文件一样引用此 JAX-WS 自定义文件。

我没有验证独立的 JAXB 自定义示例，因为我实际上只是将其作为示例和 JAX-WS 自定义示例的前身解释包含在内。

我所做的 JAX-WS 自定义示例实际上是针对您链接的 WSDL 进行测试/验证的，因此您应该能够将其用作起点。我注意到在定义的 WSDL 中有许多枚举限制，所以我假设您会想要为大多数/所有限制生成枚举。

希望对您有所帮助。