org.tentackle.sql

Class Ingres

java.lang.Object

org.tentackle.sql.AbstractBackend

org.tentackle.sql.AbstractSql92Backend

org.tentackle.sql.AbstractSql2003Backend

org.tentackle.sql.Ingres

All Implemented Interfaces:

Backend

@Service(value=Backend.class)
public class Ingres
extends AbstractSql2003Backend

Backend for Ingres.

Author:

harald

Field Summary

Fields

Modifier and Type	Field and Description
static String	SQL_FIRST FIRST string.
static String	SQL_FIRST_PAR FIRST string.

Fields inherited from class org.tentackle.sql.AbstractSql2003Backend

RESERVED_WORDS_SQL2003, SQL_WINDOW_1, SQL_WINDOW_2, SQL_WINDOW_LIMIT, SQL_WINDOW_OFFSET

Fields inherited from class org.tentackle.sql.AbstractSql92Backend

RESERVED_WORDS_SQL92, SQL_COALESCE, SQL_FOR_UPDATE

Fields inherited from class org.tentackle.sql.AbstractBackend

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_INDEX, 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
Ingres()

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.
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	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. If multiple backend implementations are provided for the same database type, only one backend should match the URL.
SqlType[]	jdbcTypeToSqlType(int jdbcType, int size, int scale) Converts the JDBC data type integer to a tentackle backend SqlTypes.
boolean	needSetLongWorkaround() Checks whether we need a workaround for the (Ingres) setLong-Bug.
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	sqlCreateColumnComment(String tableName, String columnName, String comment) Generates SQL code to create the comment for an attribute.
String	sqlCreateTableComment(String tableName, String comment) Generates SQL code to create the comment for a table.
boolean	sqlRequiresExtraCommit() According to the JDBC-specs Connection.setAutoCommit(boolean)(true) should commit, but some backends require an extra Connection.commit().
String	sqlTypeToString(SqlType sqlType, int size) Converts the java SQL-type to the database type name.

Methods inherited from class org.tentackle.sql.AbstractSql2003Backend

getReservedWords, sqlNextFromSequene, supportsSequences

Methods inherited from class org.tentackle.sql.AbstractSql92Backend

getCoalesceKeyword, sqlCreateForeignKey, sqlDropForeignKey

Methods inherited from class org.tentackle.sql.AbstractBackend

allowsExpressionsReferringToTablesBeingUpdated, assertValidName, buildSelectSql, columnTypeNullDefaultToString, columnTypeToString, createColumnMetaData, createConnection, createIndexColumnMetaData, createIndexMetaData, createPassword, createTableMetaData, getDefaultSchema, getDefaultSize, getEmptyString, getMaxScale, getMetaData, getMigrationStrategy, getModelMetaData, getTableHeaders, getTableMetaData, isCommunicationLinkException, isConstraintException, isDefaultEqual, isDropIfExistsEnabled, isFunctionBasedIndexSupported, isMatchingName, isReleaseSavepointSupported, isReservedSchemaName, isReservedTableName, isTemporaryName, needAliasForSubselect, needTxForFetchsize, normalizeDefault, optimizeSql, setDropIfExistsEnabled, sqlAddColumn, sqlAlterColumnComment, sqlAlterColumnDefault, sqlAlterColumnNullConstraint, sqlAlterColumnType, sqlAlterTableComment, sqlAsBeforeTableAlias, sqlComment, sqlCreateColumn, sqlCreateIndex, sqlCreateTableAttributeWithoutComment, sqlCreateTableClosing, sqlCreateTableIntro, sqlCreateTableIntroWithoutComment, sqlDropColumn, sqlDropIndex, sqlDropTable, sqlFunction, sqlJoin, sqlJoinSelects, sqlJoinSelects, sqlRenameAndAlterColumnType, sqlRenameColumn, sqlRenameIndex, sqlRenameTable, 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_FIRST

public static final String SQL_FIRST

FIRST string.

See Also:

Constant Field Values

SQL_FIRST_PAR

public static final String SQL_FIRST_PAR

FIRST string.

See Also:

Constant Field Values

Constructor Detail

Ingres

public Ingres()

Method Detail

isMatchingUrl

public boolean isMatchingUrl(String url)

Description copied from interface: Backend

Checks whether the backend belongs to the given jdbc url.
If multiple backend implementations are provided for the same database type, only one backend should match the URL. The others must be selected via name.

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

sqlRequiresExtraCommit

public boolean sqlRequiresExtraCommit()

Description copied from interface: Backend

According to the JDBC-specs Connection.setAutoCommit(boolean)(true) should commit, but some backends require an extra Connection.commit().

Specified by:

sqlRequiresExtraCommit in interface Backend

Overrides:

sqlRequiresExtraCommit in class AbstractBackend

Returns:

true if the database needs an extra commit

needSetLongWorkaround

public boolean needSetLongWorkaround()

Description copied from interface: Backend

Checks whether we need a workaround for the (Ingres) setLong-Bug.

Specified by:

needSetLongWorkaround in interface Backend

Overrides:

needSetLongWorkaround in class AbstractBackend

Returns:

true if workaround needed

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 AbstractSql2003Backend

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 AbstractSql2003Backend

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 AbstractSql2003Backend

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

sqlCreateTableComment

public String sqlCreateTableComment(String tableName,
                                    String comment)

Description copied from interface: Backend

Generates SQL code to create the comment for a table.

Specified by:

sqlCreateTableComment in interface Backend

Overrides:

sqlCreateTableComment in class AbstractBackend

Parameters:

tableName - the table name

comment - optional comment, null if none

Returns:

the SQL code, empty string if comment is created via Backend.sqlCreateTableIntro(java.lang.String, java.lang.String) or Backend.sqlCreateTableClosing(java.lang.String, java.lang.String)

sqlCreateColumnComment

public String sqlCreateColumnComment(String tableName,
                                     String columnName,
                                     String comment)

Description copied from interface: Backend

Generates SQL code to create the comment for an attribute.

Specified by:

sqlCreateColumnComment in interface Backend

Overrides:

sqlCreateColumnComment in class AbstractBackend

Parameters:

tableName - the table name

columnName - the column name

comment - optional comment, null if none

Returns:

the SQL code, empty string if comment is created via Backend.sqlCreateColumn(java.lang.String, java.lang.String, org.tentackle.sql.SqlType, int, int, boolean, java.lang.Object, boolean, boolean)

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