org.apache.juneau.xml.annotation

Annotation Type Xml

@Documented
 @Target(value={TYPE,FIELD,METHOD})
 @Retention(value=RUNTIME)
 @Inherited
public @interface Xml

Annotation for specifying various XML options for the XML and RDF/XML serializers.

Can be applied to Java packages, types, fields, and methods.

Can be used for the following:

• Override the child element name on the XML representation of collection or array properties.
• Specify the XML namespace on a package, class, or method.
• Override the XML format on a POJO.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and Description
String	childName Sets the name of the XML child elements for bean properties of type collection and array.
XmlFormat	format The XmlFormat to use for serializing this object type.
String	namespace Sets the namespace URI of this property or class.
String	prefix Sets the XML prefix of this property or class.

Element Detail

childName

public abstract String childName

Sets the name of the XML child elements for bean properties of type collection and array.

Applies only to collection and array bean properties.

Example:

public class MyBean { @Xml(childName="child"} public String[] children = {"foo","bar"}; }

Without the @Xml annotation, serializing this bean as XML would have produced the following...

<object> <children> <string>foo</string> <string>bar</string> </children> </object>

With the annotations, serializing this bean as XML produces the following...

<object> <children> <child>foo</child> <child>bar</child> </children> </object>

Default:

""

format

public abstract XmlFormat format

The XmlFormat to use for serializing this object type.

Example:

public class MyBean { // Normally, bean properties would be rendered as child elements of the bean element. // Override so that it's rendered as a "f1='123'" attribute on the bean element instead. @Xml(format=XmlFormat.ATTR} public int f1 = 123; // Normally, bean URL properties would be rendered as XML attributes on the bean element. // Override so that it's rendered as an <href>http://foo</href> child element instead. @BeanProperty(uri=true) @Xml(format=XmlFormat.ELEMENT} public URL href = new URL("http://foo"); // Normally, collection properties would be grouped under a single <children> child element on the bean element. // Override so that entries are directly children of the bean element with each entry having an element name of <child>. @Xml(format=XmlFormat.COLLAPSED, childName="child"} public String[] children = "foo","bar"}; }

Without the @Xml annotations, serializing this bean as XML would have produced the following...

<object href='http://foo'> <f1>123</f1> <children> <string>foo</string> <string>bar</string> </children> </object>

With the annotations, serializing this bean as XML produces the following...

<object f1='123'> <href>http://foo</href> <child>foo</child> <child>bar</child> </object>

Default:

org.apache.juneau.xml.annotation.XmlFormat.DEFAULT

namespace

public abstract String namespace

Sets the namespace URI of this property or class.

Must be matched with a prefix() annotation on this object, a parent object, or a @XmlNs with the same name through the @XmlSchema.xmlNs() annotation on the package.

Default:

""

prefix

public abstract String prefix

Sets the XML prefix of this property or class.

• When applied to a ElementType.TYPE, namespace is applied to all properties in the class, and all subclasses of the class.
• When applied to bean properties on ElementType.METHOD and ElementType.FIELD, applies to the bean property.

Must either be matched to a namespace() annotation on the same object, parent object, or a @XmlNs with the same name through the @XmlSchema.xmlNs() annotation on the package.

Default:

""