axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Mauro Molinari (JIRA)" <j...@apache.org>
Subject [jira] Commented: (AXIS2-3371) It would be VERY useful if WSDL2Java generated also Javadoc from schema and WSDL documentation elements
Date Tue, 08 Dec 2009 15:08:19 GMT

    [ https://issues.apache.org/jira/browse/AXIS2-3371?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=12787486#action_12787486
] 

Mauro Molinari commented on AXIS2-3371:
---------------------------------------

Since I am the reporter, I could promote it to bug. However, I still think this is rather
an improvement than a bug, but I agree with you that Axis2 release process is quite mysterious...

Let's hope someone at Axis2 developers side will give us some feedback on this now.

> 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: Bug
>          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.


Mime
View raw message