org.jooq.impl

Class DefaultDataType<T>

java.lang.Object

org.jooq.impl.DefaultDataType<T>

All Implemented Interfaces:

Serializable, DataType<T>

public class DefaultDataType<T>
extends Object
implements DataType<T>

A common base class for data types.

This also acts as a static data type registry for jOOQ internally.

This type is for JOOQ INTERNAL USE only. Do not reference directly

Author:

Lukas Eder

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
DefaultDataType(SQLDialect dialect, Class<T> type, String typeName)
DefaultDataType(SQLDialect dialect, Class<T> type, String typeName, String castTypeName)
DefaultDataType(SQLDialect dialect, DataType<T> sqlDataType, String typeName)
DefaultDataType(SQLDialect dialect, DataType<T> sqlDataType, String typeName, String castTypeName)

Method Summary

Methods

Modifier and Type	Method and Description
<A extends ArrayRecord<T>> DataType<A>	asArrayDataType(Class<A> arrayDataType) Retrieve the data type for an Oracle-style ARRAY of this data type
<U> DataType<U>	asConvertedDataType(Converter<? super T,U> converter) Retrieve the data type for a given converter
<E extends EnumType> DataType<E>	asEnumDataType(Class<E> enumDataType) Retrieve the data type for a given enum data type
List<T>	convert(Collection<?> objects) Convert an arbitrary set of objects into <T>
T[]	convert(Object... objects) Convert an arbitrary set of objects into <T>
T	convert(Object object) Convert an arbitrary object into <T>
boolean	equals(Object obj)
DataType<T[]>	getArrayDataType() Retrieve the data type for an ARRAY of this data type
Class<T[]>	getArrayType() Retrieve the Java type associated with ARRAYs of this data type
String	getCastTypeName() Retrieve the dialect-specific type name associated with this data type used for casting This is useful for some dialects that have specialised type names for cast expressions.
String	getCastTypeName(Configuration configuration) Retrieve the dialect-specific type name associated with this data type used for casting This is useful for some dialects that have specialised type names for cast expressions.
DataType<T>	getDataType(Configuration configuration) The dialect-specific data type representing this data type.
static <T> DataType<T>	getDataType(SQLDialect dialect, Class<T> type)
static <T> DataType<T>	getDataType(SQLDialect dialect, Class<T> type, DataType<T> fallbackDataType)
static DataType<?>	getDataType(SQLDialect dialect, String typeName)
static DataType<?>	getDataType(SQLDialect dialect, String t, int p, int s) Convert a type name (using precision and scale) into a Java class
static DataType<Object>	getDefaultDataType(SQLDialect dialect, String typeName)
static DataType<Object>	getDefaultDataType(String typeName)
SQLDialect	getDialect() Retrieve the underlying SQLDialect
DataType<T>	getSQLDataType() Get the standard SQL data type of this (dialect-specific) data type if available.
int	getSQLType() Get JDBC Types value
Class<T>	getType() Retrieve the Java type associated with this data type
static Class<?>	getType(SQLDialect dialect, String t, int p, int s) Convert a type name (using precision and scale) into a Java class
String	getTypeName() Retrieve the dialect-specific type name associated with this data type
String	getTypeName(Configuration configuration) Retrieve the dialect-specific type name associated with this data type
int	hashCode()
boolean	hasLength() Whether this data type has a length
boolean	hasPrecision() Whether this data type has a precision
boolean	hasScale() Whether this data type has a scale
boolean	isArray() Whether this data type is an array type.
boolean	isBinary() Whether this data type is any binary type.
boolean	isDateTime() Whether this data type is any date or time type.
boolean	isInterval() Whether this data type is any interval type.
boolean	isLob() Whether this data type is best deserialised as a LOB.
boolean	isNumeric() Whether this data type is any numeric data type.
boolean	isString() Whether this data type is any character data type.
boolean	isTemporal() Whether this data type is any date or time type.
int	length() Get the length of this data type
DataType<T>	length(int l) Return a new data type like this, with a new length value This will have no effect if DataType.hasLength() is false
static String	normalise(String typeName)
int	precision() Get the precision of this data type
DataType<T>	precision(int p) Return a new data type like this, with a new precision value This will have no effect if DataType.hasPrecision() is false This is the same as calling DataType.precision(int, int) with scale == 0
DataType<T>	precision(int p, int s) Return a new data type like this, with a new precision and scale value This will have no effect if DataType.hasPrecision() is false , or if scale > 0 and DataType.hasScale() is false
int	scale() Get the scale of this data type
DataType<T>	scale(int s) Return a new data type like this, with a new scale value This will have no effect if DataType.hasScale() is false
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

DefaultDataType

public DefaultDataType(SQLDialect dialect,
               DataType<T> sqlDataType,
               String typeName)

DefaultDataType

public DefaultDataType(SQLDialect dialect,
               DataType<T> sqlDataType,
               String typeName,
               String castTypeName)

DefaultDataType

public DefaultDataType(SQLDialect dialect,
               Class<T> type,
               String typeName)

DefaultDataType

