de.aristaflow.adept2.core.transactionmanager

Interface ManagedExtendedConnection

All Superinterfaces:

java.lang.AutoCloseable, java.sql.Connection, ExtendedConnection, java.sql.Wrapper

public interface ManagedExtendedConnection
extends ExtendedConnection

A managed extended connection extends an ExtendedConnection by the means to handle remote iterator. This is closely coupled to a transaction managed by a TxManager.

Author:

Ulrich Kreher

Field Summary

Fields inherited from interface de.aristaflow.adept2.base.dbaccess.ExtendedConnection

DEFAULT_MAX_IN_OPERATOR_PARAMETER_COUNT, DEFAULT_MAX_PARAMETER_COUNT, DEFAULT_MAX_STATEMENT_LENGTH

Fields inherited from interface java.sql.Connection

TRANSACTION_NONE, TRANSACTION_READ_COMMITTED, TRANSACTION_READ_UNCOMMITTED, TRANSACTION_REPEATABLE_READ, TRANSACTION_SERIALIZABLE

Method Summary

Modifier and Type	Method and Description
ManagedStatement	createStatement()
ManagedStatement	createStatement(int resultSetType, int resultSetConcurrency)
ManagedStatement	createStatement(int resultSetType, int resultSetConcurrency, int resultSetHoldability)
ManagedDatabaseMetaData	getMetaData()
int	getRemoteIteratorCount() The current amount of registered remote iterator.
ManagedCallableStatement	prepareCall(java.lang.String sql)
ManagedCallableStatement	prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency)
ManagedCallableStatement	prepareCall(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
ManagedPreparedStatement	prepareStatement(java.lang.String sql)
ManagedPreparedStatement	prepareStatement(java.lang.String sql, int autoGeneratedKeys)
ManagedPreparedStatement	prepareStatement(java.lang.String sql, int[] columnIndexes)
ManagedPreparedStatement	prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency)
ManagedPreparedStatement	prepareStatement(java.lang.String sql, int resultSetType, int resultSetConcurrency, int resultSetHoldability)
ManagedPreparedStatement	prepareStatement(java.lang.String sql, java.lang.String[] columnNames)
void	registerRemoteIterator(RemoteIterator<?> iterator, long aliveTime) Registers the designated remote iterator to drop it after the designated alive time has elapsed.
void	remoteIteratorDropped(RemoteIterator<?> iterator) Signals the dropping of the remote iterator.

Methods inherited from interface de.aristaflow.adept2.base.dbaccess.ExtendedConnection

addColumn, columnExists, createRecursionTable, createRecursionTable, createSequence, deregisterIterator, dropAllRecursionTables, dropColumn, dropRecursionTable, dropSchemaVersion, dropSequence, formatValue, getAddForeignKey, getAllTableNames, getColumnNames, getColumnType, getCorrespondingDBType, getCorrespondingDBType, getCorrespondingDBType, getCurrentTime, getDatabaseName, getDropForeignKeyConstraintKeyword, getEXCEPTKeyword, getMaxInOperatorParameterCount, getMaxParameterCount, getMaxStatementLength, getSchemaVersion, getStringComparison, getTimeDifference, isForeignKeyViolation, isLockTimeout, isSyntaxError, isTableMissing, isUniqueViolation, lockTable, nextID, registerIterator, renameColumn, renameTable, sequenceExists, setDefaultLockTimeout, setLockTimeout, setSchemaVersion, supportsIntersect, tableExists, toUpperCase, updateColumnsNullable, updateColumnType, useLockTimeout

Methods inherited from interface java.sql.Connection

abort, clearWarnings, close, commit, createArrayOf, createBlob, createClob, createNClob, createSQLXML, createStruct, getAutoCommit, getCatalog, getClientInfo, getClientInfo, getHoldability, getNetworkTimeout, getSchema, getTransactionIsolation, getTypeMap, getWarnings, isClosed, isReadOnly, isValid, nativeSQL, releaseSavepoint, rollback, rollback, setAutoCommit, setCatalog, setClientInfo, setClientInfo, setHoldability, setNetworkTimeout, setReadOnly, setSavepoint, setSavepoint, setSchema, setTransactionIsolation, setTypeMap

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Method Detail

registerRemoteIterator

void registerRemoteIterator(RemoteIterator<?> iterator,
                            long aliveTime)

Registers the designated remote iterator to drop it after the designated alive time has elapsed. The iterator can be safely dropped beforehand and signal this via remoteIteratorDropped(RemoteIterator).

Parameters:

iterator - The iterator to drop after its alive time has elapsed.

aliveTime - The time in milliseconds the designated iterator can be active without being forced to be dropped.

getRemoteIteratorCount

int getRemoteIteratorCount()

The current amount of registered remote iterator. The wrapped connection must not be closed until all remote iterator have been dropped.

Returns:

The current amount of registered remote iterator.

remoteIteratorDropped

void remoteIteratorDropped(RemoteIterator<?> iterator)

Signals the dropping of the remote iterator. As soon as all remote iterator of this connection are dropped, the underlying connection will be closed.

Parameters:

iterator - The remote iterator that has been dropped.

createStatement

ManagedStatement createStatement()
                          throws java.sql.SQLException

Specified by:

createStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareCall

ManagedCallableStatement prepareCall(java.lang.String sql)
                              throws java.sql.SQLException

Specified by:

prepareCall in interface java.sql.Connection

Throws:

java.sql.SQLException

getMetaData

ManagedDatabaseMetaData getMetaData()
                             throws java.sql.SQLException

Specified by:

getMetaData in interface java.sql.Connection

Throws:

java.sql.SQLException

createStatement

ManagedStatement createStatement(int resultSetType,
                                 int resultSetConcurrency)
                          throws java.sql.SQLException

Specified by:

createStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql,
                                          int resultSetType,
                                          int resultSetConcurrency)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareCall

ManagedCallableStatement prepareCall(java.lang.String sql,
                                     int resultSetType,
                                     int resultSetConcurrency)
                              throws java.sql.SQLException

Specified by:

prepareCall in interface java.sql.Connection

Throws:

java.sql.SQLException

createStatement

ManagedStatement createStatement(int resultSetType,
                                 int resultSetConcurrency,
                                 int resultSetHoldability)
                          throws java.sql.SQLException

Specified by:

createStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql,
                                          int resultSetType,
                                          int resultSetConcurrency,
                                          int resultSetHoldability)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareCall

ManagedCallableStatement prepareCall(java.lang.String sql,
                                     int resultSetType,
                                     int resultSetConcurrency,
                                     int resultSetHoldability)
                              throws java.sql.SQLException

Specified by:

prepareCall in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql,
                                          int autoGeneratedKeys)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql,
                                          int[] columnIndexes)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException

prepareStatement

ManagedPreparedStatement prepareStatement(java.lang.String sql,
                                          java.lang.String[] columnNames)
                                   throws java.sql.SQLException

Specified by:

prepareStatement in interface java.sql.Connection

Throws:

java.sql.SQLException