java.lang.Object
org.jooq.tools.Convert
Deprecated, for removal: This API element is subject to removal in a future version.
Utility methods for type conversions
This class provides less type-safety than the general jOOQ API methods. For
instance, it accepts arbitrary Converter
objects in methods like
convert(Collection, Converter)
and convert(Object, Class)
,
trying to retrofit the Object
argument to the type provided in
Converter.fromType()
before performing the actual conversion.
- Author:
- Lukas Eder
-
Field Summary
Modifier and TypeFieldDescriptionDeprecated, for removal: This API element is subject to removal in a future version.All string values that can be transformed into a booleanfalse
value.Deprecated, for removal: This API element is subject to removal in a future version.All string values that can be transformed into a booleantrue
value. -
Constructor Summary
ConstructorDescriptionConvert()
Deprecated, for removal: This API element is subject to removal in a future version. -
Method Summary
Modifier and TypeMethodDescriptionstatic final Object[]
Deprecated, for removal: This API element is subject to removal in a future version.Convert an array of values to a matching data typestatic final Object[]
Deprecated, for removal: This API element is subject to removal in a future version.Convert an array of values to a matching data typestatic final <T> T
Deprecated, for removal: This API element is subject to removal in a future version.Convert an object to a type.static final <U> U
Deprecated, for removal: This API element is subject to removal in a future version.Convert an object to a type.static final <T> List<T>
convert
(Collection<?> collection, Class<? extends T> type) Deprecated, for removal: This API element is subject to removal in a future version.Convert a collection of objects to a list ofT
, usingconvert(Object, Class)
static final <U> List<U>
convert
(Collection<?> collection, Converter<?, ? extends U> converter) Deprecated, for removal: This API element is subject to removal in a future version.Convert a collection of objects to a list ofT
, usingconvert(Object, Converter)
static final Object[]
convertArray
(Object[] from, Class<?> toClass) Deprecated, for removal: This API element is subject to removal in a future version.Convert an array into another one by these rulesstatic final <U> U[]
convertArray
(Object[] from, Converter<?, ? extends U> converter) Deprecated, for removal: This API element is subject to removal in a future version.Convert an array into another one using a converterstatic final <U> U[]
convertCollection
(Collection from, Class<? extends U[]> to) Deprecated, for removal: This API element is subject to removal in a future version.
-
Field Details
-
TRUE_VALUES
Deprecated, for removal: This API element is subject to removal in a future version.All string values that can be transformed into a booleantrue
value. -
FALSE_VALUES
Deprecated, for removal: This API element is subject to removal in a future version.All string values that can be transformed into a booleanfalse
value.
-
-
Constructor Details
-
Convert
public Convert()Deprecated, for removal: This API element is subject to removal in a future version.
-
-
Method Details
-
convert
Deprecated, for removal: This API element is subject to removal in a future version.Convert an array of values to a matching data typeThis converts
values[i]
tofields[i].getType()
-
convert
Deprecated, for removal: This API element is subject to removal in a future version.Convert an array of values to a matching data typeThis converts
values[i]
totypes[i]
-
convertArray
public static final <U> U[] convertArray(Object[] from, Converter<?, ? extends U> converter) throws DataTypeExceptionDeprecated, for removal: This API element is subject to removal in a future version.Convert an array into another one using a converterThis uses
convertArray(Object[], Class)
to convert the array to an array ofConverter.fromType()
first, before converting that array again toConverter.toType()
- Parameters:
from
- The array to convertconverter
- The data type converter- Returns:
- A converted array
- Throws:
DataTypeException
- - When the conversion is not possible
-
convertArray
Deprecated, for removal: This API element is subject to removal in a future version.Convert an array into another one by these rules- If
toClass
is not an array class, then make it an array class first - If
toClass
is an array class, then create an instance from it, and convert all elements in thefrom
array one by one, usingconvert(Object, Class)
- Parameters:
from
- The array to converttoClass
- The target array type- Returns:
- A converted array
- Throws:
DataTypeException
- - When the conversion is not possible
- If
-
convertCollection
Deprecated, for removal: This API element is subject to removal in a future version. -
convert
public static final <U> U convert(Object from, Converter<?, ? extends U> converter) throws DataTypeExceptionDeprecated, for removal: This API element is subject to removal in a future version.Convert an object to a type.- Parameters:
from
- The source objectconverter
- The data type converter- Returns:
- The target type object
- Throws:
DataTypeException
- - When the conversion is not possible
-
convert
Deprecated, for removal: This API element is subject to removal in a future version.Convert an object to a type. These are the conversion rules:null
is always converted tonull
, or the primitive default value, orOptional.empty()
, regardless of the target type.- Identity conversion (converting a value to its own type) is always possible.
- Primitive types can be converted to their wrapper types and vice versa
- All types can be converted to
String
- All types can be converted to
Object
- All
Number
types can be converted to otherNumber
types - All
Number
orString
types can be converted toBoolean
. Possible (case-insensitive) values fortrue
:1
1.0
y
yes
true
on
enabled
Possible (case-insensitive) values for
false
:0
0.0
n
no
false
off
disabled
All other values evaluate to
null
- All
Date
subtypes (Date
,Time
,Timestamp
), as well as mostTemporal
subtypes (LocalDate
,LocalTime
,LocalDateTime
,OffsetTime
,OffsetDateTime
, as well asInstant
) can be converted into each other. - All
String
types can be converted intoURI
,URL
andFile
byte[]
andByteBuffer
can be converted into one anotherbyte[]
can be converted intoString
, using the platform's default charsetObject[]
can be converted into any other array type, if array elements can be converted, too- All types can be converted into types containing a single argument constructor whose argument is a type that can be converted to according to the above rules.
- All other combinations that are not listed above will result in a
DataTypeException
- Parameters:
from
- The object to converttoClass
- The target type- Returns:
- The converted object
- Throws:
DataTypeException
- - When the conversion is not possible
-
convert
public static final <T> List<T> convert(Collection<?> collection, Class<? extends T> type) throws DataTypeException Deprecated, for removal: This API element is subject to removal in a future version.Convert a collection of objects to a list ofT
, usingconvert(Object, Class)
- Parameters:
collection
- The list of objectstype
- The target type- Returns:
- The list of converted objects
- Throws:
DataTypeException
- - When the conversion is not possible- See Also:
-
convert
public static final <U> List<U> convert(Collection<?> collection, Converter<?, ? extends U> converter) throws DataTypeExceptionDeprecated, for removal: This API element is subject to removal in a future version.Convert a collection of objects to a list ofT
, usingconvert(Object, Converter)
- Parameters:
collection
- The collection of objectsconverter
- The data type converter- Returns:
- The list of converted objects
- Throws:
DataTypeException
- - When the conversion is not possible- See Also:
-
Converter
implementations, orConverterProvider
provided ones, or implementations attached to fields via generated code, or viaField.convert(Converter)
, orDataType.asConvertedDataType(Converter)
.