de.team33.libs.testing.v1

Interface Attempts<X extends Exception>

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

public interface Attempts<X extends Exception>

Abstracts a tool for performing a certain operation repeatedly. Both parallel and serial execution are possible.

Method Summary

Modifier and Type	Method and Description
List<Throwable>	getCaught() Returns any exceptions that might have occurred while performing the associated operation.
void	reThrowCaught() Re-throws one of the exceptions that may have occurred while executing the associated operation.
static <X extends Exception> Attempts<X>	runParallel(int count, XConsumer<Integer,X> xConsumer) Repeatedly performs a specific operation in parallel threads.
static <X extends Exception> Attempts<X>	runParallel(int count, XRunnable<X> xRunnable) Repeatedly performs a specific operation in parallel threads.
static <X extends Exception> Attempts<X>	runSerial(int count, XConsumer<Integer,X> xConsumer) Repeatedly performs a specific operation in the current thread.
static <X extends Exception> Attempts<X>	runSerial(int count, XRunnable<X> xRunnable) Repeatedly performs a specific operation in the current thread.
static <X extends Exception> void	tryParallel(int count, XConsumer<Integer,X> xConsumer) Repeatedly performs a specific operation in parallel threads.
static <X extends Exception> void	tryParallel(int count, XRunnable<X> xRunnable) Repeatedly performs a specific operation in parallel threads.
static <X extends Exception> void	trySerial(int count, XConsumer<Integer,X> xConsumer) Repeatedly performs a specific operation in the current thread.
static <X extends Exception> void	trySerial(int count, XRunnable<X> xRunnable) Repeatedly performs a specific operation in the current thread.

Method Detail

tryParallel

static <X extends Exception> void tryParallel(int count,
                                              XRunnable<X> xRunnable)
                                       throws X extends Exception

Repeatedly performs a specific operation in parallel threads.

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xRunnable - the operation

Throws:

Error - if an Error occurred while performing the operation.

RuntimeException - if a RuntimeException occurred while performing the operation.

X - if an Exception of type <X> occurred while performing the operation.

X extends Exception

See Also:

trySerial(int, XRunnable), tryParallel(int, XConsumer), runParallel(int, XRunnable)

tryParallel

static <X extends Exception> void tryParallel(int count,
                                              XConsumer<Integer,X> xConsumer)
                                       throws X extends Exception

Repeatedly performs a specific operation in parallel threads. In this variant, the operation receives a unique consecutive number as a parameter

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xConsumer - the operation

Throws:

Error - if an Error occurred while performing the operation.

RuntimeException - if a RuntimeException occurred while performing the operation.

X - if an Exception of type <X> occurred while performing the operation.

X extends Exception

See Also:

trySerial(int, XConsumer), tryParallel(int, XRunnable), runParallel(int, XConsumer)

runParallel

static <X extends Exception> Attempts<X> runParallel(int count,
                                                     XRunnable<X> xRunnable)

Repeatedly performs a specific operation in parallel threads.

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xRunnable - the operation

Returns:

An instance of Attempts. This contains the exceptions that actually occurred during the execution of the operation.

See Also:

runSerial(int, XRunnable), runParallel(int, XConsumer), tryParallel(int, XRunnable)

runParallel

static <X extends Exception> Attempts<X> runParallel(int count,
                                                     XConsumer<Integer,X> xConsumer)

Repeatedly performs a specific operation in parallel threads. In this variant, the operation receives a unique consecutive number as a parameter

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xConsumer - the operation

Returns:

An instance of Attempts. This contains the exceptions that actually occurred during the execution of the operation.

See Also:

runSerial(int, XConsumer), runParallel(int, XRunnable), tryParallel(int, XConsumer)

trySerial

static <X extends Exception> void trySerial(int count,
                                            XRunnable<X> xRunnable)
                                     throws X extends Exception

Repeatedly performs a specific operation in the current thread.

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xRunnable - the operation

Throws:

Error - if an Error occurred while performing the operation.

RuntimeException - if a RuntimeException occurred while performing the operation.

X - if an Exception of type <X> occurred while performing the operation.

X extends Exception

See Also:

tryParallel(int, XRunnable), trySerial(int, XConsumer), runSerial(int, XRunnable)

trySerial

static <X extends Exception> void trySerial(int count,
                                            XConsumer<Integer,X> xConsumer)
                                     throws X extends Exception

Repeatedly performs a specific operation in the current thread. In this variant, the operation receives a unique consecutive number as a parameter

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xConsumer - the operation

Throws:

Error - if an Error occurred while performing the operation.

RuntimeException - if a RuntimeException occurred while performing the operation.

X - if an Exception of type <X> occurred while performing the operation.

X extends Exception

See Also:

tryParallel(int, XRunnable), trySerial(int, XRunnable), runSerial(int, XConsumer)

runSerial

static <X extends Exception> Attempts<X> runSerial(int count,
                                                   XRunnable<X> xRunnable)

Repeatedly performs a specific operation in the current thread. In this variant, the operation receives a unique consecutive number as a parameter

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xRunnable - the operation

Returns:

An instance of Attempts. This contains the exceptions that actually occurred during the execution of the operation.

See Also:

runParallel(int, XRunnable), runSerial(int, XConsumer), trySerial(int, XRunnable)

runSerial

static <X extends Exception> Attempts<X> runSerial(int count,
                                                   XConsumer<Integer,X> xConsumer)

Repeatedly performs a specific operation in the current thread. In this variant, the operation receives a unique consecutive number as a parameter

Type Parameters:

X - A type of (checked) exception that may occur while performing the operation.

Parameters:

count - the number of parallel threads

xConsumer - the operation

Returns:

An instance of Attempts. This contains the exceptions that actually occurred during the execution of the operation.

See Also:

runParallel(int, XConsumer), runSerial(int, XRunnable), trySerial(int, XConsumer)

reThrowCaught

void reThrowCaught()
            throws X extends Exception

Re-throws one of the exceptions that may have occurred while executing the associated operation.

Throws:

Error - if an Error occurred while performing the operation.

RuntimeException - if a RuntimeException occurred while performing the operation.

X - if an Exception of type <X> occurred while performing the operation.

X extends Exception

getCaught

List<Throwable> getCaught()

Returns any exceptions that might have occurred while performing the associated operation.