axis-java-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "keith chapman" <keithgchap...@gmail.com>
Subject Re: [Axis2] Proposal to chage the method signature of set/get documentation
Date Fri, 26 Oct 2007 04:40:34 GMT
On 10/26/07, Eran Chinthaka <chinthaka@opensource.lk> wrote:
>
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
>
> +1 from me.
>
> If some one calls the earlier methods, you can serialize the OMNode and
> return, which i think is the easier to do.


Sure.

Thanks,
Keith.

Chinthaka
>
> 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/
>
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.4.6 (GNU/Linux)
> Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org
>
> iD8DBQFHIWucjON2uBzUhh8RAtmCAKCabVIEiPB/qtLSnzhw2PvW5Jj+GwCaA17r
> xWy2A3una8h4LSgppYDjGYM=
> =2Dyf
> -----END PGP SIGNATURE-----
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: axis-dev-unsubscribe@ws.apache.org
> For additional commands, e-mail: axis-dev-help@ws.apache.org
>
>


-- 
Keith Chapman
WSO2 Inc.
Oxygen for Web Services Developers.
http://wso2.org/

Mime
View raw message