org.slieb.throwables

Interface BinaryOperatorWithThrowable<T,E extends Throwable>

Type Parameters:

T - some generic flag

E - The extension

All Superinterfaces:

BiFunction<T,T,T>, BinaryOperator<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 BinaryOperatorWithThrowable<T,E extends Throwable>
extends BinaryOperator<T>

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

Method Summary

Modifier and Type	Method and Description
static <T,E extends Throwable> BinaryOperator<T>	aBinaryOperatorThatUnsafelyThrowsUnchecked(BinaryOperatorWithThrowable<T,E> binaryoperatorwiththrowable) Utility method to unwrap lambdas of type BinaryOperator and withUncheckedThrowable any Exception
default T	apply(T v1, T v2) Overridden method of BinaryOperatorWithThrowable that will call applyWithThrowable, but catching any exceptions.
T	applyWithThrowable(T v1, T v2) Functional method that will throw exceptions.
static <T,E extends Throwable> BinaryOperatorWithThrowable<T,E>	asBinaryOperatorWithThrowable(BinaryOperator<T> binaryoperator) Utility method to convert BinaryOperatorWithThrowable
static <T,E extends Throwable> BinaryOperatorWithThrowable<T,E>	castBinaryOperatorWithThrowable(BinaryOperatorWithThrowable<T,E> binaryoperatorwiththrowable) Utility method to mark lambdas of type BinaryOperatorWithThrowable
default BinaryOperatorWithThrowable<T,E>	onException(BiConsumer<Throwable,Object[]> consumer)
default BinaryOperatorWithThrowable<T,E>	onException(Consumer<Throwable> consumer)
default BinaryOperator<T>	thatReturnsOnCatch(T defaultReturnValue)
default BinaryOperator<T>	thatUnsafelyThrowsUnchecked()
default BinaryOperatorWithThrowable<T,E>	withLogging() Will log WARNING level exceptions on logger if they occur within the interface
default BinaryOperatorWithThrowable<T,E>	withLogging(org.slf4j.Logger logger) Will log WARNING level exceptions on logger if they occur within the interface
default BinaryOperatorWithThrowable<T,E>	withLogging(org.slf4j.Logger logger, String message)

Methods inherited from interface java.util.function.BinaryOperator

maxBy, minBy

Methods inherited from interface java.util.function.BiFunction

andThen

Method Detail

castBinaryOperatorWithThrowable

static <T,E extends Throwable> BinaryOperatorWithThrowable<T,E> castBinaryOperatorWithThrowable(BinaryOperatorWithThrowable<T,E> binaryoperatorwiththrowable)

Utility method to mark lambdas of type BinaryOperatorWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on BinaryOperator

E - The type this interface is allowed to throw

Parameters:

binaryoperatorwiththrowable - The interface instance

Returns:

the cast interface

aBinaryOperatorThatUnsafelyThrowsUnchecked

static <T,E extends Throwable> BinaryOperator<T> aBinaryOperatorThatUnsafelyThrowsUnchecked(BinaryOperatorWithThrowable<T,E> binaryoperatorwiththrowable)
                                                                                     throws E extends Throwable

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

Type Parameters:

T - Generic that corresponds to the same generic on BinaryOperator

E - The type this interface is allowed to throw

Parameters:

binaryoperatorwiththrowable - The interface instance

Returns:

the cast interface

Throws:

E - the original Exception from binaryoperatorwiththrowable

E extends Throwable

asBinaryOperatorWithThrowable

static <T,E extends Throwable> BinaryOperatorWithThrowable<T,E> asBinaryOperatorWithThrowable(BinaryOperator<T> binaryoperator)

Utility method to convert BinaryOperatorWithThrowable

Type Parameters:

T - Generic that corresponds to the same generic on BinaryOperator

E - The type this interface is allowed to throw

Parameters:

binaryoperator - The interface instance

Returns:

the cast interface

apply

default T apply(T v1,
                T v2)

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

Specified by:

apply in interface BiFunction<T,T,T>

Parameters:

v1 - parameter to overridden method

v2 - parameter to overridden method

Returns:

the value

applyWithThrowable

T applyWithThrowable(T v1,
                     T 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

thatReturnsOnCatch

default BinaryOperator<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 BinaryOperator<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 BinaryOperatorWithThrowable<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 BinaryOperatorWithThrowable<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 BinaryOperatorWithThrowable<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 BinaryOperatorWithThrowable<T,E> onException(Consumer<Throwable> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger

onException

default BinaryOperatorWithThrowable<T,E> onException(BiConsumer<Throwable,Object[]> consumer)

Parameters:

consumer - An exception consumer.

Returns:

An interface that will log all exceptions to given logger