[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

--------------------------------------------------------------
Hi,

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,
A
--------------------------------------------------------------

Reply to this message by going to Community
[https://community.jboss.org/message/728126#728126]

Start a new discussion in JBoss Web Services at Community
[https://community.jboss.org/choose-container!input.jspa?contentType=1&containerType=14&container=2044]

-------------- 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