axis-java-dev mailing list archives

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

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.
> http://wso2.org/

-- 
Sanjiva Weerawarana, Ph.D.
Founder & Director; Lanka Software Foundation; http://www.opensource.lk/
Founder, Chairman & CEO; WSO2, Inc.; http://www.wso2.com/
Member; Apache Software Foundation; http://www.apache.org/
Visiting Lecturer; University of Moratuwa; http://www.cse.mrt.ac.lk/

---------------------------------------------------------------------
To unsubscribe, e-mail: axis-dev-unsubscribe@ws.apache.org
For additional commands, e-mail: axis-dev-help@ws.apache.org


Mime
View raw message