Module org.tentackle.sql

Package org.tentackle.sql.datatypes

Class StringType

java.lang.Object

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

org.tentackle.sql.datatypes.StringType

All Implemented Interfaces:

DataType<java.lang.String>

Direct Known Subclasses:

LargeStringType

@Service(DataType.class)
public class StringType
extends AbstractDataType<java.lang.String>

Datatype for String.

Notice that there are two types of strings. This one is for the SQL type VARCHAR.

Constructor Summary

Constructors

Constructor	Description
StringType()

Method Summary

Modifier and Type	Method	Description
java.lang.String	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	isMapNullSupported()	Returns whether this type supports mapping null values to some well-defined constant.
java.lang.Object[]	set(Backend backend, java.sql.PreparedStatement statement, int pos, java.lang.String object, boolean mapNull, java.lang.Integer size)	Sets the object into a prepared statement. Must be implemented if DataType.isPredefined() returns false.
java.lang.String	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).
java.lang.String	valueOfLiteralToCode(java.lang.String str)	Creates the java code to apply the valueOf method to a String.

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, isModelProvidingInnerType, isMutable, isNumeric, isPredefined, isPrimitive, isUTCSupported, set, toLiteral, toNonPrimitive, toPrimitive, toString, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

StringType

public StringType()

Method Detail

getJavaType

public java.lang.String getJavaType()

Description copied from interface: DataType

Gets the name of the Java type.

Returns:

the type

isMapNullSupported

public boolean isMapNullSupported()

Description copied from interface: DataType

Returns whether this type supports mapping null values to some well-defined constant.

Specified by:

isMapNullSupported in interface DataType<java.lang.String>

Overrides:

isMapNullSupported in class AbstractDataType<java.lang.String>

Returns:

true if mapNull supported

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.String 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

valueOfLiteralToCode

public java.lang.String valueOfLiteralToCode(java.lang.String str)

Description copied from interface: DataType

Creates the java code to apply the valueOf method to a String.

Specified by:

valueOfLiteralToCode in interface DataType<java.lang.String>

Overrides:

valueOfLiteralToCode in class AbstractDataType<java.lang.String>

Parameters:

str - the literal to be parsed

Returns:

the java code

set

public java.lang.Object[] set(Backend backend,
                              java.sql.PreparedStatement statement,
                              int pos,
                              java.lang.String 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.String 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