在JAXB @XmlElement中添加说明？

Question

我正在进行java-first web服务开发。我想为一个字段添加@XmlElement的描述，以便生成的WSDL将包含该字段的文档。

看来你不能用@XmlElement来做这件事。不知道甲骨文为什么不支持它。

如果我选择JAXB以外的其他绑定，我可以这样做吗？

Answer 1

无法使用JAXB注释，因此文档详细信息将包含在生成的模式中（请参阅this）

您可以使用CXF custom annotations，但仅适用于端口和操作

@WebService
@WSDLDocumentationCollection(
    {
        @WSDLDocumentation("My portType documentation"),
        @WSDLDocumentation(value = "My top level documentation",
                           placement = WSDLDocumentation.Placement.TOP),
        @WSDLDocumentation(value = "My binding doc",
                           placement = WSDLDocumentation.Placement.BINDING)
    }
)
public interface MyService {

    @WSDLDocumentation("The docs for echoString")
    String echoString(String s);

}