java - online - Anotación de documentación JAXB

xsd to java class xjc

Question

Tengo la siguiente clase de Java con la anotación JAXB @XMLRootElement

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

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

que produce este fragmento xml cuando genero el esquema xsd

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

¿Es posible usar una anotación JAXB para que los detalles de la documentación en el campo dirección1 se incluyan como un elemento xs: anotación / xs: documentación en mi esquema 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

No sé si es posible, ya que nunca lo he usado. Pero hasta donde puedo decir, la API no admite el elemento de documentación. Sin embargo, podría usar la anotación @XMLElement para darle a su miembro un nombre más descriptivo.

//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>

Answer 2

Respuesta simple: no, no es posible con JAXB incorporado.