public DefaultDataType(SQLDialect dialect,
               Class<T> type,
               String typeName,
               String castTypeName)

Method Detail

precision

public final DataType<T> precision(int p)

Description copied from interface: DataType

Return a new data type like this, with a new precision value

This will have no effect if DataType.hasPrecision() is false

This is the same as calling DataType.precision(int, int) with scale == 0

Specified by:

precision in interface DataType<T>

Parameters:

p - The new precision value

Returns:

The new data type

precision

public final DataType<T> precision(int p,
                    int s)

Description copied from interface: DataType

Return a new data type like this, with a new precision and scale value

This will have no effect if DataType.hasPrecision() is false , or if scale > 0 and DataType.hasScale() is false

Specified by:

precision in interface DataType<T>

Parameters:

p - The new precision value

s - The new scale value

Returns:

The new data type

precision

public final int precision()

Description copied from interface: DataType

Get the precision of this data type

Specified by:

precision in interface DataType<T>

Returns:

The precision of this data type

hasPrecision

public final boolean hasPrecision()

Description copied from interface: DataType

Whether this data type has a precision

Specified by:

hasPrecision in interface DataType<T>

Returns:

Whether this data type has a precision

scale

public final DataType<T> scale(int s)

Description copied from interface: DataType

Return a new data type like this, with a new scale value

This will have no effect if DataType.hasScale() is false

Specified by:

scale in interface DataType<T>

Parameters:

s - The new scale value

Returns:

The new data type

scale

public final int scale()

Description copied from interface: DataType

Get the scale of this data type

Specified by:

scale in interface DataType<T>

Returns:

The scale of this data type

hasScale

public final boolean hasScale()

Description copied from interface: DataType

Whether this data type has a scale

Specified by:

hasScale in interface DataType<T>

Returns:

Whether this data type has a scale

length

public final DataType<T> length(int l)

Description copied from interface: DataType

Return a new data type like this, with a new length value

This will have no effect if DataType.hasLength() is false

Specified by:

length in interface DataType<T>

Parameters:

l - The new length value

Returns:

The new data type

length

public final int length()

Description copied from interface: DataType

Get the length of this data type

Specified by:

length in interface DataType<T>

Returns:

The length of this data type

hasLength

public final boolean hasLength()

Description copied from interface: DataType

Whether this data type has a length

Specified by:

hasLength in interface DataType<T>

Returns:

Whether this data type has a length

getSQLDataType

public final DataType<T> getSQLDataType()

Description copied from interface: DataType

Get the standard SQL data type of this (dialect-specific) data type if available.

Specified by:

getSQLDataType in interface DataType<T>

getDataType

public final DataType<T> getDataType(Configuration configuration)

Description copied from interface: DataType

The dialect-specific data type representing this data type.

Specified by:

getDataType in interface DataType<T>

getSQLType

public int getSQLType()

Description copied from interface: DataType

Get JDBC Types value

Specified by:

getSQLType in interface DataType<T>

getType

public final Class<T> getType()

Description copied from interface: DataType

Retrieve the Java type associated with this data type

Specified by:

getType in interface DataType<T>

getArrayType

public final Class<T[]> getArrayType()

Description copied from interface: DataType

Retrieve the Java type associated with ARRAYs of this data type

Specified by:

getArrayType in interface DataType<T>

getTypeName

public final String getTypeName()

Description copied from interface: DataType

Retrieve the dialect-specific type name associated with this data type

Specified by:

getTypeName in interface DataType<T>

getTypeName

public String getTypeName(Configuration configuration)

Description copied from interface: DataType

Retrieve the dialect-specific type name associated with this data type

Specified by:

getTypeName in interface DataType<T>

getCastTypeName

public final String getCastTypeName()

Description copied from interface: DataType

Retrieve the dialect-specific type name associated with this data type used for casting

This is useful for some dialects that have specialised type names for cast expressions. Other dialects require type-length binding when casting, (e.g. VARCHAR(32767))

Specified by:

getCastTypeName in interface DataType<T>

getCastTypeName

public String getCastTypeName(Configuration configuration)

Description copied from interface: DataType

Retrieve the dialect-specific type name associated with this data type used for casting

This is useful for some dialects that have specialised type names for cast expressions. Other dialects require type-length binding when casting, (e.g. VARCHAR(32767))

Specified by:

getCastTypeName in interface DataType<T>

getArrayDataType

public final DataType<T[]> getArrayDataType()

Description copied from interface: DataType

Retrieve the data type for an ARRAY of this data type

Specified by:

getArrayDataType in interface DataType<T>

asArrayDataType

public final <A extends ArrayRecord<T>> DataType<A> asArrayDataType(Class<A> arrayDataType)

Description copied from interface: DataType

Retrieve the data type for an Oracle-style ARRAY of this data type

Specified by:

asArrayDataType in interface DataType<T>

asEnumDataType

public final <E extends EnumType> DataType<E> asEnumDataType(Class<E> enumDataType)

Description copied from interface: DataType

Retrieve the data type for a given enum data type

