org.eclipse.persistence.internal.oxm

Class XMLConversionManager

java.lang.Object

org.eclipse.persistence.internal.core.helper.CoreConversionManager

org.eclipse.persistence.internal.helper.ConversionManager

org.eclipse.persistence.internal.oxm.XMLConversionManager

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, TimeZoneHolder, ConversionManager

public class XMLConversionManager
extends ConversionManager
implements ConversionManager, TimeZoneHolder

INTERNAL:

Purpose: Primarily used to convert objects from a given XML Schema type to a different type in Java. Uses a singleton instance

Since:

OracleAS TopLink 10g

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
XMLConversionManager()

Method Summary

Modifier and Type	Method and Description
java.lang.String	buildBase64StringFromBytes(byte[] bytes)
java.lang.String	buildBase64StringFromObjectBytes(java.lang.Byte[] bytes)
javax.xml.namespace.QName	buildQNameFromString(java.lang.String stringValue, AbstractUnmarshalRecord record)
java.lang.Object	clone() INTERNAL:
java.lang.String	collapseStringValue(java.lang.String value) Removes all leading and trailing whitespaces, and replaces any sequences of whitespaces that occur in the string with a single ' ' character.
java.lang.String	convertArrayToString(java.lang.Object[] sourceObject, javax.xml.namespace.QName schemaType)
java.lang.Object	convertHexBinaryListToByteArrayList(java.lang.Object sourceObject, CoreContainerPolicy containerPolicy, CoreAbstractSession session)
java.lang.String	convertListToString(java.lang.Object sourceObject, javax.xml.namespace.QName schemaType)
java.lang.Object	convertObject(java.lang.Object sourceObject, java.lang.Class javaClass) Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.
java.lang.Object	convertObject(java.lang.Object sourceObject, java.lang.Class javaClass, javax.xml.namespace.QName schemaTypeQName) Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.
java.lang.Object	convertSchemaBase64ListToByteArrayList(java.lang.Object sourceObject, CoreContainerPolicy containerPolicy, CoreAbstractSession session)
byte[]	convertSchemaBase64ToByteArray(java.lang.Object sourceObject) INTERNAL: Converts a String which is in Base64 format to a Byte[]
java.util.Calendar	convertStringToCalendar(java.lang.String sourceString, javax.xml.namespace.QName schemaTypeQName)
java.util.Date	convertStringToDate(java.lang.String sourceString, javax.xml.namespace.QName schemaType)
javax.xml.datatype.Duration	convertStringToDuration(java.lang.String sourceString) Return a Duration created with a given date string.
java.lang.Object	convertStringToList(java.lang.Object sourceObject, java.lang.Class elementType, ContainerPolicy containerPolicy, javax.xml.namespace.QName schemaType) Convert the given sourceObject (String) to the appropriate collection type specified by the containerPolicy, using the elementType to properly convert each element of the list.
java.sql.Timestamp	convertStringToTimestamp(java.lang.String sourceString, javax.xml.namespace.QName schemaType)
javax.xml.datatype.XMLGregorianCalendar	convertStringToXMLGregorianCalendar(java.lang.String sourceString) Return an XMLGregorianCalander created with a given date string
javax.xml.datatype.XMLGregorianCalendar	convertStringToXMLGregorianCalendar(java.lang.String sourceString, javax.xml.namespace.QName schemaTypeQName)
static java.util.HashMap	getDefaultJavaTypes()
static XMLConversionManager	getDefaultXMLManager()
static java.util.HashMap	getDefaultXMLTypes()
java.util.TimeZone	getTimeZone() Return the specified TimeZone used for all String to date object conversions.
boolean	isTimeZoneQualified()
java.lang.Class<?>	javaType(javax.xml.namespace.QName schemaType)
java.lang.String	normalizeStringValue(java.lang.String value) Replaces any CR, Tab or LF characters in the string with a single ' ' character.
javax.xml.namespace.QName	schemaType(java.lang.Class<?> javaType)
void	setTimeZone(java.util.TimeZone timeZone) The specified TimeZone will be used for all String to date object conversions.
void	setTimeZoneQualified(boolean timeZoneQualified) Specify if Specify if when date objects are converted to Strings in the XML Schema time or dateTime format
java.lang.String	stringFromCalendar(java.util.Calendar sourceCalendar, javax.xml.namespace.QName schemaTypeQName)
java.lang.String	stringFromDate(java.util.Date sourceDate, javax.xml.namespace.QName schemaType) This method returns a string representing a given java.util.Date based on a given schema type QName.

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

