axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Allen Cronce (JIRA)" <axis-...@ws.apache.org>
Subject [jira] Created: (AXIS-2291) WSDL2Java does not embed annotations in JavaDoc comments for some generated classes
Date Sat, 05 Nov 2005 17:02:20 GMT
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


Mime
View raw message