Like the title says: Is it possible to export my javadoc comments for web service method parameters into the wsdl? We’re using CXF and the java2ws goal with maven to generate the wsdl from source code.
Share
Sign Up to our social questions and Answers Engine to ask questions, answer people’s questions, and connect with other people.
Login to our social questions & Answers Engine to ask questions answer people’s questions & connect with other people.
Lost your password? Please enter your email address. You will receive a link and will create a new password via email.
Please briefly explain why you feel this question should be reported.
Please briefly explain why you feel this answer should be reported.
Please briefly explain why you feel this user should be reported.
Like the title says: Is it possible to export my javadoc comments for web service method parameters into the wsdl? We’re using CXF and the java2ws goal with maven to generate the wsdl from source code.
You can use the
@WSDLDocumentationCollectionannotation to attach multiple@WSDLDocumentationannotations to a single method (with different placements) but you can’t use this to go much deeper than placing documentation on single operations of a port, because that’s where it ceases to be a WSDL problem and becomes an XSD problem. XSD documentation would be handled by an annotation at the JAXB level, except that no such annotation exists; the schema generated won’t contain<xs:documentation>elements. (When starting from a schema, documentation comments can be generated as Javadoc, but the reverse direction doesn’t happen as Javadoc comments aren’t retained in Java class files.)