com.feedzai.commons.sql.abstraction.engine.impl

Class DB2Engine

java.lang.Object

com.feedzai.commons.sql.abstraction.engine.DatabaseEngineImpl

com.feedzai.commons.sql.abstraction.engine.impl.DB2Engine

All Implemented Interfaces:

DatabaseEngine, DatabaseLocal

public class DB2Engine
extends DatabaseEngineImpl

DB2 specific database implementation.

Field Summary

Fields

Modifier and Type	Field and Description
static String	DB2_DEFAULT_BLOB_SIZE The default size of a BLOB in DB2.
protected static String	DB2_DRIVER The DB2 JDBC driver.
static String	FOREIGN_ALREADY_EXISTS Foreign key already exists
static String	NAME_ALREADY_EXISTS Name is already used by an existing object.
static String	SEQUENCE_DOES_NOT_EXIST Sequence does not exist.
static String	TABLE_CAN_ONLY_HAVE_ONE_PRIMARY_KEY Table can have only one primary key.
static String	TABLE_OR_VIEW_DOES_NOT_EXIST Table or view does not exist.

Fields inherited from class com.feedzai.commons.sql.abstraction.engine.DatabaseEngineImpl

conn, dev, diaclect, entities, ESCAPE_CHARATER, logger, notificationLogger, properties, stmts

Constructor Summary

Constructors

Constructor and Description
DB2Engine(Properties properties) Creates a new DB2 connection.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addColumn(DbEntity entity, DbColumn... columns) Adds the column to an existent table.
protected void	addFks(DbEntity entity) Adds the FKs.
protected void	addIndexes(DbEntity entity) Add the desired indexes.
protected void	addPrimaryKey(DbEntity entity) Add a primary key to the entity.
protected void	addSequences(DbEntity entity) Adds the necessary sequences.
protected boolean	checkConnection(Connection conn) Checks if the connection is alive.
protected MappedEntity	createPreparedStatementForInserts(DbEntity entity) Creates and gets the prepared statement that will be used for insertions.
protected ResultIterator	createResultIterator(PreparedStatement ps) Creates a specific ResultIterator for the engine in place given given prepared statement.
protected ResultIterator	createResultIterator(Statement statement, String sql) Creates a specific ResultIterator given the engine implementation.
protected void	createTable(DbEntity entity) Creates the table.
protected void	dropColumn(DbEntity entity, String... columns) Drops the column.
protected void	dropSequences(DbEntity entity) Drops the sequences of the entity.
protected void	dropTable(DbEntity entity) Drops the table.
protected int	entityToPreparedStatement(DbEntity entity, PreparedStatement ps, EntityEntry entry, boolean useAutoInc) Translates the given entry entity to the prepared statement.
int	executeUpdate(String query) Executes a native query.
Map<String,DbColumnType>	getMetadata(String name) Gets the table metadata.
Long	persist(String name, EntityEntry entry) Persists a given entry.
Long	persist(String name, EntityEntry entry, boolean useAutoInc) Persists a given entry.
void	setParameter(String name, int index, Object param) Sets the parameter on the specified index.
void	setParameters(String name, Object... params) Sets the parameters on the specified prepared statement.
protected String	translateType(DbColumn c) Translates the type present in the given column.
void	updateEntity(DbEntity entity) Updates an entity in the engine.

Methods inherited from class com.feedzai.commons.sql.abstraction.engine.DatabaseEngineImpl

addBatch, addEntity, beginTransaction, checkConnection, checkConnection, clearParameters, close, commentCharacter, commit, connect, containsEntity, createBatch, createPreparedStatement, createPreparedStatement, createPreparedStatement, createPreparedStatement, dropEntity, dropEntity, dropFks, duplicate, escapeCharacter, executePS, executePSUpdate, executeUpdate, flush, getConnection, getDialect, getEntities, getProperties, getPSIterator, getPSResultSet, getQueryMetadata, getQueryMetadata, isTransactionActive, iterator, iterator, objectToArray, preparedStatementExists, processResultIterator, query, query, removeEntity, removePreparedStatement, rollback, setTransactionIsolation, toPdbType, translate

Methods inherited from class java.lang.Object

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

Field Detail

DB2_DRIVER

protected static final String DB2_DRIVER

The DB2 JDBC driver.

NAME_ALREADY_EXISTS

public static final String NAME_ALREADY_EXISTS

Name is already used by an existing object.

See Also:

Constant Field Values

