org.apache.derby.iapi.sql.execute
Interface ExecutionContext

All Superinterfaces:

Context

All Known Implementing Classes:

GenericExecutionContext

public interface ExecutionContext

extends Context

ExecutionContext stores the factories that are to be used by the current connection. It also provides execution services for statement atomicity.

Author:

ames

Field Summary

static java.lang.String	CONTEXT_ID this is the ID we expect execution contexts to be stored into a context manager under.
static int[]	CS_TO_JDBC_ISOLATION_LEVEL_MAP
static java.lang.String[][]	CS_TO_SQL_ISOLATION_MAP
static int	READ_COMMITTED_ISOLATION_LEVEL
static int	READ_UNCOMMITTED_ISOLATION_LEVEL
static int	REPEATABLE_READ_ISOLATION_LEVEL
static int	SERIALIZABLE_ISOLATION_LEVEL
static int	UNSPECIFIED_ISOLATION_LEVEL

Method Summary

void	beginStatement(ResultSet sourceRS) Mark the beginning of a statement (INSERT, UPDATE, DELETE)
void	endStatement() The end of a statement (INSERT, UPDATE, DELETE)
ExecutionFactory	getExecutionFactory() Get the ExecutionFactory from this ExecutionContext.
ResultSetFactory	getResultSetFactory() Get the ResultSetFactory from this ExecutionContext.
ResultSetStatisticsFactory	getResultSetStatisticsFactory() Get the ResultSetStatisticsFactory from this ExecutionContext.
java.lang.Object[]	siftForeignKeys(java.lang.Object[] fullList) Sifts the array of foreign key constraints for the ones which apply in the current context.
java.lang.Object	siftTriggers(java.lang.Object triggerInfo) Sifts the triggers for the ones which apply in the current context.

Methods inherited from interface org.apache.derby.iapi.services.context.Context

cleanupOnError, getContextManager, getIdName, isLastHandler, popMe, pushMe

Field Detail

CONTEXT_ID

public static final java.lang.String CONTEXT_ID

this is the ID we expect execution contexts to be stored into a context manager under.

See Also:

Constant Field Values

UNSPECIFIED_ISOLATION_LEVEL

public static final int UNSPECIFIED_ISOLATION_LEVEL

See Also:

Constant Field Values

READ_UNCOMMITTED_ISOLATION_LEVEL

public static final int READ_UNCOMMITTED_ISOLATION_LEVEL

See Also:

Constant Field Values

READ_COMMITTED_ISOLATION_LEVEL

public static final int READ_COMMITTED_ISOLATION_LEVEL

See Also:

Constant Field Values

REPEATABLE_READ_ISOLATION_LEVEL

public static final int REPEATABLE_READ_ISOLATION_LEVEL

See Also:

Constant Field Values

SERIALIZABLE_ISOLATION_LEVEL

public static final int SERIALIZABLE_ISOLATION_LEVEL

See Also:

Constant Field Values

CS_TO_JDBC_ISOLATION_LEVEL_MAP

public static final int[] CS_TO_JDBC_ISOLATION_LEVEL_MAP

CS_TO_SQL_ISOLATION_MAP

public static final java.lang.String[][] CS_TO_SQL_ISOLATION_MAP

Method Detail

getResultSetFactory

public ResultSetFactory getResultSetFactory()

Get the ResultSetFactory from this ExecutionContext.

Returns:

The result set factory associated with this ExecutionContext

getResultSetStatisticsFactory

public ResultSetStatisticsFactory getResultSetStatisticsFactory()
                                                         throws StandardException

Get the ResultSetStatisticsFactory from this ExecutionContext.

Returns:

The result set statistics factory associated with this ExecutionContext

Throws:

StandardException - Thrown on error

getExecutionFactory

public ExecutionFactory getExecutionFactory()

Get the ExecutionFactory from this ExecutionContext.

Returns:

The Execution factory associated with this ExecutionContext

beginStatement

public void beginStatement(ResultSet sourceRS)
                    throws StandardException

Mark the beginning of a statement (INSERT, UPDATE, DELETE)

Parameters:

sourceRS - Source ResultSet for the statement.

Throws:

StandardException - Thrown on error

endStatement

public void endStatement()
                  throws StandardException

The end of a statement (INSERT, UPDATE, DELETE)

Throws:

StandardException - Thrown on error

siftForeignKeys

public java.lang.Object[] siftForeignKeys(java.lang.Object[] fullList)
                                   throws StandardException

Sifts the array of foreign key constraints for the ones which apply in the current context. In certain contexts (e.g., when applying the COPY file or when tearing-off a new table during REFRESH), we don't want to not bother enforcing some foreign keys.

Parameters:

fullList - the full list of foreign keys that apply for the current statement

Returns:

a pruned back list, which we will actually bother enforcing.

Throws:

StandardException - Thrown on error

siftTriggers

public java.lang.Object siftTriggers(java.lang.Object triggerInfo)
                              throws StandardException

Sifts the triggers for the ones which apply in the current context. In certain contexts (e.g., when applying the COPY file or when tearing-off a new table during REFRESH), we don't want to not bother firing triggers.

Parameters:

triggerInfo - the original trigger info

Returns:

a pruned back triggerInfo, which we will actually bother enforcing.

Throws:

StandardException - Thrown on error