Package org.sellcom.core.util.function

Interface ThrowingBiPredicate<T,U>

All Superinterfaces:

java.util.function.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 java.util.function.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	Description
default java.util.function.BiPredicate<T,U>	fallbackTo(java.util.function.BiPredicate<T,U> fallback)	Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default java.util.function.BiPredicate<T,U>	fallbackTo(java.util.function.BiPredicate<T,U> fallback, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a BiPredicate evaluating the given predicate on the arguments if this predicate throws an exception.
default java.util.function.BiPredicate<T,U>	orReturn(boolean value)	Returns a BiPredicate returning the given value if this predicate throws an exception.
default java.util.function.BiPredicate<T,U>	orReturn(boolean value, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a BiPredicate returning the given value if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingBiPredicate throwing an exception of the given type if this predicate throws an exception.
default ThrowingBiPredicate<T,U>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.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, java.util.function.Consumer<java.lang.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 java.util.function.BiPredicate<T,U>

Since:

1.0

testThrowing

boolean testThrowing(T former,
                     U latter)
              throws java.lang.Exception

Evaluates this predicate on the given arguments.

Throws:

java.lang.Exception

Since:

1.0

fallbackTo

default java.util.function.BiPredicate<T,U> fallbackTo(java.util.function.BiPredicate<T,U> fallback)

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

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

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

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orReturn

default java.util.function.BiPredicate<T,U> orReturn(boolean value)

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

Since:

1.0

orReturn

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

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

Since:

1.0

orThrow

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

java.lang.IllegalArgumentException - if exceptionClass is null

Since:

1.0

orThrow

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

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

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

default ThrowingBiPredicate<T,U> orTryWith(ThrowingBiPredicate<? super T,? super U> other,
                                           java.util.function.Consumer<java.lang.Exception> exceptionConsumer)

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

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0