analytics_options.hxx

Go to the documentation of this file.

/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
/*
 *   Copyright 2020-Present Couchbase, Inc.
 *
 *   Licensed 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.
 */
 
#pragma once
 
#include <couchbase/analytics_result.hxx>
#include <couchbase/analytics_scan_consistency.hxx>
#include <couchbase/analytics_stream_result.hxx>
#include <couchbase/common_options.hxx>
#include <couchbase/error.hxx>
#include <couchbase/mutation_state.hxx>
 
#include <chrono>
#include <functional>
#include <map>
#include <optional>
 
namespace couchbase
{
 
namespace codec
{
class tao_json_serializer;
} // namespace codec

struct analytics_options : public common_options<analytics_options> {
  struct built : public common_options<analytics_options>::built {
    std::optional<std::string> client_context_id;
    const bool priority;
    const bool readonly;
    std::optional<analytics_scan_consistency> scan_consistency;
    std::optional<std::chrono::milliseconds> scan_wait;
    std::vector<mutation_token> mutation_state;
    std::vector<codec::binary> positional_parameters;
    std::map<std::string, codec::binary, std::less<>> named_parameters;
    std::map<std::string, codec::binary, std::less<>> raw;
  };

  [[nodiscard]] auto build() const -> built
  {
    return {
      build_common_options(),
      client_context_id_,
      priority_,
      readonly_,
      scan_consistency_,
      scan_wait_,
      mutation_state_,
      positional_parameters_,
      named_parameters_,
      raw_,
    };
  }

  auto priority(bool prioritized) -> analytics_options&
  {
    priority_ = prioritized;
    return self();
  }

  auto readonly(bool readonly) -> analytics_options&
  {
    readonly_ = readonly;
    return self();
  }

  auto scan_wait(std::chrono::milliseconds wait) -> analytics_options&
  {
    if (scan_consistency_ == analytics_scan_consistency::not_bounded) {
      scan_wait_.reset();
    } else {
      scan_wait_ = wait;
    }
    return self();
  }

  auto client_context_id(std::string client_context_id) -> analytics_options&
  {
    if (client_context_id.empty()) {
      client_context_id_.reset();
    } else {
      client_context_id_ = std::move(client_context_id);
    }
    return self();
  }

  auto scan_consistency(analytics_scan_consistency scan_consistency) -> analytics_options&
  {
    scan_consistency_ = scan_consistency;
    mutation_state_.clear();
    return self();
  }

  auto consistent_with(const mutation_state& state) -> analytics_options&
  {
    mutation_state_ = state.tokens();
    scan_consistency_.reset();
    return self();
  }

  template<typename Serializer = codec::tao_json_serializer,
           typename Value,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  auto raw(std::string name, const Value& value) -> analytics_options&
  {
    raw_[std::move(name)] = std::move(Serializer::template serialize<const Value&>(value));
    return self();
  }

  template<typename Serializer = codec::tao_json_serializer,
           typename... Parameters,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  auto positional_parameters(const Parameters&... parameters) -> analytics_options&
  {
    positional_parameters_.clear();
    encode_positional_parameters<Serializer>(parameters...);
    return self();
  }

  template<typename Serializer = codec::tao_json_serializer,
           typename... Parameters,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  auto named_parameters(const Parameters&... parameters) -> analytics_options&
  {
    named_parameters_.clear();
    encode_named_parameters<Serializer>(parameters...);
    return self();
  }

  template<typename Serializer = codec::tao_json_serializer,
           typename Parameter,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  auto add_positional_parameter(const Parameter& parameter) -> analytics_options&
  {
    encode_positional_parameters<Serializer>(parameter);
    return self();
  }

  template<typename Serializer = codec::tao_json_serializer,
           typename Value,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  auto add_named_parameter(const std::string& name, const Value& value) -> analytics_options&
  {
    encode_named_parameters<Serializer>(std::make_pair(name, value));
    return self();
  }

  auto clear_positional_parameters() -> analytics_options&
  {
    positional_parameters_.clear();
    return self();
  }

  auto clear_named_parameters() -> analytics_options&
  {
    named_parameters_.clear();
    return self();
  }

  auto encoded_raw_options(std::map<std::string, codec::binary, std::less<>> options)
    -> analytics_options&
  {
    raw_ = std::move(options);
    return self();
  }

  auto encoded_positional_parameters(std::vector<codec::binary> parameters) -> analytics_options&
  {
    positional_parameters_ = std::move(parameters);
    return self();
  }

  auto encoded_named_parameters(std::map<std::string, codec::binary, std::less<>> parameters)
    -> analytics_options&
  {
    named_parameters_ = std::move(parameters);
    return self();
  }
 
private:
  template<typename Serializer = codec::tao_json_serializer,
           typename Parameter,
           typename... Rest,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  void encode_positional_parameters(const Parameter& parameter, Rest... args)
  {
    positional_parameters_.emplace_back(
      std::move(Serializer::template serialize<Parameter>(parameter)));
    if constexpr (sizeof...(args) > 0) {
      encode_positional_parameters<Serializer>(args...);
    }
  }
 
  template<typename Serializer = codec::tao_json_serializer,
           typename Name,
           typename Parameter,
           typename... Rest,
           std::enable_if_t<codec::is_serializer_v<Serializer>, bool> = true>
  void encode_named_parameters(const std::pair<Name, Parameter>& parameter, Rest... args)
  {
    named_parameters_[parameter.first] =
      std::move(Serializer::template serialize<Parameter>(parameter.second));
    if constexpr (sizeof...(args) > 0) {
      encode_named_parameters<Serializer>(args...);
    }
  }
 
  bool priority_{ true };
  bool readonly_{ false };
  std::optional<std::string> client_context_id_{};
  std::optional<std::chrono::milliseconds> scan_wait_{};
  std::optional<analytics_scan_consistency> scan_consistency_{};
  std::vector<mutation_token> mutation_state_{};
  std::vector<codec::binary> positional_parameters_{};
  std::map<std::string, codec::binary, std::less<>> raw_{};
  std::map<std::string, codec::binary, std::less<>> named_parameters_{};
};

using analytics_handler = std::function<void(error, analytics_result)>;

using analytics_stream_handler = std::function<void(error, analytics_stream_result)>;
} // namespace couchbase