com.github.rutledgepaulv.qbuilders.conditions

Interface Condition<T extends QBuilder<T>>

Type Parameters:

T - The final type of the builder, used for a fluid chaining interface.

All Known Implementing Classes:

QBuilder.ConditionDelegate

public interface Condition<T extends QBuilder<T>>

A logically complete condition that can either be met or not met by an object. Intended to be composed into more complex conditions, or built into a query that can be executed against a set of objects to determine those things which satisfy the criteria.

Method Summary

Modifier and Type	Method and Description
T	and() Prepare to append another condition onto the current node in the condition tree in such a way that both the preceeding condition AND the next condition specified must be met in order to match an object.
T	or() Prepare to append another condition onto the current node in the condition tree in such a way that both the preceeding condition OR the next condition specified must be met in order to match an object.
<Q,S> Q	query(ContextualNodeVisitor<Q,S> visitor, S context) Given this logically complete condition, execute a node visitor against the underlying condition tree in order to build a query or predicate against which objects can be queried / tested.
<Q> Q	query(ContextualNodeVisitor<Q,Void> visitor) Given this logically complete condition, execute a node visitor against the underlying condition tree in order to build a query or predicate against which objects can be queried / tested.

Method Detail

and

T and()

Prepare to append another condition onto the current node in the condition tree in such a way that both the preceeding condition AND the next condition specified must be met in order to match an object. If more flexibility surrounding precedence is needed than what chaining provides, please see Partial.and(List) and Partial.or(List).

Returns:

The beginnings of another condition.

or

T or()

Prepare to append another condition onto the current node in the condition tree in such a way that both the preceeding condition OR the next condition specified must be met in order to match an object. If more flexibility surrounding precedence is needed than what chaining provides, please see Partial.and(List) and Partial.or(List).

Returns:

The beginnings of another condition.

query

<Q> Q query(ContextualNodeVisitor<Q,Void> visitor)

Given this logically complete condition, execute a node visitor against the underlying condition tree in order to build a query or predicate against which objects can be queried / tested.

Type Parameters:

Q - The type of the results returned from visiting any node in the tree.

Parameters:

visitor - The visitor which specifies how to traverse the nodes in the visitor tree. Nodes can be AndNodes or OrNodes or ComparisonNodes.

Returns:

The result of the visitor's execution.

query

<Q,S> Q query(ContextualNodeVisitor<Q,S> visitor,
              S context)

Given this logically complete condition, execute a node visitor against the underlying condition tree in order to build a query or predicate against which objects can be queried / tested.

Type Parameters:

Q - The type of the results returned from visiting any node in the tree.

Parameters:

visitor - The visitor which specifies how to traverse the nodes in the visitor tree. Nodes can be AndNodes or OrNodes or ComparisonNodes.

Returns:

The result of the visitor's execution.