public class SDODataHelper extends java.lang.Object implements DataHelper
Purpose: A helper class for performing data conversions.
INSTANCE
Constructor and Description |
---|
SDODataHelper() |
SDODataHelper(HelperContext aContext) |
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
convert(Property property,
java.lang.Object value)
|
java.lang.Object |
convert(Type type,
java.lang.Object value)
Convert the specified value to an
instance of the specified type. |
java.lang.Object |
convertFromStringValue(java.lang.String value,
java.lang.Class convertClass)
Convert a String value based to the appropriate type.
|
java.lang.Object |
convertFromStringValue(java.lang.String value,
java.lang.Class convertClass,
javax.xml.namespace.QName schemaType)
Convert a String value based to the appropriate type.
|
java.lang.Object |
convertFromStringValue(java.lang.String value,
Type sdoType)
Convert a String value based to the appropriate type.
|
java.lang.Object |
convertFromStringValue(java.lang.String value,
Type sdoType,
javax.xml.namespace.QName schemaType)
Convert a String value based to the appropriate type.
|
java.lang.String |
convertToStringValue(java.lang.Object value,
Type sdoType)
Convert to a String value based to the SDO type.
|
java.lang.Object |
convertValue(java.lang.Object value,
java.lang.Class convertClass,
javax.xml.namespace.QName schemaType)
Convert a value based to the appropriate type.
|
java.lang.Object |
convertValueToClass(Property prop,
java.lang.Object valueToConvert,
java.lang.Class convertToClass)
INTERNAL:
|
HelperContext |
getHelperContext()
INTERNAL:
|
void |
setHelperContext(HelperContext helperContext)
INTERNAL:
|
void |
setTimeZone(java.util.TimeZone timeZone)
The specified TimeZone will be used for all String to Date object
conversions.
|
void |
setTimeZoneQualified(boolean timeZoneQualified)
By setting this flag to true the marshalled date objects marshalled to
the XML schema types time and dateTime will be qualified by a time zone.
|
java.util.Calendar |
toCalendar(java.lang.String dateString)
Convert from a String representation of an SDO date type to a Calendar
using the default locale.
|
java.util.Calendar |
toCalendar(java.lang.String dateString,
java.util.Locale locale)
Convert from a String representation of an SDO date type to a Calendar
using the specified locale, or the default locale if the locale is null.
|
java.util.Date |
toDate(java.lang.String dateString)
Convert from a String representation of the Date type to a Date.
|
java.lang.String |
toDateTime(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the DateTime type.
|
java.lang.String |
toDateTime(java.util.Date date)
Convert from a Date to a String representation of the DateTime type.
|
java.lang.String |
toDay(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the Day type.
|
java.lang.String |
toDay(java.util.Date date)
Convert from a Date to a String representation of the Day type.
|
java.lang.String |
toDuration(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the Duration type.
|
java.lang.String |
toDuration(java.util.Date date)
Convert from a Date to a String representation of the Duration type.
|
java.lang.String |
toMonth(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the Month type.
|
java.lang.String |
toMonth(java.util.Date date)
Convert from a Date to a String representation of the Month type.
|
java.lang.String |
toMonthDay(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the MonthDay type.
|
java.lang.String |
toMonthDay(java.util.Date date)
Convert from a Date to a String representation of the MonthDay type.
|
java.lang.String |
toTime(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the Time type.
|
java.lang.String |
toTime(java.util.Date date)
Convert from a Date to a String representation of the Time type.
|
java.lang.String |
toYear(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the Year type.
|
java.lang.String |
toYear(java.util.Date date)
Convert from a Date to a String representation of the Year type.
|
java.lang.String |
toYearMonth(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the YearMonth type.
|
java.lang.String |
toYearMonth(java.util.Date date)
Convert from a Date to a String representation of the YearMonth type.
|
java.lang.String |
toYearMonthDay(java.util.Calendar calendar)
Convert from a Calendar to a String representation of the YearMonthDay
type.
|
java.lang.String |
toYearMonthDay(java.util.Date date)
Convert from a Date to a String representation of the YearMonthDay type.
|
public SDODataHelper()
public SDODataHelper(HelperContext aContext)
public void setTimeZone(java.util.TimeZone timeZone)
public void setTimeZoneQualified(boolean timeZoneQualified)
public java.util.Calendar toCalendar(java.lang.String dateString)
toCalendar
in interface DataHelper
dateString
- the String representation of an SDO date typejava.lang.IllegalArgumentException
- for invalid formats.public java.util.Calendar toCalendar(java.lang.String dateString, java.util.Locale locale)
toCalendar
in interface DataHelper
dateString
- the String representation of an SDO date typelocale
- the locale or null for default locale.java.lang.IllegalArgumentException
- for invalid formats.public java.util.Date toDate(java.lang.String dateString)
toDate
in interface DataHelper
dateString
- a String representation of the Date typepublic java.lang.String toDateTime(java.util.Calendar calendar)
toDateTime
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toDateTime(java.util.Date date)
toDateTime
in interface DataHelper
date
- the datepublic java.lang.String toDay(java.util.Calendar calendar)
toDay
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toDay(java.util.Date date)
toDay
in interface DataHelper
date
- the datepublic java.lang.String toDuration(java.util.Calendar calendar)
toDuration
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toDuration(java.util.Date date)
toDuration
in interface DataHelper
date
- the datepublic java.lang.String toMonth(java.util.Calendar calendar)
toMonth
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toMonth(java.util.Date date)
toMonth
in interface DataHelper
date
- the datepublic java.lang.String toMonthDay(java.util.Calendar calendar)
toMonthDay
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toMonthDay(java.util.Date date)
toMonthDay
in interface DataHelper
date
- the date to convertpublic java.lang.String toTime(java.util.Calendar calendar)
toTime
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toTime(java.util.Date date)
toTime
in interface DataHelper
date
- the datepublic java.lang.String toYear(java.util.Calendar calendar)
toYear
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toYear(java.util.Date date)
toYear
in interface DataHelper
date
- the datepublic java.lang.String toYearMonth(java.util.Date date)
toYearMonth
in interface DataHelper
date
- the datepublic java.lang.String toYearMonthDay(java.util.Date date)
toYearMonthDay
in interface DataHelper
date
- the datepublic java.lang.String toYearMonth(java.util.Calendar calendar)
toYearMonth
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.String toYearMonthDay(java.util.Calendar calendar)
toYearMonthDay
in interface DataHelper
calendar
- the calendar to convertpublic java.lang.Object convertValue(java.lang.Object value, java.lang.Class convertClass, javax.xml.namespace.QName schemaType)
value
- The value to convert.convertClass
- The class to convert the value to.schemaType
- The schema type if available.public java.lang.Object convertFromStringValue(java.lang.String value, java.lang.Class convertClass)
value
- The String value to convert.convertClass
- The class to convert the value to.public java.lang.Object convertFromStringValue(java.lang.String value, Type sdoType)
value
- The String value to convert.sdoType
- The SDO type of the value to convert the value to.public java.lang.Object convertFromStringValue(java.lang.String value, Type sdoType, javax.xml.namespace.QName schemaType)
value
- The String value to convert.sdoType
- The SDO type of the value to convert the value to.schemaType
- The schema type if available.public java.lang.Object convertFromStringValue(java.lang.String value, java.lang.Class convertClass, javax.xml.namespace.QName schemaType)
value
- The String value to convert.convertClass
- The class to convert the value to.schemaType
- The schema type if available.public java.lang.String convertToStringValue(java.lang.Object value, Type sdoType)
value
- The value to convert.sdoType
- the SDO typepublic java.lang.Object convert(Type type, java.lang.Object value)
instance
of the specified type. Supported conversions are listed in
Section 14 of the SDO specification.convert
in interface DataHelper
type
- the target data type
.value
- the value to convertjava.lang.IllegalArgumentException
- if the value could not be convertedconvert(Property, Object)
public java.lang.Object convert(Property property, java.lang.Object value)
instance
of the specified property's type
.
The specified value must be a List if the property is
many valued
. In this case, all the values in
the List are converted.convert
in interface DataHelper
property
- the target data type
property.value
- the value or List of values to convertjava.lang.IllegalArgumentException
- if the value could not be convertedconvert(Type, Object)
public java.lang.Object convertValueToClass(Property prop, java.lang.Object valueToConvert, java.lang.Class convertToClass)
public HelperContext getHelperContext()
public void setHelperContext(HelperContext helperContext)