|
EclipseLink1.0 - 20080707 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 FormField 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 fieldMethod Detail |
---|
public java.util.ArrayList getSchemaTypes()
public void setSchemaTypes(java.util.ArrayList value)
value
- An ArrayList containing the schema types.XMLConstants
public 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 XMLField
public void setSchemaType(javax.xml.namespace.QName value)
setSchemaType
in class XMLField
value
- 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 XMLField
public java.lang.Class getJavaClass(javax.xml.namespace.QName qname)
getJavaClass
in class XMLField
qname
- The qualified name of the XML Schema type to use as a key in the lookup
|
EclipseLink1.0 - 20080707 API Reference | ||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |