使用 CXF 和 maven 将源代码注释导出到 WSDL？答案

【问题标题】：Export source code comments to the WSDL using CXF and maven?使用 CXF 和 maven 将源代码注释导出到 WSDL？
【发布时间】：2011-11-25 08:50:42
【问题描述】：

正如标题所说：是否可以将我的 javadoc cmets 用于 Web 服务方法参数导出到 wsdl 中？我们使用 CXF 和 maven 的 java2ws 目标从源代码生成 wsdl。

【问题讨论】：

不确定 JAXWS 和参数，但使用 JAXRS，您可以使用 org.apache.cxf.jaxrs.ext.Description 注释方法，它会显示在生成的 WADL 中。
嗯，有一个 @WSDLDocumentation 注释，但这还不够好。如果有一个方法具有多个参数或两个参数，或者必须使用一个构造函数来创建参数，那么对整个方法的描述是不够的。我希望有可用的 javadocs，以便使用 web 服务的开发人员知道如何构建服务期望的对象。

标签： java web-services maven wsdl cxf

【解决方案1】：

您可以使用 @WSDLDocumentationCollection 注释将多个 @WSDLDocumentation 注释附加到单个方法（具有不同的位置），但是您不能使用它来比将文档放在端口的单个操作上更深入，因为那是它不再是一个 WSDL 问题，而是一个 XSD 问题。 XSD 文档将由 JAXB 级别的注释处理，但不存在此类注释；生成的架构不会包含 <xs:documentation> 元素。（当从模式开始时，文档 cmets 可以生成为 Javadoc，但不会发生相反的方向，因为 Javadoc cmets 不会保留在 Java 类文件中。）

【讨论】：