将描述添加到JAXB @XmlElement？

Question

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

看来你不能用@XmlElement来做到这一点。不知道为什么Oracle不支持它。

如果我选择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); 

}