org.sellcom.core.util.function

Interface ThrowingSupplier<T>

All Superinterfaces:

Supplier<T>

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 ThrowingSupplier<T>
extends Supplier<T>

Represents a supplier of results, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
default Supplier<T>	fallbackTo(Supplier<T> fallback) Returns a Supplier returning from the given supplier if this supplier throws an exception.
default Supplier<T>	fallbackTo(Supplier<T> fallback, Consumer<Exception> exceptionConsumer) Returns a Supplier returning from the given supplier if this supplier throws an exception.
default T	get() Returns a result.
T	getThrowing() Returns a result.
default Supplier<T>	orReturn(T value) Returns a Supplier returning the given value if this supplier throws an exception.
default Supplier<T>	orReturn(T value, Consumer<Exception> exceptionConsumer) Returns a Supplier returning the given value if this supplier throws an exception.
default ThrowingSupplier<T>	orThrow(Class<? extends RuntimeException> exceptionClass) Returns a ThrowingSupplier throwing an exception of the given type if this supplier throws an exception.
default ThrowingSupplier<T>	orThrow(Class<? extends RuntimeException> exceptionClass, String message) Returns a ThrowingSupplier throwing an exception of the given type if this supplier throws an exception.
default ThrowingSupplier<T>	orTryWith(ThrowingSupplier<? extends T> other) Returns a ThrowingSupplier returning from the given supplier if this supplier throws an exception.
default ThrowingSupplier<T>	orTryWith(ThrowingSupplier<? extends T> other, Consumer<Exception> exceptionConsumer) Returns a ThrowingSupplier returning from the given supplier if this supplier throws an exception.

Method Detail

fallbackTo

default Supplier<T> fallbackTo(Supplier<T> fallback)

Returns a Supplier returning from the given supplier if this supplier throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

default Supplier<T> fallbackTo(Supplier<T> fallback,
                               Consumer<Exception> exceptionConsumer)

Returns a Supplier returning from the given supplier if this supplier throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

get

default T get()

Returns a result. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

get in interface Supplier<T>

Since:

1.0

getThrowing

T getThrowing()
       throws Exception

Returns a result.

Throws:

Exception

Since:

1.0

orReturn

default Supplier<T> orReturn(T value)

Returns a Supplier returning the given value if this supplier throws an exception.

Since:

1.0

orReturn

default Supplier<T> orReturn(T value,
                             Consumer<Exception> exceptionConsumer)

Returns a Supplier returning the given value if this supplier throws an exception.

Since:

1.0

orThrow

default ThrowingSupplier<T> orThrow(Class<? extends RuntimeException> exceptionClass)

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

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

Throws:

IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

default ThrowingSupplier<T> orThrow(Class<? extends RuntimeException> exceptionClass,
                                    String message)

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

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

Throws:

IllegalArgumentException - if exceptionClass is null

Since:

1.0

orTryWith

default ThrowingSupplier<T> orTryWith(ThrowingSupplier<? extends T> other)

Returns a ThrowingSupplier returning from the given supplier if this supplier throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingSupplier<T> orTryWith(ThrowingSupplier<? extends T> other,
                                      Consumer<Exception> exceptionConsumer)

Returns a ThrowingSupplier returning from the given supplier if this supplier throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0