com.cinchapi.concourse.lang

Interface Criteria

All Superinterfaces:

Symbol

All Known Implementing Classes:

BuildableStartState, BuildableState, BuiltCriteria, TimestampState, ValueState

public interface Criteria
extends Symbol

A Criteria is an object that is used to encapsulate the semantics of a complex query. Any any given time, objects of this class can exist in one of two modes: building or built. When a Criteria is built, it is guaranteed to represent a fully and well formed query that can be processed. On the other hand, when a Criteria is building it is in an incomplete state.

This class is the public interface to Criteria construction. It is meant to be used in a chained manner, where the caller initially calls where() and continues to construct the Criteria using the options available from each subsequently returned state.

Method Summary

Modifier and Type	Method and Description
Criteria	at(Timestamp timestamp) Return this Criteria with each expression (e.g.
String	ccl() Return a CCL string that is equivalent to this object.
default String	getCclString() Deprecated. in favor of ccl()
static Criteria	parse(String ccl) Return a Criteria object that expresses the same as the ccl statement.
List<Symbol>	symbols() Return the order list of symbols that make up this Criteria.
static StartState	where() Start building a new Criteria.

Method Detail

parse

static Criteria parse(String ccl)

Return a Criteria object that expresses the same as the ccl statement.

Parameters:

ccl - the CCL statement to parse

Returns:

an equivalanet Criteria object

where

static StartState where()

Start building a new Criteria.

Returns:

the Criteria builder

at

Criteria at(Timestamp timestamp)

Return this Criteria with each expression (e.g. {key} {operator} {values}) pinned to the specified timestamp. NOTE: Any timestamps that are pinned to any expressions within this Criteria will be replaced by the specified timestamp.

Parameters:

timestamp - the Timestamp to which the returned Criteria is pinned

Returns:

this Criteria pinned to timestamp

ccl

String ccl()

Return a CCL string that is equivalent to this object.

Returns:

an equivalent CCL string

getCclString

@Deprecated
default String getCclString()

Deprecated. in favor of ccl()

Return a CCL string that is equivalent to this object.

Returns:

an equivalent CCL string

symbols

List<Symbol> symbols()

Return the order list of symbols that make up this Criteria.

Returns:

symbols