com.github.robtimus.sql.function

Interface LongSQLPredicate

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 LongSQLPredicate

Represents a predicate (boolean-valued function) of one long-valued argument. This is the SQLException throwing equivalent of LongPredicate.

Method Summary

Modifier and Type	Method and Description
default LongSQLPredicate	and(LongSQLPredicate other) Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another.
static LongSQLPredicate	checked(LongPredicate predicate) Returns a predicate that evaluates the predicate predicate, and unwraps any UncheckedSQLException that is thrown by throwing its cause.
default LongSQLPredicate	negate() Returns a predicate that represents the logical negation of this predicate.
default LongSQLPredicate	or(LongSQLPredicate other) Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another.
boolean	test(long value) Evaluates this predicate on the given argument.
static LongPredicate	unchecked(LongSQLPredicate predicate) Returns a predicate that evaluates the predicate predicate, and wraps any SQLException that is thrown in an UncheckedSQLException.

Method Detail

test

boolean test(long value)
      throws SQLException

Evaluates this predicate on the given argument.

Parameters:

value - The input argument.

Returns:

true if the input argument matches the predicate, otherwise false.

Throws:

SQLException - If an SQL error occurs.

and

default LongSQLPredicate and(LongSQLPredicate other)

Returns a composed predicate that represents a short-circuiting logical AND of this predicate and another. When evaluating the composed predicate, if this predicate is false, then the other predicate is not evaluated.

Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of this predicate throws an exception, the other predicate will not be evaluated.

Parameters:

other - A predicate that will be logically-ANDed with this predicate.

Returns:

A composed predicate that represents the short-circuiting logical AND of this predicate and the other predicate.

Throws:

NullPointerException - If other is null.

negate

default LongSQLPredicate negate()

Returns a predicate that represents the logical negation of this predicate.

Returns:

A predicate that represents the logical negation of this predicate

or

default LongSQLPredicate or(LongSQLPredicate other)

Returns a composed predicate that represents a short-circuiting logical OR of this predicate and another. When evaluating the composed predicate, if this predicate is true, then the other predicate is not evaluated.

Any exceptions thrown during evaluation of either predicate are relayed to the caller; if evaluation of this predicate throws an exception, the other predicate will not be evaluated.

Parameters:

other - A predicate that will be logically-ORed with this predicate.

Returns:

A composed predicate that represents the short-circuiting logical OR of this predicate and the other predicate.

Throws:

NullPointerException - If other is null.

unchecked

static LongPredicate unchecked(LongSQLPredicate predicate)

Returns a predicate that evaluates the predicate predicate, and wraps any SQLException that is thrown in an UncheckedSQLException.

Parameters:

predicate - The predicate to evaluate when the returned predicate is evaluated.

Returns:

A predicate that evaluates the predicate predicate on its input, and wraps any SQLException that is thrown in an UncheckedSQLException.

Throws:

NullPointerException - If predicate is null.

checked

static LongSQLPredicate checked(LongPredicate predicate)

Returns a predicate that evaluates the predicate predicate, and unwraps any UncheckedSQLException that is thrown by throwing its cause.

Parameters:

predicate - The predicate to evaluate when the returned predicate is evaluated.

Returns:

A predicate that evaluates the predicate operation on its input, and unwraps any UncheckedSQLException that is thrown.

Throws:

NullPointerException - If the given operation is null.