MongoDB C++ Driver  mongocxx-3.7.0
index.hpp
1 // Copyright 2015 MongoDB Inc.
2 //
3 // Licensed under the Apache License, Version 2.0 (the "License");
4 // you may not use this file except in compliance with the License.
5 // You may obtain a copy of the License at
6 //
7 // http://www.apache.org/licenses/LICENSE-2.0
8 //
9 // Unless required by applicable law or agreed to in writing, software
10 // distributed under the License is distributed on an "AS IS" BASIS,
11 // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 // See the License for the specific language governing permissions and
13 // limitations under the License.
14 
15 #pragma once
16 
17 #include <chrono>
18 #include <memory>
19 
20 #include <bsoncxx/document/value.hpp>
21 #include <bsoncxx/document/view.hpp>
22 #include <bsoncxx/document/view_or_value.hpp>
23 #include <bsoncxx/stdx/optional.hpp>
24 #include <bsoncxx/string/view_or_value.hpp>
25 #include <mongocxx/stdx.hpp>
26 
27 #include <mongocxx/config/prelude.hpp>
28 
29 namespace mongocxx {
30 MONGOCXX_INLINE_NAMESPACE_BEGIN
31 
32 class collection;
33 
34 namespace options {
35 
41 class MONGOCXX_API index {
42  public:
46  class MONGOCXX_API base_storage_options {
47  public:
48  virtual ~base_storage_options();
49 
50  private:
51  friend class options::index;
52  MONGOCXX_PRIVATE virtual int type() const = 0;
53  };
54 
58  class MONGOCXX_API wiredtiger_storage_options final : public base_storage_options {
59  public:
60  ~wiredtiger_storage_options() override;
61 
68  void config_string(bsoncxx::string::view_or_value config_string);
69 
75  const stdx::optional<bsoncxx::string::view_or_value>& config_string() const;
76 
77  private:
78  friend collection;
79  MONGOCXX_PRIVATE int type() const override;
80  stdx::optional<bsoncxx::string::view_or_value> _config_string;
81  };
82 
83  index();
84 
98  index& background(bool background);
99 
105  const stdx::optional<bool>& background() const;
106 
120  index& unique(bool unique);
121 
127  const stdx::optional<bool>& unique() const;
128 
142  index& hidden(bool hidden);
143 
149  const stdx::optional<bool>& hidden() const;
150 
162 
168  const stdx::optional<bsoncxx::string::view_or_value>& name() const;
169 
183  index& collation(bsoncxx::document::view collation);
184 
194  const stdx::optional<bsoncxx::document::view>& collation() const;
195 
209  index& sparse(bool sparse);
210 
216  const stdx::optional<bool>& sparse() const;
217 
229  index& storage_options(std::unique_ptr<base_storage_options> storage_options);
230 
238  index& storage_options(std::unique_ptr<wiredtiger_storage_options> storage_options);
239 
253  index& expire_after(std::chrono::seconds seconds);
254 
260  const stdx::optional<std::chrono::seconds>& expire_after() const;
261 
272  index& version(std::int32_t v);
273 
279  const stdx::optional<std::int32_t>& version() const;
280 
292  index& weights(bsoncxx::document::view weights);
293 
299  const stdx::optional<bsoncxx::document::view>& weights() const;
300 
312  index& default_language(bsoncxx::string::view_or_value default_language);
313 
319  const stdx::optional<bsoncxx::string::view_or_value>& default_language() const;
320 
332  index& language_override(bsoncxx::string::view_or_value language_override);
333 
339  const stdx::optional<bsoncxx::string::view_or_value>& language_override() const;
340 
351  index& partial_filter_expression(bsoncxx::document::view partial_filter_expression);
352 
358  const stdx::optional<bsoncxx::document::view>& partial_filter_expression() const;
359 
370  index& twod_sphere_version(std::uint8_t twod_sphere_version);
371 
377  const stdx::optional<std::uint8_t>& twod_sphere_version() const;
378 
389  index& twod_bits_precision(std::uint8_t twod_bits_precision);
390 
396  const stdx::optional<std::uint8_t>& twod_bits_precision() const;
397 
408  index& twod_location_min(double twod_location_min);
409 
415  const stdx::optional<double>& twod_location_min() const;
416 
427  index& twod_location_max(double twod_location_max);
428 
434  const stdx::optional<double>& twod_location_max() const;
435 
453  MONGOCXX_DEPRECATED index& haystack_bucket_size(double haystack_bucket_size);
454  index& haystack_bucket_size_deprecated(double haystack_bucket_size);
455 
464  MONGOCXX_DEPRECATED const stdx::optional<double>& haystack_bucket_size() const;
465  const stdx::optional<double>& haystack_bucket_size_deprecated() const;
466 
475 
476  private:
477  friend collection;
478 
479  stdx::optional<bool> _background;
480  stdx::optional<bool> _unique;
481  stdx::optional<bool> _hidden;
482  stdx::optional<bsoncxx::string::view_or_value> _name;
483  stdx::optional<bsoncxx::document::view> _collation;
484  stdx::optional<bool> _sparse;
485  std::unique_ptr<base_storage_options> _storage_options;
486  stdx::optional<std::chrono::seconds> _expire_after;
487  stdx::optional<std::int32_t> _version;
488  stdx::optional<bsoncxx::document::view> _weights;
489  stdx::optional<bsoncxx::string::view_or_value> _default_language;
490  stdx::optional<bsoncxx::string::view_or_value> _language_override;
491  stdx::optional<bsoncxx::document::view> _partial_filter_expression;
492  stdx::optional<std::uint8_t> _twod_sphere_version;
493  stdx::optional<std::uint8_t> _twod_bits_precision;
494  stdx::optional<double> _twod_location_min;
495  stdx::optional<double> _twod_location_max;
496  stdx::optional<double> _haystack_bucket_size;
497 
498  //
499  // Return the current storage_options setting.
500  //
501  const std::unique_ptr<base_storage_options>& storage_options() const;
502 };
503 
504 } // namespace options
505 MONGOCXX_INLINE_NAMESPACE_END
506 } // namespace mongocxx
507 
508 #include <mongocxx/config/postlude.hpp>
mongocxx
Top level namespace for the MongoDB C++ driver.
Definition: bulk_write.hpp:24
bsoncxx::view_or_value< document::view, document::value >
mongocxx::options::index
Class representing the optional arguments to a MongoDB create index operation.
Definition: index.hpp:41
mongocxx::options::index::wiredtiger_storage_options
Class representing the optional WiredTiger storage engine options for indexes.
Definition: index.hpp:58
bsoncxx::string::view_or_value
Class representing a view-or-value variant type for strings.
Definition: view_or_value.hpp:36
mongocxx::options::index::base_storage_options
Base class representing the optional storage engine options for indexes.
Definition: index.hpp:46
mongocxx::collection
Class representing server side document groupings within a MongoDB database.
Definition: collection.hpp:83
bsoncxx::document::view
A read-only, non-owning view of a BSON document.
Definition: view.hpp:33