java - Apache CXF - 阐明 wsdl 生成错误

Question

我们正在使用 Apache CXF 代码优先方法来创建 Web 服务。我们有一个自定义的肥皂头来传递用户凭据。

我正在尝试使用 @webparam 注释传递 ​​SEI 中的用户凭据。

这是 Service 类中的两个操作。

@Path("/item/{id}")
@GET
public Item getItem(@PathParam("id") String id,
 @WebParam(name="userDetails", header=true, mode=Mode.IN) UserDetails details) throws NotFoundException;

@Path("/name/{id}")
@GET
public Item getItemByName(@PathParam("id") String id,
 @WebParam(name="userDetails", header=true, mode=Mode.IN) UserDetails details) throws NotFoundException;

生成 wsdl 时阐明会抛出错误

D:\workspace\myService\src\main\java\com\ws\api\ItemPublicationWebService.java:52: [xml] Web method defines a message part named 'userDetails' that is identical to the name of a web message part defined in D:\workspace\myService\src\main\java\com\ws\api\ItemPublicationWebService.java:41. Please use annotations to disambiguate.

我发现保持 webParam 名称唯一将生成 wsdl。但这不是预期的结果。

我在这里缺少什么？

Answer 1

Enunciate 在这里所做的是尝试为您的 Web 服务 API 构建一个漂亮、干净、整合的 WSDL。 Enunciate 与其他 WSDL 生成器不同，因为它在编译时工作，并尝试将所有 header 元素分组到 WSDL 可以引用的单个统一的 XML 模式文件中。 (其他 WSDL 生成器在运行时工作，因此可以根据需要即时生成模式，但存在大量重复的 XML 元素等。)

因此，当 Enunciate 遇到“getItem”方法时，它会看到名为“userDetails”的 header 元素，并将该 XML 元素添加到正在生成的 XML 架构文档中。然后，Enunciate 遇到您的“getItemByName”方法，并发现还有另一个名为“userDetails”的 header 元素，但它不够智能，无法看出它们是相同的元素。因此认为存在冲突，它会抛出错误。

我已为您记录了 JIRA 问题:

http://jira.codehaus.org/browse/ENUNCIATE-453

目前，如果您不介意让 Enunciate 为您生成 WSDL，您可以禁用“xml”Enunciate 模块:

<enunciate...>
  ...
  <modules>
    <xml disabled="true"/>
  </modules>
</enunciate>