Module org.eclipse.persistence.core

Package org.eclipse.persistence.oxm

Class XMLUnionField

java.lang.Object

org.eclipse.persistence.internal.helper.DatabaseField

org.eclipse.persistence.oxm.XMLField

org.eclipse.persistence.oxm.XMLUnionField

All Implemented Interfaces:

Serializable, Cloneable, CoreField, Field<XMLConversionManager,NamespaceResolver>, UnionField<XMLConversionManager,NamespaceResolver>

public class XMLUnionField
extends XMLField
implements UnionField<XMLConversionManager,NamespaceResolver>

Subclass of XMLField for fields that are mapped to unions. Maintains a list of schema types instead of just one single schema type. Schema types can be added using the addSchemaType api. XMLConstants has a list of useful constants including a list of QNames for built-in schema types that can be used when adding schema types.

When reading and writing an element that is mapped with an XMLUnionField, a conversion to each of the schema types on the field (in the order they are specified ) is tried until a conversion is successful. The java type to convert to is based on the list of schema type to java conversion pairs specified on the field. These conversion pairs can be modified using the addXMLConversion api.

Code Sample
In this example the age field could be a date or an int.
XMLUnionField field = new XMLUnionField("age/text()");
field.addSchemaType(XMLConstants.DATE_QNAME);
field.addSchemaType(XMLConstants.INT_QNAME)


See Also:

• XMLField
• XMLConstants
• Serialized Form

Field Summary

Fields inherited from class org.eclipse.persistence.oxm.XMLField

isTypedTextField, leafElementType, userJavaTypes, userXMLTypes

Fields inherited from class org.eclipse.persistence.internal.helper.DatabaseField

columnDefinition, index, isCreatable, isInsertable, isNullable, isPrimaryKey, isTranslated, isUnique, isUpdatable, keepInRow, length, name, nameForComparisons, NULL_SQL_TYPE, precision, qualifiedName, scale, sqlType, table, type, typeName, useDelimiters, useUpperCaseForComparisons

Constructor Summary

Constructors

Constructor	Description
XMLUnionField()	Constructs an XMLUnionField
XMLUnionField(String xPath)	Constructs an XMLUnionField with the xpath set to the specified xPath

Method Summary

Modifier and Type	Method	Description
void	addSchemaType(QName value)	Adds the new type value to the list of types
Object	convertValueBasedOnSchemaType(Object value, XMLConversionManager xmlConversionManager, AbstractUnmarshalRecord record)	INTERNAL:
Class<?>	getJavaClass(QName qname)	Return the class for a given qualified XML Schema type.
Class<?>	getJavaClass(QName qname, ConversionManager conversionManager)	INTERNAL
QName	getSchemaType()	Return the first schema type in the list of schema types
QName	getSchemaTypeForValue(Object value, CoreAbstractSession session)	INTERNAL:
ArrayList	getSchemaTypes()	Return the list of schema types
protected QName	getSingleValueToWriteForUnion(Object value, CoreAbstractSession session)
boolean	isSchemaType(QName schemaType)	INTERNAL
boolean	isUnionField()	INTERNAL: returns true since this is a union field
void	setSchemaType(QName value)	Adds the new type value to the list of types
void	setSchemaTypes(ArrayList value)	Sets the schema types that this attribute can be mapped to Valid QName schema types can be found on org.eclipse.persistence.oxm.XMLConstants

Methods inherited from class org.eclipse.persistence.oxm.XMLField

addConversion, addJavaConversion, addXMLConversion, equals, getLastXPathFragment, getLeafElementType, getNamespaceResolver, getUserJavaTypesForDeploymentXML, getUserXMLTypesForDeploymentXML, getXMLType, getXMLType, getXPath, getXPathFragment, hashCode, hasLastXPathFragment, initialize, isCDATA, isNestedArray, isRequired, isSelfField, isTypedTextField, removeConversion, removeJavaConversion, removeXMLConversion, setIsCDATA, setIsTypedTextField, setLastXPathFragment, setLeafElementType, setName, setName, setNamespaceResolver, setNestedArray, setRequired, setUserJavaTypesForDeploymentXML, setUserXMLTypesForDeploymentXML, setUsesSingleNode, setXPath, setXPathFragment, usesSingleNode

Methods inherited from class org.eclipse.persistence.internal.helper.DatabaseField

