Class: Mongo::URI::SRVProtocol

Inherits:
URI
  • Object
show all
Defined in:
lib/mongo/uri/srv_protocol.rb

Overview

Parser for a URI using the mongodb+srv protocol, which specifies a DNS to query for SRV records. The driver will query the DNS server for SRV records on ., prefixed with _mongodb._tcp The SRV records can then be used as the seedlist for a Mongo::Client. The driver also queries for a TXT record providing default connection string options. Only one TXT record is allowed, and only a subset of Mongo::Client options is allowed.

Please refer to the Initial DNS Seedlist Discovery spec for details.

https://github.com/mongodb/specifications/blob/master/source/initial-dns-seedlist-discovery/initial-dns-seedlist-discovery.md

Examples:

Use the uri string to make a client connection.

client = Mongo::Client.new('mongodb+srv://test6.test.build.10gen.cc/')

Since:

  • 2.5.0

Instance Attribute Summary collapse

Instance Method Summary collapse

Instance Attribute Details

#query_hostname ⇒ String (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

The hostname that is specified in the URI and used to look up SRV records.

This attribute needs to be defined because SRVProtocol changes #servers to be the result of the lookup rather than the hostname specified in the URI.

Returns:

  • (String) —

    The hostname used in SRV lookup.

Since:

  • 2.5.0



68
69
70
 
# File 'lib/mongo/uri/srv_protocol.rb', line 68

def query_hostname
  @query_hostname
end

#srv_records ⇒ Object (readonly)

Since:

  • 2.5.0



35
36
37
 
# File 'lib/mongo/uri/srv_protocol.rb', line 35

def srv_records
  @srv_records
end

#srv_result ⇒ Srv::Result (readonly)

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns SRV lookup result.

Returns:

Since:

  • 2.5.0



56
57
58
 
# File 'lib/mongo/uri/srv_protocol.rb', line 56

def srv_result
  @srv_result
end

Instance Method Details

#client_options ⇒ Hash

Gets the options hash that needs to be passed to a Mongo::Client on instantiation, so we don't have to merge the txt record options, credentials, and database in at that point - we only have a single point here.

Examples:

Get the client options.

uri.client_options

Returns:

  • (Hash) —

    The options passed to the Mongo::Client

Since:

  • 2.5.0



47
48
49
50
51
 
# File 'lib/mongo/uri/srv_protocol.rb', line 47

def client_options
  opts = @txt_options.merge(ssl: true)
  opts = opts.merge(uri_options).merge(database: database)
  @user ? opts.merge(credentials) : opts
end