|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||
java.lang.Objectorg.eclipse.persistence.internal.helper.DatabaseField
org.eclipse.persistence.oxm.XMLField
org.eclipse.persistence.oxm.XMLUnionField
public class XMLUnionField
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)
XMLField,
XMLConstants,
Serialized Form| Field Summary |
|---|
| Fields inherited from class org.eclipse.persistence.oxm.XMLField |
|---|
userJavaTypes, userXMLTypes |
| Fields inherited from class org.eclipse.persistence.internal.helper.DatabaseField |
|---|
columnDefinition, index, isInsertable, isNullable, isUnique, isUpdatable, length, name, NULL_SQL_TYPE, precision, qualifiedName, scale, sqlType, table, type |
| Constructor Summary | |
|---|---|
XMLUnionField()
Constructs an XMLUnionField |
|
XMLUnionField(java.lang.String xPath)
Constructs an XMLUnionField with the xpath set to the specified xPath |
|
| Method Summary | |
|---|---|
void |
addSchemaType(javax.xml.namespace.QName value)
Adds the new type value to the list of types |
java.lang.Object |
convertValueBasedOnSchemaType(java.lang.Object value,
org.eclipse.persistence.internal.oxm.XMLConversionManager xmlConversionManager)
INTERNAL: |
java.lang.Class |
getJavaClass(javax.xml.namespace.QName qname)
Return the class for a given qualified XML Schema type. |
javax.xml.namespace.QName |
getSchemaType()
Return the first schema type in the list of schema types |
java.util.ArrayList |
getSchemaTypes()
Return the list of schema types |
boolean |
isUnionField()
INTERNAL: returns true since this is a union field |
void |
setSchemaType(javax.xml.namespace.QName value)
Adds the new type value to the list of types |
void |
setSchemaTypes(java.util.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.internal.helper.DatabaseField |
|---|
clone, equals, equals, getColumnDefinition, getIndex, getLength, getName, getPrecision, getQualifiedName, getScale, getSqlType, getTable, getTableName, getType, hashCode, hasTableName, initDDLFields, isInsertable, isNullable, isObjectRelationalDatabaseField, isReadOnly, isUnique, isUpdatable, resetQualifiedName, setColumnDefinition, setIndex, setInsertable, setLength, setNullable, setPrecision, setScale, setSqlType, setTable, setTableName, setType, setUnique, setUpdatable, toString |
| Methods inherited from class java.lang.Object |
|---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
| Constructor Detail |
|---|
public XMLUnionField()
public XMLUnionField(java.lang.String xPath)
xPath - The xpath expression for the field| Method Detail |
|---|
public java.util.ArrayList getSchemaTypes()
public void setSchemaTypes(java.util.ArrayList value)
value - An ArrayList containing the schema types.XMLConstantspublic void addSchemaType(javax.xml.namespace.QName value)
value - QName to be added to the list of schema typespublic javax.xml.namespace.QName getSchemaType()
getSchemaType in class XMLFieldpublic void setSchemaType(javax.xml.namespace.QName value)
setSchemaType in class XMLFieldvalue - The value to be added to the list of schema typespublic boolean isUnionField()
isUnionField in class XMLField
public java.lang.Object convertValueBasedOnSchemaType(java.lang.Object value,
org.eclipse.persistence.internal.oxm.XMLConversionManager xmlConversionManager)
convertValueBasedOnSchemaType in class XMLFieldpublic java.lang.Class getJavaClass(javax.xml.namespace.QName qname)
getJavaClass in class XMLFieldqname - The qualified name of the XML Schema type to use as a key in the lookup
|
EclipseLink 1.1.0_ 1.1.0.r3634 API Reference | |||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
| SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | |||||||||