TABLE_CAN_ONLY_HAVE_ONE_PRIMARY_KEY

public static final String TABLE_CAN_ONLY_HAVE_ONE_PRIMARY_KEY

Table can have only one primary key.

See Also:

Constant Field Values

SEQUENCE_DOES_NOT_EXIST

public static final String SEQUENCE_DOES_NOT_EXIST

Sequence does not exist.

See Also:

Constant Field Values

TABLE_OR_VIEW_DOES_NOT_EXIST

public static final String TABLE_OR_VIEW_DOES_NOT_EXIST

Table or view does not exist.

See Also:

Constant Field Values

FOREIGN_ALREADY_EXISTS

public static final String FOREIGN_ALREADY_EXISTS

Foreign key already exists

See Also:

Constant Field Values

DB2_DEFAULT_BLOB_SIZE

public static final String DB2_DEFAULT_BLOB_SIZE

The default size of a BLOB in DB2.

See Also:

Constant Field Values

Constructor Detail

DB2Engine

public DB2Engine(Properties properties)
          throws DatabaseEngineException

Creates a new DB2 connection.

Parameters:

properties - The properties for the database connection.

Throws:

DatabaseEngineException - When the connection fails.

Method Detail

entityToPreparedStatement

protected int entityToPreparedStatement(DbEntity entity,
                            PreparedStatement ps,
                            EntityEntry entry,
                            boolean useAutoInc)
                                 throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Translates the given entry entity to the prepared statement.

Specified by:

entityToPreparedStatement in class DatabaseEngineImpl

Parameters:

entity - The entity.

ps - The prepared statement.

entry - The entry.

Returns:

The prepared statement filled in.

Throws:

DatabaseEngineException - if something occurs during the translation.

createTable

protected void createTable(DbEntity entity)
                    throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Creates the table.

Specified by:

createTable in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong while creating the table.

addPrimaryKey

protected void addPrimaryKey(DbEntity entity)
                      throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Add a primary key to the entity.

Specified by:

addPrimaryKey in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong while creating the table.

addIndexes

protected void addIndexes(DbEntity entity)
                   throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Add the desired indexes.

Specified by:

addIndexes in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong while creating the table.

addSequences

protected void addSequences(DbEntity entity)
                     throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Adds the necessary sequences.

Specified by:

addSequences in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong while creating the table.

executeUpdate

public int executeUpdate(String query)
                  throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Executes a native query.

Specified by:

executeUpdate in interface DatabaseEngine

Overrides:

executeUpdate in class DatabaseEngineImpl

Parameters:

query - The query to execute.

Returns:

The number of rows updated.

Throws:

DatabaseEngineException - If something goes wrong executing the native query.

createPreparedStatementForInserts

protected MappedEntity createPreparedStatementForInserts(DbEntity entity)
                                                  throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Creates and gets the prepared statement that will be used for insertions.

Specified by:

createPreparedStatementForInserts in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong while creating the table.

dropSequences

protected void dropSequences(DbEntity entity)
                      throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Drops the sequences of the entity.

Specified by:

dropSequences in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong dropping the sequences.

dropTable

protected void dropTable(DbEntity entity)
                  throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Drops the table.

Specified by:

dropTable in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong dropping the sequences.

dropColumn

protected void dropColumn(DbEntity entity,
              String... columns)
                   throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Drops the column.

Specified by:

dropColumn in class DatabaseEngineImpl

Parameters:

entity - The entity.

columns - The column name to drop.

Throws:

DatabaseEngineException - If something goes wrong dropping the sequences.

updateEntity

public void updateEntity(DbEntity entity)
                  throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Updates an entity in the engine.

If the entity does not exists in the instance, the method DatabaseEngineImpl.addEntity(com.feedzai.commons.sql.abstraction.ddl.DbEntity) will be invoked.

The engine will compare the entity with the DatabaseEngineImpl.getMetadata(String) information and update the schema of the table.

ATTENTION: This method will only add new columns or drop removed columns in the database table. It will also drop and create foreign keys. Primary Keys, Indexes and column types changes will not be updated.

Specified by:

updateEntity in interface DatabaseEngine

Overrides:

updateEntity in class DatabaseEngineImpl

Parameters:

entity - The entity to update.

Throws:

DatabaseEngineException

addColumn

protected void addColumn(DbEntity entity,
             DbColumn... columns)
                  throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Adds the column to an existent table.

Specified by:

addColumn in class DatabaseEngineImpl

