MongoDB C++ Driver current
Loading...
Searching...
No Matches
Classes | Public Member Functions | Static Public Attributes | List of all members
mongocxx::v_noabi::uri Class Reference

#include <mongocxx/v_noabi/mongocxx/uri.hpp>

Description

Class representing a MongoDB connection string URI.

See also

Classes

struct  host
 A host. More...
 

Public Member Functions

 uri (bsoncxx::v_noabi::string::view_or_value uri_string=k_default_uri)
 Constructs a uri from an optional MongoDB URI string. If no URI string is specified, uses the default URI string: "mongodb://localhost:27017".
 
 uri (uri &&) noexcept
 Move constructs a uri.
 
 ~uri ()
 Destroys a uri.
 
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_viewappname () const
 Returns the value of the option "appname" if present in the uri.
 
std::string auth_mechanism () const
 Returns the authentication mechanism from the uri.
 
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::viewauth_mechanism_properties () const
 Returns the value of the option "authMechanismProperties" if present in the uri.
 
std::string auth_source () const
 Returns the authentication source from the uri.
 
std::vector< bsoncxx::v_noabi::stdx::string_viewcompressors () const
 Returns the list of compressors present in the uri or an empty list if "compressors" was not present or contained no valid compressors.
 
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< bsoncxx::v_noabi::document::viewcredentials ()
 Returns the value of the option credentials if present in the uri.
 
std::string database () const
 Returns the database from the uri.
 
bsoncxx::v_noabi::stdx::optional< bool > direct_connection () const
 Returns the value of the option "directConnection" 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.
 
std::vector< hosthosts () const
 Returns the hosts 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< std::int32_t > max_pool_size () const
 Returns the value of the option "maxPoolSize" if present in the uri.
 
urioperator= (uri &&) noexcept
 Move assigns a uri.
 
bsoncxx::v_noabi::document::view options () const
 Returns other uri options.
 
std::string password () const
 Returns the password from the uri.
 
mongocxx::v_noabi::read_concern read_concern () const
 Returns the read concern from the uri.
 
mongocxx::v_noabi::read_preference read_preference () const
 Returns the read preference from 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 > retry_writes () const
 Returns the value of the option "retryWrites" if present in the uri.
 
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< bool > server_selection_try_once () const
 Returns the value of the option "serverSelectionTryOnce" 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.
 
bsoncxx::v_noabi::stdx::optional< std::int32_t > srv_max_hosts () const
 Returns the value of the option "srvMaxHosts" if present in the uri.
 
MONGOCXX_DEPRECATED bool ssl () const
 Returns the ssl parameter from the uri.
 
bool tls () const
 Returns the tls parameter from 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< 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_viewtls_ca_file () const
 Returns the value of the option "tlsCAFile" if present in the uri.
 
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_viewtls_certificate_key_file () const
 Returns the value of the option "tlsCertificateKeyFile" if present in the uri.
 
bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_viewtls_certificate_key_file_password () const
 Returns the value of the option "tlsCertificateKeyFilePassword" if present in 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< bool > tls_disable_ocsp_endpoint_check () const
 Returns the value of the option "tlsDisableOCSPEndpointCheck" 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.
 
std::string to_string () const
 Returns the uri in a string format.
 
std::string username () const
 Returns the supplied username from 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.
 
mongocxx::v_noabi::write_concern write_concern () const
 Returns the write concern specified in 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.
 

Static Public Attributes

static MONGOCXX_ABI_EXPORT const std::string k_default_uri
 The default URI string: "mongodb://localhost:27017".
 

Constructor & Destructor Documentation

◆ uri() [1/2]

mongocxx::v_noabi::uri::uri ( bsoncxx::v_noabi::string::view_or_value  uri_string = k_default_uri)

Constructs a uri from an optional MongoDB URI string. If no URI string is specified, uses the default URI string: "mongodb://localhost:27017".

See also
Parameters
uri_stringString representing a MongoDB connection string URI, defaults to k_default_uri.

◆ uri() [2/2]

mongocxx::v_noabi::uri::uri ( uri &&  )
noexcept

Move constructs a uri.

◆ ~uri()

mongocxx::v_noabi::uri::~uri ( )

Destroys a uri.

