JAXB Documentation Annotation

Question

J'ai la classe java suivante avec l'annotation JAXB @XmlRootElement

@XmlRootElement(name="ClientData") 
public class ClientData { 

/** 
* The first address field of the person 
*/ 
private String address1 = null; 
} 

qui produit ce fragment XML quand je produis le schéma xsd

<xs:complexType name="clientData"> 
    <xs:sequence> 
    <xs:element minOccurs="0" name="address1" type="xs:string"/> 

Est-il possible d'utiliser un JAXB annotation afin que les détails de la documentation sur le champ address1 soient inclus dans un élément xs: annotation/xs: documentention dans mon schéma final?

<xs:complexType name="clientData"> 
    <xs:sequence> 
    <xs:element minOccurs="0" name="address1" type="xs:string"> 
    <xs:annotation> 
     <xs:documentation>The first address field of the person</xs:documentation> 
    </xs:annotation> 
    </xs:element> 

Answer 1

Réponse simple: non ce n'est pas possible avec JAXB intégré.

Answer 2

Je ne sais pas si c'est possible, puisque je ne l'ai jamais utilisé. Mais autant que je peux dire que l'API ne supporte pas l'élément de documentation. Toutefois, vous pouvez utiliser l'annotation @XMLElement pour donner à votre membre un nom plus descriptif.

//Example: Code fragment 
public class USPrice { 
    @XmlElement(name="itemprice") 
    public java.math.BigDecimal price; 
} 

<!-- Example: Local XML Schema element --> 
<xs:complexType name="USPrice"/> 
    <xs:sequence> 
    <xs:element name="itemprice" type="xs:decimal" minOccurs="0"/> 
    </sequence> 
</xs:complexType>