Parameters:

entity - The entity that represents the table.

columns - The db column to add.

Throws:

DatabaseEngineException

translateType

protected String translateType(DbColumn c)
                        throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Translates the type present in the given column.

Specified by:

translateType in class DatabaseEngineImpl

Parameters:

c - The column.

Returns:

The translation.

Throws:

DatabaseEngineException - If the type cannot be found.

persist

public Long persist(String name,
           EntityEntry entry)
             throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Persists a given entry. Persisting a query implies executing the statement.

If you are inside of an explicit transaction, changes will only be visible upon explicit commit, otherwise a commit will immediately take place.

Specified by:

persist in interface DatabaseEngine

Specified by:

persist in class DatabaseEngineImpl

Parameters:

name - The entity name.

entry - The entry to persist.

Returns:

The ID of the auto generated value, null if there's no auto generated value.

Throws:

DatabaseEngineException - If something goes wrong while persisting data.

persist

public Long persist(String name,
           EntityEntry entry,
           boolean useAutoInc)
             throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Persists a given entry. Persisting a query implies executing the statement. If define useAutoInc as false, PDB will disable the auto increments for the current insert and advance the sequences if needed.

If you are inside of an explicit transaction, changes will only be visible upon explicit commit, otherwise a commit will immediately take place.

Specified by:

persist in interface DatabaseEngine

Specified by:

persist in class DatabaseEngineImpl

Parameters:

name - The entity name.

entry - The entry to persist.

useAutoInc - Use or not the autoinc.

Returns:

The ID of the auto generated value, null if there's no auto generated value.

Throws:

DatabaseEngineException - If something goes wrong while persisting data.

addFks

protected void addFks(DbEntity entity)
               throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Adds the FKs.

Specified by:

addFks in class DatabaseEngineImpl

Parameters:

entity - The entity.

Throws:

DatabaseEngineException - If something goes wrong creating the FKs.

checkConnection

protected boolean checkConnection(Connection conn)

Description copied from class: DatabaseEngineImpl

Checks if the connection is alive.

Specified by:

checkConnection in class DatabaseEngineImpl

Parameters:

conn - The connection to test.

Returns:

True if the connection is valid, false otherwise.

createResultIterator

protected ResultIterator createResultIterator(Statement statement,
                                  String sql)
                                       throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Creates a specific ResultIterator given the engine implementation.

Specified by:

createResultIterator in class DatabaseEngineImpl

Parameters:

statement - The statement.

sql - The SQL sentence.

Returns:

An iterator for the specific engine.

Throws:

DatabaseEngineException - If a database access error occurs.

getMetadata

public Map<String,DbColumnType> getMetadata(String name)
                                     throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Gets the table metadata.

Specified by:

getMetadata in interface DatabaseEngine

Overrides:

getMetadata in class DatabaseEngineImpl

Returns:

A representation of the table columns and types.

Throws:

DatabaseEngineException - If something occurs getting the metadata.

setParameters

public void setParameters(String name,
                 Object... params)
                   throws DatabaseEngineException,
                          ConnectionResetException

Description copied from interface: DatabaseEngine

Sets the parameters on the specified prepared statement.

Specified by:

setParameters in interface DatabaseEngine

Overrides:

setParameters in class DatabaseEngineImpl

Parameters:

name - The prepared statement name.

params - The parameters to set.

Throws:

DatabaseEngineException - If something occurs setting the parameters.

ConnectionResetException - If the connection was reset while trying to set parameters.

setParameter

public void setParameter(String name,
                int index,
                Object param)
                  throws DatabaseEngineException,
                         ConnectionResetException

Description copied from interface: DatabaseEngine

Sets the parameter on the specified index.

Specified by:

setParameter in interface DatabaseEngine

Overrides:

setParameter in class DatabaseEngineImpl

Parameters:

name - The prepared statement name.

index - The index to set.

param - The parameter to set.

Throws:

DatabaseEngineException - If something occurs setting the parameters.

ConnectionResetException - If the connection was reset while trying to set the parameter.

createResultIterator

protected ResultIterator createResultIterator(PreparedStatement ps)
                                       throws DatabaseEngineException

Description copied from class: DatabaseEngineImpl

Creates a specific ResultIterator for the engine in place given given prepared statement.

Specified by:

createResultIterator in class DatabaseEngineImpl

Parameters:

ps - The prepared statement.

Returns:

The result iterator.

Throws:

DatabaseEngineException - If a database access error occurs.