org.everit.osgi.transaction.helper.internal

Class TransactionHelperComponent

java.lang.Object

org.everit.osgi.transaction.helper.internal.TransactionHelperComponent

All Implemented Interfaces:

TransactionHelper

@Properties(value=@Property(name="transactionManager.target"))
 @Service(value=TransactionHelper.class)
 @Reference(name="transactionManager",
           referenceInterface=javax.transaction.TransactionManager.class,
           policy=STATIC,
           bind="setTransactionManager")
public class TransactionHelperComponent
extends Object
implements TransactionHelper

Implementation of TransactionHelper.

Constructor Summary

Constructors

Constructor and Description
TransactionHelperComponent()

Method Summary

Modifier and Type	Method and Description
<R> R	mandatory(java.util.function.Supplier<R> callback) Support a current transaction, throw an exception if none exists.
<R> R	never(java.util.function.Supplier<R> callback) Execute non-transactionally, throw an exception if a transaction exists.
<R> R	notSupported(java.util.function.Supplier<R> callback) Execute non-transactionally, suspend the current transaction if one exists.
<R> R	required(java.util.function.Supplier<R> callback) Support a current transaction, create a new one if none exists.
<R> R	requiresNew(java.util.function.Supplier<R> callback) Create a new transaction, suspend the current transaction if one exists.
protected void	setTransactionManager(TransactionManager transactionManager)
<R> R	supports(java.util.function.Supplier<R> callback) Support a current transaction, execute non-transactionally if none exists.
protected void	unbindTransactionManager(TransactionManager transactionManager)

Methods inherited from class java.lang.Object

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

Constructor Detail

TransactionHelperComponent

public TransactionHelperComponent()

Method Detail

mandatory

public <R> R mandatory(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Support a current transaction, throw an exception if none exists. In case there is an exception in the callback, the transaction status is set to MARKED_ROLLBACK.

Specified by:

mandatory in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

never

public <R> R never(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Execute non-transactionally, throw an exception if a transaction exists.

Specified by:

never in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

notSupported

public <R> R notSupported(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Execute non-transactionally, suspend the current transaction if one exists.

Specified by:

notSupported in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

required

public <R> R required(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Support a current transaction, create a new one if none exists. In case there is an exception in the callback and the function call created the transaction, the transaction will be rollbacked. In case there is an exception and there was already a transaction when the method was called, the transaction status is set to MARKED_ROLLBACK.

Specified by:

required in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

requiresNew

public <R> R requiresNew(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Create a new transaction, suspend the current transaction if one exists. In case there is an exception, the newly created transaction will be rolled back.

Specified by:

requiresNew in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

setTransactionManager

protected void setTransactionManager(TransactionManager transactionManager)

supports

public <R> R supports(java.util.function.Supplier<R> callback)

Description copied from interface: TransactionHelper

Support a current transaction, execute non-transactionally if none exists. If there was an ACTIVE transaction at the time calling the function and the callback throws an exception, the transaction status will be MARKED_ROLLBACK.

Specified by:

supports in interface TransactionHelper

Type Parameters:

R - Return type.

Parameters:

callback - The callback instance will be called inside.

Returns:

The result of the callback execution.

unbindTransactionManager

protected void unbindTransactionManager(TransactionManager transactionManager)