com.datastax.oss.driver.api.core.time

Interface TimestampGenerator

All Superinterfaces:

AutoCloseable

public interface TimestampGenerator
extends AutoCloseable

Generates client-side, microsecond-precision query timestamps.

These timestamps are used to order queries server-side, and resolve potential conflicts.

Method Summary

Modifier and Type	Method and Description
long	next() Returns the next timestamp, in microseconds.

Methods inherited from interface java.lang.AutoCloseable

close

Method Detail

next

long next()

Returns the next timestamp, in microseconds.

The timestamps returned by this method should be monotonic; that is, successive invocations should return strictly increasing results. Note that this might not be possible using the clock alone, if it is not precise enough; alternative strategies might include incrementing the last returned value if the clock tick hasn't changed, and possibly drifting in the future. See the built-in driver implementations for more details.

Returns:

the next timestamp, or Statement.NO_DEFAULT_TIMESTAMP to indicate that the driver should not send one with the query (and let Cassandra generate a server-side timestamp).