logo标签列表

jax-ws ri 2.2.1无法为Amazon ECS WSDL文件生成枚举类型

javaweb-servicesantwsdlwsimport
7
我正在尝试为以下Amazon 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/
谢谢

2个回答
5
正如Puspendu所提到的，JAXB客户端自定义绑定与您需要的非常接近 -- 您需要为示例使用JAX-WS客户端自定义。JAXB和JAX-WS自定义基本上允许您增强对您不控制的WSDL / schema的模式元素的定义。您可以完成许多不同的事情，例如将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元素的“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定制执行与外部定制文件相同的功能：根据模式修改生成的对象。最大的区别在于，您不需要告诉JAXB解析器模式文件的位置，而是提供一个绑定部分，该部分使用XPATH选择要应用定制的模式定义。我实际测试并验证了此示例，以生成您正在询问的元素的枚举类，因此您可以逐字复制此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自定义示例的前导说明和示例包含在内。

实际上，我对JAX-WS自定义示例进行了测试/验证，并针对您链接的WSDL使用它作为起点。我注意到在定义的WSDL中有许多枚举限制，因此我认为您可能希望为大多数/全部限制生成枚举。

希望这可以帮助您。

1
如果Helter所描述的方法让你感到难以理解，只需在简单类型节点中添加一个“name”属性，对应于xs:enumeration。 - Puspendu Banerjee
1
如果您不拥有WSDL，则编辑它以满足您的需求并不是一个非常可扩展的选项。每次获取新版本的WSDL时，您都必须重新进行编辑。这正是客户端定制构建的情况。如果您没有编辑和重新编辑WSDL的问题，您可以将Condition元素的匿名内部类型重构为适当命名的简单类型，它将生成一个枚举类，但是随着Amazon WSDL中定义的枚举数量增加，这样做并不实际。 - Helter Scelter
@Helter 如果你得到了一个新版本的WSDL，你需要检查/修改JAXB/JAX-WS绑定。举个例子，如果他们提供了一个只有一个ConditionType的新wsdl，你需要找出并映射它。我不是说绑定是无用的，而是我的观点是如果有更简单的方法，我们应该首先遵循它。 - Puspendu Banerjee
这是正确的。当wsdl中的内容更新时，您需要更新绑定自定义。然而，在亚马逊wsdl中定义了大量匿名枚举。将所有这些匿名类型转换为命名类型将是太多的工作。特别是如果您必须每次获取wsdl时都要重复此操作。您必须知道如何重新构建wsdl，然后找出新的wsdl与旧的wsdl之间的差异。绑定文件可以简单地与新的wsdl进行比较并进行更新。这是很多样板文件，但我认为它提供了最好的长期选择。 - Helter Scelter
1
@Helter，你的解决方案已经足够好了，我很感激你写样例的努力，所以我会点赞的 :) - Puspendu Banerjee
显示剩余2条评论
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接