users@jaxb.java.net

Re: annotated (javadoc=>complexType/annotation/documentation)

From: Felipe Gaścho <fgaucho_at_gmail.com>
Date: Tue, 15 Jan 2008 08:03:02 +0100

1th option seems better.....

On Jan 15, 2008 3:12 AM, Andy Malakov <nabblespam_at_malakov.com> wrote:
>
> Hello All,
>
> In our project we derive XML schema from Java data model (using
> XmlSchemaGenerator). We want to provide XML schema document as a
> specification for our web service and want to generate schema documentation
> from Java.
>
> It could be based on javadoc for mapped classes and properties; or some kind
> of annotations [e.g. @SchemaDocumentation('blah-blah')]; or an extension of
> JAXB annotations: @XmlElement(documentation='blah-blah').
>
> I can see two ways:
>
> 1. The simplest way would be generating documentation as a separate set of
> HTML documents using JAXB reflection API.
>
> 2. Alternative approach will be patch XmlSchemaGenerator. For example, add
> documentation block in XmlSchemaGenerator.Namespace.writeClass().
>
>
> Could you please comment or provide alternative suggestions?
>
> Best Regards,
> Andy
>
>
>
>
> --
> View this message in context: http://www.nabble.com/annotated--%28javadoc%3D%3EcomplexType-annotation-documentation%29-tp14826092p14826092.html
> Sent from the java.net - jaxb users mailing list archive at Nabble.com.
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_jaxb.dev.java.net
> For additional commands, e-mail: users-help_at_jaxb.dev.java.net
>
>