-
- All Known Implementing Classes:
SDODataHelper
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 Deprecated Methods Modifier and Type Method Description Object
convert(Property property, Object value)
Object
convert(Type type, Object value)
Convert the specified value to aninstance
of the specified type.Calendar
toCalendar(String dateString)
Convert from a String representation of an SDO date type to a Calendar using the default locale.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.Date
toDate(String dateString)
Convert from a String representation of an SDO date type to a Date.String
toDateTime(Calendar calendar)
Convert from a Calendar to a String representation of the DateTime type.String
toDateTime(Date date)
Convert from a Date to a String representation of the DateTime type.String
toDay(Calendar calendar)
Convert from a Calendar to a String representation of the Day type.String
toDay(Date date)
Convert from a Date to a String representation of the Day type.String
toDuration(Calendar calendar)
Deprecated.There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged.String
toDuration(Date date)
Deprecated.There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged.String
toMonth(Calendar calendar)
Convert from a Calendar to a String representation of the Month type.String
toMonth(Date date)
Convert from a Date to a String representation of the Month type.String
toMonthDay(Calendar calendar)
Convert from a Calendar to a String representation of the MonthDay type.String
toMonthDay(Date date)
Convert from a Date to a String representation of the MonthDay type.String
toTime(Calendar calendar)
Convert from a Calendar to a String representation of the Time type.String
toTime(Date date)
Convert from a Date to a String representation of the Time type.String
toYear(Calendar calendar)
Convert from a Calendar to a String representation of the Year type.String
toYear(Date date)
Convert from a Date to a String representation of the Year type.String
toYearMonth(Calendar calendar)
Convert from a Calendar to a String representation of the YearMonth type.String
toYearMonth(Date date)
Convert from a Date to a String representation of the YearMonth type.String
toYearMonthDay(Calendar calendar)
Convert from a Calendar to a String representation of the YearMonthDay type.String
toYearMonthDay(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
Date toDate(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:
IllegalArgumentException
- for invalid formats.
-
toCalendar
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).- 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
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.- Parameters:
dateString
- the String representation of an SDO date typelocale
- the locale or null for default locale.- Returns:
- a Calendar representation of an SDO date type.
- Throws:
IllegalArgumentException
- for invalid formats.
-
toDateTime
String toDateTime(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
String toDuration(Date date)
Deprecated.There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. 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
String toTime(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
String toDay(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
String toMonth(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
String toMonthDay(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
String toYear(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
String toYearMonth(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
String toYearMonthDay(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
String toDateTime(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
String toDuration(Calendar calendar)
Deprecated.There is no accepted algorithm to convert a date into a Duration so use of this method is discouraged. 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
String toTime(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
String toDay(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
String toMonth(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
String toMonthDay(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
String toYear(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
String toYearMonth(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
String toYearMonthDay(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
Object convert(Type type, Object value)
Convert the specified value to aninstance
of the specified type. Supported conversions are listed in Section 16 of the SDO specification.- Parameters:
type
- the targetdata 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(Property, Object)
-
convert
Object convert(Property property, Object value)
Convert the specified value to aninstance
of the specified property'stype
. The specified value must be a List if the property ismany valued
. In this case, all the values in the List are converted.- Parameters:
property
- the targetdata 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:
convert(Type, Object)
-
-