[jboss-user] [JBoss Web Services] - as7 and java --> wsdl documentation trouble

Aleš Bregar do-not-reply at jboss.com
Tue Apr 3 22:13:07 EDT 2012

Aleš Bregar [https://community.jboss.org/people/kristjan273] created the discussion

"as7 and java --> wsdl documentation trouble"

To view the discussion, visit: https://community.jboss.org/message/728126#728126


I am migrating some old app (from as4.3 to as7.1) and this includes also some webservices adaptation. I have figured more or less everything on topic. There is only issue/improvement I would like to introduce and that is automatically generated documentation inside wsdl. I checked  https://issues.jboss.org/browse/JBWS-1850 https://issues.jboss.org/browse/JBWS-1850 as a starting point as it seemed promising. Than I have decorated the desired webmethod as:

@WebMethod(operationName = "hello", action = "urn:hello")
    @Documentation(content = "This is a test service OPERATION doing nothing special, just hello")
    public String hello(@WebParam(name="helloParameter",partName="description") String parameter){

Starting this, and there was no *wsdl:documentation* attribute in the wsdl. So little more reading told me (from  https://docs.jboss.org/author/display/JBWS/JBoss+Modules https://docs.jboss.org/author/display/JBWS/JBoss+Modules) that MANIFEST.MF dependencies should be updated with proper module, so I have added 

Dependencies: ..., org.jboss.ws.native.jbossws-native-core services annotations export

Still no *wsdl:documentation* in the generated wsdl.

I would be glad if someone would tell if there is something I am missing?

Also another question/proposal - why @Documentation annotation is METHOD only, as IMO it would be nice to decorate methods params too? Any reasonable issue against?

Tnx in advance,

Reply to this message by going to Community

Start a new discussion in JBoss Web Services at Community

-------------- next part --------------
An HTML attachment was scrubbed...
URL: http://lists.jboss.org/pipermail/jboss-user/attachments/20120403/62c478f1/attachment-0001.html 

More information about the jboss-user mailing list