org.springframework.cassandra.core

Class WriteOptions.WriteOptionsBuilder

java.lang.Object

org.springframework.cassandra.core.QueryOptions.QueryOptionsBuilder

org.springframework.cassandra.core.WriteOptions.WriteOptionsBuilder

Enclosing class:

WriteOptions

public static class WriteOptions.WriteOptionsBuilder
extends QueryOptions.QueryOptionsBuilder

Builder for QueryOptions.

Since:

1.5

Author:

Mark Paluch

Method Summary

Modifier and Type	Method and Description
WriteOptions	build() Builds a new WriteOptions with the configured values.
WriteOptions.WriteOptionsBuilder	consistencyLevel(com.datastax.driver.core.ConsistencyLevel driverConsistencyLevel) Sets the ConsistencyLevel to use.
WriteOptions.WriteOptionsBuilder	fetchSize(int fetchSize) Sets the query fetch size for ResultSet chunks.
WriteOptions.WriteOptionsBuilder	readTimeout(long readTimeout) Sets the read timeout in milliseconds.
WriteOptions.WriteOptionsBuilder	readTimeout(long readTimeout, TimeUnit timeUnit) Sets the read timeout.
WriteOptions.WriteOptionsBuilder	retryPolicy(com.datastax.driver.core.policies.RetryPolicy driverRetryPolicy) Sets the driver RetryPolicy to use.
WriteOptions.WriteOptionsBuilder	retryPolicy(RetryPolicy retryPolicy) Sets the RetryPolicy to use.
WriteOptions.WriteOptionsBuilder	tracing(boolean tracing) Enables statement tracing.
WriteOptions.WriteOptionsBuilder	ttl(int ttl) Sets the time to live for write operations.
WriteOptions.WriteOptionsBuilder	withTracing() Enables statement tracing.

Methods inherited from class java.lang.Object

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

Method Detail

consistencyLevel

public WriteOptions.WriteOptionsBuilder consistencyLevel(com.datastax.driver.core.ConsistencyLevel driverConsistencyLevel)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the ConsistencyLevel to use.

Overrides:

consistencyLevel in class QueryOptions.QueryOptionsBuilder

Parameters:

driverConsistencyLevel - must not be null.

Returns:

this QueryOptions.QueryOptionsBuilder

retryPolicy

public WriteOptions.WriteOptionsBuilder retryPolicy(com.datastax.driver.core.policies.RetryPolicy driverRetryPolicy)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the driver RetryPolicy to use. Setting both ( RetryPolicy and driver RetryPolicy) retry policies is not supported.

Overrides:

retryPolicy in class QueryOptions.QueryOptionsBuilder

Parameters:

driverRetryPolicy - must not be null.

Returns:

this QueryOptions.QueryOptionsBuilder

retryPolicy

public WriteOptions.WriteOptionsBuilder retryPolicy(RetryPolicy retryPolicy)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the RetryPolicy to use. Setting both (RetryPolicy and driver RetryPolicy) retry policies is not supported.

Overrides:

retryPolicy in class QueryOptions.QueryOptionsBuilder

Parameters:

retryPolicy - must not be null.

Returns:

this QueryOptions.QueryOptionsBuilder

fetchSize

public WriteOptions.WriteOptionsBuilder fetchSize(int fetchSize)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the query fetch size for ResultSet chunks.

The fetch size controls how much resulting rows will be retrieved simultaneously (the goal being to avoid loading too much results in memory for queries yielding large results). Please note that while value as low as 1 can be used, it is *highly* discouraged to use such a low value in practice as it will yield very poor performance.

Overrides:

fetchSize in class QueryOptions.QueryOptionsBuilder

Parameters:

fetchSize - the number of rows to fetch per chunking request. To disable chunking of the result set, use fetchSize == Integer.MAX_VALUE. Negative values are not allowed.

Returns:

this QueryOptions.QueryOptionsBuilder

See Also:

QueryOptions.getFetchSize(), Cluster.Builder.withQueryOptions(com.datastax.driver.core.QueryOptions)

readTimeout

public WriteOptions.WriteOptionsBuilder readTimeout(long readTimeout)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the read timeout in milliseconds. Overrides the default per-host read timeout.

Overrides:

readTimeout in class QueryOptions.QueryOptionsBuilder

Parameters:

readTimeout - the read timeout in milliseconds. Negative values are not allowed. If it is 0, the read timeout will be disabled for this statement.

Returns:

this QueryOptions.QueryOptionsBuilder

See Also:

SocketOptions.getReadTimeoutMillis(), Cluster.Builder.withSocketOptions(SocketOptions)

readTimeout

public WriteOptions.WriteOptionsBuilder readTimeout(long readTimeout,
                                                    TimeUnit timeUnit)

Description copied from class: QueryOptions.QueryOptionsBuilder

Sets the read timeout. Overrides the default per-host read timeout.

Overrides:

readTimeout in class QueryOptions.QueryOptionsBuilder

Parameters:

readTimeout - the read timeout value. Negative values are not allowed. If it is 0, the read timeout will be disabled for this statement.

timeUnit - the TimeUnit for the supplied timeout; must not be null.

Returns:

this QueryOptions.QueryOptionsBuilder

See Also:

SocketOptions.getReadTimeoutMillis(), Cluster.Builder.withSocketOptions(SocketOptions)

tracing

public WriteOptions.WriteOptionsBuilder tracing(boolean tracing)

Description copied from class: QueryOptions.QueryOptionsBuilder

Enables statement tracing.

Overrides:

tracing in class QueryOptions.QueryOptionsBuilder

Parameters:

tracing - true to enable statement tracing to the executed statements.

Returns:

this QueryOptions.QueryOptionsBuilder

withTracing

public WriteOptions.WriteOptionsBuilder withTracing()

Description copied from class: QueryOptions.QueryOptionsBuilder

Enables statement tracing.

Overrides:

withTracing in class QueryOptions.QueryOptionsBuilder

Returns:

this QueryOptions.QueryOptionsBuilder

ttl

public WriteOptions.WriteOptionsBuilder ttl(int ttl)

Sets the time to live for write operations.

Parameters:

ttl - the time to live.

Returns:

this WriteOptions.WriteOptionsBuilder

build

public WriteOptions build()

Builds a new WriteOptions with the configured values.

Overrides:

build in class QueryOptions.QueryOptionsBuilder

Returns:

a new WriteOptions with the configured values