Specified by:

asEnumDataType in interface DataType<T>

asConvertedDataType

public final <U> DataType<U> asConvertedDataType(Converter<? super T,U> converter)

Description copied from interface: DataType

Retrieve the data type for a given converter

Specified by:

asConvertedDataType in interface DataType<T>

getDialect

public final SQLDialect getDialect()

Description copied from interface: DataType

Retrieve the underlying SQLDialect

Specified by:

getDialect in interface DataType<T>

convert

public T convert(Object object)

Description copied from interface: DataType

Convert an arbitrary object into <T>

Specified by:

convert in interface DataType<T>

Parameters:

object - The object to be converted

Returns:

The converted object

convert

public final T[] convert(Object... objects)

Description copied from interface: DataType

Convert an arbitrary set of objects into <T>

Specified by:

convert in interface DataType<T>

Parameters:

objects - The objects to be converted

Returns:

The converted objects

convert

public final List<T> convert(Collection<?> objects)

Description copied from interface: DataType

Convert an arbitrary set of objects into <T>

Specified by:

convert in interface DataType<T>

Parameters:

objects - The objects to be converted

Returns:

The converted objects

getDefaultDataType

public static DataType<Object> getDefaultDataType(String typeName)

getDefaultDataType

public static DataType<Object> getDefaultDataType(SQLDialect dialect,
                                  String typeName)

getDataType

public static DataType<?> getDataType(SQLDialect dialect,
                      String typeName)

getDataType

public static <T> DataType<T> getDataType(SQLDialect dialect,
                          Class<T> type)

getDataType

public static <T> DataType<T> getDataType(SQLDialect dialect,
                          Class<T> type,
                          DataType<T> fallbackDataType)

isNumeric

public final boolean isNumeric()

Description copied from interface: DataType

Whether this data type is any numeric data type.

This applies to any of these types:

• SQLDataType.TINYINT
• SQLDataType.SMALLINT
• SQLDataType.INTEGER
• SQLDataType.BIGINT
• SQLDataType.FLOAT
• SQLDataType.DOUBLE
• SQLDataType.REAL
• SQLDataType.DECIMAL
• SQLDataType.DECIMAL_INTEGER
• SQLDataType.NUMERIC

Specified by:

isNumeric in interface DataType<T>

isString

public final boolean isString()

Description copied from interface: DataType

Whether this data type is any character data type.

This applies to any of these types:

• SQLDataType.CHAR
• SQLDataType.CLOB
• SQLDataType.LONGNVARCHAR
• SQLDataType.LONGVARCHAR
• SQLDataType.NCHAR
• SQLDataType.NCLOB
• SQLDataType.NVARCHAR
• SQLDataType.VARCHAR

Specified by:

isString in interface DataType<T>

isDateTime

public final boolean isDateTime()

Description copied from interface: DataType

Whether this data type is any date or time type.

This applies to any of these types.

• SQLDataType.DATE
• SQLDataType.TIME
• SQLDataType.TIMESTAMP

Specified by:

isDateTime in interface DataType<T>

isTemporal

public final boolean isTemporal()

Description copied from interface: DataType

Whether this data type is any date or time type.

This applies to any of these types.

• SQLDataType.DATE
• SQLDataType.TIME
• SQLDataType.TIMESTAMP
• YearToMonth
• DayToSecond

This is a combination of DataType.isDateTime() or DataType.isInterval()

Specified by:

isTemporal in interface DataType<T>

isInterval

public final boolean isInterval()

Description copied from interface: DataType

Whether this data type is any interval type.

This applies to any of these types.

• YearToMonth
• DayToSecond

Specified by:

isInterval in interface DataType<T>

isLob

public final boolean isLob()

Description copied from interface: DataType

Whether this data type is best deserialised as a LOB.

This applies to any of these types.

• SQLDataType.BLOB
• SQLDataType.CLOB
• SQLDataType.NCLOB

Specified by:

isLob in interface DataType<T>

isBinary

public final boolean isBinary()

Description copied from interface: DataType

Whether this data type is any binary type.

This applies to any of these types.

• SQLDataType.BINARY
• SQLDataType.BLOB
• SQLDataType.LONGVARBINARY
• SQLDataType.VARBINARY

Specified by:

isBinary in interface DataType<T>

isArray

public final boolean isArray()

Description copied from interface: DataType

Whether this data type is an array type.

Specified by:

isArray in interface DataType<T>

toString

public String toString()

Overrides:

toString in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

normalise

public static String normalise(String typeName)

Returns:

The type name without all special characters and white spaces

getDataType

public static DataType<?> getDataType(SQLDialect dialect,
                      String t,
                      int p,
                      int s)
                               throws SQLDialectNotSupportedException

Convert a type name (using precision and scale) into a Java class

Throws:

SQLDialectNotSupportedException

getType

public static Class<?> getType(SQLDialect dialect,
               String t,
               int p,
               int s)
                        throws SQLDialectNotSupportedException

Convert a type name (using precision and scale) into a Java class

Throws:

SQLDialectNotSupportedException