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 方法定义一个名为“userDetails”的消息部分，该部分与 Web 的名称相同消息部分定义在 D:\workspace\myService\src\main\java\com\ws\api\ItemPublicationWebService.java:41 中。请使用注释来消除歧义。

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

我在这里缺少什么？

Answer 1

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

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

我已经为您记录了 JIRA 问题：

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

现在，如果您不关心 Enunciate 为您生成 WSDL，您可以禁用“xml”Enunciate 模块：

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