MongoDB C++ Driver mongocxx-4.0.0
Loading...
Searching...
No Matches
uri.hpp
Go to the documentation of this file.
1// Copyright 2009-present 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 <memory>
18#include <string>
19#include <vector>
20
22#include <mongocxx/pool-fwd.hpp>
23#include <mongocxx/uri-fwd.hpp>
24
27
31
33
34namespace mongocxx {
35namespace v_noabi {
36
43class uri {
44 public:
46 struct host {
47 std::string name;
48 std::uint16_t port;
49 std::int32_t family;
50 };
51
55 static MONGOCXX_ABI_EXPORT const std::string k_default_uri;
56
68 uri(bsoncxx::v_noabi::string::view_or_value uri_string = k_default_uri);
69
74
78 MONGOCXX_ABI_EXPORT_CDECL(uri&) operator=(uri&&) noexcept;
79
84
85 uri(const uri&) = delete;
86 uri& operator=(const uri&) = delete;
87
94
101
108
115
125 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::document::view) options() const;
126
133
140
147
154
163
170
177
184
191
197 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::stdx::string_view>)
198 appname() const;
199
205 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::view>)
207
213 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::document::view>)
215
221 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>) srv_max_hosts() const;
222
229 MONGOCXX_ABI_EXPORT_CDECL(std::vector<bsoncxx::v_noabi::stdx::string_view>) compressors() const;
230
236 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
238
244 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>) direct_connection() const;
245
251 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
253
259 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
261
267 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>) max_pool_size() const;
268
274 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>) retry_reads() const;
275
281 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>) retry_writes() const;
282
288 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
290
296 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>)
298
304 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
306
312 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>)
314
320 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>)
322
328 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::stdx::string_view>)
329 tls_ca_file() const;
330
336 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::stdx::string_view>)
338
344 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bsoncxx::v_noabi::stdx::string_view>)
346
353 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>)
355
361 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>)
363
369 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<bool>) tls_insecure() const;
370
376 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
378
384 MONGOCXX_ABI_EXPORT_CDECL(bsoncxx::v_noabi::stdx::optional<std::int32_t>)
386
387 private:
388 friend ::mongocxx::v_noabi::client;
389 friend ::mongocxx::v_noabi::pool;
390
391 class impl;
392
393 uri(std::unique_ptr<impl>&& implementation);
394
395 std::unique_ptr<impl> _impl;
396};
397
398} // namespace v_noabi
399} // namespace mongocxx
400
401#include <mongocxx/config/postlude.hpp>
402
Class representing a client connection to MongoDB.
Definition client.hpp:61
Class representing a MongoDB database.
Definition database.hpp:46
A pool of client objects associated with a MongoDB deployment.
Definition pool.hpp:51
A class to represent the read concern. Read concern can be set at the client, database,...
Definition read_concern.hpp:57
Class representing a preference for how the driver routes read operations to members of a replica set...
Definition read_preference.hpp:64
Class representing a MongoDB connection string URI.
Definition uri.hpp:43
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > tls_ca_file() const
Returns the value of the option "tlsCAFile" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bool > server_selection_try_once() const
Returns the value of the option "serverSelectionTryOnce" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bool > tls_insecure() const
Returns the value of the option "tlsInsecure" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > tls_certificate_key_file() const
Returns the value of the option "tlsCertificateKeyFile" if present in the uri.
static MONGOCXX_ABI_EXPORT const std::string k_default_uri
The default URI string: "mongodb://localhost:27017".
Definition uri.hpp:55
std::vector< host > hosts() const
Returns the hosts from the uri.
std::string auth_mechanism() const
Returns the authentication mechanism from the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > zlib_compression_level() const
Returns the value of the option "zlibCompressionLevel" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > max_pool_size() const
Returns the value of the option "maxPoolSize" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > connect_timeout_ms() const
Returns the value of the option "connectTimeoutMS" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > wait_queue_timeout_ms() const
Returns the value of the option "waitQueueTimeoutMS" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view > auth_mechanism_properties() const
Returns the value of the option "authMechanismProperties" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bool > tls_allow_invalid_certificates() const
Returns the value of the option "tlsAllowInvalidCertificates" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > appname() const
Returns the value of the option "appname" if present in the uri.
bool tls() const
Returns the tls parameter from the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > local_threshold_ms() const
Returns the value of the option "localThresholdMS" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view > credentials()
Returns the value of the option credentials if present in the uri.
std::string auth_source() const
Returns the authentication source from the uri.
std::string to_string() const
Returns the uri in a string format.
bsoncxx::v_noabi::stdx::optional< std::int32_t > server_selection_timeout_ms() const
Returns the value of the option "serverSelectionTimeoutMS" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > heartbeat_frequency_ms() const
Returns the value of the option "heartbeatFrequencyMS" if present in the uri.
bsoncxx::v_noabi::document::view options() const
Returns other uri options.
bsoncxx::v_noabi::stdx::optional< bool > retry_writes() const
Returns the value of the option "retryWrites" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bool > tls_allow_invalid_hostnames() const
Returns the value of the option "tlsAllowInvalidHostnames" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > tls_certificate_key_file_password() const
Returns the value of the option "tlsCertificateKeyFilePassword" if present in the uri.
std::vector< bsoncxx::v_noabi::stdx::string_view > compressors() const
Returns the list of compressors present in the uri or an empty list if "compressors" was not present ...
MONGOCXX_DEPRECATED bool ssl() const
Returns the ssl parameter from the uri.
std::string username() const
Returns the supplied username from the uri.
bsoncxx::v_noabi::stdx::optional< bool > tls_disable_certificate_revocation_check() const
Returns the value of the option "tlsDisableCertificateRevocationCheck" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > srv_max_hosts() const
Returns the value of the option "srvMaxHosts" if present in the uri.
bsoncxx::v_noabi::stdx::optional< std::int32_t > socket_timeout_ms() const
Returns the value of the option "socketTimeoutMS" if present in the uri.
std::string password() const
Returns the password from the uri.
bsoncxx::v_noabi::stdx::optional< bool > direct_connection() const
Returns the value of the option "directConnection" if present in the uri.
std::string replica_set() const
Returns the replica set specified in the uri.
bsoncxx::v_noabi::stdx::optional< bool > retry_reads() const
Returns the value of the option "retryReads" if present in the uri.
bsoncxx::v_noabi::stdx::optional< bool > tls_disable_ocsp_endpoint_check() const
Returns the value of the option "tlsDisableOCSPEndpointCheck" if present in the uri.
Class representing the server-side requirement for reporting the success of a write operation....
Definition write_concern.hpp:60
Declares mongocxx::v_noabi::client.
Provides bsoncxx::v_noabi::document::view.
#define MONGOCXX_DEPRECATED
Declares the associated entity as deprecated.
Definition fwd.hpp:212
#define MONGOCXX_ABI_EXPORT_CDECL(...)
Equivalent to MONGOCXX_ABI_EXPORT with MONGOCXX_ABI_CDECL.
Definition fwd.hpp:204
#define MONGOCXX_ABI_EXPORT
Exports the associated entity as part of the ABI.
Definition fwd.hpp:180
The mongocxx macro guard prelude header.
The top-level namespace within which all bsoncxx library entities are declared.
The top-level namespace within which all mongocxx library entities are declared.
The top-level namespace reserved for the C++ standard library.
Declares mongocxx::v_noabi::pool.
Provides mongocxx::v_noabi::read_concern.
Provides mongocxx::v_noabi::read_preference.
Provides bsoncxx::v_noabi::string::view_or_value.
A host.
Definition uri.hpp:46
Declares mongocxx::v_noabi::uri.
Provides mongocxx::v_noabi::write_concern.