@XmlRootElement versus @XMLType

He estado anotando clases con @XMLType cuando la estructura será utilizado más de una vez dentro de un esquema XML y con @XmlRootElement cuando se utilizará solo una vez - ¿es este el mejor enfoque?

Una cosa a saber es que no se requiere la anotación @XmlRootElement o @XmlType. No son el equivalente de @Entity de JPA. Puedes usar un JAXB (JSR-222) implementación sin ninguna anotación nunca:

• http://wiki.eclipse.org/EclipseLink/Examples/MOXy/GettingStarted

A continuación explicaré lo que @XmlRootElement y @XmlType hacen.

@XmlRootElement

Hay momentos en que su implementación JAXB necesita crear instancias de un objeto basado solo en el elemento XML que se está procesando. La anotación @XmlRootElement es el medio principal para especificar esta asociación. Nota si una clase corresponde a más de un elemento XML entonces el @XmlElementDecl la anotación se debe utilizar insteat,

ROL # 1-Especificar el Objeto Raíz

@XmlRootElement se utiliza principalmente para especificar el objeto raíz. Esto es así cuando su implementación JAXB comienza a desmarcar un documento XML, sabe qué objeto crear una instancia. Casi todas las anotaciones posteriores se basarán en la información recopilada de la clase padre.

Foo

@XmlRootElement(name="root")
public class Foo {

    private String name;

}

Bar

public class Bar {

    private String name;

}

XML

<root>
    <name>Jane Doe</name>
</root>

Demo

Foo foo = (Foo) unmarshaller.unmarshal(xml);
Bar bar = unmarshaller.unmarshal(xml, Bar.class).getValue();

ROL # 2-Grupos de Sustitución

La anotación @XmlElementRef delega el tipo de objeto instanciado al nombre/uri del elemento. Esto permite la asignación al concepto de grupos de sustitución para representar herencia.

• http://blog.bdoughan.com/2010/11/jaxb-and-inheritance-using-substitution.html

ROL # 3 - Cualquier contenido

@XmlAnyElement le permite asignar una sección de comodín de su documento XML. Si especifica @XmlAnyElement(lax=true), los elementos asociados con los objetos de dominio se convertirán en el dominio correspondiente objeto.

• http://blog.bdoughan.com/2010/08/using-xmlanyelement-to-build-generic.html

@XmlType

ROL #1-Schema Gen

Por defecto se genera un tipo complejo con nombre para cada clase Java conocida por el contexto JAXB. Puede controlar el nombre de este tipo usando la anotación @XmlType, o especificar que se debe generar un tipo complejo anónimo especificando el nombre como "".

FUNCIÓN #2-Herencia y xsi: tipo

Por defecto JAXB aprovecha el atributo xsi:type como indicador de herencia. El valor de este atributo corresponde al nombre y espacio de nombres que ha especificado en la anotación @XmlType, o está predeterminado en función de la clase.

• http://blog.bdoughan.com/2010/11/jaxb-and-inheritance-using-xsitype.html

ROL # 3-Orden de la prop

Como usted menciona puede utilizar el @XmlType para especificar la orden de propiedad.

• http://blog.bdoughan.com/2012/02/jaxbs-xmltype-and-proporder.html

ROLE # 4-Métodos de fábrica

@XmlType permite especificar una clase y/o método de fábrica que se puede utilizar para crear instancias del objeto domain en lugar del constructor predeterminado.

• http://blog.bdoughan.com/2011/06/jaxb-and-factory-methods.html

Una pregunta diferente pero relacionada que incluiré aquí. El @XMLType anotación tiene un atributo propOrder para especificar en qué orden es aparecen elementos - hay un equivalente para @XMLRootElement?

No, el aspecto propOrder pertenece a la anotación @XmlType. Esto tiene sentido ya que los tipos complejos son responsables de especificar un (o falta de) orden. Por supuesto, puede usar estas anotaciones al mismo tiempo.

@XmlRootElement
@XmlType(propOrder={"foo", "bar"}
public class Root {
    ...
}