/*
 * 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.
 *
 * Other licenses:
 * -----------------------------------------------------------------------------
 * Commercial licenses for this work are available. These replace the above
 * ASL 2.0 and offer limited warranties, support, maintenance, and commercial
 * database integrations.
 *
 * For more information, please visit: http://www.jooq.org/licenses
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 *
 */
package org.jooq.tools;

import static java.time.temporal.ChronoField.INSTANT_SECONDS;
import static java.time.temporal.ChronoField.MILLI_OF_DAY;
import static java.time.temporal.ChronoField.MILLI_OF_SECOND;
import static org.jooq.tools.reflect.Reflect.accessible;
import static org.jooq.tools.reflect.Reflect.wrapper;
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.io.StringReader;
import java.io.StringWriter;
import java.lang.reflect.Array;
import java.lang.reflect.Constructor;
import java.lang.reflect.Method;
import java.math.BigDecimal;
import java.math.BigInteger;
import java.net.URI;
import java.net.URL;
import java.nio.ByteBuffer;
import java.sql.Date;
import java.sql.Struct;
import java.sql.Time;
import java.sql.Timestamp;
import java.time.Instant;
import java.time.LocalDate;
import java.time.LocalDateTime;
import java.time.LocalTime;
import java.time.OffsetDateTime;
import java.time.OffsetTime;
import java.time.format.DateTimeParseException;
import java.time.temporal.Temporal;
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.Optional;
import java.util.Set;
import java.util.UUID;
import java.util.regex.Pattern;

import javax.xml.bind.JAXB;

// ...
import org.jooq.Converter;
import org.jooq.EnumType;
import org.jooq.Field;
import org.jooq.JSON;
import org.jooq.JSONB;
import org.jooq.Record;
import org.jooq.SQLDialect;
import org.jooq.UDTRecord;
import org.jooq.XML;
import org.jooq.exception.DataTypeException;
import org.jooq.impl.IdentityConverter;
import org.jooq.tools.jdbc.MockArray;
import org.jooq.tools.reflect.Reflect;
import org.jooq.types.UByte;
import org.jooq.types.UInteger;
import org.jooq.types.ULong;
import org.jooq.types.UShort;
import org.jooq.util.xml.jaxb.InformationSchema;

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<?,? extends Object>) and convert(Object, Class<? extends Object>), trying to retrofit the Object argument to the type provided in Converter.fromType() before performing the actual conversion.

