users@jax-ws.java.net

Re: Maybe a feature request - what do you think?

From: Sekhar Vajjhala <Sekhar.Vajjhala_at_Sun.COM>
Date: Wed, 07 Feb 2007 09:25:45 -0500

This is already supported.

Use the JAXB customization <jxb:javadoc>.
<jxb:javadoc> has been present since JAXB 1.0 and is mandated by
the JAXB spec.

<xsd:complexType name="TransferableDataObject">
  <xsd:annotation> <xsd:appinfo>
    <jxb:class>
      <jxb:javadoc> JAVADOC ONE </jxb:javadoc>
    </jxb:class>
  </xsd:appinfo></xsd:annotation>

  <xsd:sequence>
    <xsd:element minOccurs="1" maxOccurs="1" nillable="true"
      name="objectType" type="xsd:string" >
      <xsd:annotation> <xsd:appinfo>
          <jxb:property>
            <jxb:javadoc> JAVADOC TWO </jxb:javadoc>
          </jxb:property>
        </xsd:appinfo> </xsd:annotation>
    </xsd:element>
  </xsd:sequence>
</xsd:complexType>

</xsd:schema>

JAVADOC TWO will be generated for both getter/setter.

Sekhar

Ingo Siebert wrote:

> Hi,
>
> i wrote a WSDL and some XSDs for my web service.
>
>
> WsImport generates the classes and all beans for me, but i'm missing
> JavaDoc comments.
>
> That's a snippet of my XSD:
>
> <xsd:complexType name="TransferableDataObject">
> <xsd:annotation>
> <xsd:documentation>JAVADOC ONE</xsd:documentation>
> </xsd:annotation>
>
> <xsd:sequence>
> <xsd:element minOccurs="1" maxOccurs="1" nillable="true"
> name="objectType" type="xsd:string" >
> <xsd:annotation>
> <xsd:documentation>JAVADOC TWO</xsd:documentation>
> </xsd:annotation>
> </xsd:element>
> ...
>
>
>
> If i look at the generated classes, only "JAVADOC ONE" is included as
> JavaDoc comment, but "JAVADOC TWO" is missing.
>
> I think the comment "JAVADOC TWO" should appear at the getter and
> setter of the property.
> What do you think?
>
> Cheers,
>
> Ingo
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe_at_jax-ws.dev.java.net
> For additional commands, e-mail: users-help_at_jax-ws.dev.java.net
>