【问题标题】:No enums generated by jax-ws ri 2.2.1 for amazon ecs wsdl filejax-ws ri 2.2.1 没有为亚马逊 ecs wsdl 文件生成枚举
【发布时间】:2011-05-13 05:08:05
【问题描述】:

我正在尝试为以下亚马逊 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/
谢谢

【问题讨论】:

    标签: java web-services ant wsdl wsimport


    【解决方案1】:

    在 JAXB 绑定中使用 typesafeEnumMember

    参考:http://download.oracle.com/docs/cd/E17802_01/webservices/webservices/docs/1.5/tutorial/doc/JAXBUsing4.html#wp148439

    或者

    类似的东西[添加 name="ConditionType" ]:

    <xs:simpleType name="ConditionType">
                <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>
    

    【讨论】:

    • 您好,感谢您的回答。你能详细说明一下吗?我不控制它来自亚马逊的 wsdl 文件。
    • @leftbrainlogic 如果 Helter 描述的方式看起来很难遵循,只需将“名称”属性添加到对应 xs:enumeration 的 simpleType 节点
    • 如果您不拥有 WSDL,那么编辑它以满足您的需要并不是一个非常可扩展的选项。每次获得新版本的 wsdl 时,您都必须重新进行编辑。这正是构建客户端自定义的情况。如果您在编辑和重新编辑 wsdl 时没有问题,您可以将 Condition 元素的匿名内部类型重构为适当命名的简单类型,并且它将生成一个枚举类,但这并不实际每次都这样做您将获得一个新的 WSDL,尤其是在 amazon wsdl 中定义的枚举数量。
    • @Helter 如果您获得了新版本的 WSDL,您还需要检查/修改 JAXB/JAX-WS 绑定。举个例子,如果他们提供了一个新的 wsdlonly 并添加了一个 ConditionType,您需要找出并映射它。我并不是说绑定没有用,而是我的观点是,如果有更简单的方法,我们应该先遵循它。
    • @Helter 您的解决方案已经足够好了,感谢您为编写示例所做的努力,所以.. 赞成 :)
    【解决方案2】:

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

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

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

    如果 wsdl 导入外部模式文件,则

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

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

    这个新文件的内容将类似于以下内容:

    <?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 文件进行的扩充。此文件中的所有绑定元素都有一个节点属性,该属性是一个 XPATH 表达式,用于选择您要扩充的模式项。在示例中,我没有任何命名空间或其他信息,因此我指定 XPATH 以仅选择元素的简单类型声明。在该绑定中,我们定义了 typesafeenumclass,这会导致 jaxb/wsimport 生成一个枚举类来表示引用的简单类型。因为它是一个匿名的简单类型,所以这有效地为引用的元素定义了一个类。生成的类将是一个 ENUM,其成员由 typesafeEnumMember 元素的“名称”属性定义。

    要使用这个 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 定制执行与外部定制文件相同的功能:它改变基于生成的对象在架构上。

    最大的区别在于,您提供了一个绑定部分来选择要应用自定义的架构定义(使用 XPATH),而不是告诉 JAXB 解析器架构文件在哪里。

    我实际测试并验证了这个示例,以便为您提出问题的元素生成一个 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>
    

    然后您将引用此 JAX-WS 自定义文件,就像引用 JXB 文件一样。

    我没有验证独立的 JAXB 自定义示例,因为我实际上只是将它作为示例和作为 JAX-WS 自定义示例的前导说明。

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

    我希望这会有所帮助。

    【讨论】:

      猜你喜欢
      • 1970-01-01
      • 1970-01-01
      • 2016-03-05
      • 2013-08-26
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      • 1970-01-01
      相关资源
      最近更新 更多