WSDL2Java does not embed annotations in JavaDoc comments for some generated
classes
-----------------------------------------------------------------------------------
Key: AXIS-2291
URL: http://issues.apache.org/jira/browse/AXIS-2291
Project: Apache Axis
Type: Bug
Components: WSDL processing
Versions: 1.3
Environment: Mac OS X 10.4.3, java full version "1.4.2_09-232"
Reporter: Allen Cronce
Priority: Minor
We have annotations in our XSD in order to document the code generated. But for
some classes, WSDL2Java does not embed the annotation text in the JavaDoc
comments of the generated. code.
With the wsdl example below, the wsdl annotation for BirthDayType does make it
into the BirthDayType.java generated code. But the annotation for CountingType
does not make it into the CountingType.java generated code.
Here's the sample wsdl that demonstrates the problem:
<?xml version="1.0" encoding="UTF-8"?>
<definitions targetNamespace="axisprob.wsdl"
xmlns:http="http://schemas.xmlsoap.org/wsdl/http/";
xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/";
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/";
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/";
xmlns="http://schemas.xmlsoap.org/wsdl/";
xmlns:xs="http://www.w3.org/2001/XMLSchema";
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance";
xmlns:wsdlns="axisprob.wsdl"
xmlns:xsdns="axisprob.xsd"
xmlns:xml="http://www.w3.org/XML/1998/namespace";>
<!-- Imports -->
<xs:import namespace="http://www.w3.org/XML/1998/namespace";
schemaLocation="http://www.w3.org/2001/xml.xsd"/>
<!-- Schema -->
<types>
<xs:schema targetNamespace="axisprob.xsd"
xmlns:xsdns="axisprob.xsd"
xmlns:xs="http://www.w3.org/2001/XMLSchema";
xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/";
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/";>
<!-- Types -->
<!-- CountingType -->
<xs:simpleType name="CountingType">
<xs:annotation>
<xs:documentation xml:lang="en"> This
type demonstrates an enumeration
type. For some reason this text
does not make it into the JavaDoc
comments for the class
generated. </xs:documentation>
</xs:annotation>
<xs:restriction base="xs:normalizedString">
<xs:enumeration value="One"/>
<xs:enumeration value="Two"/>
<xs:enumeration value="Three"/>
</xs:restriction>
</xs:simpleType>
<!-- BirthDayType -->
<xs:complexType name="BirthDayType">
<xs:annotation>
<xs:documentation xml:lang="en"> This
is a type definition for a birthday minus the
year. Note that this text does
make it into the JavaDoc comments.</xs:documentation>
</xs:annotation>
<xs:sequence>
<xs:element name="day"
type="xs:nonNegativeInteger"/>
<xs:element name="month"
type="xs:nonNegativeInteger"/>
</xs:sequence>
</xs:complexType>
<!-- Methods signatures -->
<!-- problemMessage -->
<xs:element name="problemMessage">
<xs:annotation>
<xs:documentation xml:lang="en"> Can
you see me? </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="count"
type="xsdns:CountingType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
<!-- problemMessageResponse -->
<xs:element name="problemMessageResponse">
<xs:annotation>
<xs:documentation xml:lang="en"> Can
you see me? </xs:documentation>
</xs:annotation>
<xs:complexType>
<xs:sequence>
<xs:element name="birthday"
type="xsdns:BirthDayType"/>
</xs:sequence>
</xs:complexType>
</xs:element>
</xs:schema>
</types>
<!-- Messages -->
<!-- problemMessage message -->
<message name="problemMessage">
<part name="parameters" element="xsdns:problemMessage"/>
</message>
<message name="problemMessageResponse">
<part name="parameters" element="xsdns:problemMessageResponse"/>
</message>
<!-- Port type -->
<portType name="axisprobPortType">
<!-- problemMessage -->
<operation name="problemMessage">
<input message="wsdlns:problemMessage"/>
<output message="wsdlns:problemMessageResponse"/>
</operation>
</portType>
<!-- Binding for axisprob Web APIs - Document style, SOAP over HTTP -->
<binding name="axisprobSOAPBinding" type="wsdlns:axisprobPortType">
<soap:binding style="document"
transport="http://schemas.xmlsoap.org/soap/http"/>
<!-- problemMessage -->
<operation name="problemMessage">
<soap:operation soapAction="urn:axisprob2Action"/>
<input>
<soap:body use="literal"
namespace="axisprob.wsdl"/>
</input>
<output>
<soap:body use="literal"
namespace="axisprob.wsdl"/>
</output>
</operation>
</binding>
<!-- Endpoint for axisprob Web APIs -->
<service name="axisprob2">
<port name="axisprobPortType"
binding="wsdlns:axisprobSOAPBinding">
<soap:address
location="http://localhost:4310/WebObjects/axisprob2.woa/wa/axisprob2"/>
</port>
</service>
</definitions>
--
This message is automatically generated by JIRA.
-
If you think it was sent incorrectly contact one of the administrators:
http://issues.apache.org/jira/secure/Administrators.jspa
-
For more information on JIRA, see:
http://www.atlassian.com/software/jira
