me.jaksa

Class Transactions

java.lang.Object

me.jaksa.Transactions

public class Transactions
extends Object

Provides utility functions for lightweight transaction management. Full ACID transaction semantics are NOT provided. The methods in this class allow weak atomicity: either all or no operations will be performed as long as the process doesn't crash. The user must provide rollback and/or commit mechanisms. For critical applications where preserving atomicity even in crash scenarios is more important than performance, you should use a full transaction manager. Consistency, Isolation and Durability must be implemented by the user.

Constructor Summary

Constructors

Constructor and Description
Transactions()

Method Summary

Modifier and Type	Method and Description
static <T> T	atomically(FunctionalTransaction<T> transaction) Tries to evaluate a FunctionalTransaction, retrying each one several times in case of failures.
static void	atomically(VoidTransaction... voidTransactions) Tries to perform one or more VoidTransactions, retrying each one several times in case of failures.
static <T> FunctionalTransaction<T>	evaluate(SupplierWithException<T> function) Builds a FunctionalTransaction that can have a rollback and/or a commit.
static VoidTransaction	perform(RunnableWithException r) Builds an VoidTransaction that can have a rollback and/or a commit.

Methods inherited from class java.lang.Object

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

Constructor Detail

Transactions

public Transactions()

Method Detail

perform

public static VoidTransaction perform(RunnableWithException r)

Builds an VoidTransaction that can have a rollback and/or a commit.

Parameters:

r - the operation to perform

Returns:

the VoidTransaction object for chaining modifiers

atomically

public static void atomically(VoidTransaction... voidTransactions)

Tries to perform one or more VoidTransactions, retrying each one several times in case of failures. VoidTransactions can have defined rollbacks and commits, number of retries etc.

Parameters:

voidTransactions - the transactions to perform

evaluate

public static <T> FunctionalTransaction<T> evaluate(SupplierWithException<T> function)

Builds a FunctionalTransaction that can have a rollback and/or a commit.

Type Parameters:

T - the type of the value to return

Parameters:

function - the function to evaluate

Returns:

the value returned by a successful invocation of the function

atomically

public static <T> T atomically(FunctionalTransaction<T> transaction)

Tries to evaluate a FunctionalTransaction, retrying each one several times in case of failures. FunctionalTransactions can have defined rollbacks and commits, number of retries etc.

Type Parameters:

T - the type of the value to return

Parameters:

transaction - the transactiontransaction to evaluate

Returns:

the value returned by a successful invocation of the function