org.jooq.impl

Class DefaultDataType<T>

java.lang.Object

org.jooq.impl.DefaultDataType<T>

All Implemented Interfaces:

java.io.Serializable, DataType<T>

public class DefaultDataType<T>
extends java.lang.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, java.lang.Class<T> type, java.lang.String typeName)
DefaultDataType(SQLDialect dialect, java.lang.Class<T> type, java.lang.String typeName, java.lang.String castTypeName)
DefaultDataType(SQLDialect dialect, DataType<T> sqlDataType, java.lang.String typeName)
DefaultDataType(SQLDialect dialect, DataType<T> sqlDataType, java.lang.String typeName, java.lang.String castTypeName)

Method Summary

Modifier and Type	Method and Description
<A extends ArrayRecord<?>> DataType<A>	asArrayDataType(java.lang.Class<A> arrayDataType) Retrieve the data type for an Oracle-style ARRAY of this data type.
<U> DataType<U>	asConvertedDataType(Binding<? super T,U> binding) Retrieve the data type for a given converter.
<U> DataType<U>	asConvertedDataType(Converter<? super T,U> converter) Retrieve the data type for a given converter.
<E extends EnumType> DataType<E>	asEnumDataType(java.lang.Class<E> enumDataType) Retrieve the data type for a given enum data type.
java.util.List<T>	convert(java.util.Collection<?> objects) Convert an arbitrary set of objects into <T>.
T[]	convert(java.lang.Object... objects) Convert an arbitrary set of objects into <T>.
T	convert(java.lang.Object object) Convert an arbitrary object into <T>.
boolean	defaulted() Get the defaultability of this data type.
DataType<T>	defaulted(boolean d) Return a new data type like this, with a new defaultability.
boolean	equals(java.lang.Object obj)
DataType<T[]>	getArrayDataType() Retrieve the data type for an ARRAY of this data type.
java.lang.Class<T[]>	getArrayType() Retrieve the Java type associated with ARRAYs of this data type.
java.lang.String	getCastTypeName() Retrieve the dialect-specific type name associated with this data type used for casting.
java.lang.String	getCastTypeName(Configuration configuration) Retrieve the dialect-specific type name associated with this data type used for casting.
DataType<T>	getDataType(Configuration configuration) The dialect-specific data type representing this data type.
static <T> DataType<T>	getDataType(SQLDialect dialect, java.lang.Class<T> type)
static <T> DataType<T>	getDataType(SQLDialect dialect, java.lang.Class<T> type, DataType<T> fallbackDataType)
static DataType<?>	getDataType(SQLDialect dialect, java.lang.String typeName)
static DataType<?>	getDataType(SQLDialect dialect, java.lang.String t, int p, int s) Convert a type name (using precision and scale) into a Java class
static DataType<java.lang.Object>	getDefaultDataType(SQLDialect dialect, java.lang.String typeName)
static DataType<java.lang.Object>	getDefaultDataType(java.lang.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.
java.lang.Class<T>	getType() Retrieve the Java type associated with this data type.
static java.lang.Class<?>	getType(SQLDialect dialect, java.lang.String t, int p, int s) Convert a type name (using precision and scale) into a Java class
java.lang.String	getTypeName() Retrieve the dialect-specific type name associated with this data type.
java.lang.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.
static java.lang.String	normalise(java.lang.String typeName)
boolean	nullable() Get the nullability of this data type.
DataType<T>	nullable(boolean n) Return a new data type like this, with a new nullability.
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.
DataType<T>	precision(int p, int s) Return a new data type like this, with a new precision and scale value.
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.
java.lang.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,
                       java.lang.String typeName)

DefaultDataType

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

DefaultDataType

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

DefaultDataType

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

Method Detail

nullable

public final DataType<T> nullable(boolean n)

Description copied from interface: DataType

Return a new data type like this, with a new nullability.

Specified by:

nullable in interface DataType<T>

Parameters:

n - The new nullability

Returns:

The new data type

nullable

public final boolean nullable()

Description copied from interface: DataType

Get the nullability of this data type.

Specified by:

nullable in interface DataType<T>

Returns:

The nullability

defaulted

public final DataType<T> defaulted(boolean d)

Description copied from interface: DataType

Return a new data type like this, with a new defaultability.

Specified by:

defaulted in interface DataType<T>

Parameters:

d - The new defaultability

Returns:

The new data type

defaulted

public final boolean defaulted()

Description copied from interface: DataType

Get the defaultability of this data type.

Specified by:

defaulted in interface DataType<T>

Returns:

The defaultability

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 java.lang.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 java.lang.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 java.lang.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 java.lang.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 java.lang.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 java.lang.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<?>> DataType<A> asArrayDataType(java.lang.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(java.lang.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>

asConvertedDataType

public final <U> DataType<U> asConvertedDataType(Binding<? super T,U> binding)

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(java.lang.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(java.lang.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 java.util.List<T> convert(java.util.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<java.lang.Object> getDefaultDataType(java.lang.String typeName)

getDefaultDataType

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

getDataType

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

getDataType

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

getDataType

public static <T> DataType<T> getDataType(SQLDialect dialect,
                                          java.lang.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 java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

normalise

public static java.lang.String normalise(java.lang.String typeName)

Returns:

The type name without all special characters and white spaces

getDataType

public static DataType<?> getDataType(SQLDialect dialect,
                                      java.lang.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 java.lang.Class<?> getType(SQLDialect dialect,
                                         java.lang.String t,
                                         int p,
                                         int s)
                                  throws SQLDialectNotSupportedException

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

Throws:

SQLDialectNotSupportedException