Skip navigation links

oracle.odi.core.persistence.transaction
Interface ITransactionDefinition

All Known Implementing Classes:

DefaultTransactionDefinition, TransactionTemplate

public interface ITransactionDefinition

Interface that defines ODI transaction properties. Based on the propagation behavior definitions analogous to EJB CMT attributes.

Since:

11.1.1.3.0

Field Summary

static int	PROPAGATION_MANDATORY Support a current transaction; throw an exception if no current transaction exists.
static int	PROPAGATION_NEVER Do not support a current transaction; throw an exception if a current transaction exists.
static int	PROPAGATION_NOT_SUPPORTED Do not support a current transaction; rather always execute non-transactionally.
static int	PROPAGATION_REQUIRED Support a current transaction; create a new one if none exists.
static int	PROPAGATION_REQUIRES_NEW Create a new transaction, suspending the current transaction if one exists.
static int	PROPAGATION_SUPPORTS Support a current transaction; execute non-transactionally if none exists.
static int	TIMEOUT_DEFAULT Use the default timeout of the underlying transaction system, or none if timeouts are not supported.

Method Summary

IOdiEntityManager	getExtendedPersistentContext() Return extended persistence context.
java.lang.String	getName() Return the name of this transaction.
int	getPropagationBehavior() Return the propagation behavior.
int	getTimeout() Return the transaction timeout.

Field Detail

PROPAGATION_MANDATORY

static final int PROPAGATION_MANDATORY

Support a current transaction; throw an exception if no current transaction exists. Analogous to the EJB transaction attribute of the same name.

Note that transaction synchronization within a PROPAGATION_MANDATORY scope will always be driven by the surrounding transaction.

See Also:

Constant Field Values

PROPAGATION_NEVER

static final int PROPAGATION_NEVER

Do not support a current transaction; throw an exception if a current transaction exists. Analogous to the EJB transaction attribute of the same name.

Note that transaction synchronization is not available within a PROPAGATION_NEVER scope.

See Also:

Constant Field Values

PROPAGATION_NOT_SUPPORTED

static final int PROPAGATION_NOT_SUPPORTED

Do not support a current transaction; rather always execute non-transactionally. Analogous to the EJB transaction attribute of the same name.

NOTE: Actual transaction suspension will not work out-of-the-box on all transaction managers. This in particular applies to org.springframework.transaction.jta.JtaTransactionManager, which requires the javax.transaction.TransactionManager to be made available it to it (which is server-specific in standard J2EE).

Note that transaction synchronization is not available within a PROPAGATION_NOT_SUPPORTED scope. Existing synchronizations will be suspended and resumed appropriately.

See Also:

Constant Field Values

PROPAGATION_REQUIRED

static final int PROPAGATION_REQUIRED

Support a current transaction; create a new one if none exists. Analogous to the EJB transaction attribute of the same name.

This is typically the default setting of a transaction definition, and typically defines a transaction synchronization scope.

See Also:

Constant Field Values

PROPAGATION_REQUIRES_NEW

static final int PROPAGATION_REQUIRES_NEW

Create a new transaction, suspending the current transaction if one exists. Analogous to the EJB transaction attribute of the same name.

NOTE: Actual transaction suspension will not work out-of-the-box on all transaction managers. This in particular applies to org.springframework.transaction.jta.JtaTransactionManager, which requires the javax.transaction.TransactionManager to be made available it to it (which is server-specific in standard J2EE).

A PROPAGATION_REQUIRES_NEW scope always defines its own transaction synchronizations. Existing synchronizations will be suspended and resumed appropriately.

See Also:

Constant Field Values

PROPAGATION_SUPPORTS

static final int PROPAGATION_SUPPORTS

Support a current transaction; execute non-transactionally if none exists. Analogous to the EJB transaction attribute of the same name.

NOTE: For transaction managers with transaction synchronization, PROPAGATION_SUPPORTS is slightly different from no transaction at all, as it defines a transaction scope that synchronization might apply to. As a consequence, the same resources (a JDBC Connection, a Hibernate Session, etc) will be shared for the entire specified scope. Note that the exact behavior depends on the actual synchronization configuration of the transaction manager!

In general, use PROPAGATION_SUPPORTS with care! In particular, do not rely on PROPAGATION_REQUIRED or PROPAGATION_REQUIRES_NEW within a PROPAGATION_SUPPORTS scope (which may lead to synchronization conflicts at runtime). If such nesting is unavoidable, make sure to configure your transaction manager appropriately (typically switching to "synchronization on actual transaction").

See Also:

Constant Field Values

TIMEOUT_DEFAULT

static final int TIMEOUT_DEFAULT

Use the default timeout of the underlying transaction system, or none if timeouts are not supported.

See Also:

Constant Field Values

Method Detail

getName

java.lang.String getName()

Return the name of this transaction. Can be null.

Returns:

the name of this transaction

getPropagationBehavior

int getPropagationBehavior()

Return the propagation behavior.

Must return one of the PROPAGATION_XXX constants defined on this interface.

Returns:

the propagation behavior

getTimeout

int getTimeout()

Return the transaction timeout.

Must return a number of seconds, or DefaultTransactionDefinition.TIMEOUT_DEFAULT.

Returns:

the transaction timeout

getExtendedPersistentContext

IOdiEntityManager getExtendedPersistentContext()

Return extended persistence context.

Returns:

an IOdiEntityManager, or null if undefined / not used.

Skip navigation links