Author:Lukas Eder
/** * Utility methods for type conversions * <p> * 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 <code>Object</code> argument to the type provided in * {@link Converter#fromType()} before performing the actual conversion. * * @author Lukas Eder */
public final class Convert { private static final JooqLogger log = JooqLogger.getLogger(Convert.class);
All string values that can be transformed into a boolean true value.
/** * All string values that can be transformed into a boolean <code>true</code> value. */
public static final Set<String> TRUE_VALUES;
All string values that can be transformed into a boolean false value.
/** * All string values that can be transformed into a boolean <code>false</code> value. */
public static final Set<String> FALSE_VALUES;
A UUID pattern for UUIDs with or without hyphens
/** * 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})");
The Jackson ObjectMapper or Gson instance, if available.
/** * The Jackson ObjectMapper or Gson instance, if available. */
private static final Object JSON_MAPPER;
The Jackson ObjectMapper::readValue or Gson::fromJson method, if available.
/** * The Jackson ObjectMapper::readValue or Gson::fromJson method, if available. */
private static final Method JSON_READ_METHOD;
Whether a JAXB implementation is available.
/** * Whether a JAXB implementation is available. */
private static final boolean JAXB_AVAILABLE; static { Set<String> trueValues = new HashSet<>(); Set<String> 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("t"); trueValues.add("T"); 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("f"); falseValues.add("F"); falseValues.add("off"); falseValues.add("OFF"); falseValues.add("disabled"); falseValues.add("DISABLED"); TRUE_VALUES = Collections.unmodifiableSet(trueValues); FALSE_VALUES = Collections.unmodifiableSet(falseValues); Object jsonMapper = null; Method jsonReadMethod = null; boolean jaxbAvailable = false; try { Class<?> klass = Class.forName("com.fasterxml.jackson.databind.ObjectMapper"); jsonMapper = klass.getConstructor().newInstance(); jsonReadMethod = klass.getMethod("readValue", String.class, Class.class); log.debug("Jackson is available"); } catch (Exception e1) { log.debug("Jackson not available", e1.getMessage()); try { Class<?> klass = Class.forName("com.google.gson.Gson"); jsonMapper = klass.getConstructor().newInstance(); jsonReadMethod = klass.getMethod("fromJson", String.class, Class.class); log.debug("Gson is available"); } catch (Exception e2) { log.debug("Gson not available", e2.getMessage()); } } JSON_MAPPER = jsonMapper; JSON_READ_METHOD = jsonReadMethod; try { JAXB.marshal(new InformationSchema(), new StringWriter()); jaxbAvailable = true; log.debug("JAXB is available"); } // [#10145] Depending on whether jOOQ is modularised or not, this can also // be a NoClassDefFoundError. catch (Throwable t) { log.debug("JAXB not available", t.getMessage()); } JAXB_AVAILABLE = jaxbAvailable; }
Convert an array of values to a matching data type

This converts values[i] to fields[i].getType()

/** * Convert an array of values to a matching data type * <p> * This converts <code>values[i]</code> to <code>fields[i].getType()</code> */
public static final Object[] convert(Object[] values, Field<?>[] fields) { if (values == null) return null; // [#1005] Convert values from the <code>VALUES</code> clause to appropriate // values as specified by the <code>INTO</code> clause's column list. Object[] result = new Object[values.length]; // TODO [#1008] Should fields be cast? Check this with // appropriate integration tests for (int i = 0; i < values.length; i++) if (values[i] instanceof Field<?>) result[i] = values[i]; else result[i] = convert(values[i], fields[i].getType()); return result; }
Convert an array of values to a matching data type

This converts values[i] to types[i]

/** * Convert an array of values to a matching data type * <p> * This converts <code>values[i]</code> to <code>types[i]</code> */
public static final Object[] convert(Object[] values, Class<?>[] types) { if (values == null) return null; // [#1005] Convert values from the <code>VALUES</code> clause to appropriate // values as specified by the <code>INTO</code> clause's column list. Object[] result = new Object[values.length]; // TODO [#1008] Should fields be cast? Check this with // appropriate integration tests for (int i = 0; i < values.length; i++) if (values[i] instanceof Field<?>) result[i] = values[i]; else result[i] = convert(values[i], types[i]); return result; }
Convert an array into another one using a converter

This uses convertArray(Object[], Class<?>) to convert the array to an array of Converter.fromType() first, before converting that array again to Converter.toType()

Params:
  • from – The array to convert
  • converter – The data type converter
Throws:
Returns:A converted array
/** * Convert an array into another one using a converter * <p> * 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> U[] convertArray(Object[] from, Converter<?, ? extends U> converter) throws DataTypeException { if (from == null) return null; 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 convert(Object, Class<? extends Object>)
Params:
  • from – The array to convert
  • toClass – The target array type
Throws:
Returns:A converted array
/** * Convert an array into another one by these rules * <p> * <ul> * <li>If <code>toClass</code> is not an array class, then make it an array * class first</li> * <li>If <code>toClass</code> is an array class, then create an instance * from it, and convert all elements in the <code>from</code> array one by * one, using {@link #convert(Object, Class)}</li> * </ul> * * @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<? extends Object[]>) toClass); else if (from[0] != null && from[0].getClass() == toComponentType) return Arrays.copyOf(from, from.length, (Class<? extends Object[]>) 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; } } } public static final <U> U[] convertCollection(Collection from, Class<? extends U[]> to){ return new ConvertAll<U[]>(to).from(from); }
Convert an object to a type.
Params:
  • from – The source object
  • converter – The data type converter
Throws:
Returns:The target type object
/** * 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 */
@SuppressWarnings("unchecked") public static final <U> U convert(Object from, Converter<?, ? extends U> converter) throws DataTypeException { // [#5865] [#6799] [#11099] This leads to significant performance improvements especially when // used from MockResultSet, which is likely to host IdentityConverters if (converter instanceof IdentityConverter) return (U) from; else return convert0(from, converter); }
Conversion type-safety
/** * Conversion type-safety */
@SuppressWarnings("unchecked") private static final <T, U> U convert0(Object from, Converter<T, ? extends U> converter) throws DataTypeException { Class<T> fromType = converter.fromType(); if (fromType == Object.class) return converter.from((T) from); ConvertAll<T> convertAll = new ConvertAll<>(fromType); return converter.from(convertAll.from(from)); }
Convert an object to a type. These are the conversion rules:
  • null is always converted to null, or the primitive default value, or Optional.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 other Number types
  • All Number or String types can be converted to Boolean. Possible (case-insensitive) values for true:
    • 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 most Temporal subtypes ( LocalDate, LocalTime, LocalDateTime, OffsetTime, OffsetDateTime, as well as Instant) can be converted into each other.
  • All String types can be converted into URI, URL and File
  • byte[] can be converted into String, using the platform's default charset
  • Object[] 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
Params:
  • from – The object to convert
  • toClass – The target type
Throws:
Returns:The converted object
/** * Convert an object to a type. These are the conversion rules: * <ul> * <li><code>null</code> is always converted to <code>null</code>, or the * primitive default value, or {@link Optional#empty()}, regardless of the * target type.</li> * <li>Identity conversion (converting a value to its own type) is always * possible.</li> * <li>Primitive types can be converted to their wrapper types and vice * versa</li> * <li>All types can be converted to <code>String</code></li> * <li>All types can be converted to <code>Object</code></li> * <li>All <code>Number</code> types can be converted to other * <code>Number</code> types</li> * <li>All <code>Number</code> or <code>String</code> types can be converted * to <code>Boolean</code>. Possible (case-insensitive) values for * <code>true</code>: * <ul> * <li><code>1</code></li> * <li><code>1.0</code></li> * <li><code>y</code></li> * <li><code>yes</code></li> * <li><code>true</code></li> * <li><code>on</code></li> * <li><code>enabled</code></li> * </ul> * <p> * Possible (case-insensitive) values for <code>false</code>: * <ul> * <li><code>0</code></li> * <li><code>0.0</code></li> * <li><code>n</code></li> * <li><code>no</code></li> * <li><code>false</code></li> * <li><code>off</code></li> * <li><code>disabled</code></li> * </ul> * <p> * All other values evaluate to <code>null</code></li> * <li>All {@link java.util.Date} subtypes ({@link Date}, {@link Time}, * {@link Timestamp}), as well as most {@link Temporal} subtypes ( * {@link LocalDate}, {@link LocalTime}, {@link LocalDateTime}, * {@link OffsetTime}, {@link OffsetDateTime}, as well as {@link Instant}) * can be converted into each other.</li> * <li>All <code>String</code> types can be converted into {@link URI}, * {@link URL} and {@link File}</li> * <li><code>byte[]</code> can be converted into <code>String</code>, using * the platform's default charset</li> * <li><code>Object[]</code> can be converted into any other array type, if * array elements can be converted, too</li> * <li>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.</li> * <li><b>All other combinations that are not listed above will result in a * {@link DataTypeException}</b></li> * </ul> * * @param from The object to convert * @param toClass The target type * @return The converted object * @throws DataTypeException - When the conversion is not possible */
@SuppressWarnings("unchecked") public static final <T> T convert(Object from, Class<? extends T> toClass) throws DataTypeException { if (from != null && from.getClass() == toClass) return (T) from; else return convert0(from, new ConvertAll<T>(toClass)); }
Convert a collection of objects to a list of T, using convert(Object, Class<? extends Object>)
Params:
  • collection – The list of objects
  • type – The target type
Throws:
See Also:
Returns:The list of converted objects
/** * Convert a collection of objects to a list of <code>T</code>, 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 <T> List<T> convert(Collection<?> collection, Class<? extends T> type) throws DataTypeException { return convert(collection, new ConvertAll<>(type)); }
Convert a collection of objects to a list of T, using convert(Object, Converter<?,? extends Object>)
Params:
  • collection – The collection of objects
  • converter – The data type converter
Throws:
See Also:
Returns:The list of converted objects
/** * Convert a collection of objects to a list of <code>T</code>, 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 <U> List<U> convert(Collection<?> collection, Converter<?, ? extends U> converter) throws DataTypeException { return convert0(collection, converter); }
Type safe conversion
/** * Type safe conversion */
private static final <T, U> List<U> convert0(Collection<?> collection, Converter<T, ? extends U> converter) throws DataTypeException { ConvertAll<T> all = new ConvertAll<>(converter.fromType()); List<U> result = new ArrayList<>(collection.size()); for (Object o : collection) result.add(convert(all.from(o), converter)); return result; }
No instances
/** * No instances */
private Convert() {}
The converter to convert them all.
/** * The converter to convert them all. */
private static class ConvertAll<U> implements Converter<Object, U> {
Generated UID
/** * Generated UID */
private static final long serialVersionUID = 2508560107067092501L; private final Class<? extends U> toClass; ConvertAll(Class<? extends U> 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 if (toClass == Optional.class) return (U) Optional.empty(); else return null; } else { final Class<?> fromClass = from.getClass(); final Class<?> wrapperTo; final Class<?> wrapperFrom; // 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; // [#6790] No conversion for primitive / wrapper conversions else if ((wrapperTo = wrapper(toClass)) == (wrapperFrom = wrapper(fromClass))) return (U) from; // Regular checks else if (fromClass == byte[].class) { // [#5824] UUID's most significant bits in byte[] are first if (toClass == UUID.class) { ByteBuffer b = ByteBuffer.wrap((byte[]) from); long mostSigBits = b.getLong(); long leastSigBits = b.getLong(); return (U) new UUID(mostSigBits, leastSigBits); } // [#5569] Binary data is expected to be in JVM's default encoding else { return convert(new String((byte[]) from), toClass); } } else if (fromClass.isArray()) { Object[] fromArray = (Object[]) from; // [#3062] [#5796] Default collections if no specific collection type was requested if (Collection.class.isAssignableFrom(toClass) && toClass.isAssignableFrom(ArrayList.class)) return (U) new ArrayList<>(Arrays.asList(fromArray)); else if (Collection.class.isAssignableFrom(toClass) && toClass.isAssignableFrom(LinkedHashSet.class)) return (U) new LinkedHashSet<>(Arrays.asList(fromArray)); // [#3443] Conversion from Object[] to JDBC Array else if (toClass == java.sql.Array.class) return (U) new MockArray(null, fromArray, fromClass); else return (U) convertArray(fromArray, toClass); } // [#3062] Default collections if no specific collection type was requested else if (Collection.class.isAssignableFrom(fromClass) ) { Object[] fromArray = ((Collection<?>) from).toArray(); // [#3443] [#10704] Conversion from Object[] to JDBC Array if (toClass == java.sql.Array.class) return (U) new MockArray(null, fromArray, fromClass); else return (U) convertArray(fromArray, toClass); } else if (toClass == Optional.class) return (U) Optional.of(from); // 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(); } // [#5569] It should be possible, at least, to convert an empty string to an empty (var)binary. else if (toClass == byte[].class) { // [#5824] UUID's most significant bits in byte[] are first if (from instanceof UUID) { ByteBuffer b = ByteBuffer.wrap(new byte[16]); b.putLong(((UUID) from).getMostSignificantBits()); b.putLong(((UUID) from).getLeastSignificantBits()); return (U)b.array(); } else { return (U) from.toString().getBytes(); } } // Various number types are converted between each other via String else if (wrapperTo == Byte.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Byte.valueOf(((Number) from).byteValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? Byte.valueOf((byte) 1) : Byte.valueOf((byte) 0)); try { String fromString = from.toString().trim(); Integer asInt = Ints.tryParse(fromString); return (U) Byte.valueOf(asInt != null ? asInt.byteValue() : new BigDecimal(fromString).byteValue()); } catch (NumberFormatException e) { return Reflect.initValue(toClass); } } else if (wrapperTo == Short.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Short.valueOf(((Number) from).shortValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? Short.valueOf((short) 1) : Short.valueOf((short) 0)); try { String fromString = from.toString().trim(); Integer asInt = Ints.tryParse(fromString); return (U) Short.valueOf(asInt != null ? asInt.shortValue() : new BigDecimal(fromString).shortValue()); } catch (NumberFormatException e) { return Reflect.initValue(toClass); } } else if (wrapperTo == Integer.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Integer.valueOf(((Number) from).intValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? Integer.valueOf(1) : Integer.valueOf(0)); try { String fromString = from.toString().trim(); Integer asInt = Ints.tryParse(fromString); return (U) Integer.valueOf(asInt != null ? asInt.intValue() : new BigDecimal(fromString).intValue()); } catch (NumberFormatException e) { return Reflect.initValue(toClass); } } else if (wrapperTo == Long.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Long.valueOf(((Number) from).longValue()); if (wrapperFrom == 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()); } if (Temporal.class.isAssignableFrom(fromClass)) { return (U) Long.valueOf(millis((Temporal) from)); } try { String fromString = from.toString().trim(); Long asLong = Longs.tryParse(fromString); return (U) Long.valueOf(asLong != null ? asLong.longValue() : new BigDecimal(fromString).longValue()); } catch (NumberFormatException e) { return Reflect.initValue(toClass); } } // ... this also includes unsigned number types else if (toClass == UByte.class) { try { if (Number.class.isAssignableFrom(fromClass)) return (U) ubyte(((Number) from).shortValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? ubyte(1) : ubyte(0)); String fromString = from.toString().trim(); Integer asInt = Ints.tryParse(fromString); return (U) ubyte(asInt != null ? asInt.shortValue() : new BigDecimal(fromString).shortValue()); } catch (NumberFormatException e) { return null; } } else if (toClass == UShort.class) { try { if (Number.class.isAssignableFrom(fromClass)) return (U) ushort(((Number) from).intValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? ushort(1) : ushort(0)); String fromString = from.toString().trim(); Integer asInt = Ints.tryParse(fromString); return (U) ushort(asInt != null ? asInt.intValue() : new BigDecimal(fromString).intValue()); } catch (NumberFormatException e) { return null; } } else if (toClass == UInteger.class) { try { if (Number.class.isAssignableFrom(fromClass)) return (U) uint(((Number) from).longValue()); if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? uint(1) : uint(0)); String fromString = from.toString().trim(); Long asLong = Longs.tryParse(fromString); return (U) uint(asLong != null ? asLong.longValue() : new BigDecimal(fromString).longValue()); } catch (NumberFormatException e) { return null; } } else if (toClass == ULong.class) { if (wrapperFrom == 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()); if (Temporal.class.isAssignableFrom(fromClass)) return (U) ulong(millis((Temporal) from)); try { String fromString = from.toString().trim(); // tryParse() will return null in case of overflow Long asLong = Longs.tryParse(fromString); return asLong != null ? (U) ulong(asLong.longValue()) : (U) ulong(new BigDecimal(fromString).toBigInteger()); } catch (NumberFormatException e) { return null; } } // ... and floating point / fixed point types else if (wrapperTo == Float.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Float.valueOf(((Number) from).floatValue()); if (wrapperFrom == 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 Reflect.initValue(toClass); } } else if (wrapperTo == Double.class) { if (Number.class.isAssignableFrom(fromClass)) return (U) Double.valueOf(((Number) from).doubleValue()); if (wrapperFrom == 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 Reflect.initValue(toClass); } } else if (toClass == BigDecimal.class) { if (wrapperFrom == 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 (wrapperFrom == 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 (wrapperTo == 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 (wrapperTo == Character.class) { if (wrapperFrom == Boolean.class) return (U) (((Boolean) from) ? Character.valueOf('1') : Character.valueOf('0')); if (from.toString().length() < 1) return Reflect.initValue(toClass); return (U) Character.valueOf(from.toString().charAt(0)); } // 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; } } // Date types can be converted among each other else if (java.util.Date.class.isAssignableFrom(fromClass)) { return toDate(((java.util.Date) from).getTime(), toClass); } else if (Temporal.class.isAssignableFrom(fromClass)) { return toDate(convert(from, Long.class), toClass); } // Long may also be converted into a date type else if (wrapperFrom == Long.class && java.util.Date.class.isAssignableFrom(toClass)) { return toDate((Long) from, toClass); } else if (wrapperFrom == Long.class && Temporal.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; } } else if (fromClass == String.class && toClass == LocalDate.class) { // Try "lenient" ISO date formats first try { return (U) java.sql.Date.valueOf((String) from).toLocalDate(); } catch (IllegalArgumentException e1) { try { return (U) LocalDate.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } else if (fromClass == String.class && toClass == LocalTime.class) { // Try "lenient" ISO date formats first try { return (U) java.sql.Time.valueOf((String) from).toLocalTime(); } catch (IllegalArgumentException e1) { try { return (U) LocalTime.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } else if (fromClass == String.class && toClass == OffsetTime.class) { // Try "local" ISO date formats first try { return (U) java.sql.Time.valueOf((String) from).toLocalTime().atOffset(OffsetTime.now().getOffset()); } catch (IllegalArgumentException e1) { try { return (U) OffsetTime.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } else if (fromClass == String.class && toClass == LocalDateTime.class) { // Try "lenient" ISO date formats first try { return (U) java.sql.Timestamp.valueOf((String) from).toLocalDateTime(); } catch (IllegalArgumentException e1) { try { return (U) LocalDateTime.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } else if (fromClass == String.class && toClass == OffsetDateTime.class) { // Try "local" ISO date formats first try { return (U) java.sql.Timestamp.valueOf((String) from).toLocalDateTime().atOffset(OffsetDateTime.now().getOffset()); } catch (IllegalArgumentException e1) { try { return (U) OffsetDateTime.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } else if (fromClass == String.class && toClass == Instant.class) { // Try "local" ISO date formats first try { return (U) java.sql.Timestamp.valueOf((String) from).toLocalDateTime().atOffset(OffsetDateTime.now().getOffset()).toInstant(); } catch (IllegalArgumentException e1) { try { return (U) Instant.parse((String) from); } catch (DateTimeParseException e2) { return null; } } } // [#1448] [#6255] [#5720] To Enum conversion else if (java.lang.Enum.class.isAssignableFrom(toClass) && (fromClass == String.class || from instanceof Enum || from instanceof EnumType)) { try { String fromString = (fromClass == String.class) ? (String) from : (from instanceof EnumType) ? ((EnumType) from).getLiteral() : ((Enum) from).name(); if (fromString == null) return null; if (EnumType.class.isAssignableFrom(toClass)) { for (Object value : toClass.getEnumConstants()) if (fromString.equals(((EnumType) value).getLiteral())) return (U) value; return null; } else { return (U) java.lang.Enum.valueOf((Class) toClass, fromString); } } 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; } } // [#8943] JSON data types can be read from Strings else if (fromClass == String.class && toClass == JSON.class) { return (U) JSON.valueOf((String) from); } // [#8943] JSONB data types can be read from Strings else if (fromClass == String.class && toClass == JSONB.class) { return (U) JSONB.valueOf((String) from); } // [#10072] Out of the box Jackson JSON mapping support else if (fromClass == JSON.class && JSON_MAPPER != null) { try { return (U) JSON_READ_METHOD.invoke(JSON_MAPPER, ((JSON) from).data(), toClass); } catch (Exception e) { throw new DataTypeException("Error while mapping JSON to POJO using Jackson", e); } } // [#10072] Out of the box Jackson JSON mapping support else if (fromClass == JSONB.class && JSON_MAPPER != null) { try { return (U) JSON_READ_METHOD.invoke(JSON_MAPPER, ((JSONB) from).data(), toClass); } catch (Exception e) { throw new DataTypeException("Error while mapping JSON to POJO using Jackson", e); } } // [#10072] Out of the box JAXB mapping support else if (fromClass == XML.class && JAXB_AVAILABLE) { try { return JAXB.unmarshal(new StringReader(((XML) from).data()), toClass); } catch (Exception e) { throw new DataTypeException("Error while mapping XML to POJO using JAXB", e); } } // [#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); } else if (Struct.class.isAssignableFrom(fromClass)) { Struct struct = (Struct) from; if (UDTRecord.class.isAssignableFrom(toClass)) { try { UDTRecord<?> record = ((UDTRecord<?>) toClass.newInstance()); record.from(struct.getAttributes()); return (U) record; } catch (Exception e) { throw new DataTypeException("Cannot convert from " + fromClass + " to " + toClass, e); } } } // TODO [#2520] When RecordUnmappers are supported, they should also be considered here // [#10229] Try public, single argument, applicable constructors first for (Constructor<?> constructor : toClass.getConstructors()) { Class<?>[] types = constructor.getParameterTypes(); if (types.length == 1) { try { return (U) constructor.newInstance(convert(from, types[0])); } // Throw exception further down instead catch (Exception ignore) {} } } // [#10229] Try private, single argument, applicable constructors for (Constructor<?> constructor : toClass.getDeclaredConstructors()) { Class<?>[] types = constructor.getParameterTypes(); if (types.length == 1) { try { return (U) accessible(constructor).newInstance(convert(from, types[0])); } // Throw exception further down instead catch (Exception ignore) {} } } } throw fail(from, toClass); } @Override public Object to(U to) { return to; } @Override public Class<Object> fromType() { return Object.class; } @SuppressWarnings("unchecked") @Override public Class<U> toType() { return (Class<U>) toClass; }
Convert a long timestamp to any date type
/** * Convert a long timestamp to any date type */
@SuppressWarnings("unchecked") private static <X> X toDate(long time, Class<X> toClass) { if (toClass == Date.class) return (X) new Date(time); else if (toClass == Time.class) return (X) new Time(time); else if (toClass == Timestamp.class) return (X) new Timestamp(time); else if (toClass == java.util.Date.class) return (X) new java.util.Date(time); else if (toClass == Calendar.class) { Calendar calendar = Calendar.getInstance(); calendar.setTimeInMillis(time); return (X) calendar; } else if (toClass == LocalDate.class) return (X) new Date(time).toLocalDate(); else if (toClass == LocalTime.class) return (X) new Time(time).toLocalTime(); else if (toClass == OffsetTime.class) return (X) new Time(time).toLocalTime().atOffset(OffsetTime.now().getOffset()); else if (toClass == LocalDateTime.class) return (X) new Timestamp(time).toLocalDateTime(); else if (toClass == OffsetDateTime.class) return (X) new Timestamp(time).toLocalDateTime().atOffset(OffsetDateTime.now().getOffset()); else if (toClass == Instant.class) return (X) Instant.ofEpochMilli(time); throw fail(time, toClass); } private static final long millis(Temporal temporal) { // java.sql.* temporal types: if (temporal instanceof LocalDate) return Date.valueOf((LocalDate) temporal).getTime(); else if (temporal instanceof LocalTime) return Time.valueOf((LocalTime) temporal).getTime(); else if (temporal instanceof LocalDateTime) return Timestamp.valueOf((LocalDateTime) temporal).getTime(); // OffsetDateTime else if (temporal.isSupported(INSTANT_SECONDS)) return 1000 * temporal.getLong(INSTANT_SECONDS) + temporal.getLong(MILLI_OF_SECOND); // OffsetTime else if (temporal.isSupported(MILLI_OF_DAY)) return temporal.getLong(MILLI_OF_DAY); throw fail(temporal, Long.class); }
Some databases do not implement the standard very well. Specifically, SQLDialect.SYBASE seems to omit hyphens
/** * Some databases do not implement the standard very well. Specifically, * {@link SQLDialect#SYBASE} seems to omit hyphens */
private static final UUID parseUUID(String string) { if (string == null) return null; else if (string.contains("-")) return UUID.fromString(string); else return UUID.fromString(UUID_PATTERN.matcher(string).replaceAll("$1-$2-$3-$4-$5")); } private static DataTypeException fail(Object from, Class<?> toClass) { String message = "Cannot convert from " + from + " (" + from.getClass() + ") to " + toClass; // [#10072] [#11023] Some mappings may not have worked because of badly set up classpaths if ((from instanceof JSON || from instanceof JSONB) && JSON_MAPPER == null) return new DataTypeException(message + ". Check your classpath to see if Jackson or Gson is available to jOOQ."); else if (from instanceof XML && !JAXB_AVAILABLE) return new DataTypeException(message + ". Check your classpath to see if JAXB is available to jOOQ."); else return new DataTypeException(message); } } }