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:

Serializable, 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
String	buildBase64StringFromBytes(byte[] bytes)
String	buildBase64StringFromObjectBytes(Byte[] bytes)
QName	buildQNameFromString(String stringValue, AbstractUnmarshalRecord record)
Object	clone() INTERNAL:
String	collapseStringValue(String value) Removes all leading and trailing whitespaces, and replaces any sequences of whitespaces that occur in the string with a single ' ' character.
String	convertArrayToString(Object[] sourceObject, QName schemaType)
Object	convertHexBinaryListToByteArrayList(Object sourceObject, CoreContainerPolicy containerPolicy, CoreAbstractSession session)
String	convertListToString(Object sourceObject, QName schemaType)
Object	convertObject(Object sourceObject, Class javaClass) Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.
Object	convertObject(Object sourceObject, Class javaClass, QName schemaTypeQName) Convert the given object to the appropriate type by invoking the appropriate ConversionManager method.
Object	convertSchemaBase64ListToByteArrayList(Object sourceObject, CoreContainerPolicy containerPolicy, CoreAbstractSession session)
byte[]	convertSchemaBase64ToByteArray(Object sourceObject) INTERNAL: Converts a String which is in Base64 format to a Byte[]
Calendar	convertStringToCalendar(String sourceString, QName schemaTypeQName)
Date	convertStringToDate(String sourceString, QName schemaType)
Duration	convertStringToDuration(String sourceString) Return a Duration created with a given date string.
Object	convertStringToList(Object sourceObject, Class elementType, ContainerPolicy containerPolicy, 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.
Timestamp	convertStringToTimestamp(String sourceString, QName schemaType)
XMLGregorianCalendar	convertStringToXMLGregorianCalendar(String sourceString) Return an XMLGregorianCalander created with a given date string
XMLGregorianCalendar	convertStringToXMLGregorianCalendar(String sourceString, QName schemaTypeQName)
static HashMap	getDefaultJavaTypes()
static XMLConversionManager	getDefaultXMLManager()
static HashMap	getDefaultXMLTypes()
TimeZone	getTimeZone() Return the specified TimeZone used for all String to date object conversions.
boolean	isTimeZoneQualified()
Class<?>	javaType(QName schemaType)
String	normalizeStringValue(String value) Replaces any CR, Tab or LF characters in the string with a single ' ' character.
QName	schemaType(Class<?> javaType)
void	setTimeZone(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
String	stringFromCalendar(Calendar sourceCalendar, QName schemaTypeQName)
String	stringFromDate(Date sourceDate, 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 TimeZone getTimeZone()

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

Specified by:

getTimeZone in interface TimeZoneHolder

setTimeZone

public void setTimeZone(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 Object convertObject(Object sourceObject,
                            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 Object convertObject(Object sourceObject,
                            Class javaClass,
                            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 XMLGregorianCalendar convertStringToXMLGregorianCalendar(String sourceString,
                                                                QName schemaTypeQName)

convertStringToXMLGregorianCalendar

public XMLGregorianCalendar convertStringToXMLGregorianCalendar(String sourceString)

Return an XMLGregorianCalander created with a given date string

Parameters:

dateString -

Returns:

convertStringToDuration

public Duration convertStringToDuration(String sourceString)

Return a Duration created with a given date string.

Parameters:

dateString -

Returns:

convertStringToCalendar

public Calendar convertStringToCalendar(String sourceString,
                                        QName schemaTypeQName)

convertStringToTimestamp

public Timestamp convertStringToTimestamp(String sourceString,
                                          QName schemaType)

stringFromCalendar

public String stringFromCalendar(Calendar sourceCalendar,
                                 QName schemaTypeQName)

convertStringToDate

public Date convertStringToDate(String sourceString,
                                QName schemaType)

stringFromDate

public String stringFromDate(Date sourceDate,
                             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(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 Object convertSchemaBase64ListToByteArrayList(Object sourceObject,
                                                     CoreContainerPolicy containerPolicy,
                                                     CoreAbstractSession session)
                                              throws ConversionException

Specified by:

convertSchemaBase64ListToByteArrayList in interface ConversionManager

Throws:

ConversionException

buildBase64StringFromBytes

public String buildBase64StringFromBytes(byte[] bytes)

Specified by:

buildBase64StringFromBytes in interface ConversionManager

buildBase64StringFromObjectBytes

public String buildBase64StringFromObjectBytes(Byte[] bytes)

convertStringToList

public Object convertStringToList(Object sourceObject,
                                  Class elementType,
                                  ContainerPolicy containerPolicy,
                                  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 String convertListToString(Object sourceObject,
                                  QName schemaType)
                           throws ConversionException

Throws:

ConversionException

convertArrayToString

public String convertArrayToString(Object[] sourceObject,
                                   QName schemaType)
                            throws ConversionException

Throws:

ConversionException

getDefaultXMLTypes

public static HashMap getDefaultXMLTypes()

getDefaultJavaTypes

public static HashMap getDefaultJavaTypes()

clone

public Object clone()

INTERNAL:

Overrides:

clone in class ConversionManager

buildQNameFromString

public QName buildQNameFromString(String stringValue,
                                  AbstractUnmarshalRecord record)

Specified by:

buildQNameFromString in interface ConversionManager

normalizeStringValue

public String normalizeStringValue(String value)

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

Specified by:

normalizeStringValue in interface ConversionManager

collapseStringValue

public String collapseStringValue(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 Class<?> javaType(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 QName schemaType(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 Object convertHexBinaryListToByteArrayList(Object sourceObject,
                                                  CoreContainerPolicy containerPolicy,
                                                  CoreAbstractSession session)

Specified by:

convertHexBinaryListToByteArrayList in interface ConversionManager