I wrote a web-service in a documentation-first approach, meaning I wrote a WSDl + XSD spec, and generated Java sources from it.

The WSDL also contains documentation in form of <wsdl:documentation> tags, as does the XSD with <xsd:annotation> tags. Now this information is successfully translated into JavaDoc comments in the generated sources,.which is a nice feature by JAXWS.

However, when I finally deploy my web-service, the WSDL made available by JBoss does not contain any sort of documentation at all. As I understand it, JBoss re-creates the WSDL interface from the (generated) annotated web-service classes on deployment - and apparently does not include the present documentation.

Is there any way to get documentation into the generated WSDL which is made available by JBoss as the endpoint of a deployed web-service?

link|improve this question

75% accept rate
feedback

Know someone who can answer? Share a link to this question via email, Google+, Twitter, or Facebook.

Your Answer

 
or
required, but never shown

Browse other questions tagged or ask your own question.