com.datastax.oss.driver.api.querybuilder.term

Interface Term

All Superinterfaces:

CqlSnippet

All Known Subinterfaces:

BindMarker, Literal, Raw

public interface Term
extends CqlSnippet

A simple expression that doesn't reference columns.

It is used as an argument to certain selectors (for example the indices in a range), or as the right operand of relations.

To create a term, call one of the static factory methods in QueryBuilder:

• literal() to inline a Java object into the query string;
• function() to invoke a built-in or user-defined function;
• an arithmetic operator combining other terms: add(), subtract(), negate(), multiply(), divide() or remainder();
• typeHint() to coerce another term to a particular CQL type;
• raw() for a raw CQL snippet.

Note that some of these methods have multiple overloads.

Method Summary

Modifier and Type	Method and Description
boolean	isIdempotent() Whether the term is idempotent.

Methods inherited from interface com.datastax.oss.driver.api.querybuilder.CqlSnippet

appendTo

Method Detail

isIdempotent

boolean isIdempotent()

Whether the term is idempotent.

That is, whether it always produces the same result when used multiple times. For example, the literal 1 is idempotent, the function call now() isn't.

This is used internally by the query builder to compute the Request.isIdempotent() flag on the statements generated by BuildableQuery.build(). If a term is ambiguous (for example a raw snippet or a call to a user function), the builder is pessimistic and assumes the term is not idempotent.