axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Sanjiva Weerawarana <>
Subject Re: [Axis2] Proposal to chage the method signature of set/get documentation
Date Fri, 26 Oct 2007 08:14:45 GMT

keith chapman wrote:
> Hi Devs,
> Currently the method signature for det/get documentation in 
> AxisDescriptio is as follows.
>     public String getDocumentation();
>     public void setDocumentation(String documentation);
> As you can see it treats the documentation as a string. There are 
> occasions where the documentation can be XML though. If the 
> documentation is XML what we do currently is wrap it in CDATA tags. This 
> works, but its not the best sollution.
> I propose deprecating the above methods and introducing the following 
> methods which that documentation as an OMNode.
>     public OMNode getDocumentation();
>     public void setDocumentation(OMNode documentation);
> This will enable us to set the documentation as an OMText or OMElement.
> If needed we can retain the old methods without deprecating them (Just 
> leave them as a convenience method), where they will call into the new 
> method.
> The above proposal is targeted at improving the wsdl served by Axis2. 
> With what we have currently documentation which is XML is wrapped in 
> CDATA tags in the WSDL.
> Thanks,
> Keith.
> -- 
> Keith Chapman
> WSO2 Inc.
> Oxygen for Web Services Developers.

Sanjiva Weerawarana, Ph.D.
Founder & Director; Lanka Software Foundation;
Founder, Chairman & CEO; WSO2, Inc.;
Member; Apache Software Foundation;
Visiting Lecturer; University of Moratuwa;

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message