couchbase 3.4.1 → 3.4.3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +2 -2
- data/ext/couchbase/CMakeLists.txt +59 -7
- data/ext/couchbase/cmake/Documentation.cmake +0 -1
- data/ext/couchbase/cmake/OpenSSL.cmake +98 -3
- data/ext/couchbase/cmake/Testing.cmake +12 -4
- data/ext/couchbase/cmake/ThirdPartyDependencies.cmake +4 -0
- data/ext/couchbase/cmake/build_config.hxx.in +3 -0
- data/ext/couchbase/core/bucket.cxx +3 -2
- data/ext/couchbase/core/bucket.hxx +9 -0
- data/ext/couchbase/core/cluster.hxx +17 -0
- data/ext/couchbase/core/cluster_options.cxx +2 -2
- data/ext/couchbase/core/cluster_options.hxx +4 -7
- data/ext/couchbase/core/{config_profile.cxx → cluster_options_fwd.hxx} +7 -6
- data/ext/couchbase/core/config_profile.hxx +2 -65
- data/ext/couchbase/core/config_profiles.cxx +79 -0
- data/ext/couchbase/core/config_profiles.hxx +56 -0
- data/ext/couchbase/core/error_context/search.hxx +1 -1
- data/ext/couchbase/core/impl/analytics.cxx +237 -0
- data/ext/couchbase/core/impl/boolean_field_query.cxx +40 -0
- data/ext/couchbase/core/impl/boolean_query.cxx +62 -0
- data/ext/couchbase/core/impl/cluster.cxx +2 -1
- data/ext/couchbase/core/impl/conjunction_query.cxx +51 -0
- data/ext/couchbase/core/impl/date_range.cxx +89 -0
- data/ext/couchbase/core/impl/date_range_facet.cxx +54 -0
- data/ext/couchbase/core/impl/date_range_facet_result.cxx +64 -0
- data/ext/couchbase/core/impl/date_range_query.cxx +125 -0
- data/ext/couchbase/core/impl/disjunction_query.cxx +51 -0
- data/ext/couchbase/core/impl/dns_srv_tracker.cxx +5 -3
- data/ext/couchbase/core/impl/encoded_search_facet.hxx +29 -0
- data/ext/couchbase/core/impl/encoded_search_query.hxx +29 -0
- data/ext/couchbase/core/impl/encoded_search_sort.hxx +29 -0
- data/ext/couchbase/core/impl/geo_bounding_box_query.cxx +46 -0
- data/ext/couchbase/core/impl/geo_distance_query.cxx +43 -0
- data/ext/couchbase/core/impl/geo_polygon_query.cxx +46 -0
- data/ext/couchbase/core/impl/internal_date_range_facet_result.cxx +80 -0
- data/ext/couchbase/core/impl/internal_date_range_facet_result.hxx +48 -0
- data/ext/couchbase/core/impl/internal_numeric_range_facet_result.cxx +80 -0
- data/ext/couchbase/core/impl/internal_numeric_range_facet_result.hxx +48 -0
- data/ext/couchbase/core/impl/internal_search_error_context.cxx +141 -0
- data/ext/couchbase/core/impl/internal_search_error_context.hxx +61 -0
- data/ext/couchbase/core/impl/internal_search_meta_data.cxx +60 -0
- data/ext/couchbase/core/impl/internal_search_meta_data.hxx +41 -0
- data/ext/couchbase/core/impl/internal_search_result.cxx +84 -0
- data/ext/couchbase/core/impl/internal_search_result.hxx +43 -0
- data/ext/couchbase/core/impl/internal_search_row.cxx +82 -0
- data/ext/couchbase/core/impl/internal_search_row.hxx +56 -0
- data/ext/couchbase/core/impl/internal_search_row_location.hxx +32 -0
- data/ext/couchbase/core/impl/internal_search_row_locations.cxx +137 -0
- data/ext/couchbase/core/impl/internal_search_row_locations.hxx +45 -0
- data/ext/couchbase/core/impl/internal_term_facet_result.cxx +80 -0
- data/ext/couchbase/core/impl/internal_term_facet_result.hxx +48 -0
- data/ext/couchbase/core/impl/match_all_query.cxx +35 -0
- data/ext/couchbase/core/impl/match_none_query.cxx +35 -0
- data/ext/couchbase/core/impl/match_phrase_query.cxx +43 -0
- data/ext/couchbase/core/impl/match_query.cxx +59 -0
- data/ext/couchbase/core/impl/numeric_range.cxx +49 -0
- data/ext/couchbase/core/impl/numeric_range_facet.cxx +54 -0
- data/ext/couchbase/core/impl/numeric_range_facet_result.cxx +64 -0
- data/ext/couchbase/core/impl/numeric_range_query.cxx +56 -0
- data/ext/couchbase/core/impl/phrase_query.cxx +42 -0
- data/ext/couchbase/core/impl/prefix_query.cxx +40 -0
- data/ext/couchbase/core/impl/query.cxx +5 -5
- data/ext/couchbase/core/impl/query_string_query.cxx +37 -0
- data/ext/couchbase/core/impl/regexp_query.cxx +40 -0
- data/ext/couchbase/core/impl/search.cxx +191 -0
- data/ext/couchbase/core/impl/search_error_context.cxx +147 -0
- data/ext/couchbase/core/impl/search_meta_data.cxx +46 -0
- data/ext/couchbase/core/impl/search_result.cxx +66 -0
- data/ext/couchbase/core/impl/search_row.cxx +74 -0
- data/ext/couchbase/core/impl/search_row_location.cxx +64 -0
- data/ext/couchbase/core/impl/search_row_locations.cxx +66 -0
- data/ext/couchbase/core/impl/search_sort_field.cxx +104 -0
- data/ext/couchbase/core/impl/search_sort_id.cxx +43 -0
- data/ext/couchbase/core/impl/search_sort_score.cxx +43 -0
- data/ext/couchbase/core/impl/term_facet.cxx +36 -0
- data/ext/couchbase/core/impl/term_facet_result.cxx +64 -0
- data/ext/couchbase/core/impl/term_query.cxx +56 -0
- data/ext/couchbase/core/impl/term_range_query.cxx +57 -0
- data/ext/couchbase/core/impl/wildcard_query.cxx +40 -0
- data/ext/couchbase/core/io/dns_client.cxx +225 -0
- data/ext/couchbase/core/io/dns_client.hxx +19 -188
- data/ext/couchbase/core/io/http_context.hxx +1 -1
- data/ext/couchbase/core/io/http_session.hxx +10 -0
- data/ext/couchbase/core/io/http_session_manager.hxx +5 -3
- data/ext/couchbase/core/io/mcbp_session.cxx +28 -1
- data/ext/couchbase/core/io/retry_orchestrator.hxx +3 -2
- data/ext/couchbase/core/json_string.hxx +5 -0
- data/ext/couchbase/core/meta/version.cxx +18 -4
- data/ext/couchbase/core/mozilla_ca_bundle.hxx +39 -0
- data/ext/couchbase/core/operations/document_analytics.cxx +1 -0
- data/ext/couchbase/core/operations/document_analytics.hxx +1 -0
- data/ext/couchbase/core/operations/document_append.hxx +1 -1
- data/ext/couchbase/core/operations/document_decrement.hxx +1 -1
- data/ext/couchbase/core/operations/document_exists.hxx +1 -1
- data/ext/couchbase/core/operations/document_get.hxx +1 -1
- data/ext/couchbase/core/operations/document_get_and_lock.hxx +1 -1
- data/ext/couchbase/core/operations/document_get_and_touch.hxx +1 -1
- data/ext/couchbase/core/operations/document_get_projected.hxx +1 -1
- data/ext/couchbase/core/operations/document_increment.hxx +1 -1
- data/ext/couchbase/core/operations/document_insert.hxx +1 -1
- data/ext/couchbase/core/operations/document_lookup_in.hxx +1 -1
- data/ext/couchbase/core/operations/document_mutate_in.hxx +1 -1
- data/ext/couchbase/core/operations/document_prepend.hxx +1 -1
- data/ext/couchbase/core/operations/document_query.cxx +2 -0
- data/ext/couchbase/core/operations/document_query.hxx +6 -0
- data/ext/couchbase/core/operations/document_remove.hxx +1 -1
- data/ext/couchbase/core/operations/document_replace.hxx +1 -1
- data/ext/couchbase/core/operations/document_search.cxx +4 -1
- data/ext/couchbase/core/operations/document_search.hxx +2 -1
- data/ext/couchbase/core/operations/document_touch.hxx +1 -1
- data/ext/couchbase/core/operations/document_unlock.hxx +1 -1
- data/ext/couchbase/core/operations/document_upsert.hxx +1 -1
- data/ext/couchbase/core/operations/document_view.hxx +1 -0
- data/ext/couchbase/core/protocol/client_request.hxx +11 -2
- data/ext/couchbase/core/public_fwd.hxx +21 -0
- data/ext/couchbase/core/tls_verify_mode.hxx +26 -0
- data/ext/couchbase/core/topology/configuration.cxx +15 -2
- data/ext/couchbase/core/topology/configuration.hxx +5 -1
- data/ext/couchbase/core/transactions/active_transaction_record.hxx +2 -2
- data/ext/couchbase/core/transactions/attempt_context_impl.cxx +3 -0
- data/ext/couchbase/core/transactions/attempt_context_impl.hxx +1 -1
- data/ext/couchbase/core/transactions/attempt_context_testing_hooks.cxx +93 -0
- data/ext/couchbase/core/transactions/attempt_context_testing_hooks.hxx +48 -75
- data/ext/couchbase/core/transactions/cleanup_testing_hooks.cxx +52 -0
- data/ext/couchbase/core/transactions/cleanup_testing_hooks.hxx +17 -31
- data/ext/couchbase/core/transactions/exceptions.hxx +12 -9
- data/ext/couchbase/core/transactions/internal/transaction_context.hxx +12 -12
- data/ext/couchbase/core/transactions/internal/transactions_cleanup.hxx +7 -1
- data/ext/couchbase/core/transactions/transaction_context.cxx +1 -0
- data/ext/couchbase/core/transactions/transactions_cleanup.cxx +144 -155
- data/ext/couchbase/core/utils/connection_string.cxx +27 -3
- data/ext/couchbase/core/utils/connection_string.hxx +3 -3
- data/ext/couchbase/core/utils/json.cxx +4 -1
- data/ext/couchbase/couchbase/analytics_error_context.hxx +143 -0
- data/ext/couchbase/couchbase/analytics_meta_data.hxx +155 -0
- data/ext/couchbase/couchbase/analytics_metrics.hxx +163 -0
- data/ext/couchbase/couchbase/analytics_options.hxx +359 -0
- data/ext/couchbase/couchbase/analytics_result.hxx +102 -0
- data/ext/couchbase/couchbase/analytics_scan_consistency.hxx +46 -0
- data/ext/couchbase/couchbase/analytics_status.hxx +41 -0
- data/ext/couchbase/couchbase/analytics_warning.hxx +85 -0
- data/ext/couchbase/couchbase/behavior_options.hxx +10 -1
- data/ext/couchbase/couchbase/boolean_field_query.hxx +77 -0
- data/ext/couchbase/couchbase/boolean_query.hxx +223 -0
- data/ext/couchbase/couchbase/cluster.hxx +75 -1
- data/ext/couchbase/couchbase/conjunction_query.hxx +88 -0
- data/ext/couchbase/couchbase/date_range.hxx +69 -0
- data/ext/couchbase/couchbase/date_range_facet.hxx +56 -0
- data/ext/couchbase/couchbase/date_range_facet_result.hxx +55 -0
- data/ext/couchbase/couchbase/date_range_query.hxx +265 -0
- data/ext/couchbase/couchbase/disjunction_query.hxx +109 -0
- data/ext/couchbase/couchbase/doc_id_query.hxx +111 -0
- data/ext/couchbase/couchbase/error_context.hxx +7 -6
- data/ext/couchbase/couchbase/fmt/analytics_scan_consistency.hxx +52 -0
- data/ext/couchbase/couchbase/fmt/analytics_status.hxx +76 -0
- data/ext/couchbase/couchbase/fmt/search_scan_consistency.hxx +49 -0
- data/ext/couchbase/couchbase/geo_bounding_box_query.hxx +107 -0
- data/ext/couchbase/couchbase/geo_distance_query.hxx +109 -0
- data/ext/couchbase/couchbase/geo_point.hxx +32 -0
- data/ext/couchbase/couchbase/geo_polygon_query.hxx +85 -0
- data/ext/couchbase/couchbase/highlight_style.hxx +45 -0
- data/ext/couchbase/couchbase/match_all_query.hxx +43 -0
- data/ext/couchbase/couchbase/match_none_query.hxx +43 -0
- data/ext/couchbase/couchbase/match_operator.hxx +45 -0
- data/ext/couchbase/couchbase/match_phrase_query.hxx +108 -0
- data/ext/couchbase/couchbase/match_query.hxx +163 -0
- data/ext/couchbase/couchbase/numeric_range.hxx +58 -0
- data/ext/couchbase/couchbase/numeric_range_facet.hxx +56 -0
- data/ext/couchbase/couchbase/numeric_range_facet_result.hxx +55 -0
- data/ext/couchbase/couchbase/numeric_range_query.hxx +143 -0
- data/ext/couchbase/couchbase/phrase_query.hxx +93 -0
- data/ext/couchbase/couchbase/prefix_query.hxx +82 -0
- data/ext/couchbase/couchbase/query_options.hxx +0 -1
- data/ext/couchbase/couchbase/query_string_query.hxx +72 -0
- data/ext/couchbase/couchbase/regexp_query.hxx +82 -0
- data/ext/couchbase/couchbase/scope.hxx +73 -0
- data/ext/couchbase/couchbase/search_date_range.hxx +68 -0
- data/ext/couchbase/couchbase/search_error_context.hxx +138 -0
- data/ext/couchbase/couchbase/search_facet.hxx +60 -0
- data/ext/couchbase/couchbase/search_facet_result.hxx +50 -0
- data/ext/couchbase/couchbase/search_meta_data.hxx +85 -0
- data/ext/couchbase/couchbase/search_metrics.hxx +127 -0
- data/ext/couchbase/couchbase/search_numeric_range.hxx +69 -0
- data/ext/couchbase/couchbase/search_options.hxx +509 -0
- data/ext/couchbase/couchbase/search_query.hxx +69 -0
- data/ext/couchbase/couchbase/search_result.hxx +77 -0
- data/ext/couchbase/couchbase/search_row.hxx +104 -0
- data/ext/couchbase/couchbase/search_row_location.hxx +55 -0
- data/ext/couchbase/couchbase/search_row_locations.hxx +86 -0
- data/ext/couchbase/couchbase/search_scan_consistency.hxx +34 -0
- data/ext/couchbase/couchbase/search_sort.hxx +58 -0
- data/ext/couchbase/couchbase/search_sort_field.hxx +117 -0
- data/ext/couchbase/couchbase/search_sort_field_missing.hxx +26 -0
- data/ext/couchbase/couchbase/search_sort_field_mode.hxx +27 -0
- data/ext/couchbase/couchbase/search_sort_field_type.hxx +28 -0
- data/ext/couchbase/couchbase/search_sort_id.hxx +60 -0
- data/ext/couchbase/couchbase/search_sort_score.hxx +60 -0
- data/ext/couchbase/couchbase/search_term_range.hxx +51 -0
- data/ext/couchbase/couchbase/security_options.hxx +3 -0
- data/ext/couchbase/couchbase/term_facet.hxx +48 -0
- data/ext/couchbase/couchbase/term_facet_result.hxx +55 -0
- data/ext/couchbase/couchbase/term_query.hxx +151 -0
- data/ext/couchbase/couchbase/term_range_query.hxx +142 -0
- data/ext/couchbase/couchbase/tracing/request_span.hxx +63 -0
- data/ext/couchbase/couchbase/tracing/request_tracer.hxx +2 -40
- data/ext/couchbase/couchbase/transactions/async_attempt_context.hxx +83 -4
- data/ext/couchbase/couchbase/transactions/attempt_context.hxx +68 -1
- data/ext/couchbase/couchbase/transactions/transaction_get_result.hxx +2 -0
- data/ext/couchbase/couchbase/transactions/transaction_keyspace.hxx +11 -1
- data/ext/couchbase/couchbase/transactions/transaction_options.hxx +79 -8
- data/ext/couchbase/couchbase/transactions/transaction_query_options.hxx +128 -15
- data/ext/couchbase/couchbase/transactions/transaction_query_result.hxx +4 -0
- data/ext/couchbase/couchbase/transactions/transaction_result.hxx +1 -1
- data/ext/couchbase/couchbase/transactions/transactions_cleanup_config.hxx +5 -3
- data/ext/couchbase/couchbase/transactions/transactions_config.hxx +9 -5
- data/ext/couchbase/couchbase/transactions/transactions_query_config.hxx +6 -3
- data/ext/couchbase/couchbase/transactions.hxx +34 -1
- data/ext/couchbase/couchbase/wildcard_query.hxx +83 -0
- data/ext/couchbase/test/CMakeLists.txt +8 -7
- data/ext/couchbase/test/benchmark_helper_integration.hxx +2 -2
- data/ext/couchbase/test/test_helper.hxx +6 -6
- data/ext/couchbase/test/test_integration_analytics.cxx +314 -16
- data/ext/couchbase/test/test_integration_collections.cxx +7 -3
- data/ext/couchbase/test/test_integration_connect.cxx +7 -3
- data/ext/couchbase/test/test_integration_crud.cxx +19 -2
- data/ext/couchbase/test/test_integration_diagnostics.cxx +11 -5
- data/ext/couchbase/test/test_integration_durability.cxx +12 -7
- data/ext/couchbase/test/test_integration_examples.cxx +324 -11
- data/ext/couchbase/test/test_integration_management.cxx +162 -94
- data/ext/couchbase/test/test_integration_query.cxx +68 -10
- data/ext/couchbase/test/test_integration_range_scan.cxx +12 -12
- data/ext/couchbase/test/test_integration_read_replica.cxx +48 -11
- data/ext/couchbase/test/test_integration_search.cxx +621 -0
- data/ext/couchbase/test/test_integration_subdoc.cxx +62 -11
- data/ext/couchbase/test/test_integration_tracer.cxx +5 -0
- data/ext/couchbase/test/test_integration_transcoders.cxx +13 -5
- data/ext/couchbase/test/{test_transaction_transaction_context.cxx → test_transaction_context.cxx} +1 -1
- data/ext/couchbase/test/test_transaction_examples.cxx +195 -0
- data/ext/couchbase/test/{test_transaction_transaction_simple.cxx → test_transaction_simple.cxx} +90 -5
- data/ext/couchbase/test/{test_transaction_transaction_simple_async.cxx → test_transaction_simple_async.cxx} +19 -21
- data/ext/couchbase/test/test_unit_config_profiles.cxx +13 -13
- data/ext/couchbase/test/test_unit_connection_string.cxx +35 -0
- data/ext/couchbase/test/test_unit_json_transcoder.cxx +4 -0
- data/ext/couchbase/test/test_unit_search.cxx +427 -0
- data/ext/couchbase/test/test_unit_transaction_utils.cxx +10 -1
- data/ext/couchbase/test/test_unit_utils.cxx +8 -4
- data/ext/couchbase/third_party/snappy/CMakeLists.txt +150 -27
- data/ext/couchbase/third_party/snappy/cmake/config.h.in +28 -24
- data/ext/couchbase/third_party/snappy/snappy-internal.h +189 -25
- data/ext/couchbase/third_party/snappy/snappy-sinksource.cc +26 -9
- data/ext/couchbase/third_party/snappy/snappy-sinksource.h +11 -11
- data/ext/couchbase/third_party/snappy/snappy-stubs-internal.cc +1 -1
- data/ext/couchbase/third_party/snappy/snappy-stubs-internal.h +227 -308
- data/ext/couchbase/third_party/snappy/snappy-stubs-public.h.in +0 -11
- data/ext/couchbase/third_party/snappy/snappy.cc +1176 -410
- data/ext/couchbase/third_party/snappy/snappy.h +19 -4
- data/ext/couchbase.cxx +85 -22
- data/ext/revisions.rb +3 -3
- data/lib/couchbase/authenticator.rb +0 -1
- data/lib/couchbase/cluster.rb +13 -13
- data/lib/couchbase/cluster_registry.rb +7 -2
- data/lib/couchbase/config_profiles.rb +1 -1
- data/lib/couchbase/configuration.rb +3 -4
- data/lib/couchbase/json_transcoder.rb +12 -5
- data/lib/couchbase/management/collection_query_index_manager.rb +54 -15
- data/lib/couchbase/management/query_index_manager.rb +70 -5
- data/lib/couchbase/options.rb +85 -2
- data/lib/couchbase/raw_binary_transcoder.rb +37 -0
- data/lib/couchbase/raw_json_transcoder.rb +38 -0
- data/lib/couchbase/raw_string_transcoder.rb +40 -0
- data/lib/couchbase/search_options.rb +163 -240
- data/lib/couchbase/transcoder_flags.rb +62 -0
- data/lib/couchbase/version.rb +1 -1
- metadata +151 -12
- data/ext/couchbase/core/CMakeLists.txt +0 -0
- /data/ext/couchbase/test/{test_transaction_transaction_public_async_api.cxx → test_transaction_public_async_api.cxx} +0 -0
- /data/ext/couchbase/test/{test_transaction_transaction_public_blocking_api.cxx → test_transaction_public_blocking_api.cxx} +0 -0
@@ -0,0 +1,109 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2023-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/search_query.hxx>
|
21
|
+
|
22
|
+
#include <cstdint>
|
23
|
+
#include <memory>
|
24
|
+
#include <vector>
|
25
|
+
|
26
|
+
namespace couchbase
|
27
|
+
{
|
28
|
+
/**
|
29
|
+
* The disjunction query is a compound query. The result documents must satisfy a configurable minimal (@ref min) number of child queries.
|
30
|
+
* By default this min is set to 1.
|
31
|
+
*
|
32
|
+
* At execution, a conjunction query that has no child queries is not allowed and will fail fast.
|
33
|
+
*
|
34
|
+
* Match documents with at least one (see @ref min) of the following conditions is satisfied:
|
35
|
+
* * `"location"` in the field `reviews.content`
|
36
|
+
* * `true` in the field `free_breakfast`.
|
37
|
+
*
|
38
|
+
* @snippet test_unit_search.cxx search-disjunction
|
39
|
+
*
|
40
|
+
* @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-conjuncts-disjuncts.html server documentation
|
41
|
+
*
|
42
|
+
* @since 1.0.0
|
43
|
+
* @committed
|
44
|
+
*/
|
45
|
+
class disjunction_query : public search_query
|
46
|
+
{
|
47
|
+
public:
|
48
|
+
/**
|
49
|
+
* Create a disjunction query.
|
50
|
+
*
|
51
|
+
* @tparam SearchQuery any subclass of @ref search_query
|
52
|
+
* @param queries sequence of query arguments
|
53
|
+
*
|
54
|
+
* @since 1.0.0
|
55
|
+
* @committed
|
56
|
+
*/
|
57
|
+
template<typename... SearchQuery>
|
58
|
+
explicit disjunction_query(SearchQuery&&... queries)
|
59
|
+
{
|
60
|
+
or_else(std::forward<SearchQuery>(queries)...);
|
61
|
+
}
|
62
|
+
|
63
|
+
/**
|
64
|
+
* Add one or more queries to add to the disjunction.
|
65
|
+
*
|
66
|
+
* @tparam SearchQuery any subclass of @ref search_query
|
67
|
+
* @param queries sequence of query arguments
|
68
|
+
*
|
69
|
+
* @return this query for chaining purposes.
|
70
|
+
*
|
71
|
+
* @since 1.0.0
|
72
|
+
* @committed
|
73
|
+
*/
|
74
|
+
template<typename... SearchQuery>
|
75
|
+
auto or_else(SearchQuery... queries) -> disjunction_query&
|
76
|
+
{
|
77
|
+
(disjuncts_.emplace_back(std::make_shared<SearchQuery>(std::move(queries))), ...);
|
78
|
+
return *this;
|
79
|
+
}
|
80
|
+
|
81
|
+
/**
|
82
|
+
* Set the minimum number of child queries that must be satisfied for the disjunction query.
|
83
|
+
*
|
84
|
+
* @param number_of_queries minimum number of child queries.
|
85
|
+
*
|
86
|
+
* @return this query for chaining purposes.
|
87
|
+
*
|
88
|
+
* @since 1.0.0
|
89
|
+
* @committed
|
90
|
+
*/
|
91
|
+
auto min(std::uint32_t number_of_queries) -> disjunction_query&
|
92
|
+
{
|
93
|
+
min_ = number_of_queries;
|
94
|
+
return *this;
|
95
|
+
}
|
96
|
+
|
97
|
+
/**
|
98
|
+
* @return encoded representation of the query.
|
99
|
+
*
|
100
|
+
* @since 1.0.0
|
101
|
+
* @internal
|
102
|
+
*/
|
103
|
+
[[nodiscard]] auto encode() const -> encoded_search_query override;
|
104
|
+
|
105
|
+
private:
|
106
|
+
std::vector<std::shared_ptr<search_query>> disjuncts_{};
|
107
|
+
std::uint32_t min_{ 1 };
|
108
|
+
};
|
109
|
+
} // namespace couchbase
|
@@ -0,0 +1,111 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2023-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/search_query.hxx>
|
21
|
+
|
22
|
+
#include <string>
|
23
|
+
#include <vector>
|
24
|
+
|
25
|
+
namespace couchbase
|
26
|
+
{
|
27
|
+
/**
|
28
|
+
* A doc_id query is a query that directly matches the documents whose ID have been provided. It can be combined within a conjunction_query
|
29
|
+
* to restrict matches on the set of documents.
|
30
|
+
*
|
31
|
+
* @since 1.0.0
|
32
|
+
* @committed
|
33
|
+
*/
|
34
|
+
class doc_id_query : public search_query
|
35
|
+
{
|
36
|
+
public:
|
37
|
+
doc_id_query() = default;
|
38
|
+
|
39
|
+
/**
|
40
|
+
* Create a new doc_id query.
|
41
|
+
*
|
42
|
+
* @param ids the list of document IDs to be restricted against.
|
43
|
+
*
|
44
|
+
* @since 1.0.0
|
45
|
+
* @committed
|
46
|
+
*/
|
47
|
+
explicit doc_id_query(std::vector<std::string> ids)
|
48
|
+
: ids_{ std::move(ids) }
|
49
|
+
{
|
50
|
+
}
|
51
|
+
|
52
|
+
/**
|
53
|
+
* Create a new doc_id query.
|
54
|
+
*
|
55
|
+
* @param ids the list of document IDs to be restricted against.
|
56
|
+
*
|
57
|
+
* @since 1.0.0
|
58
|
+
* @committed
|
59
|
+
*/
|
60
|
+
doc_id_query(std::initializer_list<std::string> ids)
|
61
|
+
{
|
62
|
+
ids_.reserve(ids.size());
|
63
|
+
doc_ids(ids);
|
64
|
+
}
|
65
|
+
|
66
|
+
/**
|
67
|
+
* Add IDs to the query.
|
68
|
+
*
|
69
|
+
* @param ids the list of document identifiers to add
|
70
|
+
*
|
71
|
+
* @return this query for chaining purposes.
|
72
|
+
*
|
73
|
+
* @since 1.0.0
|
74
|
+
* @committed
|
75
|
+
*/
|
76
|
+
auto doc_ids(const std::vector<std::string>& ids) -> doc_id_query&
|
77
|
+
{
|
78
|
+
for (const auto& id : ids) {
|
79
|
+
ids_.push_back(id);
|
80
|
+
}
|
81
|
+
return *this;
|
82
|
+
}
|
83
|
+
|
84
|
+
/**
|
85
|
+
* Add ID to the query.
|
86
|
+
*
|
87
|
+
* @param id the document identifier to add
|
88
|
+
*
|
89
|
+
* @return this query for chaining purposes.
|
90
|
+
*
|
91
|
+
* @since 1.0.0
|
92
|
+
* @committed
|
93
|
+
*/
|
94
|
+
auto doc_id(const std::string& id) -> doc_id_query&
|
95
|
+
{
|
96
|
+
ids_.push_back(id);
|
97
|
+
return *this;
|
98
|
+
}
|
99
|
+
|
100
|
+
/**
|
101
|
+
* @return encoded representation of the query.
|
102
|
+
*
|
103
|
+
* @since 1.0.0
|
104
|
+
* @internal
|
105
|
+
*/
|
106
|
+
[[nodiscard]] auto encode() const -> encoded_search_query override;
|
107
|
+
|
108
|
+
private:
|
109
|
+
std::vector<std::string> ids_{};
|
110
|
+
};
|
111
|
+
} // namespace couchbase
|
@@ -43,6 +43,7 @@ class error_context
|
|
43
43
|
* @committed
|
44
44
|
*/
|
45
45
|
error_context() = default;
|
46
|
+
virtual ~error_context() = default;
|
46
47
|
|
47
48
|
/**
|
48
49
|
* Creates and initializes error context with given parameters.
|
@@ -79,7 +80,7 @@ class error_context
|
|
79
80
|
* @since 1.0.0
|
80
81
|
* @committed
|
81
82
|
*/
|
82
|
-
[[nodiscard]] auto ec() const -> std::error_code
|
83
|
+
[[nodiscard]] virtual auto ec() const -> std::error_code
|
83
84
|
{
|
84
85
|
return ec_;
|
85
86
|
}
|
@@ -105,7 +106,7 @@ class error_context
|
|
105
106
|
* @since 1.0.0
|
106
107
|
* @committed
|
107
108
|
*/
|
108
|
-
[[nodiscard]] auto last_dispatched_to() const -> const std::optional<std::string>&
|
109
|
+
[[nodiscard]] virtual auto last_dispatched_to() const -> const std::optional<std::string>&
|
109
110
|
{
|
110
111
|
return last_dispatched_to_;
|
111
112
|
}
|
@@ -118,7 +119,7 @@ class error_context
|
|
118
119
|
* @since 1.0.0
|
119
120
|
* @committed
|
120
121
|
*/
|
121
|
-
[[nodiscard]] auto last_dispatched_from() const -> const std::optional<std::string>&
|
122
|
+
[[nodiscard]] virtual auto last_dispatched_from() const -> const std::optional<std::string>&
|
122
123
|
{
|
123
124
|
return last_dispatched_from_;
|
124
125
|
}
|
@@ -131,7 +132,7 @@ class error_context
|
|
131
132
|
* @since 1.0.0
|
132
133
|
* @committed
|
133
134
|
*/
|
134
|
-
[[nodiscard]] auto retry_attempts() const -> std::size_t
|
135
|
+
[[nodiscard]] virtual auto retry_attempts() const -> std::size_t
|
135
136
|
{
|
136
137
|
return retry_attempts_;
|
137
138
|
}
|
@@ -144,7 +145,7 @@ class error_context
|
|
144
145
|
* @since 1.0.0
|
145
146
|
* @committed
|
146
147
|
*/
|
147
|
-
[[nodiscard]] auto retry_reasons() const -> const std::set<retry_reason>&
|
148
|
+
[[nodiscard]] virtual auto retry_reasons() const -> const std::set<retry_reason>&
|
148
149
|
{
|
149
150
|
return retry_reasons_;
|
150
151
|
}
|
@@ -158,7 +159,7 @@ class error_context
|
|
158
159
|
* @since 1.0.0
|
159
160
|
* @uncommitted
|
160
161
|
*/
|
161
|
-
[[nodiscard]] auto retried_because_of(retry_reason reason) const -> bool
|
162
|
+
[[nodiscard]] virtual auto retried_because_of(retry_reason reason) const -> bool
|
162
163
|
{
|
163
164
|
return retry_reasons_.count(reason) > 0;
|
164
165
|
}
|
@@ -0,0 +1,52 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2020-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/analytics_scan_consistency.hxx>
|
21
|
+
|
22
|
+
#include <fmt/core.h>
|
23
|
+
|
24
|
+
/**
|
25
|
+
* Helper for fmtlib to format @ref couchbase::analytics_scan_consistency objects.
|
26
|
+
*
|
27
|
+
* @since 1.0.0
|
28
|
+
* @committed
|
29
|
+
*/
|
30
|
+
template<>
|
31
|
+
struct fmt::formatter<couchbase::analytics_scan_consistency> {
|
32
|
+
template<typename ParseContext>
|
33
|
+
constexpr auto parse(ParseContext& ctx)
|
34
|
+
{
|
35
|
+
return ctx.begin();
|
36
|
+
}
|
37
|
+
|
38
|
+
template<typename FormatContext>
|
39
|
+
auto format(couchbase::analytics_scan_consistency mode, FormatContext& ctx) const
|
40
|
+
{
|
41
|
+
string_view name = "unknown";
|
42
|
+
switch (mode) {
|
43
|
+
case couchbase::analytics_scan_consistency::not_bounded:
|
44
|
+
name = "not_bounded";
|
45
|
+
break;
|
46
|
+
case couchbase::analytics_scan_consistency::request_plus:
|
47
|
+
name = "request_plus";
|
48
|
+
break;
|
49
|
+
}
|
50
|
+
return format_to(ctx.out(), "{}", name);
|
51
|
+
}
|
52
|
+
};
|
@@ -0,0 +1,76 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2020-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/analytics_status.hxx>
|
21
|
+
|
22
|
+
#include <fmt/core.h>
|
23
|
+
|
24
|
+
/**
|
25
|
+
* Helper for fmtlib to format @ref couchbase::analytics_status objects.
|
26
|
+
*
|
27
|
+
* @since 1.0.0
|
28
|
+
* @committed
|
29
|
+
*/
|
30
|
+
template<>
|
31
|
+
struct fmt::formatter<couchbase::analytics_status> {
|
32
|
+
template<typename ParseContext>
|
33
|
+
constexpr auto parse(ParseContext& ctx)
|
34
|
+
{
|
35
|
+
return ctx.begin();
|
36
|
+
}
|
37
|
+
|
38
|
+
template<typename FormatContext>
|
39
|
+
auto format(couchbase::analytics_status status, FormatContext& ctx) const
|
40
|
+
{
|
41
|
+
string_view name = "unknown";
|
42
|
+
switch (status) {
|
43
|
+
case couchbase::analytics_status::running:
|
44
|
+
name = "running";
|
45
|
+
break;
|
46
|
+
case couchbase::analytics_status::success:
|
47
|
+
name = "success";
|
48
|
+
break;
|
49
|
+
case couchbase::analytics_status::errors:
|
50
|
+
name = "errors";
|
51
|
+
break;
|
52
|
+
case couchbase::analytics_status::completed:
|
53
|
+
name = "completed";
|
54
|
+
break;
|
55
|
+
case couchbase::analytics_status::stopped:
|
56
|
+
name = "stopped";
|
57
|
+
break;
|
58
|
+
case couchbase::analytics_status::timeout:
|
59
|
+
name = "timeout";
|
60
|
+
break;
|
61
|
+
case couchbase::analytics_status::closed:
|
62
|
+
name = "closed";
|
63
|
+
break;
|
64
|
+
case couchbase::analytics_status::fatal:
|
65
|
+
name = "fatal";
|
66
|
+
break;
|
67
|
+
case couchbase::analytics_status::aborted:
|
68
|
+
name = "aborted";
|
69
|
+
break;
|
70
|
+
case couchbase::analytics_status::unknown:
|
71
|
+
name = "unknown";
|
72
|
+
break;
|
73
|
+
}
|
74
|
+
return format_to(ctx.out(), "{}", name);
|
75
|
+
}
|
76
|
+
};
|
@@ -0,0 +1,49 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2020-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/search_scan_consistency.hxx>
|
21
|
+
|
22
|
+
#include <fmt/core.h>
|
23
|
+
|
24
|
+
/**
|
25
|
+
* Helper for fmtlib to format @ref couchbase::search_scan_consistency objects.
|
26
|
+
*
|
27
|
+
* @since 1.0.0
|
28
|
+
* @committed
|
29
|
+
*/
|
30
|
+
template<>
|
31
|
+
struct fmt::formatter<couchbase::search_scan_consistency> {
|
32
|
+
template<typename ParseContext>
|
33
|
+
constexpr auto parse(ParseContext& ctx)
|
34
|
+
{
|
35
|
+
return ctx.begin();
|
36
|
+
}
|
37
|
+
|
38
|
+
template<typename FormatContext>
|
39
|
+
auto format(couchbase::search_scan_consistency mode, FormatContext& ctx) const
|
40
|
+
{
|
41
|
+
string_view name = "unknown";
|
42
|
+
switch (mode) {
|
43
|
+
case couchbase::search_scan_consistency::not_bounded:
|
44
|
+
name = "not_bounded";
|
45
|
+
break;
|
46
|
+
}
|
47
|
+
return format_to(ctx.out(), "{}", name);
|
48
|
+
}
|
49
|
+
};
|
@@ -0,0 +1,107 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2023-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/geo_point.hxx>
|
21
|
+
#include <couchbase/search_query.hxx>
|
22
|
+
|
23
|
+
#include <optional>
|
24
|
+
#include <string>
|
25
|
+
|
26
|
+
namespace couchbase
|
27
|
+
{
|
28
|
+
/**
|
29
|
+
* This query finds all @ref geo_point indexed matches within a given area (identified by the list of @ref geo_point coordinates). Each of
|
30
|
+
* the pairs is taken to indicate one corner of a polygon. Documents are returned if they reference a location within the area of the
|
31
|
+
* polygon.
|
32
|
+
*
|
33
|
+
* The following query-body uses an array of @ref geo_point to specify the latitude and longitude of each of the corners of a polygon, known
|
34
|
+
* as polygon points. Here, the last-specified entry is identical to the initial, thus explicitly closing the box. However, specifying an
|
35
|
+
* explicit closure in this way is optional: the closure will be inferred by the Couchbase Server if not explicitly specified.
|
36
|
+
* @snippet test_unit_search.cxx search-geo-bounding-box
|
37
|
+
*
|
38
|
+
* @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-geo-bounded-rectangle.html server documentation
|
39
|
+
*
|
40
|
+
* @since 1.0.0
|
41
|
+
* @committed
|
42
|
+
*/
|
43
|
+
class geo_bounding_box_query : public search_query
|
44
|
+
{
|
45
|
+
public:
|
46
|
+
/**
|
47
|
+
* Create a new geo bounding box query.
|
48
|
+
*
|
49
|
+
* @param top_left the top left coordinates signify the bounding box area
|
50
|
+
* @param bottom_right the bottom right coordinates signify the bounding box area
|
51
|
+
*
|
52
|
+
* @since 1.0.0
|
53
|
+
* @committed
|
54
|
+
*/
|
55
|
+
geo_bounding_box_query(geo_point top_left, geo_point bottom_right)
|
56
|
+
: top_left_{ top_left }
|
57
|
+
, bottom_right_{ bottom_right }
|
58
|
+
{
|
59
|
+
}
|
60
|
+
|
61
|
+
/**
|
62
|
+
* Create a new geo distance query.
|
63
|
+
*
|
64
|
+
* @param top_left_latitude latitude of the top left coordinate
|
65
|
+
* @param top_left_longitude longitude of the top left coordinate
|
66
|
+
* @param bottom_right_latitude latitude of the bottom right coordinate
|
67
|
+
* @param bottom_right_longitude latitude of the bottom right coordinate
|
68
|
+
*
|
69
|
+
* @since 1.0.0
|
70
|
+
* @committed
|
71
|
+
*/
|
72
|
+
geo_bounding_box_query(double top_left_latitude, double top_left_longitude, double bottom_right_latitude, double bottom_right_longitude)
|
73
|
+
: top_left_{ geo_point{ top_left_latitude, top_left_longitude } }
|
74
|
+
, bottom_right_{ geo_point{ bottom_right_latitude, bottom_right_longitude } }
|
75
|
+
{
|
76
|
+
}
|
77
|
+
|
78
|
+
/**
|
79
|
+
* If a field is specified, only terms in that field will be matched.
|
80
|
+
*
|
81
|
+
* @param field_name name of the field to be matched
|
82
|
+
*
|
83
|
+
* @return this query for chaining purposes.
|
84
|
+
*
|
85
|
+
* @since 1.0.0
|
86
|
+
* @committed
|
87
|
+
*/
|
88
|
+
auto field(std::string field_name) -> geo_bounding_box_query&
|
89
|
+
{
|
90
|
+
field_ = std::move(field_name);
|
91
|
+
return *this;
|
92
|
+
}
|
93
|
+
|
94
|
+
/**
|
95
|
+
* @return encoded representation of the query.
|
96
|
+
*
|
97
|
+
* @since 1.0.0
|
98
|
+
* @internal
|
99
|
+
*/
|
100
|
+
[[nodiscard]] auto encode() const -> encoded_search_query override;
|
101
|
+
|
102
|
+
private:
|
103
|
+
geo_point top_left_;
|
104
|
+
geo_point bottom_right_;
|
105
|
+
std::optional<std::string> field_{};
|
106
|
+
};
|
107
|
+
} // namespace couchbase
|
@@ -0,0 +1,109 @@
|
|
1
|
+
/* -*- Mode: C++; tab-width: 4; c-basic-offset: 4; indent-tabs-mode: nil -*- */
|
2
|
+
/*
|
3
|
+
* Copyright 2023-Present Couchbase, Inc.
|
4
|
+
*
|
5
|
+
* Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
* you may not use this file except in compliance with the License.
|
7
|
+
* You may obtain a copy of the License at
|
8
|
+
*
|
9
|
+
* http://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
*
|
11
|
+
* Unless required by applicable law or agreed to in writing, software
|
12
|
+
* distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
* See the License for the specific language governing permissions and
|
15
|
+
* limitations under the License.
|
16
|
+
*/
|
17
|
+
|
18
|
+
#pragma once
|
19
|
+
|
20
|
+
#include <couchbase/geo_point.hxx>
|
21
|
+
#include <couchbase/search_query.hxx>
|
22
|
+
|
23
|
+
#include <optional>
|
24
|
+
#include <string>
|
25
|
+
|
26
|
+
namespace couchbase
|
27
|
+
{
|
28
|
+
/**
|
29
|
+
* This query finds all matches from a given location as @ref geo_point within the given distance. Both the point and the distance are
|
30
|
+
* required.
|
31
|
+
*
|
32
|
+
* The following query specifies a longitude of `-2.235143` and a latitude of `53.482358`. The target-field `geo` is specified, as is a
|
33
|
+
* distance of `100 miles`: this is the radius within which target-locations must reside for their documents to be returned.
|
34
|
+
* @snippet test_unit_search.cxx search-geo-distance
|
35
|
+
*
|
36
|
+
* @see https://docs.couchbase.com/server/current/fts/fts-supported-queries-geo-point-distance.html server documentation
|
37
|
+
*
|
38
|
+
* @since 1.0.0
|
39
|
+
* @committed
|
40
|
+
*/
|
41
|
+
class geo_distance_query : public search_query
|
42
|
+
{
|
43
|
+
public:
|
44
|
+
/**
|
45
|
+
* Create a new geo distance query.
|
46
|
+
*
|
47
|
+
* @param location the location represents a point from which the distance is measured.
|
48
|
+
* @param distance the distance describes how far from the location the radius should be matched. For example, `"11km"`,
|
49
|
+
* `"11kilometers"`, `"3nm"`, `"3nauticalmiles"`, `"17mi"`, `"17miles"`, `"19m"`, `"19meters"`.
|
50
|
+
*
|
51
|
+
* @see https://github.com/blevesearch/bleve/blob/ae28975038cb25655da968e3f043210749ba382b/geo/geo_dist.go#L29-L37 list of distance
|
52
|
+
* units.
|
53
|
+
*
|
54
|
+
* @since 1.0.0
|
55
|
+
* @committed
|
56
|
+
*/
|
57
|
+
geo_distance_query(geo_point location, std::string distance)
|
58
|
+
: location_{ location }
|
59
|
+
, distance_{ std::move(distance) }
|
60
|
+
{
|
61
|
+
}
|
62
|
+
|
63
|
+
/**
|
64
|
+
* Create a new geo distance query.
|
65
|
+
*
|
66
|
+
* @param latitude the location latitude
|
67
|
+
* @param longitude the location longitude
|
68
|
+
* @param distance the distance describes how far from the location the radius should be matched. For example, `"11km"`,
|
69
|
+
* `"11kilometers"`, `"3nm"`, `"3nauticalmiles"`, `"17mi"`, `"17miles"`, `"19m"`, `"19meters"`.
|
70
|
+
*
|
71
|
+
* @since 1.0.0
|
72
|
+
* @committed
|
73
|
+
*/
|
74
|
+
geo_distance_query(double latitude, double longitude, std::string distance)
|
75
|
+
: location_{ geo_point{ latitude, longitude } }
|
76
|
+
, distance_{ std::move(distance) }
|
77
|
+
{
|
78
|
+
}
|
79
|
+
|
80
|
+
/**
|
81
|
+
* If a field is specified, only terms in that field will be matched.
|
82
|
+
*
|
83
|
+
* @param field_name name of the field to be matched
|
84
|
+
*
|
85
|
+
* @return this query for chaining purposes.
|
86
|
+
*
|
87
|
+
* @since 1.0.0
|
88
|
+
* @committed
|
89
|
+
*/
|
90
|
+
auto field(std::string field_name) -> geo_distance_query&
|
91
|
+
{
|
92
|
+
field_ = std::move(field_name);
|
93
|
+
return *this;
|
94
|
+
}
|
95
|
+
|
96
|
+
/**
|
97
|
+
* @return encoded representation of the query.
|
98
|
+
*
|
99
|
+
* @since 1.0.0
|
100
|
+
* @internal
|
101
|
+
*/
|
102
|
+
[[nodiscard]] auto encode() const -> encoded_search_query override;
|
103
|
+
|
104
|
+
private:
|
105
|
+
geo_point location_;
|
106
|
+
std::string distance_;
|
107
|
+
std::optional<std::string> field_{};
|
108
|
+
};
|
109
|
+
} // namespace couchbase
|