Package org.sellcom.core.util.function

Interface ThrowingSupplier<T>

All Superinterfaces:

java.util.function.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 java.util.function.Supplier<T>

Represents a supplier of results, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method	Description
default java.util.function.Supplier<T>	fallbackTo(java.util.function.Supplier<T> fallback)	Returns a Supplier returning from the given supplier if this supplier throws an exception.
default java.util.function.Supplier<T>	fallbackTo(java.util.function.Supplier<T> fallback, java.util.function.Consumer<java.lang.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 java.util.function.Supplier<T>	orReturn(T value)	Returns a Supplier returning the given value if this supplier throws an exception.
default java.util.function.Supplier<T>	orReturn(T value, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a Supplier returning the given value if this supplier throws an exception.
default ThrowingSupplier<T>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingSupplier throwing an exception of the given type if this supplier throws an exception.
default ThrowingSupplier<T>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.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, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a ThrowingSupplier returning from the given supplier if this supplier throws an exception.

Method Detail

fallbackTo

default java.util.function.Supplier<T> fallbackTo(java.util.function.Supplier<T> fallback)

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

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

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

Throws:

java.lang.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 java.util.function.Supplier<T>

Since:

1.0

getThrowing

T getThrowing()
       throws java.lang.Exception

Returns a result.

Throws:

java.lang.Exception

Since:

1.0

orReturn

default java.util.function.Supplier<T> orReturn(T value)

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

Since:

1.0

orReturn

default java.util.function.Supplier<T> orReturn(T value,
                                                java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

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

Since:

1.0

orThrow

default ThrowingSupplier<T> orThrow(java.lang.Class<? extends java.lang.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:

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

default ThrowingSupplier<T> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass,
                                    java.lang.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:

java.lang.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:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingSupplier<T> orTryWith(ThrowingSupplier<? extends T> other,
                                      java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

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

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0