convertClassNameToClass, getDataTypesConvertedFrom, getDataTypesConvertedTo, getDefaultLoader, getDefaultManager, getDefaultNullValue, getDefaultNullValues, getLoader, getObjectClass, getPrimitiveClass, hasDefaultNullValues, loadClass, setDefaultLoader, setDefaultManager, setDefaultNullValue, setDefaultNullValues, setLoader, setShouldUseClassLoaderFromCurrentThread, shouldUseClassLoaderFromCurrentThread

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

XMLConversionManager

public XMLConversionManager()

Method Detail

getDefaultXMLManager

public static XMLConversionManager getDefaultXMLManager()

getTimeZone

public java.util.TimeZone getTimeZone()

Return the specified TimeZone used for all String to date object conversions.

Specified by:

getTimeZone in interface TimeZoneHolder

setTimeZone

public void setTimeZone(java.util.TimeZone timeZone)

The specified TimeZone will be used for all String to date object conversions. By default the TimeZone from the JVM is used.

isTimeZoneQualified

public boolean isTimeZoneQualified()

setTimeZoneQualified

public void setTimeZoneQualified(boolean timeZoneQualified)

Specify if Specify if when date objects are converted to Strings in the XML Schema time or dateTime format

convertObject

public java.lang.Object convertObject(java.lang.Object sourceObject,
                                      java.lang.Class javaClass)
                               throws ConversionException

Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.

Overrides:

convertObject in class ConversionManager

Parameters:

sourceObject - - will always be a string if read from XML

javaClass - - the class that the object must be converted to

Returns:

- the newly converted object

Throws:

ConversionException

convertObject

public java.lang.Object convertObject(java.lang.Object sourceObject,
                                      java.lang.Class javaClass,
                                      javax.xml.namespace.QName schemaTypeQName)
                               throws ConversionException

Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.

Specified by:

convertObject in interface ConversionManager

Parameters:

sourceObject - - will always be a string if read from XML

javaClass - - the class that the object must be converted to

schemaTypeQName - - the XML schema that the object is being converted from

Returns:

- the newly converted object

Throws:

ConversionException

convertStringToXMLGregorianCalendar

public javax.xml.datatype.XMLGregorianCalendar convertStringToXMLGregorianCalendar(java.lang.String sourceString,
                                                                                   javax.xml.namespace.QName schemaTypeQName)

convertStringToXMLGregorianCalendar

public javax.xml.datatype.XMLGregorianCalendar convertStringToXMLGregorianCalendar(java.lang.String sourceString)

Return an XMLGregorianCalander created with a given date string

Parameters:

dateString -

Returns:

convertStringToDuration

public javax.xml.datatype.Duration convertStringToDuration(java.lang.String sourceString)

Return a Duration created with a given date string.

Parameters:

dateString -

Returns:

convertStringToCalendar

public java.util.Calendar convertStringToCalendar(java.lang.String sourceString,
                                                  javax.xml.namespace.QName schemaTypeQName)

convertStringToTimestamp

public java.sql.Timestamp convertStringToTimestamp(java.lang.String sourceString,
                                                   javax.xml.namespace.QName schemaType)

stringFromCalendar

public java.lang.String stringFromCalendar(java.util.Calendar sourceCalendar,
                                           javax.xml.namespace.QName schemaTypeQName)

convertStringToDate

public java.util.Date convertStringToDate(java.lang.String sourceString,
                                          javax.xml.namespace.QName schemaType)

stringFromDate

public java.lang.String stringFromDate(java.util.Date sourceDate,
                                       javax.xml.namespace.QName schemaType)

