6.2.2
Annotation for Classes: XmlType
This annotation adds information that would be available from a schema
type, but isn't implied by a Java class declaration. The annotation has
several attributes:
factoryClass
and factoryMethod
define the
class containing a no-argument method for creating an instance of this
class as the equivalent of an empty XML element.
- The attribute
name
provides the XML schema name if you
don't want to use the class name.
- The
namespace
attribute provides the name of the
target namespace.
- The string array value defined by
propOrder
establishes
an ordering of the sub-elements. (It's pretty obvious that there can't
be a connection between the textual order of items in a class
definition and the order its fields are returned by reflection methods.)
Here is an example for XmlType
, requesting that the
elements title
, items
and cluster
should appear in the given order:
@XmlRootElement
@XmlType( propOrder={ "title", "items", "cluster" } )
public class Document {
...
}