org.sellcom.core.util.function

Interface ThrowingBiPredicate<T,U>

All Superinterfaces:

BiPredicate<T,U>

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 ThrowingBiPredicate<T,U>
extends BiPredicate<T,U>

Represents a predicate (boolean-valued function) of two arguments, possibly throwing an exception.

Since:

1.0

Method Summary

Modifier and Type	Method and Description
default BiPredicate<T,U>	fallbackTo(BiPredicate<T,U> fallback) Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default BiPredicate<T,U>	fallbackTo(BiPredicate<T,U> fallback, Consumer<Exception> exceptionConsumer) Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default BiPredicate<T,U>	orReturn(boolean value) Returns a BiPredicate returning the given value if this predicate throws an exception.
default BiPredicate<T,U>	orReturn(boolean value, Consumer<Exception> exceptionConsumer) Returns a BiPredicate returning the given value if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass) Returns a ThrowingBiPredicate throwing an exception of the given type if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orThrow(Class<? extends RuntimeException> exceptionClass, String message) Returns a ThrowingBiPredicate throwing an exception of the given type if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orTryWith(ThrowingBiPredicate<? super T,? super U> other) Returns a ThrowingBiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orTryWith(ThrowingBiPredicate<? super T,? super U> other, Consumer<Exception> exceptionConsumer) Returns a ThrowingBiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default boolean	test(T former, U latter) Evaluates this predicate on the given arguments.
boolean	testThrowing(T former, U latter) Evaluates this predicate on the given arguments.

Methods inherited from interface java.util.function.BiPredicate

and, negate, or

Method Detail

test

default boolean test(T former,
                     U latter)

Evaluates this predicate on the given arguments. Wraps any thrown checked exceptions with UncheckedException.

Specified by:

test in interface BiPredicate<T,U>

Since:

1.0

testThrowing

boolean testThrowing(T former,
                     U latter)
              throws Exception

Evaluates this predicate on the given arguments.

Throws:

Exception

Since:

1.0

fallbackTo

default BiPredicate<T,U> fallbackTo(BiPredicate<T,U> fallback)

Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.

Throws:

IllegalArgumentException - if fallback is null

Since:

1.0

orReturn

default BiPredicate<T,U> orReturn(boolean value)

Returns a BiPredicate returning the given value if this predicate throws an exception.

Since:

1.0

orReturn

default BiPredicate<T,U> orReturn(boolean value,
                                  Consumer<Exception> exceptionConsumer)

Returns a BiPredicate returning the given value if this predicate throws an exception.

Since:

1.0

orThrow

default ThrowingBiPredicate<T,U> orThrow(Class<? extends RuntimeException> exceptionClass)

Returns a ThrowingBiPredicate throwing an exception of the given type if this predicate throws an exception. The original exception thrown by this predicate 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 ThrowingBiPredicate<T,U> orThrow(Class<? extends RuntimeException> exceptionClass,
                                         String message)

Returns a ThrowingBiPredicate throwing an exception of the given type if this predicate throws an exception. The original exception thrown by this predicate 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 ThrowingBiPredicate<T,U> orTryWith(ThrowingBiPredicate<? super T,? super U> other)

Returns a ThrowingBiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingBiPredicate<T,U> orTryWith(ThrowingBiPredicate<? super T,? super U> other,
                                           Consumer<Exception> exceptionConsumer)

Returns a ThrowingBiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.

Throws:

IllegalArgumentException - if other is null

Since:

1.0