<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<body link="#355491" alink="#4262a1" vlink="#355491" style="background: #e2e2e2; margin: 0; padding: 20px;">
<div>
<table cellpadding="0" bgcolor="#FFFFFF" border="0" cellspacing="0" style="border: 1px solid #dadada; margin-bottom: 30px; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td>
<table border="0" cellpadding="0" cellspacing="0" bgcolor="#FFFFFF" style="border: solid 2px #ccc; background: #dadada; width: 100%; -moz-border-radius: 6px; -webkit-border-radius: 6px;">
<tbody>
<tr>
<td bgcolor="#000000" valign="middle" height="58px" style="border-bottom: 1px solid #ccc; padding: 20px; -moz-border-radius-topleft: 3px; -moz-border-radius-topright: 3px; -webkit-border-top-right-radius: 5px; -webkit-border-top-left-radius: 5px;">
<h1 style="color: #333333; font: bold 22px Arial, Helvetica, sans-serif; margin: 0; display: block !important;">
<!-- To have a header image/logo replace the name below with your img tag -->
<!-- Email clients will render the images when the message is read so any image -->
<!-- must be made available on a public server, so that all recipients can load the image. -->
<a href="https://community.jboss.org/index.jspa" style="text-decoration: none; color: #E1E1E1">JBoss Community</a></h1>
</td>
</tr>
<tr>
<td bgcolor="#FFFFFF" style="font: normal 12px Arial, Helvetica, sans-serif; color:#333333; padding: 20px; -moz-border-radius-bottomleft: 4px; -moz-border-radius-bottomright: 4px; -webkit-border-bottom-right-radius: 5px; -webkit-border-bottom-left-radius: 5px;"><h3 style="margin: 10px 0 5px; font-size: 17px; font-weight: normal;">
as7 and java --> wsdl documentation trouble
</h3>
<span style="margin-bottom: 10px;">
created by <a href="https://community.jboss.org/people/kristjan273">Aleš Bregar</a> in <i>JBoss Web Services</i> - <a href="https://community.jboss.org/message/728126#728126">View the full discussion</a>
</span>
<hr style="margin: 20px 0; border: none; background-color: #dadada; height: 1px;">
<div class="jive-rendered-content"><p>Hi,</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>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 <a class="jive-link-external-small" href="https://issues.jboss.org/browse/JBWS-1850">https://issues.jboss.org/browse/JBWS-1850</a> as a starting point as it seemed promising. Than I have decorated the desired webmethod as:</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code jive-java">@WebMethod(operationName = <font color="red">"hello"</font>, action = <font color="red">"urn:hello"</font>)
    @Documentation(content = <font color="red">"This is a test service OPERATION doing nothing special, just hello"</font>)
    <font color="navy"><b>public</b></font> String hello(@WebParam(name=<font color="red">"helloParameter"</font>,partName=<font color="red">"description"</font>) String parameter)<font color="navy">{</font>
...
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Starting this, and there was no <strong>wsdl:documentation</strong> attribute in the wsdl. So little more reading told me (from <a class="jive-link-external-small" href="https://docs.jboss.org/author/display/JBWS/JBoss+Modules">https://docs.jboss.org/author/display/JBWS/JBoss+Modules</a>) that MANIFEST.MF dependencies should be updated with proper module, so I have added </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><pre class="jive-pre"><code class="jive-code">Dependencies: ..., org.jboss.ws.native.jbossws-native-core services annotations export
</code></pre><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Still no <strong>wsdl:documentation </strong>in the generated wsdl.</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>I would be glad if someone would tell if there is something I am missing?</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>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?</p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p style="min-height: 8pt; height: 8pt; padding: 0px;"> </p><p>Tnx in advance,</p><p>A</p></div>
<div style="background-color: #f4f4f4; padding: 10px; margin-top: 20px;">
<p style="margin: 0;">Reply to this message by <a href="https://community.jboss.org/message/728126#728126">going to Community</a></p>
<p style="margin: 0;">Start a new discussion in JBoss Web Services at <a href="https://community.jboss.org/choose-container!input.jspa?contentType=1&containerType=14&container=2044">Community</a></p>
</div></td>
</tr>
</tbody>
</table>
</td>
</tr>
</tbody>
</table>
</div>
</body>
</html>