org.hibernate.resource.transaction.backend.jta.internal.synchronization

Interface SynchronizationCallbackTarget

All Known Implementing Classes:

JtaTransactionCoordinatorImpl

public interface SynchronizationCallbackTarget

Defines "inflow" for JTA transactions from the perspective of Hibernate's registered JTA Synchronization back into the TransactionCoordinator by means of the SynchronizationCallbackCoordinator.

That's a mouthful :) The way it works is like this...

• Hibernate will register a JTA Synchronization implementation (RegisteredSynchronization) which allows it to listen for completion of the JTA transaction.
• That RegisteredSynchronization is given a SynchronizationCallbackCoordinator which it uses to route the transaction completion calls back into Hibernate. The SynchronizationCallbackCoordinator contract applies various behaviors around this process. See the impls for details.
• The SynchronizationCallbackCoordinator is handed a SynchronizationCallbackTarget which is the specific means for it to "route the transaction completion calls back into Hibernate". The SynchronizationCallbackTarget is most often the TransactionCoordinator impl or a direct delegate of the TransactionCoordinator impl. In that sense, SynchronizationCallbackTarget is the contract between the SynchronizationCallbackCoordinator and the TransactionCoordinator.

Author:

Steve Ebersole

Method Summary

Modifier and Type	Method and Description
void	afterCompletion(boolean successful, boolean delayed) Callback of after-completion.
void	beforeCompletion() Callback of before-completion.
boolean	isActive() Is the callback target still active?

Method Detail

isActive

boolean isActive()

Is the callback target still active? Generally this is checked by the caller prior to calling beforeCompletion() or afterCompletion(boolean, boolean)

Returns:

true indicates the target is active; false indicates it is not.

beforeCompletion

void beforeCompletion()

Callback of before-completion.

See Also:

Synchronization.beforeCompletion()

afterCompletion

void afterCompletion(boolean successful,
                     boolean delayed)

Callback of after-completion.

Parameters:

successful - Was the transaction successful?

See Also:

Synchronization.afterCompletion(int)