org.slieb.throwables

Interface SupplierWithThrowable<T,E extends Throwable>

Type Parameters:

T - some generic flag

E - The extension

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 SupplierWithThrowable<T,E extends Throwable>
extends Supplier<T>

Generated from Supplier Extends java.util.function.Supplier to allow for a checked exception.

Method Summary

Modifier and Type	Method and Description
static <T,E extends Throwable> SupplierWithThrowable<T,E>	asSupplierWithThrowable(Supplier<T> supplier) Utility method to convert SupplierWithThrowable
static <T,E extends Throwable> Supplier<T>	aSupplierThatUnsafelyThrowsUnchecked(SupplierWithThrowable<T,E> supplierwiththrowable) Utility method to unwrap lambdas of type Supplier and withUncheckedThrowable any Exception
static <T,E extends Throwable> SupplierWithThrowable<T,E>	castSupplierWithThrowable(SupplierWithThrowable<T,E> supplierwiththrowable) Utility method to mark lambdas of type SupplierWithThrowable
default T	get() Overridden method of SupplierWithThrowable that will call getWithThrowable, but catching any exceptions.
T	getWithThrowable() Functional method that will throw exceptions.
default SupplierWithThrowable<T,E>	onException(Consumer<Throwable> consumer)
default Supplier<T>	thatReturnsOnCatch(T defaultReturnValue)
default Supplier<Optional<T>>	thatReturnsOptional()
default Supplier<T>	thatUnsafelyThrowsUnchecked()
default SupplierWithThrowable<T,E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default SupplierWithThrowable<T,E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default SupplierWithThrowable<T,E>	withLogging(org.slf4j.Logger logger, String message)

Method Detail

castSupplierWithThrowable

static <T,E extends Throwable> SupplierWithThrowable<T,E> castSupplierWithThrowable(SupplierWithThrowable<T,E> supplierwiththrowable)

Utility method to mark lambdas of type SupplierWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on Supplier

E - The type this interface is allowed to throw

Parameters:

supplierwiththrowable - The interface instance

Returns:

the cast interface

aSupplierThatUnsafelyThrowsUnchecked

static <T,E extends Throwable> Supplier<T> aSupplierThatUnsafelyThrowsUnchecked(SupplierWithThrowable<T,E> supplierwiththrowable)
                                                                         throws E extends Throwable

Utility method to unwrap lambdas of type Supplier and withUncheckedThrowable any Exception

Type Parameters:

T - Generic that corresponds to the same generic on Supplier

E - The type this interface is allowed to throw

Parameters:

supplierwiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from supplierwiththrowable

E extends Throwable

asSupplierWithThrowable

static <T,E extends Throwable> SupplierWithThrowable<T,E> asSupplierWithThrowable(Supplier<T> supplier)

Utility method to convert SupplierWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on Supplier

E - The type this interface is allowed to throw

Parameters:

supplier - The interface instance

Returns:

the cast interface

get

default T get()

Overridden method of SupplierWithThrowable that will call getWithThrowable, but catching any exceptions.

Specified by:

get in interface Supplier<T>

Returns:

the value

getWithThrowable

T getWithThrowable()
            throws E extends Throwable

Functional method that will throw exceptions.

Returns:

the value

Throws:

E - some exception

E extends Throwable

thatReturnsOptional

default Supplier<Optional<T>> thatReturnsOptional()

Returns:

An interface that will wrap the result in an optional, and return an empty optional when an exception occurs.

thatReturnsOnCatch

default Supplier<T> thatReturnsOnCatch(T defaultReturnValue)

Parameters:

defaultReturnValue - A value to return if any throwable is caught.

Returns:

An interface that returns a default value if any exception occurs.

thatUnsafelyThrowsUnchecked

default Supplier<T> thatUnsafelyThrowsUnchecked()
                                         throws E extends Throwable

Returns:

An interface that is only returned if no exception has been thrown.

Throws:

E - if an exception E has been thrown, it is rethrown by this method

E extends Throwable

withLogging

default SupplierWithThrowable<T,E> withLogging(org.slf4j.Logger logger,
                                               String message)

Parameters:

logger - The logger to log exceptions on

message - A message to use for logging exceptions

Returns:

An interface that will log all exceptions to given logger

withLogging

default SupplierWithThrowable<T,E> withLogging(org.slf4j.Logger logger)

Will log WARNING level exceptions on logger if they occur within the interface

Parameters:

logger - The logger instance to log exceptions on

Returns:

An interface that will log exceptions on given logger

withLogging

default SupplierWithThrowable<T,E> withLogging()

Will log WARNING level exceptions on logger if they occur within the interface

Returns:

An interface that will log exceptions on global logger

onException

default SupplierWithThrowable<T,E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger