be0351b49c
Currently, the code is using bytes_opt and bytes_view_opt to represent CQL values, which can hold a value or null. In preparation for supporting a third state, unset value introduced in CQL v4, introduce new raw_value and raw_value_view types and use them instead. The new types are based on boost::variant<> and are capable of holding null, unset values, and blobs that represent a value.
134 lines
5.3 KiB
C++
134 lines
5.3 KiB
C++
/*
|
|
* Licensed to the Apache Software Foundation (ASF) under one
|
|
* or more contributor license agreements. See the NOTICE file
|
|
* distributed with this work for additional information
|
|
* regarding copyright ownership. The ASF licenses this file
|
|
* to you under the Apache License, Version 2.0 (the
|
|
* "License"); you may not use this file except in compliance
|
|
* with the License. You may obtain a copy of the License at
|
|
*
|
|
* http://www.apache.org/licenses/LICENSE-2.0
|
|
*
|
|
* Unless required by applicable law or agreed to in writing, software
|
|
* distributed under the License is distributed on an "AS IS" BASIS,
|
|
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
* See the License for the specific language governing permissions and
|
|
* limitations under the License.
|
|
*/
|
|
|
|
/*
|
|
* Copyright (C) 2014 ScyllaDB
|
|
*
|
|
* Modified by ScyllaDB
|
|
*/
|
|
|
|
/*
|
|
* This file is part of Scylla.
|
|
*
|
|
* Scylla is free software: you can redistribute it and/or modify
|
|
* it under the terms of the GNU Affero General Public License as published by
|
|
* the Free Software Foundation, either version 3 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* Scylla is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License
|
|
* along with Scylla. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include "timestamp.hh"
|
|
#include "bytes.hh"
|
|
#include "db/consistency_level.hh"
|
|
#include "service/query_state.hh"
|
|
#include "service/pager/paging_state.hh"
|
|
#include "cql3/column_specification.hh"
|
|
#include "cql3/column_identifier.hh"
|
|
#include "cql3/values.hh"
|
|
#include "cql_serialization_format.hh"
|
|
|
|
namespace cql3 {
|
|
|
|
/**
|
|
* Options for a query.
|
|
*/
|
|
class query_options {
|
|
public:
|
|
// Options that are likely to not be present in most queries
|
|
struct specific_options final {
|
|
static thread_local const specific_options DEFAULT;
|
|
|
|
const int32_t page_size;
|
|
const ::shared_ptr<service::pager::paging_state> state;
|
|
const std::experimental::optional<db::consistency_level> serial_consistency;
|
|
const api::timestamp_type timestamp;
|
|
};
|
|
private:
|
|
const db::consistency_level _consistency;
|
|
const std::experimental::optional<std::vector<sstring_view>> _names;
|
|
std::vector<cql3::raw_value> _values;
|
|
std::vector<cql3::raw_value_view> _value_views;
|
|
mutable std::vector<std::vector<int8_t>> _temporaries;
|
|
const bool _skip_metadata;
|
|
const specific_options _options;
|
|
cql_serialization_format _cql_serialization_format;
|
|
std::experimental::optional<std::vector<query_options>> _batch_options;
|
|
public:
|
|
query_options(query_options&&) = default;
|
|
query_options(const query_options&) = delete;
|
|
|
|
explicit query_options(db::consistency_level consistency,
|
|
std::experimental::optional<std::vector<sstring_view>> names,
|
|
std::vector<cql3::raw_value> values,
|
|
bool skip_metadata,
|
|
specific_options options,
|
|
cql_serialization_format sf);
|
|
explicit query_options(db::consistency_level consistency,
|
|
std::experimental::optional<std::vector<sstring_view>> names,
|
|
std::vector<cql3::raw_value_view> value_views,
|
|
bool skip_metadata,
|
|
specific_options options,
|
|
cql_serialization_format sf);
|
|
|
|
// Batch query_options constructor
|
|
explicit query_options(query_options&&, std::vector<std::vector<cql3::raw_value_view>> value_views);
|
|
|
|
// It can't be const because of prepare()
|
|
static thread_local query_options DEFAULT;
|
|
|
|
// forInternalUse
|
|
explicit query_options(std::vector<cql3::raw_value> values);
|
|
explicit query_options(db::consistency_level, std::vector<cql3::raw_value> values);
|
|
|
|
db::consistency_level get_consistency() const;
|
|
cql3::raw_value_view get_value_at(size_t idx) const;
|
|
cql3::raw_value_view make_temporary(cql3::raw_value value) const;
|
|
size_t get_values_count() const;
|
|
bool skip_metadata() const;
|
|
/** The pageSize for this query. Will be <= 0 if not relevant for the query. */
|
|
int32_t get_page_size() const;
|
|
/** The paging state for this query, or null if not relevant. */
|
|
::shared_ptr<service::pager::paging_state> get_paging_state() const;
|
|
/** Serial consistency for conditional updates. */
|
|
std::experimental::optional<db::consistency_level> get_serial_consistency() const;
|
|
api::timestamp_type get_timestamp(service::query_state& state) const;
|
|
/**
|
|
* The protocol version for the query. Will be 3 if the object don't come from
|
|
* a native protocol request (i.e. it's been allocated locally or by CQL-over-thrift).
|
|
*/
|
|
int get_protocol_version() const;
|
|
cql_serialization_format get_cql_serialization_format() const;
|
|
// Mainly for the sake of BatchQueryOptions
|
|
const specific_options& get_specific_options() const;
|
|
const query_options& for_statement(size_t i) const;
|
|
void prepare(const std::vector<::shared_ptr<column_specification>>& specs);
|
|
private:
|
|
void fill_value_views();
|
|
};
|
|
|
|
}
|