org.jooq.tools.Convert Maven / Gradle / Ivy
/**
* Copyright (c) 2009-2014, Data Geekery GmbH (http://www.datageekery.com)
* All rights reserved.
*
* This work is dual-licensed
* - under the Apache Software License 2.0 (the "ASL")
* - under the jOOQ License and Maintenance Agreement (the "jOOQ License")
* =============================================================================
* You may choose which license applies to you:
*
* - If you're using this work with Open Source databases, you may choose
* either ASL or jOOQ License.
* - If you're using this work with at least one commercial database, you must
* choose jOOQ License
*
* For more information, please visit http://www.jooq.org/licenses
*
* Apache Software License 2.0:
* -----------------------------------------------------------------------------
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* jOOQ License and Maintenance Agreement:
* -----------------------------------------------------------------------------
* Data Geekery grants the Customer the non-exclusive, timely limited and
* non-transferable license to install and use the Software under the terms of
* the jOOQ License and Maintenance Agreement.
*
* This library is distributed with a LIMITED WARRANTY. See the jOOQ License
* and Maintenance Agreement for more details: http://www.jooq.org/licensing
*/
package org.jooq.tools;
import static org.jooq.types.Unsigned.ubyte;
import static org.jooq.types.Unsigned.uint;
import static org.jooq.types.Unsigned.ulong;
import static org.jooq.types.Unsigned.ushort;
import java.io.File;
import java.lang.reflect.Array;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.net.URI;
import java.net.URISyntaxException;
import java.net.URL;
import java.sql.Date;
import java.sql.Time;
import java.sql.Timestamp;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Calendar;
import java.util.Collection;
import java.util.Collections;
import java.util.HashSet;
import java.util.LinkedHashSet;
import java.util.List;
import java.util.Set;
import java.util.UUID;
import java.util.regex.Pattern;
// ...
import org.jooq.Converter;
import org.jooq.EnumType;
import org.jooq.Field;
import org.jooq.Record;
import org.jooq.SQLDialect;
import org.jooq.exception.DataTypeException;
import org.jooq.tools.jdbc.MockArray;
import org.jooq.types.UByte;
import org.jooq.types.UInteger;
import org.jooq.types.ULong;
import org.jooq.types.UShort;
/**
* Utility methods for type conversions
*
* This class provides less type-safety than the general jOOQ API methods. For
* instance, it accepts arbitrary {@link Converter} objects in methods like
* {@link #convert(Collection, Converter)} and {@link #convert(Object, Class)},
* trying to retrofit the Object argument to the type provided in
* {@link Converter#fromType()} before performing the actual conversion.
*
* @author Lukas Eder
*/
public final class Convert {
/**
* All string values that can be transformed into a boolean true value.
*/
public static final Set TRUE_VALUES;
/**
* All string values that can be transformed into a boolean false value.
*/
public static final Set FALSE_VALUES;
/**
* A UUID pattern for UUIDs with or without hyphens
*/
private static final Pattern UUID_PATTERN = Pattern.compile("(\\p{XDigit}{8})-?(\\p{XDigit}{4})-?(\\p{XDigit}{4})-?(\\p{XDigit}{4})-?(\\p{XDigit}{12})");
static {
Set trueValues = new HashSet();
Set falseValues = new HashSet();
trueValues.add("1");
trueValues.add("1.0");
trueValues.add("y");
trueValues.add("Y");
trueValues.add("yes");
trueValues.add("YES");
trueValues.add("true");
trueValues.add("TRUE");
trueValues.add("on");
trueValues.add("ON");
trueValues.add("enabled");
trueValues.add("ENABLED");
falseValues.add("0");
falseValues.add("0.0");
falseValues.add("n");
falseValues.add("N");
falseValues.add("no");
falseValues.add("NO");
falseValues.add("false");
falseValues.add("FALSE");
falseValues.add("off");
falseValues.add("OFF");
falseValues.add("disabled");
falseValues.add("DISABLED");
TRUE_VALUES = Collections.unmodifiableSet(trueValues);
FALSE_VALUES = Collections.unmodifiableSet(falseValues);
}
/**
* Convert an array of values to a matching data type
*
* This converts values[i] to fields[i].getType()
*/
public static final Object[] convert(Object[] values, Field[] fields) {
// [#1005] Convert values from the VALUES clause to appropriate
// values as specified by the INTO clause's column list.
if (values != null) {
Object[] result = new Object[values.length];
for (int i = 0; i < values.length; i++) {
// TODO [#1008] Should fields be cast? Check this with
// appropriate integration tests
if (values[i] instanceof Field) {
result[i] = values[i];
}
else {
result[i] = convert(values[i], fields[i].getType());
}
}
return result;
}
else {
return null;
}
}
/**
* Convert an array of values to a matching data type
*
* This converts values[i] to types[i]
*/
public static final Object[] convert(Object[] values, Class[] types) {
// [#1005] Convert values from the VALUES clause to appropriate
// values as specified by the INTO clause's column list.
if (values != null) {
Object[] result = new Object[values.length];
for (int i = 0; i < values.length; i++) {
// TODO [#1008] Should fields be cast? Check this with
// appropriate integration tests
if (values[i] instanceof Field) {
result[i] = values[i];
}
else {
result[i] = convert(values[i], types[i]);
}
}
return result;
}
else {
return null;
}
}
/**
* Convert an array into another one using a converter
*
* This uses {@link #convertArray(Object[], Class)} to convert the array to
* an array of {@link Converter#fromType()} first, before converting that
* array again to {@link Converter#toType()}
*
* @param from The array to convert
* @param converter The data type converter
* @return A converted array
* @throws DataTypeException - When the conversion is not possible
*/
@SuppressWarnings("unchecked")
public static final U[] convertArray(Object[] from, Converter converter) throws DataTypeException {
if (from == null) {
return null;
}
else {
Object[] arrayOfT = convertArray(from, converter.fromType());
Object[] arrayOfU = (Object[]) Array.newInstance(converter.toType(), from.length);
for (int i = 0; i < arrayOfT.length; i++) {
arrayOfU[i] = convert(arrayOfT[i], converter);
}
return (U[]) arrayOfU;
}
}
/**
* 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 the from array one by
* one, using {@link #convert(Object, Class)}
*
*
* @param from The array to convert
* @param toClass The target array type
* @return A converted array
* @throws DataTypeException - When the conversion is not possible
*/
@SuppressWarnings("unchecked")
public static final Object[] convertArray(Object[] from, Class toClass) throws DataTypeException {
if (from == null) {
return null;
}
else if (!toClass.isArray()) {
return convertArray(from, Array.newInstance(toClass, 0).getClass());
}
else if (toClass == from.getClass()) {
return from;
}
else {
final Class toComponentType = toClass.getComponentType();
if (from.length == 0) {
return Arrays.copyOf(from, from.length, (Class) toClass);
}
else if (from[0] != null && from[0].getClass() == toComponentType) {
return Arrays.copyOf(from, from.length, (Class) toClass);
}
else {
final Object[] result = (Object[]) Array.newInstance(toComponentType, from.length);
for (int i = 0; i < from.length; i++) {
result[i] = convert(from[i], toComponentType);
}
return result;
}
}
}
/**
* Convert an object to a type.
*
* @param from The source object
* @param converter The data type converter
* @return The target type object
* @throws DataTypeException - When the conversion is not possible
*/
public static final U convert(Object from, Converter converter) throws DataTypeException {
return convert0(from, converter);
}
/**
* Conversion type-safety
*/
private static final U convert0(Object from, Converter converter) throws DataTypeException {
ConvertAll all = new ConvertAll(converter.fromType());
return converter.from(all.from(from));
}
/**
* Convert an object to a type. These are the conversion rules:
*
* null is always converted to null,
* regardless of the target type.- Identity conversion (converting a value to its own type) is always
* possible.
* - All types can be converted to
String
* - All types can be converted to
Object
* - All
Number types can be converted to other
* Number types
* - All
Number or String types can be converted
* to Boolean. Possible (case-insensitive) values for
* true:
*
* 11.0yyestrueonenabled
*
* Possible (case-insensitive) values for false:
*
* 00.0nnofalseoffdisabled
*
* All other values evaluate to null
* - All
Date types can be converted into each other
* - All
String types can be converted into {@link URI},
* {@link URL} and {@link File}
* - Primitive target types behave like their wrapper types, except that
*
null is converted into the initialisation value (e.g.
* 0 for int, false for
* boolean)
* byte[] can be converted into String, using
* the platform's default charsetObject[] can be converted into any other array type, if
* array elements can be converted, too- All other combinations that are not listed above will result in a
* {@link DataTypeException}
*
*
* @param from The object to convert
* @param toClass The target type
* @return The converted object
* @throws DataTypeException - When the conversion is not possible
*/
public static final T convert(Object from, Class toClass) throws DataTypeException {
return convert(from, new ConvertAll(toClass));
}
/**
* Convert a collection of objects to a list of T, using
* {@link #convert(Object, Class)}
*
* @param collection The list of objects
* @param type The target type
* @return The list of converted objects
* @throws DataTypeException - When the conversion is not possible
* @see #convert(Object, Class)
*/
public static final List convert(Collection collection, Class type) throws DataTypeException {
return convert(collection, new ConvertAll(type));
}
/**
* Convert a collection of objects to a list of T, using
* {@link #convert(Object, Converter)}
*
* @param collection The collection of objects
* @param converter The data type converter
* @return The list of converted objects
* @throws DataTypeException - When the conversion is not possible
* @see #convert(Object, Converter)
*/
public static final List convert(Collection collection, Converter converter) throws DataTypeException {
return convert0(collection, converter);
}
/**
* Type safe conversion
*/
private static final List convert0(Collection collection, Converter converter) throws DataTypeException {
ConvertAll all = new ConvertAll(converter.fromType());
List result = new ArrayList(collection.size());
for (Object o : collection) {
result.add(convert(all.from(o), converter));
}
return result;
}
/**
* No instances
*/
private Convert() {}
/**
* The converter to convert them all.
*/
private static class ConvertAll implements Converter {
/**
* Generated UID
*/
private static final long serialVersionUID = 2508560107067092501L;
private final Class toClass;
ConvertAll(Class toClass) {
this.toClass = toClass;
}
@SuppressWarnings({ "unchecked", "rawtypes" })
@Override
public U from(Object from) {
if (from == null) {
// [#936] If types are converted to primitives, the result must not
// be null. Return the default value instead
if (toClass.isPrimitive()) {
// Characters default to the "zero" character
if (toClass == char.class) {
return (U) Character.valueOf((char) 0);
}
// All others can be converted from (int) 0
else {
return convert(0, toClass);
}
}
else {
return null;
}
}
else {
final Class fromClass = from.getClass();
// No conversion
if (toClass == fromClass) {
return (U) from;
}
// [#2535] Simple up-casting can be done early
// [#1155] ... up-casting includes (toClass == Object.class)
else if (toClass.isAssignableFrom(fromClass)) {
return (U) from;
}
// Regular checks
else if (fromClass == byte[].class) {
// This may not make much sense. Any other options?
return convert(Arrays.toString((byte[]) from), toClass);
}
else if (fromClass.isArray()) {
// [#3443] Conversion from Object[] to JDBC Array
if (toClass == java.sql.Array.class) {
return (U) new MockArray(null, (Object[]) from, fromClass);
}
else {
return (U) convertArray((Object[]) from, toClass);
}
}
// All types can be converted into String
else if (toClass == String.class) {
if (from instanceof EnumType) {
return (U) ((EnumType) from).getLiteral();
}
return (U) from.toString();
}
// Various number types are converted between each other via String
else if (toClass == Byte.class || toClass == byte.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Byte.valueOf((byte) 1) : Byte.valueOf((byte) 0));
}
try {
return (U) Byte.valueOf(new BigDecimal(from.toString().trim()).byteValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == Short.class || toClass == short.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Short.valueOf((short) 1) : Short.valueOf((short) 0));
}
try {
return (U) Short.valueOf(new BigDecimal(from.toString().trim()).shortValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == Integer.class || toClass == int.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Integer.valueOf(1) : Integer.valueOf(0));
}
try {
return (U) Integer.valueOf(new BigDecimal(from.toString().trim()).intValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == Long.class || toClass == long.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Long.valueOf(1L) : Long.valueOf(0L));
}
if (java.util.Date.class.isAssignableFrom(fromClass)) {
return (U) Long.valueOf(((java.util.Date) from).getTime());
}
try {
return (U) Long.valueOf(new BigDecimal(from.toString().trim()).longValue());
}
catch (NumberFormatException e) {
return null;
}
}
// ... this also includes unsigned number types
else if (toClass == UByte.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? ubyte(1) : ubyte(0));
}
try {
return (U) ubyte(new BigDecimal(from.toString().trim()).shortValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == UShort.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? ushort(1) : ushort(0));
}
try {
return (U) ushort(new BigDecimal(from.toString().trim()).intValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == UInteger.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? uint(1) : uint(0));
}
try {
return (U) uint(new BigDecimal(from.toString().trim()).longValue());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == ULong.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? ulong(1) : ulong(0));
}
if (java.util.Date.class.isAssignableFrom(fromClass)) {
return (U) ulong(((java.util.Date) from).getTime());
}
try {
return (U) ulong(new BigDecimal(from.toString().trim()).toBigInteger().toString());
}
catch (NumberFormatException e) {
return null;
}
}
// ... and floating point / fixed point types
else if (toClass == Float.class || toClass == float.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Float.valueOf(1.0f) : Float.valueOf(0.0f));
}
try {
return (U) Float.valueOf(from.toString().trim());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == Double.class || toClass == double.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Double.valueOf(1.0) : Double.valueOf(0.0));
}
try {
return (U) Double.valueOf(from.toString().trim());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == BigDecimal.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? BigDecimal.ONE : BigDecimal.ZERO);
}
try {
return (U) new BigDecimal(from.toString().trim());
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == BigInteger.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? BigInteger.ONE : BigInteger.ZERO);
}
try {
return (U) new BigDecimal(from.toString().trim()).toBigInteger();
}
catch (NumberFormatException e) {
return null;
}
}
else if (toClass == Boolean.class || toClass == boolean.class) {
String s = from.toString().toLowerCase().trim();
if (TRUE_VALUES.contains(s)) {
return (U) Boolean.TRUE;
}
else if (FALSE_VALUES.contains(s)) {
return (U) Boolean.FALSE;
}
else {
return (U) (toClass == Boolean.class ? null : false);
}
}
else if (toClass == Character.class || toClass == char.class) {
if (fromClass == Boolean.class || fromClass == boolean.class) {
return (U) (((Boolean) from) ? Character.valueOf('1') : Character.valueOf('0'));
}
if (from.toString().length() < 1) {
return null;
}
return (U) Character.valueOf(from.toString().charAt(0));
}
// URI types can be converted from strings
else if ((fromClass == String.class) && toClass == URI.class) {
try {
return (U) new URI(from.toString());
}
catch (URISyntaxException e) {
return null;
}
}
// URI types can be converted from strings
else if ((fromClass == String.class) && toClass == URL.class) {
try {
return (U) new URI(from.toString()).toURL();
}
catch (Exception e) {
return null;
}
}
// File types can be converted from strings
else if ((fromClass == String.class) && toClass == File.class) {
try {
return (U) new File(from.toString());
}
catch (Exception e) {
return null;
}
}
// Date types can be converted among each other
else if (java.util.Date.class.isAssignableFrom(fromClass)) {
return toDate(((java.util.Date) from).getTime(), toClass);
}
// Long may also be converted into a date type
else if ((fromClass == Long.class || fromClass == long.class) && java.util.Date.class.isAssignableFrom(toClass)) {
return toDate((Long) from, toClass);
}
// [#1501] Strings can be converted to java.sql.Date
else if ((fromClass == String.class) && toClass == java.sql.Date.class) {
try {
return (U) java.sql.Date.valueOf((String) from);
}
catch (IllegalArgumentException e) {
return null;
}
}
// [#1501] Strings can be converted to java.sql.Date
else if ((fromClass == String.class) && toClass == java.sql.Time.class) {
try {
return (U) java.sql.Time.valueOf((String) from);
}
catch (IllegalArgumentException e) {
return null;
}
}
// [#1501] Strings can be converted to java.sql.Date
else if ((fromClass == String.class) && toClass == java.sql.Timestamp.class) {
try {
return (U) java.sql.Timestamp.valueOf((String) from);
}
catch (IllegalArgumentException e) {
return null;
}
}
// [#1448] Some users may find it useful to convert string
// literals to Enum values without a Converter
else if ((fromClass == String.class) && java.lang.Enum.class.isAssignableFrom(toClass)) {
try {
return (U) java.lang.Enum.valueOf((Class) toClass, (String) from);
}
catch (IllegalArgumentException e) {
return null;
}
}
// [#1624] UUID data types can be read from Strings
else if ((fromClass == String.class) && toClass == UUID.class) {
try {
return (U) parseUUID((String) from);
}
catch (IllegalArgumentException e) {
return null;
}
}
// [#3023] Record types can be converted using the supplied Configuration's
// RecordMapperProvider
else if (Record.class.isAssignableFrom(fromClass)) {
Record record = (Record) from;
return record.into(toClass);
}
/* [pro] xx
xx xxxxxxx xxxxxx xxxxxx x xxxxx xxxxx xxxxxx xx xxxxxxxxxxx xxxx xxxxxx xxx xxxxxxxxxxx
xxxx xx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx x
xxxxxxxxxxxxxx xxxxxx x xxxxxxxxxxxxxxxx xxxxx
xx xxxxxxx xxxxx xxxx xxxxxxxxxx xxxxxxxxxx xxxx xxxxxxxxx xxx xxxxxxxxx
xx xxxx xxx xxxxx xxxxx xxxx xxxxxx xxxxxx x xxxxx xxxxx
xx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx x
xxx x
xxxxxxxxxxxxxxxxxx xx
xx xxxxxxxxxxxxxxxxxxxxxxxx x
x x xxxxxxxxxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxx
x
xxxx xx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx x
x x xxx xxxxxxxxxxxxxxxxxxxxxxxx
x
xxxx x
x x xxx xxxxxxxxxxxxxxxxxxxx
x
xxxxxxxxxxxxxxxxxxxxxxxxxxx
xxxxxx xxx xx
x
xxxxx xxxxxxxxxx xx x
xxxxx xxx xxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxx xxxx x x xxxxxxxxx x x xx x x xxxxxxxx xxx
x
x
xx xxxxxxx xxxxxxxxxx xx xxxxxxxxxxx xx xxxx xxxxx
xxxx xx xxxxxxxx xx xxxxxxxxxxxxxxxxxxxxx x
xxxxxx xxx xxx xxxxxxxxxxxxxxx xxxxxxxxxxxxx xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
x
xxxx x
xxxxxx xxx xxxxxxxxxxxxxxxxxxxxxxxxxx xxxxxxxxx
x
x
xx [/pro] */
// TODO [#2520] When RecordUnmappers are supported, they should also be considered here
}
throw fail(from, toClass);
}
@Override
public Object to(U to) {
return to;
}
@Override
public Class