Package org.sellcom.core.util.function

Interface ThrowingRunnable

All Superinterfaces:

java.lang.Runnable

Functional Interface:

This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.

@FunctionalInterface
public interface ThrowingRunnable
extends java.lang.Runnable

Represents an operation that accepts no arguments and returns no result, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
default java.lang.Runnable	fallbackTo(java.lang.Runnable fallback)	Returns a Runnable performing the given operation if this operation throws an exception.
default java.lang.Runnable	fallbackTo(java.lang.Runnable fallback, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a Runnable performing the given operation if this operation throws an exception.
default java.lang.Runnable	orDoNothing()	Returns a Runnable performing no other operation if this operation throws an exception.
default java.lang.Runnable	orDoNothing(java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a Runnable performing no other operation if this operation throws an exception.
default ThrowingRunnable	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingRunnable throwing an exception of the given type if this operation throws an exception.
default ThrowingRunnable	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.String message)	Returns a ThrowingRunnable throwing an exception of the given type if this operation throws an exception.
default ThrowingRunnable	orTryWith(ThrowingRunnable other)	Returns a ThrowingRunnable performing the given operation if this operation throws an exception.
default ThrowingRunnable	orTryWith(ThrowingRunnable other, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a ThrowingRunnable performing the given operation if this operation throws an exception.
default void	run()	Performs this operation.
void	runThrowing()	Performs this operation.

Method Detail

fallbackTo

default java.lang.Runnable fallbackTo(java.lang.Runnable fallback)

Returns a Runnable performing the given operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

default java.lang.Runnable fallbackTo(java.lang.Runnable fallback,
                                      java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a Runnable performing the given operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orDoNothing

default java.lang.Runnable orDoNothing()

Returns a Runnable performing no other operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orDoNothing

default java.lang.Runnable orDoNothing(java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a Runnable performing no other operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orThrow

default ThrowingRunnable orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)

Returns a ThrowingRunnable throwing an exception of the given type if this operation throws an exception. The original exception thrown by this operation is the cause of the thrown exception.

The exception class must have a constructor accepting a single Throwable as an argument.

Throws:

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

default ThrowingRunnable orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass,
                                 java.lang.String message)

Returns a ThrowingRunnable throwing an exception of the given type if this operation throws an exception. The original exception thrown by this operation is the cause of the thrown exception.

The exception class must have a constructor accepting String and Throwable as arguments.

Throws:

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orTryWith

default ThrowingRunnable orTryWith(ThrowingRunnable other)

Returns a ThrowingRunnable performing the given operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingRunnable orTryWith(ThrowingRunnable other,
                                   java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

Returns a ThrowingRunnable performing the given operation if this operation throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

run

default void run()

Performs this operation. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

run in interface java.lang.Runnable

Since:

1.0

runThrowing

void runThrowing()
          throws java.lang.Exception

Performs this operation.

Throws:

java.lang.Exception

Since:

1.0