org.springframework.data.cassandra.core.cql.util

Class StatementBuilder<S extends com.datastax.oss.driver.api.querybuilder.BuildableQuery>

java.lang.Object

org.springframework.data.cassandra.core.cql.util.StatementBuilder<S>

Type Parameters:

S - Statement type

public class StatementBuilder<S extends com.datastax.oss.driver.api.querybuilder.BuildableQuery>
extends Object

Functional builder for Cassandra statements. Statements are built by applying builder functions that get applied when building the actual statement. The StatementBuilder provides a mutable container for statement creation allowing a functional declaration of actions that are necessary to build a statement. This class helps building CQL statements as a BuildableQuery classes are typically immutable and require return value tracking across methods that want to apply modifications to a statement.

Building a statement consists of three phases:

1. Creation of the StatementBuilder with a query stub
2. Functional declaration applying builder functions, bind functions and on build signals
3. Building the statement using build()

The initial query stub is used as base object for all built queries. Builder functions are applied each time a statement is built allowing to build multiple statement instances while evolving the actual statement.

The builder can be used for structural evolution and value evolution of statements. Values are bound through binding functions that accept the statement and a TermFactory. Values can be bound inline or through bind markers when building the statement. All functions are applied in the order of their declaration.

All methods returning StatementBuilder point to the same instance. This class is intended for internal use.

Since:

3.0

Author:

Mark Paluch

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	StatementBuilder.BindFunction<S> Binding function.
static class	StatementBuilder.ParameterHandling Enumeration to represent how parameters are rendered.

Method Summary

Modifier and Type	Method and Description
<R extends com.datastax.oss.driver.api.querybuilder.BuildableQuery> StatementBuilder<S>	apply(Function<S,R> action) Apply a builder function to the statement.
StatementBuilder<S>	bind(StatementBuilder.BindFunction<S> action) Apply a StatementBuilder.BindFunction to the statement.
com.datastax.oss.driver.api.core.cql.SimpleStatement	build() Build a statement by applying builder and bind functions using the default CodecRegistry and StatementBuilder.ParameterHandling.BY_INDEX parameter rendering.
com.datastax.oss.driver.api.core.cql.SimpleStatement	build(StatementBuilder.ParameterHandling parameterHandling) Build a statement by applying builder and bind functions using the given StatementBuilder.ParameterHandling.
com.datastax.oss.driver.api.core.cql.SimpleStatement	build(StatementBuilder.ParameterHandling parameterHandling, com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry codecRegistry) Build a statement by applying builder and bind functions using the given CodecRegistry and StatementBuilder.ParameterHandling.
static <S extends com.datastax.oss.driver.api.querybuilder.BuildableQuery> StatementBuilder<S>	of(S stub) Factory method used to create a new StatementBuilder with the given query stub.
StatementBuilder<S>	onBuild(Consumer<com.datastax.oss.driver.api.core.cql.SimpleStatementBuilder> action) Add behavior when the statement is built.
StatementBuilder<S>	transform(UnaryOperator<com.datastax.oss.driver.api.core.cql.SimpleStatement> mappingFunction) Add behavior after the SimpleStatement has been built.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

of

public static <S extends com.datastax.oss.driver.api.querybuilder.BuildableQuery> StatementBuilder<S> of(S stub)

Factory method used to create a new StatementBuilder with the given query stub. The stub is used as base for the built query so each query inherits properties of this stub.

Type Parameters:

S - query type.

Parameters:

stub - the query stub to use.

Returns:

a StatementBuilder for the given query stub.

Throws:

IllegalArgumentException - if the query stub is null.

See Also:

BuildableQuery

bind

public StatementBuilder<S> bind(StatementBuilder.BindFunction<S> action)

Apply a StatementBuilder.BindFunction to the statement. Bind functions are applied on build().

Parameters:

action - the bind function to be applied to the statement.

Returns:

this StatementBuilder.

apply

public <R extends com.datastax.oss.driver.api.querybuilder.BuildableQuery> StatementBuilder<S> apply(Function<S,R> action)

Apply a builder function to the statement. Builder functions are applied on build().

Parameters:

action - the builder function to be applied to the statement.

Returns:

this StatementBuilder.

onBuild

public StatementBuilder<S> onBuild(Consumer<com.datastax.oss.driver.api.core.cql.SimpleStatementBuilder> action)

Add behavior when the statement is built. The Consumer gets invoked with a SimpleStatementBuilder allowing association of the final statement with additional settings. The Consumer is applied on build().

Parameters:

action - the Consumer function that gets notified on build().

Returns:

this StatementBuilder.

transform

public StatementBuilder<S> transform(UnaryOperator<com.datastax.oss.driver.api.core.cql.SimpleStatement> mappingFunction)

Add behavior after the SimpleStatement has been built. The UnaryOperator gets invoked with a SimpleStatement allowing association of the final statement with additional settings. The UnaryOperator is applied on build().

Parameters:

mappingFunction - the UnaryOperator function that gets notified on build().

Returns:

this StatementBuilder.

build

public com.datastax.oss.driver.api.core.cql.SimpleStatement build()

Build a statement by applying builder and bind functions using the default CodecRegistry and StatementBuilder.ParameterHandling.BY_INDEX parameter rendering.

Returns:

the built SimpleStatement.

build

public com.datastax.oss.driver.api.core.cql.SimpleStatement build(StatementBuilder.ParameterHandling parameterHandling)

Build a statement by applying builder and bind functions using the given StatementBuilder.ParameterHandling.

Parameters:

parameterHandling - StatementBuilder.ParameterHandling used to determine how to render parameters.

Returns:

the built SimpleStatement.

build

public com.datastax.oss.driver.api.core.cql.SimpleStatement build(StatementBuilder.ParameterHandling parameterHandling,
                                                                  com.datastax.oss.driver.api.core.type.codec.registry.CodecRegistry codecRegistry)

Build a statement by applying builder and bind functions using the given CodecRegistry and StatementBuilder.ParameterHandling.

Parameters:

parameterHandling - StatementBuilder.ParameterHandling used to determine how to render parameters.

codecRegistry - registry of Apache Cassandra codecs for converting to/from Java types and CQL types.

Returns:

the built SimpleStatement.