org.multiverse.api

Interface OrElseBlock

All Superinterfaces:

org.multiverse.MultiverseConstants

public interface OrElseBlock
extends org.multiverse.MultiverseConstants

The OrElse is responsible for executing the either block, or in case of a retry, the orelse block is executed.

Another useful features of this design is that for certain primitives it doesn't require any form of boxing. It also provides an atomicChecked for a TxnVoidCallable which doesn't force a developer to return something when nothing needs to be returned.

Field Summary

Fields inherited from interface org.multiverse.MultiverseConstants

LOCKMODE_EXCLUSIVE, LOCKMODE_NONE, LOCKMODE_READ, LOCKMODE_WRITE, SHAKE_BUGS, SPIN_YIELD, TRACING_ENABLED

Method Summary

Modifier and Type	Method and Description
boolean	execute(org.multiverse.api.callables.TxnBooleanCallable either, org.multiverse.api.callables.TxnBooleanCallable orelse) Executes the either, or when it is retried, the orelse block.
<E> E	execute(org.multiverse.api.callables.TxnCallable<E> either, org.multiverse.api.callables.TxnCallable<E> orelse) Executes the either, or when it is retried, the orelse block.
double	execute(org.multiverse.api.callables.TxnDoubleCallable either, org.multiverse.api.callables.TxnDoubleCallable orelse) Executes the either, or when it is retried, the orelse block.
int	execute(org.multiverse.api.callables.TxnIntCallable either, org.multiverse.api.callables.TxnIntCallable orelse) Executes the either, or when it is retried, the orelse block.
long	execute(org.multiverse.api.callables.TxnLongCallable either, org.multiverse.api.callables.TxnLongCallable orelse) Executes the either, or when it is retried, the orelse block.
void	execute(org.multiverse.api.callables.TxnVoidCallable either, org.multiverse.api.callables.TxnVoidCallable orelse) Executes the either, or when it is retried, the orelse block.
boolean	executeChecked(org.multiverse.api.callables.TxnBooleanCallable either, org.multiverse.api.callables.TxnBooleanCallable orelse) Executes the either, or when it is retried, the orelse block.
<E> E	executeChecked(org.multiverse.api.callables.TxnCallable<E> either, org.multiverse.api.callables.TxnCallable<E> orelse) Executes the either, or when it is retried, the orelse block.
double	executeChecked(org.multiverse.api.callables.TxnDoubleCallable either, org.multiverse.api.callables.TxnDoubleCallable orelse) Executes the either, or when it is retried, the orelse block.
int	executeChecked(org.multiverse.api.callables.TxnIntCallable either, org.multiverse.api.callables.TxnIntCallable orelse) Executes the either, or when it is retried, the orelse block.
long	executeChecked(org.multiverse.api.callables.TxnLongCallable either, org.multiverse.api.callables.TxnLongCallable orelse) Executes the either, or when it is retried, the orelse block.
void	executeChecked(org.multiverse.api.callables.TxnVoidCallable either, org.multiverse.api.callables.TxnVoidCallable orelse) Executes the either, or when it is retried, the orelse block.

Method Detail

execute

<E> E execute(org.multiverse.api.callables.TxnCallable<E> either,
              org.multiverse.api.callables.TxnCallable<E> orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

org.multiverse.api.exceptions.TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

<E> E executeChecked(org.multiverse.api.callables.TxnCallable<E> either,
                     org.multiverse.api.callables.TxnCallable<E> orelse)
              throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

org.multiverse.api.exceptions.TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.

execute

int execute(org.multiverse.api.callables.TxnIntCallable either,
            org.multiverse.api.callables.TxnIntCallable orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

org.multiverse.api.exceptions.TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

int executeChecked(org.multiverse.api.callables.TxnIntCallable either,
                   org.multiverse.api.callables.TxnIntCallable orelse)
            throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.

execute

long execute(org.multiverse.api.callables.TxnLongCallable either,
             org.multiverse.api.callables.TxnLongCallable orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

long executeChecked(org.multiverse.api.callables.TxnLongCallable either,
                    org.multiverse.api.callables.TxnLongCallable orelse)
             throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.

execute

double execute(org.multiverse.api.callables.TxnDoubleCallable either,
               org.multiverse.api.callables.TxnDoubleCallable orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

double executeChecked(org.multiverse.api.callables.TxnDoubleCallable either,
                      org.multiverse.api.callables.TxnDoubleCallable orelse)
               throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.

execute

boolean execute(org.multiverse.api.callables.TxnBooleanCallable either,
                org.multiverse.api.callables.TxnBooleanCallable orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

boolean executeChecked(org.multiverse.api.callables.TxnBooleanCallable either,
                       org.multiverse.api.callables.TxnBooleanCallable orelse)
                throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Returns:

the result of the execution.

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.

execute

void execute(org.multiverse.api.callables.TxnVoidCallable either,
             org.multiverse.api.callables.TxnVoidCallable orelse)

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

If in the execution of the closure a checked exception is thrown, the exception is wrapped in a InvisibleCheckedException. The original exception can be retrieved by calling the getCause method.

Parameters:

either -

orelse -

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

org.multiverse.api.exceptions.InvisibleCheckedException - if a checked exception is thrown by the closure.

executeChecked

void executeChecked(org.multiverse.api.callables.TxnVoidCallable either,
                    org.multiverse.api.callables.TxnVoidCallable orelse)
             throws java.lang.Exception

Executes the either, or when it is retried, the orelse block. This operation makes composable blocking operations possible.

Parameters:

either -

orelse -

Throws:

java.lang.NullPointerException - if either or orelse is null.

TxnMandatoryException - if no transaction is found on the TxnThreadLocal.

java.lang.Exception - if the atomicChecked call fails.