This method returns a string representing a given java.util.Date based on a given schema type QName. BC dates (sourceDate.getTime() < YEAR_ONE_AD_TIME) are handled as follows: '2007 BC' --> '-2006 AD'.

Parameters:

sourceDate -

schemaType -

Returns:

convertSchemaBase64ToByteArray

public byte[] convertSchemaBase64ToByteArray(java.lang.Object sourceObject)
                                      throws ConversionException

INTERNAL: Converts a String which is in Base64 format to a Byte[]

Specified by:

convertSchemaBase64ToByteArray in interface ConversionManager

Throws:

ConversionException

convertSchemaBase64ListToByteArrayList

public java.lang.Object convertSchemaBase64ListToByteArrayList(java.lang.Object sourceObject,
                                                               CoreContainerPolicy containerPolicy,
                                                               CoreAbstractSession session)
                                                        throws ConversionException

Specified by:

convertSchemaBase64ListToByteArrayList in interface ConversionManager

Throws:

ConversionException

buildBase64StringFromBytes

public java.lang.String buildBase64StringFromBytes(byte[] bytes)

Specified by:

buildBase64StringFromBytes in interface ConversionManager

buildBase64StringFromObjectBytes

public java.lang.String buildBase64StringFromObjectBytes(java.lang.Byte[] bytes)

convertStringToList

public java.lang.Object convertStringToList(java.lang.Object sourceObject,
                                            java.lang.Class elementType,
                                            ContainerPolicy containerPolicy,
                                            javax.xml.namespace.QName schemaType)
                                     throws ConversionException

Convert the given sourceObject (String) to the appropriate collection type specified by the containerPolicy, using the elementType to properly convert each element of the list.

Parameters:

sourceObject - - will always be a string if read from XML

elementType - - the type of the elements contained in the list

Returns:

- the newly converted object

Throws:

ConversionException

convertListToString

public java.lang.String convertListToString(java.lang.Object sourceObject,
                                            javax.xml.namespace.QName schemaType)
                                     throws ConversionException

Throws:

ConversionException

convertArrayToString

public java.lang.String convertArrayToString(java.lang.Object[] sourceObject,
                                             javax.xml.namespace.QName schemaType)
                                      throws ConversionException

Throws:

ConversionException

getDefaultXMLTypes

public static java.util.HashMap getDefaultXMLTypes()

getDefaultJavaTypes

public static java.util.HashMap getDefaultJavaTypes()

clone

public java.lang.Object clone()

INTERNAL:

Overrides:

clone in class ConversionManager

buildQNameFromString

public javax.xml.namespace.QName buildQNameFromString(java.lang.String stringValue,
                                                      AbstractUnmarshalRecord record)

Specified by:

buildQNameFromString in interface ConversionManager

normalizeStringValue

public java.lang.String normalizeStringValue(java.lang.String value)

Replaces any CR, Tab or LF characters in the string with a single ' ' character.

Specified by:

normalizeStringValue in interface ConversionManager

collapseStringValue

public java.lang.String collapseStringValue(java.lang.String value)

Removes all leading and trailing whitespaces, and replaces any sequences of whitespaces that occur in the string with a single ' ' character.

Specified by:

collapseStringValue in interface ConversionManager

javaType

public java.lang.Class<?> javaType(javax.xml.namespace.QName schemaType)

Specified by:

javaType in interface ConversionManager

Parameters:

schemaType - The type you want to find a corresponding Java class for.

Returns:

the Java class for the XML schema type.

Since:

EclipseLink 2.6.0

schemaType

public javax.xml.namespace.QName schemaType(java.lang.Class<?> javaType)

Specified by:

schemaType in interface ConversionManager

Parameters:

javaType - The type you want to find a corresponding schema type for.

Returns:

the schema type for the Java class.

Since:

EclipseLink 2.6.0

convertHexBinaryListToByteArrayList

public java.lang.Object convertHexBinaryListToByteArrayList(java.lang.Object sourceObject,
                                                            CoreContainerPolicy containerPolicy,
                                                            CoreAbstractSession session)

Specified by:

convertHexBinaryListToByteArrayList in interface ConversionManager