axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From S?bastien Tardif (JIRA) <axis-...@ws.apache.org>
Subject [jira] Updated: (AXIS-1665) Axis do not generate JavaDoc for the service and port interface.
Date Mon, 22 Nov 2004 15:51:32 GMT
     [ http://nagoya.apache.org/jira/browse/AXIS-1665?page=history ]

Sébastien Tardif updated AXIS-1665:
-----------------------------------

    Attachment: docHarbor.wsdl

Here an example of a WSDL with full documentations in many sections of a WSDL.

> Axis do not generate JavaDoc for the service and port interface.
> ----------------------------------------------------------------
>
>          Key: AXIS-1665
>          URL: http://nagoya.apache.org/jira/browse/AXIS-1665
>      Project: Axis
>         Type: Bug
>   Components: Serialization/Deserialization
>     Versions: 1.0-rc1
>  Environment: CVS Nov 12 2004
>     Reporter: Sébastien Tardif
>  Attachments: docHarbor.wsdl, docHarbor.wsdl
>
> Title: Axis do not generate JavaDoc for the service and port interface.
> Service and Port are the entries points and so are quite important and should have JavaDoc!
> I have a WSDL like this:
> ...
> <wsdl:service name="DocHarborServices">
> 	<xsd:annotation>
> 		<xsd:documentation xml:lang="en">Contain all operations in docHarbor Web Services.
The mode of operation is stateless so you have to provide a Credential instance to every operation.</xsd:documentation>
> 	</xsd:annotation>
> 	<wsdl:port name="docHarbor" binding="impl:webservicesSoapBinding">
> 		<xsd:annotation>
> 			<xsd:documentation xml:lang="en">Contain all operations in docHarbor Web Services.
The mode of operation is stateless so you have to provide a Credential instance to every operation.</xsd:documentation>
> 			</xsd:annotation>
> 		<wsdlsoap:address location="http://localhost/webservices1_0/services/docHarbor"/>
> 	</wsdl:port>
> </wsdl:service> -->
> </wsdl:definitions>
> So I was expecting to see in those classes Javadoc having what I specified in xsd:documentation:
> docHarbor.java extract:
> // SHOULD HAVE JAVADOC HERE
> public interface DocHarbor extends javax.xml.rpc.Service {
>     public java.lang.String getdocHarborAddress();
> ...
> and
> DocHarborServices.java extract:
> // SHOULD HAVE JAVADOC HERE
> public interface DocHarborServices extends javax.xml.rpc.Service {
>     public java.lang.String getdocHarborAddress();
> I'm surprise because there are many bugs one JavaDoc issues and they are all Closed:
>   AXIS-1262  Pulling Javadoc from  Unassigned  Danno Ferrin     Closed  Fixed  24/Mar/04
24/Mar/04    Unwatch 
>   AXIS-766  Generate JavaDoc comments from WSDL comments  Axis Developers Mailing List
 ted stockwell      Resolved  Duplicate  23/Mar/03 23/Feb/04  
>   AXIS-604  Generated comments should be javadoc comments  Unassigned  Steve Loughran
     Closed  Fixed  08/Jan/03 23/Mar/04      
> I have attached the WSDL for reference.

-- 
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
   http://nagoya.apache.org/jira/secure/Administrators.jspa
-
If you want more information on JIRA, or have a bug to report see:
   http://www.atlassian.com/software/jira


Mime
View raw message