Package org.apache.cassandra.service

Class QueryState

java.lang.Object

org.apache.cassandra.service.QueryState

public class QueryState
extends java.lang.Object

Primarily used as a recorder for server-generated timestamps (timestamp, in microseconds, and nowInSeconds - in, well, seconds). The goal is to be able to use a single consistent server-generated value for both timestamps across the whole request, and later be able to inspect QueryState for the generated values - for logging or other purposes.

Constructor Summary

Constructors

Constructor	Description
QueryState(ClientState clientState)
QueryState(ClientState clientState, long timestamp, long nowInSeconds)

Method Summary

Modifier and Type	Method	Description
static QueryState	forInternalCalls()
long	generatedNowInSeconds()
long	generatedTimestamp()
java.net.InetAddress	getClientAddress()
ClientState	getClientState()
long	getNowInSeconds()	Generate, cache, and record a nowInSeconds value on the server-side.
long	getTimestamp()	Generate, cache, and record a timestamp value on the server-side.

Methods inherited from class java.lang.Object

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

Constructor Detail

QueryState

public QueryState(ClientState clientState)

QueryState

public QueryState(ClientState clientState,
                  long timestamp,
                  long nowInSeconds)

Method Detail

forInternalCalls

public static QueryState forInternalCalls()

Returns:

a QueryState object for internal C* calls (not limited by any kind of auth).

getTimestamp

public long getTimestamp()

Generate, cache, and record a timestamp value on the server-side. Used in reads for all live and expiring cells, and all kinds of deletion infos. Shouldn't be used directly. QueryOptions.getTimestamp(QueryState) should be used by all consumers.

Returns:

server-generated, recorded timestamp in seconds

getNowInSeconds

public long getNowInSeconds()

Generate, cache, and record a nowInSeconds value on the server-side. In writes is used for calculating localDeletionTime for tombstones and expiring cells and other deletion infos. In reads used to determine liveness of expiring cells and rows. Shouldn't be used directly. QueryOptions.getNowInSeconds(QueryState) should be used by all consumers.

Returns:

server-generated, recorded timestamp in seconds

generatedTimestamp

public long generatedTimestamp()

Returns:

server-generated timestamp value, if one had been requested, or Long.MIN_VALUE otherwise

generatedNowInSeconds

public long generatedNowInSeconds()

Returns:

server-generated nowInSeconds value, if one had been requested, or Integer.MIN_VALUE otherwise

getClientState

public ClientState getClientState()

getClientAddress

public java.net.InetAddress getClientAddress()