org.tentackle.sql

Class Informix

java.lang.Object

org.tentackle.sql.AbstractBackend

org.tentackle.sql.AbstractSql92Backend

org.tentackle.sql.Informix

All Implemented Interfaces:

Backend

@Service(value=Backend.class)
public class Informix
extends AbstractSql92Backend

Backend for Informix.

Author:

harald

Field Summary

Fields

Modifier and Type	Field and Description
static String	SQL_FIRST FIRST string.
static String	SQL_FIRST_PAR FIRST string.
static String	SQL_NVL NVL keyword.
static String	SQL_SKIP SKIP string.
static String	SQL_SKIP_PAR SKIP string.

Fields inherited from class org.tentackle.sql.AbstractSql92Backend

RESERVED_WORDS_SQL92, SQL_COALESCE, SQL_FOR_UPDATE

Fields inherited from class org.tentackle.sql.AbstractBackend

EMPTY_STRING, TYPE_BIGINT, TYPE_BIT, TYPE_BLOB, TYPE_BOOL, TYPE_BOOLEAN, TYPE_BYTE, TYPE_BYTEA, TYPE_CHAR_1, TYPE_DATE, TYPE_DATETIME, TYPE_DATETIME_YEAR_TO_SECOND, TYPE_DECIMAL, TYPE_DECIMAL_19, TYPE_DOUBLE, TYPE_FLOAT, TYPE_FLOAT4, TYPE_FLOAT8, TYPE_INT, TYPE_INT2, TYPE_INT4, TYPE_INT8, TYPE_INTEGER, TYPE_NCHAR_1, TYPE_NUMBER, TYPE_NUMBER_1, TYPE_NUMBER_10, TYPE_NUMBER_19, TYPE_NUMBER_5, TYPE_NVARCHAR, TYPE_NVARCHAR_MAX, TYPE_REAL, TYPE_SMALLFLOAT, TYPE_SMALLINT, TYPE_TEXT, TYPE_TIME, TYPE_TIMESTAMP, TYPE_TINYINT, TYPE_VARBINARY_MAX, TYPE_VARCHAR

Fields inherited from interface org.tentackle.sql.Backend

SQL_ALLSTAR, SQL_AND, SQL_ANDNOT, SQL_COMMA, SQL_COMMA_PAR, SQL_DELETE, SQL_EQUAL, SQL_EQUAL_PAR, SQL_EQUAL_PAR_COMMA, SQL_EQUAL_ZERO, SQL_EXISTS, SQL_FROM, SQL_GREATER, SQL_GREATER_PAR, SQL_GREATEROREQUAL, SQL_GREATEROREQUAL_PAR, SQL_GROUPBY, SQL_INSERT_INTO, SQL_INSERT_VALUES, SQL_ISNOTNULL, SQL_ISNULL, SQL_LEFT_PARENTHESIS, SQL_LESS, SQL_LESS_PAR, SQL_LESSOREQUAL, SQL_LESSOREQUAL_PAR, SQL_LIKE, SQL_LIKE_PAR, SQL_MAX, SQL_MIN, SQL_NOT, SQL_NOTEQUAL, SQL_NOTEQUAL_PAR, SQL_NOTEQUAL_ZERO, SQL_NOTLIKE, SQL_NOTLIKE_PAR, SQL_OR, SQL_ORDERBY, SQL_ORNOT, SQL_PAR, SQL_PAR_COMMA, SQL_PLUS_ONE, SQL_RIGHT_PARENTHESIS, SQL_SELECT, SQL_SELECT_ALL_FROM, SQL_SET, SQL_SORTASC, SQL_SORTDESC, SQL_UPDATE, SQL_WHERE, SQL_WHEREALL, SQL_WHEREAND, SQL_WHERENOTHING, SQL_WHEREOR

Constructor Summary

Constructors

Constructor and Description
Informix()

Method Summary

