Package org.sellcom.core.util.function

Interface ThrowingPredicate<T>

All Superinterfaces:

java.util.function.Predicate<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 ThrowingPredicate<T>
extends java.util.function.Predicate<T>

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

Since:

1.0

Method Summary

Modifier and Type	Method	Description
default java.util.function.Predicate<T>	fallbackTo(java.util.function.Predicate<T> fallback)	Returns a Predicate evaluating the given predicate on the argument if this predicate throws an exception.
default java.util.function.Predicate<T>	fallbackTo(java.util.function.Predicate<T> fallback, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a Predicate evaluating the given predicate on the argument if this predicate throws an exception.
default java.util.function.Predicate<T>	orReturn(boolean value)	Returns a Predicate returning the given value if this predicate throws an exception.
default java.util.function.Predicate<T>	orReturn(boolean value, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a Predicate returning the given value if this predicate throws an exception.
default ThrowingPredicate<T>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)	Returns a ThrowingPredicate throwing an exception of the given type if this predicate throws an exception.
default ThrowingPredicate<T>	orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass, java.lang.String message)	Returns a ThrowingPredicate throwing an exception of the given type if this predicate throws an exception.
default ThrowingPredicate<T>	orTryWith(ThrowingPredicate<? super T> other)	Returns a ThrowingPredicate evaluating the given predicate on the argument if this predicate throws an exception.
default ThrowingPredicate<T>	orTryWith(ThrowingPredicate<? super T> other, java.util.function.Consumer<java.lang.Exception> exceptionConsumer)	Returns a ThrowingPredicate evaluating the given predicate on the argument if this predicate throws an exception.
default boolean	test(T argument)	Evaluates this predicate on the given argument.
boolean	testThrowing(T argument)	Evaluates this predicate on the given argument.

Methods inherited from interface java.util.function.Predicate

and, negate, or

Method Detail

test

default boolean test(T argument)

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

Specified by:

test in interface java.util.function.Predicate<T>

Since:

1.0

testThrowing

boolean testThrowing(T argument)
              throws java.lang.Exception

Evaluates this predicate on the given argument.

Throws:

java.lang.Exception

Since:

1.0

fallbackTo

default java.util.function.Predicate<T> fallbackTo(java.util.function.Predicate<T> fallback)

Returns a Predicate evaluating the given predicate on the argument if this predicate throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

fallbackTo

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

Returns a Predicate evaluating the given predicate on the argument if this predicate throws an exception.

Throws:

java.lang.IllegalArgumentException - if fallback is null

Since:

1.0

orReturn

default java.util.function.Predicate<T> orReturn(boolean value)

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

Since:

1.0

orReturn

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

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

Since:

1.0

orThrow

default ThrowingPredicate<T> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass)

Returns a ThrowingPredicate 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 ThrowingPredicate<T> orThrow(java.lang.Class<? extends java.lang.RuntimeException> exceptionClass,
                                     java.lang.String message)

Returns a ThrowingPredicate 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 ThrowingPredicate<T> orTryWith(ThrowingPredicate<? super T> other)

Returns a ThrowingPredicate evaluating the given predicate on the argument if this predicate throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0

orTryWith

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

Returns a ThrowingPredicate evaluating the given predicate on the argument if this predicate throws an exception.

Throws:

java.lang.IllegalArgumentException - if other is null

Since:

1.0