org.slieb.throwables

Interface BiFunctionWithThrowable<T,U,R,E extends Throwable>

Type Parameters:

T - some generic flag

U - some generic flag

R - some generic flag

E - The extension

All Superinterfaces:

BiFunction<T,U,R>

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 BiFunctionWithThrowable<T,U,R,E extends Throwable>
extends BiFunction<T,U,R>

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

Method Summary

Modifier and Type	Method and Description
static <T,U,R,E extends Throwable> BiFunction<T,U,R>	aBiFunctionThatUnsafelyThrowsUnchecked(BiFunctionWithThrowable<T,U,R,E> bifunctionwiththrowable) Utility method to unwrap lambdas of type BiFunction and withUncheckedThrowable any Exception
default R	apply(T v1, U v2) Overridden method of BiFunctionWithThrowable that will call applyWithThrowable, but catching any exceptions.
R	applyWithThrowable(T v1, U v2) Functional method that will throw exceptions.
static <T,U,R,E extends Throwable> BiFunctionWithThrowable<T,U,R,E>	asBiFunctionWithThrowable(BiFunction<T,U,R> bifunction) Utility method to convert BiFunctionWithThrowable
static <T,U,R,E extends Throwable> BiFunctionWithThrowable<T,U,R,E>	castBiFunctionWithThrowable(BiFunctionWithThrowable<T,U,R,E> bifunctionwiththrowable) Utility method to mark lambdas of type BiFunctionWithThrowable
default BiFunctionWithThrowable<T,U,R,E>	onException(BiConsumer<Throwable,Object[]> consumer)
default BiFunctionWithThrowable<T,U,R,E>	onException(Consumer<Throwable> consumer)
default BiFunction<T,U,R>	thatReturnsOnCatch(R defaultReturnValue)
default BiFunction<T,U,Optional<R>>	thatReturnsOptional()
default BiFunction<T,U,R>	thatUnsafelyThrowsUnchecked()
default BiFunctionWithThrowable<T,U,R,E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default BiFunctionWithThrowable<T,U,R,E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default BiFunctionWithThrowable<T,U,R,E>	withLogging(org.slf4j.Logger logger, String message)

Methods inherited from interface java.util.function.BiFunction

andThen

Method Detail

castBiFunctionWithThrowable

static <T,U,R,E extends Throwable> BiFunctionWithThrowable<T,U,R,E> castBiFunctionWithThrowable(BiFunctionWithThrowable<T,U,R,E> bifunctionwiththrowable)

Utility method to mark lambdas of type BiFunctionWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on BiFunction

U - Generic that corresponds to the same generic on BiFunction

R - Generic that corresponds to the same generic on BiFunction

E - The type this interface is allowed to throw

Parameters:

bifunctionwiththrowable - The interface instance

Returns:

the cast interface

aBiFunctionThatUnsafelyThrowsUnchecked

static <T,U,R,E extends Throwable> BiFunction<T,U,R> aBiFunctionThatUnsafelyThrowsUnchecked(BiFunctionWithThrowable<T,U,R,E> bifunctionwiththrowable)
                                                                                     throws E extends Throwable

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

Type Parameters:

T - Generic that corresponds to the same generic on BiFunction

U - Generic that corresponds to the same generic on BiFunction

R - Generic that corresponds to the same generic on BiFunction

E - The type this interface is allowed to throw

Parameters:

bifunctionwiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from bifunctionwiththrowable

E extends Throwable

asBiFunctionWithThrowable

static <T,U,R,E extends Throwable> BiFunctionWithThrowable<T,U,R,E> asBiFunctionWithThrowable(BiFunction<T,U,R> bifunction)

Utility method to convert BiFunctionWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on BiFunction

U - Generic that corresponds to the same generic on BiFunction

R - Generic that corresponds to the same generic on BiFunction

E - The type this interface is allowed to throw

Parameters:

bifunction - The interface instance

Returns:

the cast interface

apply

default R apply(T v1,
                U v2)

Overridden method of BiFunctionWithThrowable that will call applyWithThrowable, but catching any exceptions.

Specified by:

apply in interface BiFunction<T,U,R>

Parameters:

v1 - parameter to overridden method

v2 - parameter to overridden method

Returns:

the value

applyWithThrowable

R applyWithThrowable(T v1,
                     U v2)
              throws E extends Throwable

Functional method that will throw exceptions.

Parameters:

v1 - parameter to overridden method

v2 - parameter to overridden method

Returns:

the value

Throws:

E - some exception

E extends Throwable

thatReturnsOptional

default BiFunction<T,U,Optional<R>> thatReturnsOptional()

Returns:

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

thatReturnsOnCatch

default BiFunction<T,U,R> thatReturnsOnCatch(R 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 BiFunction<T,U,R> 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 BiFunctionWithThrowable<T,U,R,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 BiFunctionWithThrowable<T,U,R,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 BiFunctionWithThrowable<T,U,R,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 BiFunctionWithThrowable<T,U,R,E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger

onException

default BiFunctionWithThrowable<T,U,R,E> onException(BiConsumer<Throwable,Object[]> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger