正如 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 中有许多枚举限制,所以我假设您希望为大多数/全部生成枚举。
我希望这会有所帮助。