chpr-mongodb
MongoDB connector
- Requirements
- Configuration
- Instanciation
- Migrate to version chpr-mongodb 2
- Installation
- Tests
- /!\ Deprecation warnings
This library is a wrapper on node-mongodb-native
.
The original documentation is available here. The purpose is to help
having robust connection on MongoDb databases potentially on multiple
databases, with models definitions and migration patterns.
Requirements
async
/await
is required (Node.js 7+)MongoDB 3.2+
is required to use thedocument validation
feature
Configuration
Overall configuration
The connector configuration object must look like this:
databases: // Database configuration
By default, all indexes are created in background. You can change this
behavior by setting the property ensureIndexInBackground
to false
.
Database connection configuration
If you want to connect a specific database, please use the following object format:
name: 'riders' // Database name url: 'mongodb://localhost:27017/riders' // Database connection string options: // MongoDb connection options
The options
properties are documented in the official documentation.
Instanciation
Simple connection
const MongoDbConnector = ; { const client = databases: name: 'test' url: 'mongodb://localhost:27017/test' ; await client;} { await client;}
Models definitions
Please have a look to the example.
const MongoDbConnector = ; { const client = databases: name: 'test' url: 'mongodb://localhost:27017/test' users: DATABASE: 'test' COLLECTION: 'users' ; await client; // Example of models initialization (tests only): await client;} { await client;}
Migrations definitions
Please have a look to the migrations documentation.
// migrations/index.jsconst addUniqueIndexExample20171129 = ; moduleexports = '1' addUniqueIndexExample20171129;
// migrate.jsconst MongoDbConnector = ; const migrations = ; { const client = databases: name: 'test' url: 'mongodb://localhost:27017/test' users: DATABASE: 'test' COLLECTION: 'users' migrations; await client; // Example of unique migration call (tests only): await client;} { await client;}
Installation
nvm i npm install
Tests
# Run the mocha tests only npm run mocha # Run the eslint only npm run eslint # Run the coverage withuut eslint npm run mocha # Run all the tests npm test
/!\ Deprecation warnings
migrate('update', 'init')
After 2018-03-01, no guarantee about its support is given
The keyword init
has been deprecated in favor of from-models
. It was
unclear that this migration was special and was applying for a test purpose
only migration of models from the models definitions themselves. The
replacement will be:
migrate('update', 'from-models')
Or even more explicit:
applyModels('update')
migrate('update')
with no second parameter
After 2018-03-01, no guarantee about its support is given
The absence of second parameter to the migrate
method was unclear that
it will apply all migrations from the very first one to the last one. The
keyword all
is prefered until now. The following syntax will apply the
same result:
migrate('update', 'all')
Or even more explicit:
applyAllMigrations('update')