123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688 |
- 'use strict';
- const deprecate = require('util').deprecate;
- const Logger = require('mongodb-core').Logger;
- const MongoError = require('mongodb-core').MongoError;
- const Mongos = require('../topologies/mongos');
- const parse = require('mongodb-core').parseConnectionString;
- const ReadPreference = require('mongodb-core').ReadPreference;
- const ReplSet = require('../topologies/replset');
- const Server = require('../topologies/server');
- const ServerSessionPool = require('mongodb-core').Sessions.ServerSessionPool;
- const NativeTopology = require('../topologies/native_topology');
- const MongoCredentials = require('mongodb-core').MongoCredentials;
- let client;
- function loadClient() {
- if (!client) {
- client = require('../mongo_client');
- }
- return client;
- }
- const monitoringEvents = [
- 'timeout',
- 'close',
- 'serverOpening',
- 'serverDescriptionChanged',
- 'serverHeartbeatStarted',
- 'serverHeartbeatSucceeded',
- 'serverHeartbeatFailed',
- 'serverClosed',
- 'topologyOpening',
- 'topologyClosed',
- 'topologyDescriptionChanged',
- 'commandStarted',
- 'commandSucceeded',
- 'commandFailed',
- 'joined',
- 'left',
- 'ping',
- 'ha',
- 'all',
- 'fullsetup',
- 'open'
- ];
- const ignoreOptionNames = ['native_parser'];
- const legacyOptionNames = ['server', 'replset', 'replSet', 'mongos', 'db'];
- const legacyParse = deprecate(
- require('../url_parser'),
- 'current URL string parser is deprecated, and will be removed in a future version. ' +
- 'To use the new parser, pass option { useNewUrlParser: true } to MongoClient.connect.'
- );
- const validOptionNames = [
- 'poolSize',
- 'ssl',
- 'sslValidate',
- 'sslCA',
- 'sslCert',
- 'sslKey',
- 'sslPass',
- 'sslCRL',
- 'autoReconnect',
- 'noDelay',
- 'keepAlive',
- 'keepAliveInitialDelay',
- 'connectTimeoutMS',
- 'family',
- 'socketTimeoutMS',
- 'reconnectTries',
- 'reconnectInterval',
- 'ha',
- 'haInterval',
- 'replicaSet',
- 'secondaryAcceptableLatencyMS',
- 'acceptableLatencyMS',
- 'connectWithNoPrimary',
- 'authSource',
- 'w',
- 'wtimeout',
- 'j',
- 'forceServerObjectId',
- 'serializeFunctions',
- 'ignoreUndefined',
- 'raw',
- 'bufferMaxEntries',
- 'readPreference',
- 'pkFactory',
- 'promiseLibrary',
- 'readConcern',
- 'maxStalenessSeconds',
- 'loggerLevel',
- 'logger',
- 'promoteValues',
- 'promoteBuffers',
- 'promoteLongs',
- 'domainsEnabled',
- 'checkServerIdentity',
- 'validateOptions',
- 'appname',
- 'auth',
- 'user',
- 'password',
- 'authMechanism',
- 'compression',
- 'fsync',
- 'readPreferenceTags',
- 'numberOfRetries',
- 'auto_reconnect',
- 'minSize',
- 'monitorCommands',
- 'retryWrites',
- 'useNewUrlParser',
- 'useUnifiedTopology',
- 'serverSelectionTimeoutMS',
- 'useRecoveryToken'
- ];
- function addListeners(mongoClient, topology) {
- topology.on('authenticated', createListener(mongoClient, 'authenticated'));
- topology.on('error', createListener(mongoClient, 'error'));
- topology.on('timeout', createListener(mongoClient, 'timeout'));
- topology.on('close', createListener(mongoClient, 'close'));
- topology.on('parseError', createListener(mongoClient, 'parseError'));
- topology.once('open', createListener(mongoClient, 'open'));
- topology.once('fullsetup', createListener(mongoClient, 'fullsetup'));
- topology.once('all', createListener(mongoClient, 'all'));
- topology.on('reconnect', createListener(mongoClient, 'reconnect'));
- }
- function assignTopology(client, topology) {
- client.topology = topology;
- topology.s.sessionPool =
- topology instanceof NativeTopology
- ? new ServerSessionPool(topology)
- : new ServerSessionPool(topology.s.coreTopology);
- }
- // Clear out all events
- function clearAllEvents(topology) {
- monitoringEvents.forEach(event => topology.removeAllListeners(event));
- }
- // Collect all events in order from SDAM
- function collectEvents(mongoClient, topology) {
- let MongoClient = loadClient();
- const collectedEvents = [];
- if (mongoClient instanceof MongoClient) {
- monitoringEvents.forEach(event => {
- topology.on(event, (object1, object2) => {
- if (event === 'open') {
- collectedEvents.push({ event: event, object1: mongoClient });
- } else {
- collectedEvents.push({ event: event, object1: object1, object2: object2 });
- }
- });
- });
- }
- return collectedEvents;
- }
- /**
- * Connect to MongoDB using a url as documented at
- *
- * docs.mongodb.org/manual/reference/connection-string/
- *
- * Note that for replicasets the replicaSet query parameter is required in the 2.0 driver
- *
- * @method
- * @param {MongoClient} mongoClient The MongoClient instance with which to connect.
- * @param {string} url The connection URI string
- * @param {object} [options] Optional settings. See MongoClient.prototype.connect for a list of options.
- * @param {MongoClient~connectCallback} [callback] The command result callback
- */
- function connect(mongoClient, url, options, callback) {
- options = Object.assign({}, options);
- // If callback is null throw an exception
- if (callback == null) {
- throw new Error('no callback function provided');
- }
- let didRequestAuthentication = false;
- const logger = Logger('MongoClient', options);
- // Did we pass in a Server/ReplSet/Mongos
- if (url instanceof Server || url instanceof ReplSet || url instanceof Mongos) {
- return connectWithUrl(mongoClient, url, options, connectCallback);
- }
- const parseFn = options.useNewUrlParser ? parse : legacyParse;
- const transform = options.useNewUrlParser ? transformUrlOptions : legacyTransformUrlOptions;
- parseFn(url, options, (err, _object) => {
- // Do not attempt to connect if parsing error
- if (err) return callback(err);
- // Flatten
- const object = transform(_object);
- // Parse the string
- const _finalOptions = createUnifiedOptions(object, options);
- // Check if we have connection and socket timeout set
- if (_finalOptions.socketTimeoutMS == null) _finalOptions.socketTimeoutMS = 360000;
- if (_finalOptions.connectTimeoutMS == null) _finalOptions.connectTimeoutMS = 30000;
- if (_finalOptions.db_options && _finalOptions.db_options.auth) {
- delete _finalOptions.db_options.auth;
- }
- // Store the merged options object
- mongoClient.s.options = _finalOptions;
- // Failure modes
- if (object.servers.length === 0) {
- return callback(new Error('connection string must contain at least one seed host'));
- }
- if (_finalOptions.auth && !_finalOptions.credentials) {
- try {
- didRequestAuthentication = true;
- _finalOptions.credentials = generateCredentials(
- mongoClient,
- _finalOptions.auth.user,
- _finalOptions.auth.password,
- _finalOptions
- );
- } catch (err) {
- return callback(err);
- }
- }
- if (_finalOptions.useUnifiedTopology) {
- return createTopology(mongoClient, 'unified', _finalOptions, connectCallback);
- }
- // Do we have a replicaset then skip discovery and go straight to connectivity
- if (_finalOptions.replicaSet || _finalOptions.rs_name) {
- return createTopology(mongoClient, 'replicaset', _finalOptions, connectCallback);
- } else if (object.servers.length > 1) {
- return createTopology(mongoClient, 'mongos', _finalOptions, connectCallback);
- } else {
- return createServer(mongoClient, _finalOptions, connectCallback);
- }
- });
- function connectCallback(err, topology) {
- const warningMessage = `seed list contains no mongos proxies, replicaset connections requires the parameter replicaSet to be supplied in the URI or options object, mongodb://server:port/db?replicaSet=name`;
- if (err && err.message === 'no mongos proxies found in seed list') {
- if (logger.isWarn()) {
- logger.warn(warningMessage);
- }
- // Return a more specific error message for MongoClient.connect
- return callback(new MongoError(warningMessage));
- }
- if (didRequestAuthentication) {
- mongoClient.emit('authenticated', null, true);
- }
- // Return the error and db instance
- callback(err, topology);
- }
- }
- /**
- * Connect to MongoDB using a url as documented at
- *
- * docs.mongodb.org/manual/reference/connection-string/
- *
- * Note that for replicasets the replicaSet query parameter is required in the 2.0 driver
- *
- * @method
- * @param {MongoClient} mongoClient The MongoClient instance with which to connect.
- * @param {MongoClient~connectCallback} [callback] The command result callback
- */
- function connectOp(mongoClient, err, callback) {
- // Did we have a validation error
- if (err) return callback(err);
- // Fallback to callback based connect
- connect(mongoClient, mongoClient.s.url, mongoClient.s.options, err => {
- if (err) return callback(err);
- callback(null, mongoClient);
- });
- }
- function connectWithUrl(mongoClient, url, options, connectCallback) {
- // Set the topology
- assignTopology(mongoClient, url);
- // Add listeners
- addListeners(mongoClient, url);
- // Propagate the events to the client
- relayEvents(mongoClient, url);
- let finalOptions = Object.assign({}, options);
- // If we have a readPreference passed in by the db options, convert it from a string
- if (typeof options.readPreference === 'string' || typeof options.read_preference === 'string') {
- finalOptions.readPreference = new ReadPreference(
- options.readPreference || options.read_preference
- );
- }
- const isDoingAuth = finalOptions.user || finalOptions.password || finalOptions.authMechanism;
- if (isDoingAuth && !finalOptions.credentials) {
- try {
- finalOptions.credentials = generateCredentials(
- mongoClient,
- finalOptions.user,
- finalOptions.password,
- finalOptions
- );
- } catch (err) {
- return connectCallback(err, url);
- }
- }
- return url.connect(finalOptions, connectCallback);
- }
- function createListener(mongoClient, event) {
- const eventSet = new Set(['all', 'fullsetup', 'open', 'reconnect']);
- return (v1, v2) => {
- if (eventSet.has(event)) {
- return mongoClient.emit(event, mongoClient);
- }
- mongoClient.emit(event, v1, v2);
- };
- }
- function createServer(mongoClient, options, callback) {
- // Pass in the promise library
- options.promiseLibrary = mongoClient.s.promiseLibrary;
- // Set default options
- const servers = translateOptions(options);
- const server = servers[0];
- // Propagate the events to the client
- const collectedEvents = collectEvents(mongoClient, server);
- // Connect to topology
- server.connect(options, (err, topology) => {
- if (err) {
- server.close(true);
- return callback(err);
- }
- // Clear out all the collected event listeners
- clearAllEvents(server);
- // Relay all the events
- relayEvents(mongoClient, server);
- // Add listeners
- addListeners(mongoClient, server);
- // Check if we are really speaking to a mongos
- const ismaster = topology.lastIsMaster();
- // Set the topology
- assignTopology(mongoClient, topology);
- // Do we actually have a mongos
- if (ismaster && ismaster.msg === 'isdbgrid') {
- // Destroy the current connection
- topology.close();
- // Create mongos connection instead
- return createTopology(mongoClient, 'mongos', options, callback);
- }
- // Fire all the events
- replayEvents(mongoClient, collectedEvents);
- // Otherwise callback
- callback(err, topology);
- });
- }
- function createTopology(mongoClient, topologyType, options, callback) {
- // Pass in the promise library
- options.promiseLibrary = mongoClient.s.promiseLibrary;
- const translationOptions = {};
- if (topologyType === 'unified') translationOptions.createServers = false;
- // Set default options
- const servers = translateOptions(options, translationOptions);
- // Create the topology
- let topology;
- if (topologyType === 'mongos') {
- topology = new Mongos(servers, options);
- } else if (topologyType === 'replicaset') {
- topology = new ReplSet(servers, options);
- } else if (topologyType === 'unified') {
- topology = new NativeTopology(options.servers, options);
- }
- // Add listeners
- addListeners(mongoClient, topology);
- // Propagate the events to the client
- relayEvents(mongoClient, topology);
- // Open the connection
- topology.connect(options, (err, newTopology) => {
- if (err) {
- topology.close(true);
- return callback(err);
- }
- assignTopology(mongoClient, newTopology);
- callback(null, newTopology);
- });
- }
- function createUnifiedOptions(finalOptions, options) {
- const childOptions = [
- 'mongos',
- 'server',
- 'db',
- 'replset',
- 'db_options',
- 'server_options',
- 'rs_options',
- 'mongos_options'
- ];
- const noMerge = ['readconcern', 'compression'];
- for (const name in options) {
- if (noMerge.indexOf(name.toLowerCase()) !== -1) {
- finalOptions[name] = options[name];
- } else if (childOptions.indexOf(name.toLowerCase()) !== -1) {
- finalOptions = mergeOptions(finalOptions, options[name], false);
- } else {
- if (
- options[name] &&
- typeof options[name] === 'object' &&
- !Buffer.isBuffer(options[name]) &&
- !Array.isArray(options[name])
- ) {
- finalOptions = mergeOptions(finalOptions, options[name], true);
- } else {
- finalOptions[name] = options[name];
- }
- }
- }
- return finalOptions;
- }
- function legacyTransformUrlOptions(object) {
- return mergeOptions(createUnifiedOptions({}, object), object, false);
- }
- function mergeOptions(target, source, flatten) {
- for (const name in source) {
- if (source[name] && typeof source[name] === 'object' && flatten) {
- target = mergeOptions(target, source[name], flatten);
- } else {
- target[name] = source[name];
- }
- }
- return target;
- }
- function relayEvents(mongoClient, topology) {
- const serverOrCommandEvents = [
- 'serverOpening',
- 'serverDescriptionChanged',
- 'serverHeartbeatStarted',
- 'serverHeartbeatSucceeded',
- 'serverHeartbeatFailed',
- 'serverClosed',
- 'topologyOpening',
- 'topologyClosed',
- 'topologyDescriptionChanged',
- 'commandStarted',
- 'commandSucceeded',
- 'commandFailed',
- 'joined',
- 'left',
- 'ping',
- 'ha'
- ];
- serverOrCommandEvents.forEach(event => {
- topology.on(event, (object1, object2) => {
- mongoClient.emit(event, object1, object2);
- });
- });
- }
- //
- // Replay any events due to single server connection switching to Mongos
- //
- function replayEvents(mongoClient, events) {
- for (let i = 0; i < events.length; i++) {
- mongoClient.emit(events[i].event, events[i].object1, events[i].object2);
- }
- }
- const LEGACY_OPTIONS_MAP = validOptionNames.reduce((obj, name) => {
- obj[name.toLowerCase()] = name;
- return obj;
- }, {});
- function transformUrlOptions(_object) {
- let object = Object.assign({ servers: _object.hosts }, _object.options);
- for (let name in object) {
- const camelCaseName = LEGACY_OPTIONS_MAP[name];
- if (camelCaseName) {
- object[camelCaseName] = object[name];
- }
- }
- const hasUsername = _object.auth && _object.auth.username;
- const hasAuthMechanism = _object.options && _object.options.authMechanism;
- if (hasUsername || hasAuthMechanism) {
- object.auth = Object.assign({}, _object.auth);
- if (object.auth.db) {
- object.authSource = object.authSource || object.auth.db;
- }
- if (object.auth.username) {
- object.auth.user = object.auth.username;
- }
- }
- if (_object.defaultDatabase) {
- object.dbName = _object.defaultDatabase;
- }
- if (object.maxpoolsize) {
- object.poolSize = object.maxpoolsize;
- }
- if (object.readconcernlevel) {
- object.readConcern = { level: object.readconcernlevel };
- }
- if (object.wtimeoutms) {
- object.wtimeout = object.wtimeoutms;
- }
- return object;
- }
- function translateOptions(options, translationOptions) {
- translationOptions = Object.assign({}, { createServers: true }, translationOptions);
- // If we have a readPreference passed in by the db options
- if (typeof options.readPreference === 'string' || typeof options.read_preference === 'string') {
- options.readPreference = new ReadPreference(options.readPreference || options.read_preference);
- }
- // Do we have readPreference tags, add them
- if (options.readPreference && (options.readPreferenceTags || options.read_preference_tags)) {
- options.readPreference.tags = options.readPreferenceTags || options.read_preference_tags;
- }
- // Do we have maxStalenessSeconds
- if (options.maxStalenessSeconds) {
- options.readPreference.maxStalenessSeconds = options.maxStalenessSeconds;
- }
- // Set the socket and connection timeouts
- if (options.socketTimeoutMS == null) options.socketTimeoutMS = 360000;
- if (options.connectTimeoutMS == null) options.connectTimeoutMS = 30000;
- if (!translationOptions.createServers) {
- return;
- }
- // Create server instances
- return options.servers.map(serverObj => {
- return serverObj.domain_socket
- ? new Server(serverObj.domain_socket, 27017, options)
- : new Server(serverObj.host, serverObj.port, options);
- });
- }
- // Validate options object
- function validOptions(options) {
- const _validOptions = validOptionNames.concat(legacyOptionNames);
- for (const name in options) {
- if (ignoreOptionNames.indexOf(name) !== -1) {
- continue;
- }
- if (_validOptions.indexOf(name) === -1) {
- if (options.validateOptions) {
- return new MongoError(`option ${name} is not supported`);
- } else {
- console.warn(`the options [${name}] is not supported`);
- }
- }
- if (legacyOptionNames.indexOf(name) !== -1) {
- console.warn(
- `the server/replset/mongos/db options are deprecated, ` +
- `all their options are supported at the top level of the options object [${validOptionNames}]`
- );
- }
- }
- }
- const VALID_AUTH_MECHANISMS = new Set([
- 'DEFAULT',
- 'MONGODB-CR',
- 'PLAIN',
- 'MONGODB-X509',
- 'SCRAM-SHA-1',
- 'SCRAM-SHA-256',
- 'GSSAPI'
- ]);
- const AUTH_MECHANISM_INTERNAL_MAP = {
- DEFAULT: 'default',
- 'MONGODB-CR': 'mongocr',
- PLAIN: 'plain',
- 'MONGODB-X509': 'x509',
- 'SCRAM-SHA-1': 'scram-sha-1',
- 'SCRAM-SHA-256': 'scram-sha-256'
- };
- function generateCredentials(client, username, password, options) {
- options = Object.assign({}, options);
- // the default db to authenticate against is 'self'
- // if authenticate is called from a retry context, it may be another one, like admin
- const source = options.authSource || options.authdb || options.dbName;
- // authMechanism
- const authMechanismRaw = options.authMechanism || 'DEFAULT';
- const authMechanism = authMechanismRaw.toUpperCase();
- if (!VALID_AUTH_MECHANISMS.has(authMechanism)) {
- throw MongoError.create({
- message: `authentication mechanism ${authMechanismRaw} not supported', options.authMechanism`,
- driver: true
- });
- }
- if (authMechanism === 'GSSAPI') {
- return new MongoCredentials({
- mechanism: process.platform === 'win32' ? 'sspi' : 'gssapi',
- mechanismProperties: options,
- source,
- username,
- password
- });
- }
- return new MongoCredentials({
- mechanism: AUTH_MECHANISM_INTERNAL_MAP[authMechanism],
- source,
- username,
- password
- });
- }
- function closeOperation(client, force, callback) {
- const completeClose = err => {
- client.emit('close', client);
- for (const name in client.s.dbCache) {
- client.s.dbCache[name].emit('close', client);
- }
- client.removeAllListeners('close');
- callback(err, null);
- };
- if (client.topology == null) {
- completeClose();
- return;
- }
- client.topology.close(force, completeClose);
- }
- module.exports = { connectOp, validOptions, closeOperation };
|