Modifier and Type	Method and Description
void	buildSelectSql(StringBuilder sqlBuilder, boolean writeLock, int limit, int offset) Creates a select statement string from an inner sql string.
Connection	createConnection(String url, String username, char[] password) Creates a jdbc connection.
protected String	extractWhereClause(String sql, int whereOffset) Extracts the where clause from a given sql.
String	getBackendId(Connection connection) Determines the unique id or name used by the backend for a given connection.
String	getCoalesceKeyword() Gets the keyword for the COALESCE function.
String	getDriverClassName() Gets the JDBC driver class name.
int	getMaxSize(SqlType sqlType) Returns the maximum size for a given SQL-type.
String	getName() Gets the name of the backend.
boolean	isMatchingUrl(String url) Checks whether the backend belongs to the given jdbc url.
SqlType[]	jdbcTypeToSqlType(int jdbcType, int size, int scale) Converts the JDBC data type integer to a tentackle backend SqlTypes.
int	setLeadingSelectParameters(BackendPreparedStatement stmt, int limit, int offset) Sets optional parameters before applying the original parameters.
int	setTrailingSelectParameters(BackendPreparedStatement stmt, int index, int limit, int offset) Sets optional parameters after applying the original parameters.
String	sqlAddColumn(String tableName, String columnName, String comment, SqlType sqlType, int size, int scale, boolean nullable, Object defaultValue) Generates sql code to add a column.
String	sqlAlterColumnDefault(String tableName, String columnName, SqlType sqlType, Object defaultValue) Generates sql code to change the default value a column.
String	sqlAlterColumnType(String tableName, String columnName, String comment, SqlType sqlType, int size, int scale, boolean nullable, Object defaultValue) Generates sql code to change the datatype of a column.
String	sqlDropColumn(String tableName, String columnName) Generates sql code to drop a column.
String	sqlNextFromSequene(String name) Creates the SQL string to retrieve the next id from a sequence.
String	sqlRenameColumn(String tableName, String oldColumnName, String newColumnName) Generates sql code to rename a column.
String	sqlTypeToString(SqlType sqlType, int size) Converts the java SQL-type to the database type name.
boolean	supportsSequences() True if backend provides transactionless sequences.

Methods inherited from class org.tentackle.sql.AbstractSql92Backend

getReservedWords, sqlCreateForeignKey, sqlDropForeignKey

Methods inherited from class org.tentackle.sql.AbstractBackend

allowsExpressionsReferringToTablesBeingUpdated, assertValidName, buildSelectSql, columnTypeNullDefaultToString, columnTypeToString, createColumnMetaData, createIndexColumnMetaData, createIndexMetaData, createTableMetaData, getDefaultSchema, getDefaultSize, getEmptyString, getMaxScale, getMetaData, getMigrationStrategy, getModelMetaData, getTableMetaData, isCommunicationLinkException, isConstraintException, isDefaultEqual, isMatchingName, isReleaseSavepointSupported, isTemporaryName, needAliasForSubselect, needSetLongWorkaround, needTxForFetchsize, normalizeDefault, optimizeSql, sqlAlterColumnComment, sqlAlterColumnNullConstraint, sqlAlterTableComment, sqlAsBeforeTableAlias, sqlComment, sqlCreateColumn, sqlCreateColumnComment, sqlCreateIndex, sqlCreateTableAttributeWithoutComment, sqlCreateTableClosing, sqlCreateTableComment, sqlCreateTableIntro, sqlCreateTableIntroWithoutComment, sqlDropIndex, sqlFunction, sqlJoin, sqlJoinSelects, sqlJoinSelects, sqlRenameAndAlterColumnType, sqlRequiresExtraCommit, sqlResultSetIsClosedSupported, sqlUpdateToNotNull, toQuotedString, toString, valueToLiteral

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

SQL_NVL

public static final String SQL_NVL

NVL keyword.

See Also:

Constant Field Values

SQL_FIRST

public static final String SQL_FIRST

FIRST string.

See Also:

Constant Field Values

SQL_SKIP

public static final String SQL_SKIP

SKIP string.

See Also:

Constant Field Values

SQL_FIRST_PAR

public static final String SQL_FIRST_PAR

FIRST string.

See Also:

Constant Field Values

SQL_SKIP_PAR

public static final String SQL_SKIP_PAR

SKIP string.

See Also:

Constant Field Values

Constructor Detail

Informix

public Informix()

Method Detail

isMatchingUrl

public boolean isMatchingUrl(String url)

Description copied from interface: Backend

