You are viewing a plain text version of this content. The canonical link for it is here.
Posted to java-dev@axis.apache.org by "ALB (JIRA)" <ji...@apache.org> on 2009/12/07 21:37:18 UTC
[jira] Commented: (AXIS2-3371) It would be VERY useful if WSDL2Java
generated also Javadoc from schema and WSDL documentation elements
[ https://issues.apache.org/jira/browse/AXIS2-3371?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12787095#action_12787095 ]
ALB commented on AXIS2-3371:
----------------------------
I'm also looking for a solution to adding documentation that will get carried over when the wsdl2java creates the stubs. It seems like this is an issue but it hasn't gotten fixed... is there a workaround for this?
> 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
> Attachments: Create Cell Javadoc.png, Create Cell WSDL.png
>
>
> 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.