org.apache.cassandra.cql3

Class QueryProcessor

java.lang.Object

org.apache.cassandra.cql3.QueryProcessor

All Implemented Interfaces:

QueryHandler

public class QueryProcessor
extends java.lang.Object
implements QueryHandler

Field Summary

Fields

Modifier and Type	Field and Description
static CassandraVersion	CQL_VERSION
static QueryProcessor	instance
static CQLMetrics	metrics
static CassandraVersion	NEW_PREPARED_STATEMENT_BEHAVIOUR_SINCE

Method Summary

Modifier and Type	Method and Description
static void	clearInternalStatementsCache() Clear our internal statmeent cache for test purposes.
static void	clearPreparedStatementsCache()
void	evictPrepared(MD5Digest id)
static UntypedResultSet	execute(java.lang.String query, ConsistencyLevel cl, QueryState state, java.lang.Object... values)
static UntypedResultSet	executeInternal(java.lang.String query, java.lang.Object... values)
static UntypedResultSet	executeInternalWithNow(int nowInSec, java.lang.String query, java.lang.Object... values) A special version of executeInternal that takes the time used as "now" for the query in argument.
static UntypedResultSet	executeInternalWithPaging(java.lang.String query, int pageSize, java.lang.Object... values)
static UntypedResultSet	executeOnceInternal(java.lang.String query, java.lang.Object... values) Same than executeInternal, but to use for queries we know are only executed once so that the created statement object is not cached.
ParsedStatement.Prepared	getPrepared(MD5Digest id)
ParsedStatement.Prepared	getPreparedForThrift(java.lang.Integer id)
static java.util.List<ParsedStatement.Prepared>	getPreparedStatements()
static ParsedStatement.Prepared	getStatement(java.lang.String queryStr, ClientState clientState)
static ResultMessage.Prepared	getStoredPreparedStatement(java.lang.String queryString, java.lang.String clientKeyspace, boolean forThrift)
static QueryState	internalQueryState()
static QueryOptions	makeInternalOptions(ParsedStatement.Prepared prepared, java.lang.Object[] values)
static ParsedStatement	parseStatement(java.lang.String queryStr)
static ParsedStatement.Prepared	parseStatement(java.lang.String queryStr, QueryState queryState)
ResultMessage.Prepared	prepare(java.lang.String queryString, ClientState clientState, boolean forThrift) This method got slightly out of hand, but this is with best intentions: to allow users to be upgraded from any prior version, and help implementers avoid previous mistakes by clearly separating fully qualified and non-fully qualified statement behaviour.
ResultMessage.Prepared	prepare(java.lang.String queryString, QueryState queryState)
ResultMessage.Prepared	prepare(java.lang.String query, QueryState state, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
static int	preparedStatementsCount()
static ParsedStatement.Prepared	prepareInternal(java.lang.String query)
static UntypedResultSet	process(java.lang.String query, ConsistencyLevel cl)
static UntypedResultSet	process(java.lang.String query, ConsistencyLevel cl, java.util.List<java.nio.ByteBuffer> values)
static ResultMessage	process(java.lang.String queryString, ConsistencyLevel cl, QueryState queryState)
ResultMessage	process(java.lang.String queryString, QueryState queryState, QueryOptions options)
ResultMessage	process(java.lang.String query, QueryState state, QueryOptions options, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
ResultMessage	processBatch(BatchStatement batch, QueryState queryState, BatchQueryOptions options)
ResultMessage	processBatch(BatchStatement statement, QueryState state, BatchQueryOptions options, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
ResultMessage	processPrepared(CQLStatement statement, QueryState queryState, QueryOptions options)
ResultMessage	processPrepared(CQLStatement statement, QueryState state, QueryOptions options, java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
ResultMessage	processStatement(CQLStatement statement, QueryState queryState, QueryOptions options)
static UntypedResultSet	resultify(java.lang.String query, PartitionIterator partitions)
static UntypedResultSet	resultify(java.lang.String query, RowIterator partition)
static ResultMessage.Prepared	storePreparedStatement(java.lang.String queryString, java.lang.String keyspace, ParsedStatement.Prepared prepared, boolean forThrift)
boolean	useNewPreparedStatementBehaviour()
static void	validateKey(java.nio.ByteBuffer key)

Methods inherited from class java.lang.Object

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

Field Detail

CQL_VERSION

public static final CassandraVersion CQL_VERSION

NEW_PREPARED_STATEMENT_BEHAVIOUR_SINCE

public static final CassandraVersion NEW_PREPARED_STATEMENT_BEHAVIOUR_SINCE

instance

public static final QueryProcessor instance

metrics

public static final CQLMetrics metrics

Method Detail

preparedStatementsCount

public static int preparedStatementsCount()

internalQueryState

public static QueryState internalQueryState()

evictPrepared

public void evictPrepared(MD5Digest id)

getPrepared

public ParsedStatement.Prepared getPrepared(MD5Digest id)

Specified by:

getPrepared in interface QueryHandler

getPreparedForThrift

public ParsedStatement.Prepared getPreparedForThrift(java.lang.Integer id)

Specified by:

getPreparedForThrift in interface QueryHandler

validateKey

public static void validateKey(java.nio.ByteBuffer key)
                        throws InvalidRequestException

Throws:

InvalidRequestException

processStatement

public ResultMessage processStatement(CQLStatement statement,
                                      QueryState queryState,
                                      QueryOptions options)
                               throws RequestExecutionException,
                                      RequestValidationException

Throws:

RequestExecutionException

RequestValidationException

process

public static ResultMessage process(java.lang.String queryString,
                                    ConsistencyLevel cl,
                                    QueryState queryState)
                             throws RequestExecutionException,
                                    RequestValidationException

Throws:

RequestExecutionException

RequestValidationException

process

public ResultMessage process(java.lang.String query,
                             QueryState state,
                             QueryOptions options,
                             java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
                      throws RequestExecutionException,
                             RequestValidationException

Specified by:

process in interface QueryHandler

Throws:

RequestExecutionException

RequestValidationException

process

public ResultMessage process(java.lang.String queryString,
                             QueryState queryState,
                             QueryOptions options)
                      throws RequestExecutionException,
                             RequestValidationException

Throws:

RequestExecutionException

RequestValidationException

parseStatement

public static ParsedStatement.Prepared parseStatement(java.lang.String queryStr,
                                                      QueryState queryState)
                                               throws RequestValidationException

Throws:

RequestValidationException

process

public static UntypedResultSet process(java.lang.String query,
                                       ConsistencyLevel cl)
                                throws RequestExecutionException

Throws:

RequestExecutionException

process

public static UntypedResultSet process(java.lang.String query,
                                       ConsistencyLevel cl,
                                       java.util.List<java.nio.ByteBuffer> values)
                                throws RequestExecutionException

Throws:

RequestExecutionException

makeInternalOptions

public static QueryOptions makeInternalOptions(ParsedStatement.Prepared prepared,
                                               java.lang.Object[] values)

prepareInternal

public static ParsedStatement.Prepared prepareInternal(java.lang.String query)
                                                throws RequestValidationException

Throws:

RequestValidationException

executeInternal

public static UntypedResultSet executeInternal(java.lang.String query,
                                               java.lang.Object... values)

execute

public static UntypedResultSet execute(java.lang.String query,
                                       ConsistencyLevel cl,
                                       QueryState state,
                                       java.lang.Object... values)
                                throws RequestExecutionException

Throws:

RequestExecutionException

executeInternalWithPaging

public static UntypedResultSet executeInternalWithPaging(java.lang.String query,
                                                         int pageSize,
                                                         java.lang.Object... values)

executeOnceInternal

public static UntypedResultSet executeOnceInternal(java.lang.String query,
                                                   java.lang.Object... values)

Same than executeInternal, but to use for queries we know are only executed once so that the created statement object is not cached.

executeInternalWithNow

public static UntypedResultSet executeInternalWithNow(int nowInSec,
                                                      java.lang.String query,
                                                      java.lang.Object... values)

A special version of executeInternal that takes the time used as "now" for the query in argument. Note that this only make sense for Selects so this only accept SELECT statements and is only useful in rare cases.

resultify

public static UntypedResultSet resultify(java.lang.String query,
                                         RowIterator partition)

resultify

public static UntypedResultSet resultify(java.lang.String query,
                                         PartitionIterator partitions)

prepare

public ResultMessage.Prepared prepare(java.lang.String query,
                                      QueryState state,
                                      java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
                               throws RequestValidationException

Specified by:

prepare in interface QueryHandler

Throws:

RequestValidationException

prepare

public ResultMessage.Prepared prepare(java.lang.String queryString,
                                      QueryState queryState)

useNewPreparedStatementBehaviour

public boolean useNewPreparedStatementBehaviour()

prepare

public ResultMessage.Prepared prepare(java.lang.String queryString,
                                      ClientState clientState,
                                      boolean forThrift)

This method got slightly out of hand, but this is with best intentions: to allow users to be upgraded from any prior version, and help implementers avoid previous mistakes by clearly separating fully qualified and non-fully qualified statement behaviour. Basically we need to handle 4 different hashes here; 1. fully qualified query with keyspace 2. fully qualified query without keyspace 3. unqualified query with keyspace 4. unqualified query without keyspace The correct combination to return is 2/3 - the problem is during upgrades (assuming upgrading from < 3.0.26) - Existing clients have hash 1 or 3 - Query prepared on a 3.0.26 instance needs to return hash 1/3 to be able to execute it on a 3.0.25 instance - This is handled by the useNewPreparedStatementBehaviour flag - while there still are 3.0.25 instances in the cluster we always return hash 1/3 - Once fully upgraded we start returning hash 2/3, this will cause a prepared statement id mismatch for existing clients, but they will be able to continue using the old prepared statement id after that exception since we store the query both with and without keyspace.

getStoredPreparedStatement

public static ResultMessage.Prepared getStoredPreparedStatement(java.lang.String queryString,
                                                                java.lang.String clientKeyspace,
                                                                boolean forThrift)
                                                         throws InvalidRequestException

Throws:

InvalidRequestException

storePreparedStatement

public static ResultMessage.Prepared storePreparedStatement(java.lang.String queryString,
                                                            java.lang.String keyspace,
                                                            ParsedStatement.Prepared prepared,
                                                            boolean forThrift)
                                                     throws InvalidRequestException

Throws:

InvalidRequestException

processPrepared

public ResultMessage processPrepared(CQLStatement statement,
                                     QueryState state,
                                     QueryOptions options,
                                     java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
                              throws RequestExecutionException,
                                     RequestValidationException

Specified by:

processPrepared in interface QueryHandler

Throws:

RequestExecutionException

RequestValidationException

processPrepared

public ResultMessage processPrepared(CQLStatement statement,
                                     QueryState queryState,
                                     QueryOptions options)
                              throws RequestExecutionException,
                                     RequestValidationException

Throws:

RequestExecutionException

RequestValidationException

processBatch

public ResultMessage processBatch(BatchStatement statement,
                                  QueryState state,
                                  BatchQueryOptions options,
                                  java.util.Map<java.lang.String,java.nio.ByteBuffer> customPayload)
                           throws RequestExecutionException,
                                  RequestValidationException

Specified by:

processBatch in interface QueryHandler

Throws:

RequestExecutionException

RequestValidationException

processBatch

public ResultMessage processBatch(BatchStatement batch,
                                  QueryState queryState,
                                  BatchQueryOptions options)
                           throws RequestExecutionException,
                                  RequestValidationException

Throws:

RequestExecutionException

RequestValidationException

getStatement

public static ParsedStatement.Prepared getStatement(java.lang.String queryStr,
                                                    ClientState clientState)
                                             throws RequestValidationException

Throws:

RequestValidationException

parseStatement

public static ParsedStatement parseStatement(java.lang.String queryStr)
                                      throws SyntaxException

Throws:

SyntaxException

clearInternalStatementsCache

public static void clearInternalStatementsCache()

Clear our internal statmeent cache for test purposes.

clearPreparedStatementsCache

public static void clearPreparedStatementsCache()

getPreparedStatements

public static java.util.List<ParsedStatement.Prepared> getPreparedStatements()