clone, convertClassNamesToClasses, equals, getColumnDefinition, getIndex, getLength, getName, getNameDelimited, getNameForComparisons, getPrecision, getQualifiedName, getQualifiedNameDelimited, getScale, getSqlType, getTable, getTableName, getType, getTypeName, getUseUpperCaseForComparisons, hasTableName, initDDLFields, isCreatable, isInsertable, isNullable, isObjectRelationalDatabaseField, isPrimaryKey, isReadOnly, isTranslated, isUnique, isUpdatable, keepInRow, resetQualifiedName, setColumnDefinition, setCreatable, setIndex, setInsertable, setIsTranslated, setKeepInRow, setLength, setName, setNameForComparisons, setNullable, setPrecision, setPrimaryKey, setScale, setSqlType, setTable, setTableName, setType, setTypeName, setUnique, setUpdatable, setUseDelimiters, shouldUseDelimiters, toString, useUpperCaseForComparisons

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.persistence.internal.core.helper.CoreField

setName, setType

Methods inherited from interface org.eclipse.persistence.internal.oxm.mappings.Field

getLastXPathFragment, getLeafElementType, getName, getNamespaceResolver, getType, getXMLType, getXPath, getXPathFragment, hasLastXPathFragment, initialize, isCDATA, isNestedArray, isRequired, isSelfField, isTypedTextField, setIsCDATA, setIsTypedTextField, setNamespaceResolver, setNestedArray, setRequired, setUsesSingleNode, setXPath, usesSingleNode

Constructor Details

XMLUnionField

public XMLUnionField()

Constructs an XMLUnionField

XMLUnionField

public XMLUnionField(String xPath)

Constructs an XMLUnionField with the xpath set to the specified xPath

Parameters:

xPath - The xpath expression for the field

Method Details

getSchemaTypes

public ArrayList getSchemaTypes()

Return the list of schema types

Specified by:

getSchemaTypes in interface UnionField<XMLConversionManager,NamespaceResolver>

Returns:

the list of types

setSchemaTypes

public void setSchemaTypes(ArrayList value)

Sets the schema types that this attribute can be mapped to Valid QName schema types can be found on org.eclipse.persistence.oxm.XMLConstants

Parameters:

value - An ArrayList containing the schema types.

See Also:

• XMLConstants

addSchemaType

public void addSchemaType(QName value)

Adds the new type value to the list of types

Specified by:

addSchemaType in interface UnionField<XMLConversionManager,NamespaceResolver>

Parameters:

value - QName to be added to the list of schema types

getSchemaType

public QName getSchemaType()

Return the first schema type in the list of schema types

Specified by:

getSchemaType in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

getSchemaType in class XMLField

Returns:

the first item in the collection of schema types

setSchemaType

public void setSchemaType(QName value)

Adds the new type value to the list of types

Specified by:

setSchemaType in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

setSchemaType in class XMLField

Parameters:

value - The value to be added to the list of schema types

isUnionField

public boolean isUnionField()

INTERNAL: returns true since this is a union field

Specified by:

isUnionField in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

isUnionField in class XMLField

getSchemaTypeForValue

public QName getSchemaTypeForValue(Object value,
 CoreAbstractSession session)

Description copied from class: XMLField

INTERNAL:

Specified by:

getSchemaTypeForValue in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

getSchemaTypeForValue in class XMLField

getSingleValueToWriteForUnion

protected QName getSingleValueToWriteForUnion(Object value,
 CoreAbstractSession session)

convertValueBasedOnSchemaType

public Object convertValueBasedOnSchemaType(Object value,
 XMLConversionManager xmlConversionManager,
 AbstractUnmarshalRecord record)

INTERNAL:

Specified by:

convertValueBasedOnSchemaType in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

convertValueBasedOnSchemaType in class XMLField

getJavaClass

public Class<?> getJavaClass(QName qname)

Return the class for a given qualified XML Schema type. If the class is a primitive the corresponding wrapper class is returned

Overrides:

getJavaClass in class XMLField

Parameters:

qname - The qualified name of the XML Schema type to use as a key in the lookup

Returns:

The class associated with the specified schema type, if no corresponding match found returns null

getJavaClass

public Class<?> getJavaClass(QName qname,
 ConversionManager conversionManager)

INTERNAL

Specified by:

getJavaClass in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

getJavaClass in class XMLField

Parameters:

qname - The qualified name of the XML Schema type to use as a key in the lookup

Returns:

the class for a given qualified XML Schema type.

Since:

EclipseLink 2.6.0

isSchemaType

public boolean isSchemaType(QName schemaType)

INTERNAL

Specified by:

isSchemaType in interface Field<XMLConversionManager,NamespaceResolver>

Overrides:

isSchemaType in class XMLField