Checks whether the backend belongs to the given jdbc url.

Parameters:

url - the jdbc url

Returns:

true if matches

getName

public String getName()

Description copied from interface: Backend

Gets the name of the backend.

Returns:

the name

getDriverClassName

public String getDriverClassName()

Description copied from interface: Backend

Gets the JDBC driver class name.

Returns:

the class name

getBackendId

public String getBackendId(Connection connection)

Description copied from interface: Backend

Determines the unique id or name used by the backend for a given connection.

Useful to figure out the corresponding ManagedConnection from the backend's logfiles.

Parameters:

connection - the jdbc connection

Returns:

the backend id, null if none

createConnection

public Connection createConnection(String url,
                                   String username,
                                   char[] password)
                            throws SQLException

Description copied from interface: Backend

Creates a jdbc connection.

Specified by:

createConnection in interface Backend

Overrides:

createConnection in class AbstractBackend

Parameters:

url - the jdbc url

username - the username

password - the password

Returns:

the created connection

Throws:

SQLException - if connection could not be established

getCoalesceKeyword

public String getCoalesceKeyword()

Description copied from interface: Backend

Gets the keyword for the COALESCE function.

Specified by:

getCoalesceKeyword in interface Backend

Overrides:

getCoalesceKeyword in class AbstractSql92Backend

Returns:

the keyword

buildSelectSql

public void buildSelectSql(StringBuilder sqlBuilder,
                           boolean writeLock,
                           int limit,
                           int offset)

Description copied from interface: Backend

Creates a select statement string from an inner sql string.

sqlBuilder is anything as FROM... WHERE... ORDER BY....
It is decorated with a leading SELECT plus optional clauses like for the given parameters.

Specified by:

buildSelectSql in interface Backend

Overrides:

buildSelectSql in class AbstractSql92Backend

Parameters:

sqlBuilder - the sql builder, initially containing the inner sql without leading SELECT.

writeLock - true select should write lock

limit - the limit value, ≤ 0 if no limit clause

offset - the offset value, ≤ 0 if no offset clause

setLeadingSelectParameters

public int setLeadingSelectParameters(BackendPreparedStatement stmt,
                                      int limit,
                                      int offset)

Description copied from interface: Backend

Sets optional parameters before applying the original parameters.

Specified by:

setLeadingSelectParameters in interface Backend

Overrides:

setLeadingSelectParameters in class AbstractSql92Backend

Parameters:

stmt - the prepared statement

limit - the limit value, ≤ 0 if no limit clause

offset - the offset value, ≤ 0 if no offset clause

Returns:

the next parameter index

setTrailingSelectParameters

public int setTrailingSelectParameters(BackendPreparedStatement stmt,
                                       int index,
                                       int limit,
                                       int offset)

Description copied from interface: Backend

Sets optional parameters after applying the original parameters.

Specified by:

setTrailingSelectParameters in interface Backend

Overrides:

setTrailingSelectParameters in class AbstractSql92Backend

Parameters:

stmt - the prepared statement

index - the first parameter index

limit - the limit value, ≤ 0 if no limit clause

offset - the offset value, ≤ 0 if no offset clause

Returns:

the next parameter index

getMaxSize

public int getMaxSize(SqlType sqlType)

Description copied from interface: Backend

Returns the maximum size for a given SQL-type.

Specified by:

getMaxSize in interface Backend

Overrides:

getMaxSize in class AbstractBackend

Parameters:

sqlType - the SQL-type

Returns:

the maximum size, 0 if unlimited, -1 if type without size

sqlTypeToString

public String sqlTypeToString(SqlType sqlType,
                              int size)

Description copied from interface: Backend

Converts the java SQL-type to the database type name.

Specified by:

sqlTypeToString in interface Backend

Overrides:

sqlTypeToString in class AbstractBackend

Parameters:

sqlType - the java sql type

size - the column's size

Returns:

the corresponding type string

jdbcTypeToSqlType

public SqlType[] jdbcTypeToSqlType(int jdbcType,
                                   int size,
                                   int scale)

Description copied from interface: Backend

Converts the JDBC data type integer to a tentackle backend SqlTypes.

There may be more than one sqltype returned!

Specified by:

jdbcTypeToSqlType in interface Backend

Overrides:

jdbcTypeToSqlType in class AbstractBackend

Parameters:

jdbcType - the jdbc data type

size - the column size

scale - the column's scale

Returns:

the SqlTypes, empty array if no mapping available or no exact match (not generated by TT)

See Also:

Types

supportsSequences

public boolean supportsSequences()

Description copied from interface: Backend

True if backend provides transactionless sequences.

Specified by:

supportsSequences in interface Backend

Overrides:

supportsSequences in class AbstractSql92Backend

Returns:

true if database supports sequences

sqlNextFromSequene

public String sqlNextFromSequene(String name)

Description copied from interface: Backend

Creates the SQL string to retrieve the next id from a sequence.

Specified by:

sqlNextFromSequene in interface Backend

Overrides:

sqlNextFromSequene in class AbstractSql92Backend

Parameters:

name - the name of the sequence

Returns:

the SQL code

sqlRenameColumn

public String sqlRenameColumn(String tableName,
                              String oldColumnName,
                              String newColumnName)

Description copied from interface: Backend

Generates sql code to rename a column.

Specified by:

sqlRenameColumn in interface Backend

Overrides:

sqlRenameColumn in class AbstractBackend

Parameters:

tableName - the tablename

oldColumnName - the old column name

newColumnName - the new column name

Returns:

the SQL code, null if need full spec sqlRenameAndAlterColumnType below

sqlAddColumn

public String sqlAddColumn(String tableName,
                           String columnName,
                           String comment,
                           SqlType sqlType,
                           int size,
                           int scale,
                           boolean nullable,
                           Object defaultValue)

Description copied from interface: Backend

Generates sql code to add a column.

Specified by:

sqlAddColumn in interface Backend

Overrides:

sqlAddColumn in class AbstractBackend

Parameters:

tableName - the tablename

columnName - the new column name

comment - optional comment, null if none

sqlType - the JDBC sql type

size - the optional size

scale - the optional scale

nullable - true if NULL, else NOT NULL

defaultValue - the optional default value

Returns:

the SQL code

sqlDropColumn

public String sqlDropColumn(String tableName,
                            String columnName)

Description copied from interface: Backend

Generates sql code to drop a column.

Specified by:

sqlDropColumn in interface Backend

Overrides:

sqlDropColumn in class AbstractBackend

Parameters:

tableName - the tablename

columnName - the new column name

Returns:

the SQL code

sqlAlterColumnType

public String sqlAlterColumnType(String tableName,
                                 String columnName,
                                 String comment,
                                 SqlType sqlType,
                                 int size,
                                 int scale,
                                 boolean nullable,
                                 Object defaultValue)

Description copied from interface: Backend

Generates sql code to change the datatype of a column.

Specified by:

sqlAlterColumnType in interface Backend

Overrides:

sqlAlterColumnType in class AbstractBackend

Parameters:

tableName - the tablename

columnName - the new column name

comment - optional comment, null if none

sqlType - the JDBC sql type

size - the optional size

scale - the optional scale

nullable - true if NULL, else NOT NULL

defaultValue - the optional default value

Returns:

the SQL code

sqlAlterColumnDefault

public String sqlAlterColumnDefault(String tableName,
                                    String columnName,
                                    SqlType sqlType,
                                    Object defaultValue)

Description copied from interface: Backend

Generates sql code to change the default value a column.

Specified by:

sqlAlterColumnDefault in interface Backend

Overrides:

sqlAlterColumnDefault in class AbstractBackend

Parameters:

tableName - the tablename

columnName - the new column name

sqlType - the JDBC sql type

defaultValue - the optional default value

Returns:

the SQL code, null if need Backend.sqlAlterColumnType(java.lang.String, java.lang.String, java.lang.String, org.tentackle.sql.SqlType, int, int, boolean, java.lang.Object)

extractWhereClause

protected String extractWhereClause(String sql,
                                    int whereOffset)

Description copied from class: AbstractBackend

Extracts the where clause from a given sql.

Overrides:

extractWhereClause in class AbstractBackend

Parameters:

sql - the sql statement

whereOffset - the location of WHERE in sql

Returns:

the where clause without the keyword WHERE