Member Function Documentation

◆ appname()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > mongocxx::v_noabi::uri::appname ( ) const

Returns the value of the option "appname" if present in the uri.

Returns
An optional bsoncxx::v_noabi::stdx::string_view

◆ auth_mechanism()

std::string mongocxx::v_noabi::uri::auth_mechanism ( ) const

Returns the authentication mechanism from the uri.

Returns
A string representing the authentication mechanism.

◆ auth_mechanism_properties()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view > mongocxx::v_noabi::uri::auth_mechanism_properties ( ) const

Returns the value of the option "authMechanismProperties" if present in the uri.

Returns
An optional bsoncxx::v_noabi::document::view

◆ auth_source()

std::string mongocxx::v_noabi::uri::auth_source ( ) const

Returns the authentication source from the uri.

Returns
A string representing the authentication source.

◆ compressors()

std::vector< bsoncxx::v_noabi::stdx::string_view > mongocxx::v_noabi::uri::compressors ( ) const

Returns the list of compressors present in the uri or an empty list if "compressors" was not present or contained no valid compressors.

Returns
A std::vector of bsoncxx::v_noabi::stdx::string_view.

◆ connect_timeout_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::connect_timeout_ms ( ) const

Returns the value of the option "connectTimeoutMS" if present in the uri.

Returns
An optional std::int32_t

◆ credentials()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::document::view > mongocxx::v_noabi::uri::credentials ( )

Returns the value of the option credentials if present in the uri.

Returns
An optional bsoncxx::v_noabi::document::view

◆ database()

std::string mongocxx::v_noabi::uri::database ( ) const

Returns the database from the uri.

Returns
A string with the name of the database.

◆ direct_connection()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::direct_connection ( ) const

Returns the value of the option "directConnection" if present in the uri.

Returns
An optional bool

◆ heartbeat_frequency_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::heartbeat_frequency_ms ( ) const

Returns the value of the option "heartbeatFrequencyMS" if present in the uri.

Returns
An optional std::int32_t

◆ hosts()

std::vector< host > mongocxx::v_noabi::uri::hosts ( ) const

Returns the hosts from the uri.

Returns
A vector of hosts.

◆ local_threshold_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::local_threshold_ms ( ) const

Returns the value of the option "localThresholdMS" if present in the uri.

Returns
An optional std::int32_t

◆ max_pool_size()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::max_pool_size ( ) const

Returns the value of the option "maxPoolSize" if present in the uri.

Returns
An optional std::int32_t

◆ operator=()

uri & mongocxx::v_noabi::uri::operator= ( uri &&  )
noexcept

Move assigns a uri.

◆ options()

bsoncxx::v_noabi::document::view mongocxx::v_noabi::uri::options ( ) const

Returns other uri options.

Note, options are returned in the case they were presented. The URI mongodb://localhost/?appName=abc will return { "appName": "abc" } The URI mongodb://localhost/?appname=abc will return { "appname": "abc" }

Returns
A document view containing other options.

◆ password()

std::string mongocxx::v_noabi::uri::password ( ) const

Returns the password from the uri.

Returns
A string containing the supplied password.

◆ read_concern()

mongocxx::v_noabi::read_concern mongocxx::v_noabi::uri::read_concern ( ) const

Returns the read concern from the uri.

Returns
A read_concern that represents what was specified in the uri.

◆ read_preference()

mongocxx::v_noabi::read_preference mongocxx::v_noabi::uri::read_preference ( ) const

Returns the read preference from the uri.

Returns
A read_preference that represents what was specified in the uri.

◆ replica_set()

std::string mongocxx::v_noabi::uri::replica_set ( ) const

Returns the replica set specified in the uri.

Returns
A string representing the supplied replica set name.

◆ retry_reads()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::retry_reads ( ) const

Returns the value of the option "retryReads" if present in the uri.

Returns
An optional bool

◆ retry_writes()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::retry_writes ( ) const

Returns the value of the option "retryWrites" if present in the uri.

Returns
An optional bool

◆ server_selection_timeout_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::server_selection_timeout_ms ( ) const

Returns the value of the option "serverSelectionTimeoutMS" if present in the uri.

Returns
An optional std::int32_t

