向 JAXB @XmlElement 添加描述?
Add description to JAXB @XmlElement ?
我正在做 java-第一个 Web 服务开发。我想为一个字段向 @XmlElement 添加描述,以便生成的 WSDL 将包含该字段的文档。
您似乎无法使用@XmlElement 执行此操作。不知道为什么 Oracle 不支持它。
如果我选择 JAXB 以外的其他绑定,我可以这样做吗?
无法使用 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);
}
我正在做 java-第一个 Web 服务开发。我想为一个字段向 @XmlElement 添加描述,以便生成的 WSDL 将包含该字段的文档。
您似乎无法使用@XmlElement 执行此操作。不知道为什么 Oracle 不支持它。
如果我选择 JAXB 以外的其他绑定,我可以这样做吗?
无法使用 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);
}