mongo-client-connect

    1.0.6 • Public • Published

    Mongo Client Connect

    Reuses the same connection objects (creating only one connection pool per connectionURI) and collection instances, avoiding the creation of many, unnecessary, connections pools to a same connectionURI.

    It also provides an easy way to specify N collections from N connectionURIs to be retrieved at once, in one call (DRY!).

    Mongo DB Native NodeJS Driver is the engine under the hood.

    Installation

    npm install mongo-client-connect
    

    Usage

    OBS: Examples are created for Nodejs v6+ (Destructuring!).

    Connect to a MongoDB

    A simple connection to a MongoDB

    MongoClientConnect('mongodb://localhost/dbName').then(db => {});

    But in case you have more than one call in your project:

    // Somewhere
    MongoClientConnect('mongodb://localhost/dbName').then(db => {});
     
    //[...]
     
    // Somewhere else...
    MongoClientConnect('mongodb://localhost/dbName').then(db => {});

    by mistake, or intentionally because of by some file structure strategy, only one connection pool will be created

    Connect to many MongoDBs

    A simple connection to N MongoDBs

    MongoClientConnect([
        'mongodb://localhost/dbName1',
        'mongodb://anotherHost/dbName2'
    ]).then(([ db1, db2 ]) => {
        console.log(db1.databaseName);
        console.log(db2.databaseName);
    });

    Connect and gets Collections

    It will connect and return the collections that has been asked for.

    MongoClientConnect('mongodb://localhost/dbName', [
        'dbCollectionName1',
        'dbCollectionName2'
    ])
    .then( ([ dbCollectionName1, dbCollectionName2 ]) => {
        // Example of something with one collection
        dbCollectionName1.find({}).toArray().then(docs => console.log(docs.length));
       // Example of something with the other collection
        dbCollectionName2.find({}).toArray().then(docs => console.log(docs.length));
    });

    Connect to many DBs and get Collections

    It connects to N MongoDBs and returns collections for each of them.

    MongoClientConnect({
        'mongodb://localhost/dbName': ['dbCollectionName1'],
        'mongodb://someOtherHost/dbName': ['dbCollectionName2', 'dbCollectionName3']
    })
    .then(([[ dbCollectionName1 ], [ dbCollectionName2, dbCollectionName3 ]]) => {
        console.log(dbCollectionName1.s.dbName, dbCollectionName2.s.dbName, dbCollectionName3.s.dbName);
    })

    Connect and gets Collections (by Object)

    It will connect and return collections, the same as above, but the collections are specified by an Object, in case you prefer the response to be an Object. The collections can also be configured with an alias.

    MongoClientConnect('mongodb://localhost/dbName', { someAlias: 'dbCollectionName' })
        .then(({ someAlias }) => {
         // 'someAlias' will be a reference to collection 'dbCollectionName'
            someAlias.find({}).toArray().then(r => console.log(r.length))
        });

    Connect to many DBs and get Collections (by Object)

    Same as above, it connects to N MongoDBs and returns collections for each of them, but defining collections as an Object in case you prefer the response to be an Object. The collections can also be configured with an alias.

    MongoClientConnect({
        'mongodb://localhost/dbName': {
            alias1: 'dbCollectionName1'
        },
        'mongodb://someOtherHost/dbName': {
            alias2: 'dbCollectionName2',
            alias3: 'dbCollectionName3'
        }
    })
    .then(([{ alias1 }, { alias2, alias3 }]) => {
        console.log(alias1.s.name, alias2.s.name, alias3.s.name);
    });

    Install

    npm i mongo-client-connect

    DownloadsWeekly Downloads

    24

    Version

    1.0.6

    License

    MIT

    Last publish

    Collaborators

    • avatar