org.apache.cxf.annotations.WSDLDocumentation org.apache.cxf.annotations.WSDLDocumentationCollection (since 2.3) - 7.3

Talend ESB Service Developer Guide

Version
7.3
Language
English
Product
Talend Data Fabric
Talend Data Services Platform
Talend ESB
Talend MDM Platform
Talend Open Studio for ESB
Talend Real-Time Big Data Platform
Module
Talend ESB
Talend Runtime
Content
Design and Development
Installation and Upgrade
Last publication date
2023-04-17

For "java first" scenarios where the WSDL is derived from the Java interfaces/code, these annotations allow adding wsd:documentation elements to various locations in the generated wsdl.

For example:

@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);

}