Module org.tentackle.sql

Package org.tentackle.sql.datatypes

Class ConvertibleType

java.lang.Object

org.tentackle.sql.datatypes.AbstractDataType<java.lang.Object>

org.tentackle.sql.datatypes.ConvertibleType

All Implemented Interfaces:

DataType<java.lang.Object>

@Service(DataType.class)
public class ConvertibleType
extends AbstractDataType<java.lang.Object>

Virtual type for application-specific wrapper classes implementing org.tentackle.misc.Convertible. This is not real type as it does not describe a concrete Java type.

Constructor Summary

Constructors

Constructor	Description
ConvertibleType()

Method Summary

Modifier and Type	Method	Description
java.lang.Object	get(Backend backend, java.sql.ResultSet resultSet, int[] pos, boolean mapNull, java.lang.Integer size)	Gets the object from a result set. Must be implemented if DataType.isPredefined() returns false.
java.lang.String	getJavaType()	Gets the name of the Java type.
SqlType	getSqlType(int index)	Gets the SQL type.
boolean	isModelProvidingInnerType()	Returns whether the model provides an inner type.
java.lang.Object[]	set(Backend backend, java.sql.PreparedStatement statement, int pos, java.lang.Object object, boolean mapNull, java.lang.Integer size)	Sets the object into a prepared statement. Must be implemented if DataType.isPredefined() returns false.
java.lang.Object	valueOf(java.lang.String str)	Parses a string and converts to the value of this type. The method is used to parse a literal (for example the default value defined in the model).

Methods inherited from class org.tentackle.sql.datatypes.AbstractDataType

equals, getColumnCount, getColumnGetter, getColumnSuffix, getColumnValue, getCommentSuffix, getDataTypeConstant, getScale, getSize, getVariant, hashCode, isBool, isDateOrTime, isDowncastNecessary, isJavaTypeGenerified, isLiteralSupported, isMapNullSupported, isMutable, isNumeric, isPredefined, isPrimitive, isUTCSupported, set, toLiteral, toNonPrimitive, toPrimitive, toString, toString, valueOfLiteralToCode

Methods inherited from class java.lang.Object

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

Constructor Detail

ConvertibleType

public ConvertibleType()

Method Detail

getJavaType

public java.lang.String getJavaType()

Description copied from interface: DataType

Gets the name of the Java type.

Returns:

the type

isModelProvidingInnerType

public boolean isModelProvidingInnerType()

Description copied from interface: DataType

Returns whether the model provides an inner type.

Specified by:

isModelProvidingInnerType in interface DataType<java.lang.Object>

Overrides:

isModelProvidingInnerType in class AbstractDataType<java.lang.Object>

Returns:

true if inner type is specified within angle brackets, false if standard type

getSqlType

public SqlType getSqlType(int index)

Description copied from interface: DataType

Gets the SQL type.

Parameters:

index - the column index

Returns:

the SQL type

valueOf

public java.lang.Object valueOf(java.lang.String str)

Description copied from interface: DataType

Parses a string and converts to the value of this type.
The method is used to parse a literal (for example the default value defined in the model).

Notice: the method doesn't use any locale, so the results are always the same regardless of the JVM's locale.

Parameters:

str - the source string

Returns:

the value

set

public java.lang.Object[] set(Backend backend,
                              java.sql.PreparedStatement statement,
                              int pos,
                              java.lang.Object object,
                              boolean mapNull,
                              java.lang.Integer size)
                       throws java.sql.SQLException

Description copied from interface: DataType

Sets the object into a prepared statement.
Must be implemented if DataType.isPredefined() returns false. Not invoked by framework otherwise.

Parameters:

backend - the database backend

statement - the prepared statement

pos - the position of the first SQL value

object - the object, may be null

mapNull - true if map null-values to non-null values

size - the optional size specified in the model

Returns:

the values stored in the prepared statement

Throws:

java.sql.SQLException - if failed

get

public java.lang.Object get(Backend backend,
                            java.sql.ResultSet resultSet,
                            int[] pos,
                            boolean mapNull,
                            java.lang.Integer size)
                     throws java.sql.SQLException

Description copied from interface: DataType

Gets the object from a result set.
Must be implemented if DataType.isPredefined() returns false. Not invoked by framework otherwise.

Parameters:

backend - the database backend

resultSet - the result set

pos - the column positions in the result set

mapNull - true if unmap null-values from non-null values

size - the optional size specified in the model

Returns:

the object or null if column(s) IS NULL

Throws:

java.sql.SQLException - if failed