[
https://issues.apache.org/jira/browse/AXIS2-3371?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12729723#action_12729723
]
Barry L Rogoff commented on AXIS2-3371:
---------------------------------------
I consider this issue to be a bug rather than an improvement. In a nutshell,
WSDL2Java is broken. The Javadoc lists method parameters but omits parameter
descriptions.
For example, the screen captures above show the WSDL for the createCell method
(as rendered by wsdl-viewer.js) and the corresponding Javadoc. As you can see,
the WSDL contains tags like this for each parameter:
<annotation>
<documentation>Required integer that identifies the mailing in which the cell
should appear; must be a valid mailing identifier.
</documentation>
</annotation>
The text inside the <documentation> tag gets dropped on the floor.
> It would be VERY useful if WSDL2Java generated also Javadoc from schema and
> WSDL documentation elements
> -------------------------------------------------------------------------------------------------------
>
> Key: AXIS2-3371
> URL: https://issues.apache.org/jira/browse/AXIS2-3371
> Project: Axis 2.0 (Axis2)
> Issue Type: Improvement
> Components: codegen
> Affects Versions: 1.3
> Reporter: Mauro Molinari
>
> It would be EXTREMELY useful if WSDL2Java could take
> <xsd:annotation><xsd:documentation>...</xsd:documentation></xsd:documentation>
> elements content relative to elements, types and enumeration in the schema,
> as well as <wsdl:documentation>...</wsdl:documentation> elements content
> relative to services and operations, to generate Javadocs for skeleton, stubs
> and ADBBeans.
> My raw proposed mapping is:
> - <wsdl:documentation> before <wsdl:types> => skeleton/stub class Javadoc
> - <xsd:annotation><xsd:documentation> for a defined root element/complex type
> in the schema => ADBBean class Javadoc
> - <xsd:annotation><xsd:documentation> for a defined element of a complex type
> in the schema => ADBBean method Javadoc and @param entries for skeleton/stub
> methods
> - <wsdl:documentation> for an operation => method Javadoc for skeleton/stub
> methods
> - <xsd:annotation><xsd:documentation> for a defined enumeration value of an
> extension of a type in the schema => properties Javadoc for the different
> instances of the generated typesafe enum
--
This message is automatically generated by JIRA.
-
You can reply to this email to add a comment to the issue online.
