Class: Mongo::URI

Inherits:

Object

• Object
• Mongo::URI

Includes:

Loggable

Defined in:

lib/mongo/uri.rb

Overview

The URI class provides a way for users to parse the MongoDB uri as defined in the connection string format spec.

docs.mongodb.org/manual/reference/connection-string/

Examples:

Use the uri string to make a client connection.

uri = URI.new('mongodb://localhost:27017')
client = Client.new(uri.server, uri.options)
client.login(uri.credentials)
client[uri.database]

Since:

• 2.0.0

Constant Summary

UNSAFE =

Unsafe characters that must be urlencoded.

Since:

• 2.1.0

/[\:\/\+\@]/

UNIX_SOCKET =

Unix socket suffix.

Since:

• 2.1.0

/.sock/

SCHEME =

The mongodb connection string scheme.

Since:

• 2.0.0

'mongodb://'.freeze

HOST_DELIM =

The character delimiting hosts.

Since:

• 2.1.0

','.freeze

HOST_PORT_DELIM =

The character separating a host and port.

Since:

• 2.1.0

':'.freeze

DATABASE_DELIM =

The character delimiting a database.

Since:

• 2.1.0

'/'.freeze

URI_OPTS_DELIM =

The character delimiting options.

Since:

• 2.1.0

'?'.freeze

INDIV_URI_OPTS_DELIM =

The character delimiting multiple options.

Since:

• 2.1.0

'&'.freeze

URI_OPTS_VALUE_DELIM =

The character delimiting an option and its value.

Since:

• 2.1.0

'='.freeze

AUTH_USER_PWD_DELIM =

The character separating a username from the password.

Since:

• 2.1.0

':'.freeze

AUTH_DELIM =

The character delimiting auth credentials.

Since:

• 2.1.0

'@'.freeze

INVALID_SCHEME =

Error details for an invalid scheme.

Since:

• 2.1.0

"Invalid scheme. Scheme must be '#{SCHEME}'".freeze

INVALID_OPTS_VALUE_DELIM =

Error details for an invalid options format.

Since:

• 2.1.0

"Options and their values must be delimited" +
" by '#{URI_OPTS_VALUE_DELIM}'".freeze

UNESCAPED_USER_PWD =

Error details for an non-urlencoded user name or password.

Since:

• 2.1.0

"User name and password must be urlencoded.".freeze

UNESCAPED_UNIX_SOCKET =

Error details for a non-urlencoded unix socket path.

Since:

• 2.1.0

"UNIX domain sockets must be urlencoded.".freeze

UNESCAPED_DATABASE =

Error details for a non-urlencoded auth databsae name.

Since:

• 2.1.0

"Auth database must be urlencoded.".freeze

INVALID_OPTS_DELIM =

Error details for providing options without a database delimiter.

Since:

• 2.1.0

"Database delimiter '#{DATABASE_DELIM}' must be present if options are specified.".freeze

INVALID_HOST =

Error details for a missing host.

Since:

• 2.1.0

"Missing host; at least one must be provided.".freeze

INVALID_PORT =

Error details for an invalid port.

Since:

• 2.1.0

"Invalid port. Port must be an integer greater than 0 and less than 65536".freeze

FORMAT =

MongoDB URI format specification.

Since:

• 2.0.0

'mongodb://[username:password@]host1[:port1][,host2[:port2]' +
',...[,hostN[:portN]]][/[database][?options]]'.freeze

HELP =

MongoDB URI (connection string) documentation url

Since:

• 2.0.0

'http://docs.mongodb.org/manual/reference/connection-string/'.freeze

READ_MODE_MAP =

Map of URI read preference modes to ruby driver read preference modes

Since:

• 2.0.0

{
  'primary'            => :primary,
  'primaryPreferred'   => :primary_preferred,
  'secondary'          => :secondary,
  'secondaryPreferred' => :secondary_preferred,
  'nearest'            => :nearest
}.freeze

AUTH_MECH_MAP =

Map of URI authentication mechanisms to ruby driver mechanisms

Since:

• 2.0.0

{
  'PLAIN'      => :plain,
  'MONGODB-CR' => :mongodb_cr,
  'GSSAPI'     => :gssapi
}.freeze

REPEATABLE_OPTIONS =

Options that are allowed to appear more than once in the uri.

Since:

• 2.1.0

[ :tag_sets ]

Constants included from Loggable

Loggable::PREFIX

Instance Attribute Summary

• #options ⇒ Object readonly

  The uri parser object options.

• #servers ⇒ Object readonly

  The servers specified in the uri.

• #uri_options ⇒ Object readonly

  The options specified in the uri.

Instance Method Summary

• #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 credentials and database in at that point - we only have a single point here.

• #credentials ⇒ Hash

  Get the credentials provided in the URI.

• #database ⇒ String

  Get the database provided in the URI.

• #initialize(string, options = {}) ⇒ URI constructor

  Create the new uri from the provided string.

Methods included from Loggable

#log_debug, #log_error, #log_fatal, #log_info, #log_warn, #logger

Constructor Details

#initialize(string, options = {}) ⇒ URI

Create the new uri from the provided string.

Examples:

Create the new URI.

URI.new('mongodb://localhost:27017')

Parameters:

• string (String) —

  The uri string.

• options (Hash) (defaults to: {}) —

  The options.

Raises:

• (Error::InvalidURI) —

  If the uri does not match the spec.

Since:

• 2.0.0

# File 'lib/mongo/uri.rb', line 192

def initialize(string, options = {})
  @string = string
  @options = options
  empty, scheme, remaining = @string.partition(SCHEME)
  raise_invalid_error!(INVALID_SCHEME) unless scheme == SCHEME
  setup!(remaining)
end

Instance Attribute Details

#options ⇒ Object (readonly)

The uri parser object options.

Since:

• 2.0.0

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

def options
  @options
end

#servers ⇒ Object (readonly)

The servers specified in the uri.

Since:

• 2.0.0

# File 'lib/mongo/uri.rb', line 47

def servers
  @servers
end

#uri_options ⇒ Object (readonly)

The options specified in the uri.

Since:

• 2.1.0

# File 'lib/mongo/uri.rb', line 42

def uri_options
  @uri_options
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 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.0.0

# File 'lib/mongo/uri.rb', line 210

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

#credentials ⇒ Hash

Get the credentials provided in the URI.

Examples:

Get the credentials.

uri.credentials

Returns:

• (Hash) —

  The credentials.

  • :user [ String ] The user.

  • :password [ String ] The provided password.

Since:

• 2.0.0

# File 'lib/mongo/uri.rb', line 225

def credentials
  { :user => @user, :password => @password }
end

#database ⇒ String

Get the database provided in the URI.

Examples:

Get the database.

uri.database

Returns:

• (String) —

  The database.

Since:

• 2.0.0

# File 'lib/mongo/uri.rb', line 237

def database
  @database ? @database : Database::ADMIN
end