java.lang.Object
org.eclipse.persistence.sdo.helper.SDODataHelper
All Implemented Interfaces:
DataHelper

public class SDODataHelper extends Object implements DataHelper

Purpose: A helper class for performing data conversions.

  • Constructor Details

    • SDODataHelper

      public SDODataHelper()
    • SDODataHelper

      public SDODataHelper(HelperContext aContext)
  • Method Details

    • setTimeZone

      public void setTimeZone(TimeZone timeZone)
      The specified TimeZone will be used for all String to Date object conversions. By default the GMT time zone is used.
    • setTimeZoneQualified

      public 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. By default time information is not time zone qualified.
    • toCalendar

      public Calendar toCalendar(String dateString)
      Convert from a String representation of an SDO date type to a Calendar using the default locale. Same as toCalendar(dateString, null).
      Specified by:
      toCalendar in interface DataHelper
      Parameters:
      dateString - the String representation of an SDO date type
      Returns:
      a Calendar representation of an SDO date type.
      Throws:
      IllegalArgumentException - for invalid formats.
    • toCalendar

      public Calendar toCalendar(String dateString, 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.
      Specified by:
      toCalendar in interface DataHelper
      Parameters:
      dateString - the String representation of an SDO date type
      locale - the locale or null for default locale.
      Returns:
      a Calendar representation of an SDO date type.
      Throws:
      IllegalArgumentException - for invalid formats.
    • toDate

      public Date toDate(String dateString)
      Convert from a String representation of the Date type to a Date.
      Specified by:
      toDate in interface DataHelper
      Parameters:
      dateString - a String representation of the Date type
      Returns:
      a Date from a String representation of the Date type.
    • toDateTime

      public String toDateTime(Calendar calendar)
      Convert from a Calendar to a String representation of the DateTime type.
      Specified by:
      toDateTime in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the DateTime type.
    • toDateTime

      public String toDateTime(Date date)
      Convert from a Date to a String representation of the DateTime type.
      Specified by:
      toDateTime in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the DateTime type.
    • toDay

      public String toDay(Calendar calendar)
      Convert from a Calendar to a String representation of the Day type.
      Specified by:
      toDay in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the Day type.
    • toDay

      public String toDay(Date date)
      Convert from a Date to a String representation of the Day type.
      Specified by:
      toDay in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the Day type.
    • toDuration

      public String toDuration(Calendar calendar)
      Convert from a Calendar to a String representation of the Duration type.
      Specified by:
      toDuration in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the Duration type.
    • toDuration

      public String toDuration(Date date)
      Convert from a Date to a String representation of the Duration type.
      Specified by:
      toDuration in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the Duration type.
    • toMonth

      public String toMonth(Calendar calendar)
      Convert from a Calendar to a String representation of the Month type.
      Specified by:
      toMonth in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the Month type.
    • toMonth

      public String toMonth(Date date)
      Convert from a Date to a String representation of the Month type.
      Specified by:
      toMonth in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the Month type.
    • toMonthDay

      public String toMonthDay(Calendar calendar)
      Convert from a Calendar to a String representation of the MonthDay type.
      Specified by:
      toMonthDay in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the MonthDay type.
    • toMonthDay

      public String toMonthDay(Date date)
      Convert from a Date to a String representation of the MonthDay type.
      Specified by:
      toMonthDay in interface DataHelper
      Parameters:
      date - the date to convert
      Returns:
      a Date to a String representation of the MonthDay type.
    • toTime

      public String toTime(Calendar calendar)
      Convert from a Calendar to a String representation of the Time type.
      Specified by:
      toTime in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the Time type.
    • toTime

      public String toTime(Date date)
      Convert from a Date to a String representation of the Time type.
      Specified by:
      toTime in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the Time type.
    • toYear

      public String toYear(Calendar calendar)
      Convert from a Calendar to a String representation of the Year type.
      Specified by:
      toYear in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the Year type.
    • toYear

      public String toYear(Date date)
      Convert from a Date to a String representation of the Year type.
      Specified by:
      toYear in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the Year type.
    • toYearMonth

      public String toYearMonth(Date date)
      Convert from a Date to a String representation of the YearMonth type.
      Specified by:
      toYearMonth in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the YearMonth type.
    • toYearMonthDay

      public String toYearMonthDay(Date date)
      Convert from a Date to a String representation of the YearMonthDay type.
      Specified by:
      toYearMonthDay in interface DataHelper
      Parameters:
      date - the date
      Returns:
      a Date to a String representation of the YearMonthDay type.
    • toYearMonth

      public String toYearMonth(Calendar calendar)
      Convert from a Calendar to a String representation of the YearMonth type.
      Specified by:
      toYearMonth in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the YearMonth type.
    • toYearMonthDay

      public String toYearMonthDay(Calendar calendar)
      Convert from a Calendar to a String representation of the YearMonthDay type.
      Specified by:
      toYearMonthDay in interface DataHelper
      Parameters:
      calendar - the calendar to convert
      Returns:
      a Calendar to a String representation of the YearMonthDay type.
    • convertValue

      public Object convertValue(Object value, Class<?> convertClass, QName schemaType)
      Convert a value based to the appropriate type.
      Parameters:
      value - The value to convert.
      convertClass - The class to convert the value to.
      schemaType - The schema type if available.
      Returns:
      the original value converted based on the convertClass parameter.
    • convertFromStringValue

      public Object convertFromStringValue(String value, Class<?> convertClass)
      Convert a String value based to the appropriate type.
      Parameters:
      value - The String value to convert.
      convertClass - The class to convert the value to.
      Returns:
      the original value converted based on the convertClass parameter.
    • convertFromStringValue

      public Object convertFromStringValue(String value, Type sdoType)
      Convert a String value based to the appropriate type.
      Parameters:
      value - The String value to convert.
      sdoType - The SDO type of the value to convert the value to.
      Returns:
      the original value converted based on the SDO type.
    • convertFromStringValue

      public Object convertFromStringValue(String value, Type sdoType, QName schemaType)
      Convert a String value based to the appropriate type.
      Parameters:
      value - The String value to convert.
      sdoType - The SDO type of the value to convert the value to.
      schemaType - The schema type if available.
      Returns:
      the original value converted based on the convertClass parameter.
    • convertFromStringValue

      public Object convertFromStringValue(String value, Class<?> convertClass, QName schemaType)
      Convert a String value based to the appropriate type.
      Parameters:
      value - The String value to convert.
      convertClass - The class to convert the value to.
      schemaType - The schema type if available.
      Returns:
      the original value converted based on the convertClass parameter.
    • convertToStringValue

      public String convertToStringValue(Object value, Type sdoType)
      Convert to a String value based to the SDO type.
      Parameters:
      value - The value to convert.
      sdoType - the SDO type
      Returns:
      the original value converted to a String based on the SDO type specified.
    • convert

      public Object convert(Type type, Object value)
      Convert the specified value to an instance of the specified type. Supported conversions are listed in Section 14 of the SDO specification.
      Specified by:
      convert in interface DataHelper
      Parameters:
      type - the target data type.
      value - the value to convert
      Returns:
      a value of the specified type's instance class
      Throws:
      IllegalArgumentException - if the value could not be converted
      See Also:
    • convert

      public Object convert(Property property, Object value)
      Convert the specified value to an 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.
      Specified by:
      convert in interface DataHelper
      Parameters:
      property - the target data type property.
      value - the value or List of values to convert
      Returns:
      a converted value or list of converted values
      Throws:
      IllegalArgumentException - if the value could not be converted
      See Also:
    • convertValueToClass

      public Object convertValueToClass(Property prop, Object valueToConvert, Class<?> convertToClass)
      INTERNAL:
    • getHelperContext

      public HelperContext getHelperContext()
      INTERNAL:
    • setHelperContext

      public void setHelperContext(HelperContext helperContext)
      INTERNAL: