Package commonj.sdo.helper

Interface DataHelper

  • public interface DataHelper
    Data helper methods.

    • Field Summary

      Fields 
      Modifier and Type Field Description
      static DataHelper INSTANCE
      The default DataHelper.

    • Method Summary

      All Methods Instance Methods Abstract Methods 
      Modifier and Type Method Description
      java.lang.Object convert​(Property property, java.lang.Object value)
      Convert the specified value to an instance of the specified property's type.
      java.lang.Object convert​(Type type, java.lang.Object value)
      Convert the specified value to an instance of the specified type.
      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 an SDO 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.

    • Field Detail

      • INSTANCE

        static final DataHelper INSTANCE
        The default DataHelper.

    • Method Detail

      • toDate

        java.util.Date toDate​(java.lang.String dateString)
        Convert from a String representation of an SDO date type to a Date.
        Parameters:
        dateString - the String representation of an SDO date type
        Returns:
        a Date representation of an SDO date type.
        Throws:
        java.lang.IllegalArgumentException - for invalid formats.

      • toCalendar

        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. Same as toCalendar(dateString, null).
        Parameters:
        dateString - the String representation of an SDO date type
        Returns:
        a Calendar representation of an SDO date type.
        Throws:
        java.lang.IllegalArgumentException - for invalid formats.

      • toCalendar

        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.
        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:
        java.lang.IllegalArgumentException - for invalid formats.

      • toDateTime

        java.lang.String toDateTime​(java.util.Date date)
        Convert from a Date to a String representation of the DateTime type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the DateTime type.

      • toDuration

        java.lang.String toDuration​(java.util.Date date)
        Convert from a Date to a String representation of the Duration type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the Duration type.

      • toTime

        java.lang.String toTime​(java.util.Date date)
        Convert from a Date to a String representation of the Time type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the Time type.

      • toDay

        java.lang.String toDay​(java.util.Date date)
        Convert from a Date to a String representation of the Day type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the Day type.

      • toMonth

        java.lang.String toMonth​(java.util.Date date)
        Convert from a Date to a String representation of the Month type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the Month type.

      • toMonthDay

        java.lang.String toMonthDay​(java.util.Date date)
        Convert from a Date to a String representation of the MonthDay type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the MonthDay type.

      • toYear

        java.lang.String toYear​(java.util.Date date)
        Convert from a Date to a String representation of the Year type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the Year type.

      • toYearMonth

        java.lang.String toYearMonth​(java.util.Date date)
        Convert from a Date to a String representation of the YearMonth type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the YearMonth type.

      • toYearMonthDay

        java.lang.String toYearMonthDay​(java.util.Date date)
        Convert from a Date to a String representation of the YearMonthDay type.
        Parameters:
        date - the date
        Returns:
        a Date to a String representation of the YearMonthDay type.

      • toDateTime

        java.lang.String toDateTime​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the DateTime type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the DateTime type.

      • toDuration

        java.lang.String toDuration​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the Duration type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the Duration type.

      • toTime

        java.lang.String toTime​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the Time type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the Time type.

      • toDay

        java.lang.String toDay​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the Day type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the Day type.

      • toMonth

        java.lang.String toMonth​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the Month type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the Month type.

      • toMonthDay

        java.lang.String toMonthDay​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the MonthDay type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the MonthDay type.

      • toYear

        java.lang.String toYear​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the Year type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the Year type.

      • toYearMonth

        java.lang.String toYearMonth​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the YearMonth type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the YearMonth type.

      • toYearMonthDay

        java.lang.String toYearMonthDay​(java.util.Calendar calendar)
        Convert from a Calendar to a String representation of the YearMonthDay type.
        Parameters:
        calendar - the calendar to convert
        Returns:
        a Calendar to a String representation of the YearMonthDay type.

      • convert

        java.lang.Object convert​(Type type,
                         java.lang.Object value)
        Convert the specified value to an instance of the specified type. Supported conversions are listed in Section 16 of the SDO specification.
        Parameters:
        type - the target data type.
        value - the value to convert
        Returns:
        a value of the specified type's instance class
        Throws:
        java.lang.IllegalArgumentException - if the value could not be converted
        See Also:
        convert(Property, Object)

      • convert

        java.lang.Object convert​(Property property,
                         java.lang.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.
        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:
        java.lang.IllegalArgumentException - if the value could not be converted
        See Also:
        convert(Type, Object)