◆ server_selection_try_once()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::server_selection_try_once ( ) const

Returns the value of the option "serverSelectionTryOnce" if present in the uri.

Returns
An optional bool

◆ socket_timeout_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::socket_timeout_ms ( ) const

Returns the value of the option "socketTimeoutMS" if present in the uri.

Returns
An optional std::int32_t

◆ srv_max_hosts()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::srv_max_hosts ( ) const

Returns the value of the option "srvMaxHosts" if present in the uri.

Returns
An optional std::int32_t

◆ ssl()

MONGOCXX_DEPRECATED bool mongocxx::v_noabi::uri::ssl ( ) const

Returns the ssl parameter from the uri.

Returns
Boolean that is true if ssl is enabled and false if not.
Deprecated:
The tls() method should be used instead of this method.

◆ tls()

bool mongocxx::v_noabi::uri::tls ( ) const

Returns the tls parameter from the uri.

Returns
Boolean that is true if tls is enabled and false if not.

◆ tls_allow_invalid_certificates()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::tls_allow_invalid_certificates ( ) const

Returns the value of the option "tlsAllowInvalidCertificates" if present in the uri.

Returns
An optional bool

◆ tls_allow_invalid_hostnames()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::tls_allow_invalid_hostnames ( ) const

Returns the value of the option "tlsAllowInvalidHostnames" if present in the uri.

Returns
An optional bool

◆ tls_ca_file()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > mongocxx::v_noabi::uri::tls_ca_file ( ) const

Returns the value of the option "tlsCAFile" if present in the uri.

Returns
An optional bsoncxx::v_noabi::stdx::string_view

◆ tls_certificate_key_file()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > mongocxx::v_noabi::uri::tls_certificate_key_file ( ) const

Returns the value of the option "tlsCertificateKeyFile" if present in the uri.

Returns
An optional bsoncxx::v_noabi::stdx::string_view

◆ tls_certificate_key_file_password()

bsoncxx::v_noabi::stdx::optional< bsoncxx::v_noabi::stdx::string_view > mongocxx::v_noabi::uri::tls_certificate_key_file_password ( ) const

Returns the value of the option "tlsCertificateKeyFilePassword" if present in the uri.

Returns
An optional bsoncxx::v_noabi::stdx::string_view

◆ tls_disable_certificate_revocation_check()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::tls_disable_certificate_revocation_check ( ) const

Returns the value of the option "tlsDisableCertificateRevocationCheck" if present in the uri.

Returns
An optional bool

◆ tls_disable_ocsp_endpoint_check()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::tls_disable_ocsp_endpoint_check ( ) const

Returns the value of the option "tlsDisableOCSPEndpointCheck" if present in the uri.

Returns
An optional bool

◆ tls_insecure()

bsoncxx::v_noabi::stdx::optional< bool > mongocxx::v_noabi::uri::tls_insecure ( ) const

Returns the value of the option "tlsInsecure" if present in the uri.

Returns
An optional bool

◆ to_string()

std::string mongocxx::v_noabi::uri::to_string ( ) const

Returns the uri in a string format.

Returns
A string with the uri.

◆ username()

std::string mongocxx::v_noabi::uri::username ( ) const

Returns the supplied username from the uri.

Returns
A string with the username specified in the uri.

◆ wait_queue_timeout_ms()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::wait_queue_timeout_ms ( ) const

Returns the value of the option "waitQueueTimeoutMS" if present in the uri.

Returns
An optional std::int32_t

◆ write_concern()

mongocxx::v_noabi::write_concern mongocxx::v_noabi::uri::write_concern ( ) const

Returns the write concern specified in the uri.

Returns
A write_concern that represents what was specified in the uri.

◆ zlib_compression_level()

bsoncxx::v_noabi::stdx::optional< std::int32_t > mongocxx::v_noabi::uri::zlib_compression_level ( ) const

Returns the value of the option "zlibCompressionLevel" if present in the uri.

Returns
An optional std::int32_t

Member Data Documentation

◆ k_default_uri

MONGOCXX_ABI_EXPORT const std::string mongocxx::v_noabi::uri::k_default_uri
static

The default URI string: "mongodb://localhost:27017".


The documentation for this class was generated from the following file: