Informix (Tentackle SQL 8.2.4.0 API)

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_ALTER_COLUMN, SQL_ALTER_TABLE, 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_IF_EXISTS, 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()

Constructors
Constructor and Description
`Informix()`

Method Summary

All Methods Instance Methods Concrete Methods
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.
`protected boolean`	`isDropIfExistsSupported()` Adds "IF EXISTS" to drop clauses, if supported by the backend. Makes migration a little more robust in case the same SQL scripts are applied to different databases than those used to generate the migration scripts for.
`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, isDropIfExistsEnabled, isMatchingName, isReleaseSavepointSupported, isTemporaryName, needAliasForSubselect, needSetLongWorkaround, needTxForFetchsize, normalizeDefault, optimizeSql, setDropIfExistsEnabled, 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
  - isDropIfExistsSupported
```
protected boolean isDropIfExistsSupported()
```
    Description copied from class: AbstractBackend
    
    Adds "IF EXISTS" to drop clauses, if supported by the backend.
    Makes migration a little more robust in case the same SQL scripts are applied to different databases than those used to generate the migration scripts for.
    
    Overrides:
    
    isDropIfExistsSupported in class AbstractBackend
    
    Returns:
    
    true if supported

Class Informix

Field Summary

Fields inherited from class org.tentackle.sql.AbstractSql92Backend

Fields inherited from class org.tentackle.sql.AbstractBackend

Fields inherited from interface org.tentackle.sql.Backend

Constructor Summary

Method Summary

Methods inherited from class org.tentackle.sql.AbstractSql92Backend

Methods inherited from class org.tentackle.sql.AbstractBackend

Methods inherited from class java.lang.Object

Field Detail

SQL_NVL

SQL_FIRST

SQL_SKIP

SQL_FIRST_PAR

SQL_SKIP_PAR

Constructor Detail

Informix

Method Detail

isMatchingUrl

getName

getDriverClassName

getBackendId

createConnection

getCoalesceKeyword

buildSelectSql

setLeadingSelectParameters

setTrailingSelectParameters

getMaxSize

sqlTypeToString

jdbcTypeToSqlType

supportsSequences

sqlNextFromSequene

sqlRenameColumn

sqlAddColumn

sqlDropColumn

sqlAlterColumnType

sqlAlterColumnDefault

extractWhereClause

isDropIfExistsSupported