正如 Puspendu 所引用的,绑定的 JAXB 客户端自定义完全/非常接近您所需要的 —— 您需要为您的示例使用 JAX-WS 客户端自定义。 JAXB 和 JAX-WS 定制本质上允许您增强您无法控制的 WSDL/模式的模式元素的定义。您可以完成许多不同的事情,例如将 xml 元素名称映射到自定义 java 元素、更改生成的 API、回答您的问题、为受枚举限制的元素生成类型安全的枚举类。
有两种方法/部分可以为 JAX-WS 进行客户端定制。
1) 如果 WSDL 导入外部模式文件
2) 如果 WSDL 包含整个模式定义而没有任何导入
如果 wsdl 导入外部模式文件,
基本上,您需要创建一个新文件(通常带有 jxb 扩展名,但这并不重要),您将与为其生成客户端存根/api 的 wsdl 一起维护该文件。通常我将这些文件命名为架构文件名_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)。
我实际上测试并验证了这个示例,为您提出问题的元素生成一个 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 中有许多枚举限制,因此我假设您希望为大多数/全部生成枚举。
我希望这有帮助。