npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@mongodb-model/model

v0.0.1

Published

Mongodb Model

Downloads

5

Readme

Mongodb Model

Model is an exceptional and dynamic tool that excels in facilitating seamless interaction with MongoDB databases, constructing robust internal or external APIs, establishing efficient TCP connections, and enabling real-time communication. Developed as a comprehensive wrapper around the Native Node.js MongoDB driver, it effectively streamlines the intricacies typically associated with this technology, as well as with Mongoose.js. Acting as a duplex stream, particularly a Transform stream, Model maximizes the potential of both the MongoDB driver and the Node.js Transform Stream API. Essentially, any task achievable with these cutting-edge technologies can be effortlessly accomplished using Model. Furthermore, Model operates with a strong emphasis on event-driven architecture and maintains impeccable compatibility with Mongoose.js, enhancing its overall versatility and usability.

Installation

$ yarn add @mongodb-model/model

or


$ npm i @mongodb-model/model

That's it: start using it!

Instantiate the Model class by providing an object with your database URL and collection name as keys. This will give you the corresponding collection model!

 const Model = require('@mongodb-model/model');
 const User = new Model({url: 'mongodb://localhost:27017/model', collection: 'users'});

By initializing the Model class, the database connection process is automated, eliminating the need for manual handling. The instantiation of the Model class seamlessly takes care of the database connection. Additionally, using a schema is entirely optional!

  • CREATE
    • Use Promise

        User.insertOne({firstname: 'John', lastname: 'Doe', email: '[email protected]', username: 'johndoe'});
            .then(result => console.log('user inserted', result))
            .catch(error => console.log('error inserting user', error));
    • Or Use Event

      User.insertOne({firstname: 'John', lastname: 'Doe', email: '[email protected]', username: 'johndoe'});
      User.on('insertOne', result => console.log('user inserted', result));
      User.on('insertOne-error', error => console.log('error inserting user', error));
    • Or Use Callback

        User.insertOne({firstname: 'John', lastname: 'Doe', email: '[email protected]', username: 'johndoe'},{},(error, users) => {
            if(error) return console.log('error inserting user', error);
            console.log('user inserted', result);
        });
  • READ
    • Use Promise

        User.find()
            .then(users => console.log('users found', users))
            .catch(error => console.log('error finding users', error));
    • Or Use Event

      User.find();
      User.on('find', users => console.log('users found', users));
      User.on('find-error', users => console.log('error finding users', users));
    • Or Use Callback

        User.find({},{},(error, users) => {
            if(error) return console.log('error finding users', error);
            console.log('users found', users);
        });
  • UPDATE
    • Use Promise

        User.updateOne({username: 'johndoe'},{email: '[email protected]'})
            .then(result => console.log('user updated', result))
            .catch(error => console.log('error updating', error));
    • Or Use Event

      User.updateOne({username: 'johndoe'},{email: '[email protected]'});
      User.on('updateOne', result => console.log('user updated', result));
      User.on('updateOne-error', error => console.log('error updating', error));
    • Or Use Callback

        User.updateOne({username: 'johndoe'},{email: '[email protected]'},{},(error, result) => {
            if(error) return console.log('error updating', error);
            console.log('user updated', result);
        });
  • DELETE
    • Use Promise

        User.deleteOne({username: 'johndoe'})
            .then(result => console.log('user deleted', result))
            .catch(error => console.log('error deleting user', error));
    • Or Use Event

      User.deleteOne({username: 'johndoe'});
      User.on('deleteOne', result => console.log('user deleted', result));
      User.on('deleteOne-error', error => console.log('error deleting user', error));
    • Or Use Callback

        User.deleteOne({username: 'johndoe'},{},(error, result) => {
            if(error) return console.log('error deleting user', error);
            console.log('user deleted', result);
        });
    That's it! It's that simple!

A MORE DETAILED EXPLANATION

1. add .env file in your project root directory with these environment variables (at least the first two: DATABASE_NAME and DATABASE_URL, DATABASE_)

*** No need for installing dotenv npm package ***

DATABASE_NAME='Your Mongodb Database Name'
DATABASE_URL='Your Mongodb Database URL'
JSON_FAKER_URL='Your json faker url'
BUCKET_NAME='Your GridFS bucket name'

Here is an example:

DATABASE_NAME='my_app'
DATABASE_URL='mongodb://localhost:27017'
JSON_FAKER_URL='https://jsonplaceholder.typicode.com/'
BUCKET_NAME='myGridFSBucket'

2. Make sure you have mongodb server running if you are using mongodb server locally.

NOTE: The .env file is not required. It is completely optional. It only helps instantiate the MongoDB Model by passing the object with only one key: the collection name as shown in the rest of this documentation.

Start using it

Mongodb-model leverages the power of the MongoDB Native Node.js Driver, simplifying its complexities. It utilizes the same set of methods with identical parameters, seamlessly integrating with the Mongodb Native Node.js Driver. When employing the callback style, an additional callback function is included for flexibility.

Usage

Simply initialize the Model class. This automates the database connection process. There's no need for manual database connection handling, as it is seamlessly taken care of during the instantiation of the Model class.

const Model = require('@mongodb-model/model');
const ModelName = new Model({collection: 'collectionName'});

Depending on your requirements, you have the flexibility to opt for one or a combination of three approaches: the promise approach, the event approach, and the callback approach. By leveraging these approaches, you can effectively address various scenarios and accomplish your goals. The versatility provided by these options empowers you to tailor your solution to meet your specific needs. Embracing the simplicity and power of these approaches, you can confidently navigate your development journey.

  • Using Promise

    ModelName.methodName(parameter1, parameter2, ...)
             .then(result => /** Your success codes here**/)
             .catch(error => /** Your error codes here**/);
  • Using Event

    ModelName.methodName(parameter1, parameter2, ...);
    ModelName.on('methodName', result => /** Your success codes here**/);
    ModelName.on('methodName-error', error => /** Your error codes here**/);
  • Using Callback: all parameters are required (not optional) when using the callback approach.

    ModelName.methodName(parameter1, parameter2, ...,(error, result) => {
      /** Your successs and error codes here**/
    });

    That's all there is! It's that simple!

Examples

The following examples showcase mongodb-model capabilities.

const Model = require('@mongodb-model/model');
const User = new Model({collection: 'users'});

Find all users

  • Using Promise

      User.find()
          .then(users => console.log('all users found', users))
          .catch(error => console.log('error finding all users', error));
  • Using Event

    User.find();
    User.on('find', users => console.log('all users found', users));
    User.on('find-error', users => console.log('error finding all users', users));
  • Using Callback

      User.find({},{},(error, users) => {
          if(error) return console.log('error finding all users', error);
          console.log('all users found', users);
      });

Find or retrieve all users based on their last name while excluding their _ids and usernames

  • Using Promise

      User.find({lastname: 'Doe'}, {projection: {_id: 0, username: 0}})
          .then(users => console.log('all users found', users))
          .catch(error => console.log('error finding all users', error));
  • Using Event

      User.find({lastname: 'Doe'}, {projection: {_id: 0, username: 0}});
      User.on('find', users => console.log('all users found', users));
      User.on('find-error', users => console.log('error finding all users', users));
  • Using Callback

      User.find({lastname: 'Doe'}, {projection: {_id: 0, username: 0}},(error, users) => {
          if(error) return console.log('error finding all users', error);
          console.log('all users found', users);
      });

Find or retrieve all users based on their last name while excluding all other fields except their _id, first names, last names, emails, and phones

  • Using Promise

      const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1}};
    
      User.find({lastname: 'Doe'}, options)
          .then(users => console.log('all users found', users))
          .catch(error => console.log('error finding all users', error));
  • Using Event

        const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1}};
    
        User.find({lastname: 'Doe'}, options);
        User.on('find', users => console.log('all users found', users));
        User.on('find-error', users => console.log('error finding all users', users));
  • Using Callback

      const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1}};
    
      User.find({lastname: 'Doe'}, options,(error, users) => {
          if(error) return console.log('error finding all users', error);
          console.log('all users found', users);
      });

Find or retrieve all users based on their last name, excluding all other fields except _id, first names, last names, emails, and phones. Additionally, sort the results by _id in descending order to obtain a desired sorting arrangement

  • Using Promise

        const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1, sort: {_id: -1}}};
    
        User.find({lastname: 'Doe'}, options)
            .then(users => console.log('all users found', users))
            .catch(error => console.log('error finding all users', error));
  • Using Event

          const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1, sort: {_id: -1}}};
    
          User.find({lastname: 'Doe'}, options);
          User.on('find', users => console.log('all users found', users));
          User.on('find-error', users => console.log('error finding all users', users));
  • Using Callback

        const options = {projection: {firstname: 1, lastname: 1, email: 1, phone: 1, sort: {_id: -1}}};
    
        User.find({lastname: 'Doe'}, options,(error, users) => {
            if(error) return console.log('error finding all users', error);
            console.log('all users found', users);
        });

Basic CRUD (Create, Read, Update, Delete)

Mongodb-model is designed to harness the full potential of the MongoDB Native Node.js Driver while offering a simplified experience. It seamlessly incorporates the underlying Mongodb Native Node.js Driver, offering an identical set of methods with consistent parameters. Moreover, when employing the callback style, Mongodb-model conveniently includes an extra callback function to facilitate seamless integration. With Mongodb-model, you can leverage the power of the MongoDB Native Node.js Driver without compromising on ease of use or functionality.

CREATE

  1. Using Promise
    • Using the create method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
      
        User.create(userData)
            .then(result => console.log('user created successfully:' + result));
            .catch(err => console.log('error creating user: ' + err));
    • Using the insertOne Method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
      
        User.insertOne(userData).
            .then(result => console.log('user created successfully'));
            .catch(err => console.log('error creating user: ' + err));
  2. Using Callback
    • Using the create method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
      
        User.create(userData,{},(error, result) => {
            if(error) return console.log('error creating user', result);
            console.log('created user', result);
        })
    • Using the insertOne Method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
      
        User.insertOne(userData,{},(error, result) => {
            if(error) return console.log('error creating user', result);
            console.log('created user', result);
        })
  3. Using Event
    • Using the create method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
      
        User.create(userData);
      
        User.on('create', user => console.log('user created', user));
        User.on('create-error', error => console.log('error creating user', error));
    • Using the insertOne Method

        const userData = {firstname: 'John', lastname: 'Doe'}; 
             
        User.insertOne(userData);
      
        User.on('insertOne', user => console.log('user inserted', user));
        User.on('insertOne-error', error => console.log('error inserting user', error));

READ

  1. Using Promise
    • Using the all method

        User.all()
            .then(users => console.log('users found', users))
            .catch(error => console.log('error finding users', error));
    • Using the find Method

       User.find()
            .then(users => console.log('users found', users))
            .catch(error => console.log('error finding users', error));
    • Using the findById Method

       User.findById('645e4d81c050a750429b4421')
            .then(user => console.log('user by id', user))
            .catch(error => console.log('error finding user by id', error));
    • Using the lastByEmail Method

      User.lastByEmail('[email protected]')
          .then(user => console.log('last user by email found', user))
          .catch(error => console.log('error finding last user by email', error));
  2. Using Callback
    • Using the all method

        User.all({},{},(error, users) => {
            if(error) return console.log('error getting users', error);
            console.log('all users', users);
        })
    • Using the find Method

        User.find({},{},(error, users) => {
          if(error) return console.log('error finding users', error);
          console.log('all users', users);
        })
    • Using the findById method

       User.findById('645e4d81c050a750429b4421',{},(error, user) => {
          if(error) return console.log('error finding user by id', error);
          console.log('found user by id', user);
      })
    • Using the lastByEmail Method

        User.lastByEmail('[email protected]',{},(error, user) => {
            if(error) return console.log('error finding last user by email', error);
            console.log('last user by email found', user);
        });
  3. Using Event
    • Using the all method

        User.all();
        User.on('all', users => console.log('all users', users));
        User.on('all-error', error => console.log('error getting all users', error));
    • Using the find Method

        User.find();
        User.on('find', users => console.log('all found users', users));
        User.on('find-error', error => console.log('error finding users', error));
    • Using the findById method

        User.findById('645e4d81c050a750429b4421');
        User.on('findById', user => console.log(user));
        User.on('findById-error', error => console.log(error));
    • Using the lastByEmail Method

        User.lastByEmail('[email protected]');
        User.on('lastByEmail', user => console.log(user));
        User.on('lastByEmail-error', error => console.log(error));

UPDATE

  1. Using Promise
    • Using the update method

        const filter = {_id: '645e4d81c050a750429b4421'};
        const update = {firstname: 'John', lastname: 'Doe'};
      
        User.update(filter, update)
            .then(result => console.log('updated user', result))
            .catch(error => console.log('error updating user', error));
    • Using the updateOne Method

        const filter = {_id: '645e4d81c050a750429b4421'};
        const update = {firstname: 'John', lastname: 'Doe'};
             
        User.updateOne(filter, update)
            .then(result => console.log('updated user', result))
            .catch(error => console.log('error updated user', error));
    • Using the updateMany Method

        const filterForMany = {lastname: 'DeMaison'};
        const updateForMany = {firstname: 'André De', lastname: 'Maison'};
             
        User.updateMany(filterForMany, updateForMany)
            .then(result => console.log('updated users', result))
            .catch(error => console.log('error updated users', error));
    • Using the updateById Method

          const update = {firstname: 'John', lastname: 'Doe'};
              
          User.updateById('645e4d81c050a750429b4421', update)
              .then(result => console.log('updated user', result))
              .catch(error => console.log('error updated user', error));
  2. Using Callback
    • Using the update method

        const filter = {_id: '645e4d81c050a750429b4421'};
        const update = {firstname: 'John', lastname: 'Doe'};
      
        User.update(filter, update, {}, (error, result) => {
            if(error) return console.log('error updating user', result);
            console.log('updated user', result);
        });
    • Using the updateOne Method

          const filter = {_id: '645e4d81c050a750429b4421'};
          const update = {firstname: 'John', lastname: 'Doe'};
             
          User.updateOne(filter, update, {}, (error, result) => {
              if(error) return console.log('error updating user', result);
              console.log('updated user', result);
          });
    • Using the updateMany method

        const filterForMany = {lastname: 'DeMaison'};
        const updateForMany = {firstname: 'André De', lastname: 'Maison'};
             
        User.updateMany(filterForMany, updateForMany, {},(error, result) => {
            if(error) return console.log('error updating users', result);
            console.log('updated users', result);
        });
    • Using the updateById Method

        const update = {firstname: 'John', lastname: 'Doe'};
        User.updateById('645e4d81c050a750429b4421',{},(error, result) => {
            if(error) return console.log('error updating last user by id', error);
            console.log('user updated by id', result);
        });
  3. Using Event
    • Using the update method

        const filter = {_id: '645e4d81c050a750429b4421'};
        const update = {firstname: 'John', lastname: 'Doe'};
      
        User.update(filter, update);
        User.on('update', user => console.log('updated user', user));
        User.on('update-error', error => console.log('error updating user', error));
    • Using the updateOne Method

        const filter = {_id: '645e4d81c050a750429b4421'};
        const update = {firstname: 'John', lastname: 'Doe'};
             
        User.updateOne(filter, update);
        User.on('updateOne', user => console.log('updated user', user));
        User.on('updateOne-error', error => console.log('error updating user', error));
    • Using the updateMany method

        const filterForMany = {lastname: 'DeMaison'}
        const updateForMany = {firstname: 'André De', lastname: 'Maison'};
             
        User.updateMany(filterForMany, updateForMany);
        User.on('updateMany', result => console.log('updated users', result));
        User.on('updateMany-error', error => console.log('error updating users', error));
    • Using the updateById Method

        const update = {firstname: 'John', lastname: 'Doe'};
        User.updateById('645b9cf776b7fb46975316d9', update)
      
        User.on('updateById', result => console.log('updated user by id', result));
        User.on('updateById-error', error => console.log('error updating user by id', error));

DELETE

  1. Using Promise

    • Using the destroy method

        User.destroy({username: 'johndoe'})
            .then(result => console.log('user destroyed', result))
            .catch(error => console.log('error destroying user', error));
    • Using the remove method

        User.remove({username: 'johndoe'})
            .then(result => console.log('user removed', result))
            .catch(error => console.log('error removining user', error));
    • Using the deleteOne Method

        User.deleteOne({username: 'johndoe'})
            .then(result => console.log('user deleted', result))
            .catch(error => console.log('error deleting user', error));
    • Using the updateMany Method

        User.deleteMany({username: 'johndoe'})
            .then(result => console.log('users deleted', result))
            .catch(error => console.log('error deleting users', error));
    • Using the deleteById Method

          User.deleteById('645b9cf776b7fb46975316d9')
              .then(user => console.log('user deleted by id', user))
              .catch(error => console.log('error deleting user by id', error));
    • Using the removeById Method

          User.removeById('645b9cf776b7fb46975316d9')
              .then(user => console.log('user removed by id', user))
              .catch(error => console.log('error removing user by id', error));
    • Using the deleteByEmail Method

          User.deleteByEmail('[email protected]')
              .then(user => console.log('user deleted by email', user))
              .catch(error => console.log('error deleting user by email', error));
    • Using the deleteByUsername Method

          User.deleteByUsername('johndoe')
              .then(user => console.log('user deleted by username', user))
              .catch(error => console.log('error deleting user by username', error));
  2. Using Callback

    • Using the destroy method

        User.destroy({username: 'johndoe'},{}, (error,result) => {
            if(error) console.log('error destroying user', error);
            console.log('user deleted', result);
        })
    • Using the remove method

         User.remove({username: 'johndoe'},{}, (error,result) => {
            if(error) console.log('error removing user', error);
            console.log('user removed', result);
        })
    • Using the deleteOne Method

        User.deleteOne({username: 'johndoe'},{},(error, result) => {
            if(error) console.log('error deleting user', error);
            console.log('user deleted', result);
        })
    • Using the deleteMany Method

        User.deleteMany({username: 'johndoe'},{}, (error, result) =>{
            if(error) console.log('error deleting users', error);
            console.log('users deleted', result);
        })
    • Using the deleteById Method

          User.deleteById('645b9cf776b7fb46975316d9', {}, (error, result) =>{
              if(error) console.log('error deleting user by id', error);
              console.log('user deleted by id', result);
        })
    • Using the removeById Method

          User.removeById('645b9cf776b7fb46975316d9', {}, (error, result) =>{
              if(error) console.log('error removing user by id', error);
              console.log('user removed by id', result);
          })
    • Using the deleteByEmail Method

          User.deleteByEmail('[email protected]', {}, (error, result) =>{
              if(error) console.log('error deleting user by email', error);
              console.log('user deleted by email', result);
          })
    • Using the deleteByUsername Method

          User.deleteByUsername('johndoe', {}, (error, result) =>{
              if(error) console.log('error deleting user by username', error);
              console.log('user deleted by username', result);
          })
  3. Using Event

    • Using the destroy method

        User.destroy({username: 'johndoe'});
        User.on('delete', result => console.log('user destroyed', result));
        User.on('delete-error', error => console.log('error destroying user', error));
    • Using the remove method

        User.remove({username: 'johndoe'});
        User.on('delete', result => console.log('user removed', result));
        User.on('delete-error', error => console.log('error removing user', error));
    • Using the deleteOne Method

        User.deleteOne({username: 'johndoe'});
        User.on('deleteOne',result => console.log('user deleted', result));
        User.on('deleteOne-error',error => console.log('error deleting user', error));
    • Using the deleteMany Method

          User.deleteMany({username: 'johndoe'});
          User.on('deleteMany', result => console.log('user deleted', result));
          User.on('deleteMany-error', error => console.log('error deleting user', error));
    • Using the deleteById Method

        User.deleteById('645b9cf776b7fb46975316d9');
        User.on('deleteById',result => console.log('user deleted', result));
        User.on('deleteById-error',error => console.log('error deleting user', error));
    • Using the removeById Method

        User.removeById('645b9cf776b7fb46975316d9');
        User.on('removeById',result => console.log('user removed by id', result));
        User.on('removeById-error',error => console.log('error removing user by id', error));
    • Using the deleteByEmail Method

        User.deleteByEmail('[email protected]');
        User.on('deleteByEmail',result => console.log('user deleted by email', result));
        User.on('deleteByEmail-error',error => console.log('error deleting user by email', error));
    • Using the deleteByUsername Method

        User.deleteByUsername('johndoe');
        User.on('deleteByUsername', result => console.log('user deleted by username', result));
        User.on('deleteByUsername-error', error => console.log('error deleting user by username', error));

Using it in a framework

Integrating the Mongodb Model into your application framework brings numerous benefits. It allows you to leverage the flexibility and scalability of MongoDB while seamlessly integrating with your existing application infrastructure.

By incorporating the Mongodb Model, you can take advantage of its intuitive methods and functions for data management. It provides an organized approach to defining models, handling data validations, and performing CRUD operations, making it easier to work with MongoDB within the context of your application framework.

Using it in Express

Setting up a simple express server
  const express = require('express');
  const Model = require('@mongodb-model/model');
                              
  const app = express();
  app.use(express.json()); 

  const User = new Model({collection: 'users'});
                              
  /**
    Each of the example codes for the remaining of this section will go right here.
  **/      
                              
  app.listen(3000, () => console.log('listening on port 3000'));
CREATE
  1. Using Promise

    • Using the create method

      app.post('/users', async (req, res, next) => {
        try{
          const result = await User.create(req.body);
          res.status(200).send({result});
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the insertOne method

      app.post('/users', async (req, res, next) => {
         try{
          const result = await User.insertOne(req.body);
          res.status(200).send({result});
        }catch(error){
          res.status(500).send({error});
        }
      });
  2. Using Callback

    • Using the create method

      app.post('/users', (req, res, next) => {
          User.create(req.body,{},(error, result) => {
              if(error) return res.status(500).send({error});
              res.status(200).send({result});
          });
      });
    • Using the insertOne method

      app.post('/users', (req, res, next) => {
         User.insertOne(req.body,{},(error, result) => {
            if(error) return res.status(500).send({error});
            res.status(200).send({result});
        });
      });
  3. Using Event

    • Using the create method

      app.post('/users', (req, res, next) => {
                 
          User.create(req.body);
      
          User.on('create', result => res.status(200).send({result}));
          User.on('create-error', error => res.status(500).send({error}));
      });
    • Using the insertOne method

      app.post('/users', (req, res, next) => {
      
          User.insertOne(req.body);
      
          User.on('insertOne', result => res.status(200).send({result}));
          User.on('insertOne-error', error => res.status(500).send({error}));
      });
READ
  1. Using Promise

    • Using the all method

      app.get('/users', async (req, res, next) => {
        try{
          const users = await User.all();
          res.status(200).send(users);
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the find method

      app.get('/users', async (req, res, next) => {
         try{
          const users = await User.find();
          res.status(200).send(users);
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the findById method

      app.get('/users/:id', async (req, res, next) => {
         try{
          const user = await User.findById(req.params.id);
          res.status(200).send(user);
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the findByEmail method

      app.get('/user-email', async (req, res, next) => {
         try{
          const user = await User.findByEmail(req.body.email);
          res.status(200).send(user);
        }catch(error){
          res.status(500).send({error});
        }
      });
  2. Using Callback

    • Using the all method

      app.get('/users', (req, res, next) => {
          User.all({},{},(error, users) => {
              if(error) return res.status(500).send({error});
              res.status(200).send(users);
          });
      });
    • Using the find method

      app.get('/users', (req, res, next) => {
         User.find({},{},(error, users) => {
            if(error) return res.status(500).send({error});
            res.status(200).send(users);
        });
      });
    • Using the findById method

      app.get('/users/:id', (req, res, next) => {
         User.findById(req.params.id,{},(error, user) => {
            if(error) return res.status(500).send({error});
            res.status(200).send(user);
        });
      });
    • Using the findByEmail method

      app.get('/user-email', (req, res, next) => {
         User.findByEmail(req.body.email,{},(error, user) => {
            if(error) return res.status(500).send({error});
            res.status(200).send(user);
        });
      });
  3. Using Event

    • Using the all method

      app.get('/users', (req, res, next) => {
                 
          User.all();
      
          User.on('all', result => res.status(200).send(users));
          User.on('all-error', error => res.status(500).send({error}));
      });
    • Using the find method

      app.get('/users', (req, res, next) => {
      
          User.find();
      
          User.on('find', users => res.status(200).send(users));
          User.on('find-error', error => res.status(500).send({error}));
      });
    • Using the findById method

      app.get('/users/:id', (req, res, next) => {
      
          User.findById(req.params.id);
      
          User.on('findById', user => res.status(200).send(user));
          User.on('findById-error', error => res.status(500).send({error}));
      });
    • Using the findByEmail method

      app.get('/user-email', (req, res, next) => {
      
          User.findByEmail(req.body.email);
      
          User.on('findByEmail', user => res.status(200).send(user));
          User.on('findByEmail-error', error => res.status(500).send({error}));
      });
UPDATE
  1. Using Promise

    • Using the update method

      app.put('/users/:id', async (req, res, next) => {
        try{
          const userId = User.objectId(req.params.id);
          const updated = await User.update({_id: userId},req.body);
          res.status(200).send({updated});
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the updateById method

      app.put('/users/:id', async (req, res, next) => {
        try{
          const updated = await User.updateById(req.params.id, req.body);
          res.status(200).send({updated});
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the updateByUsername method

      app.put('/user-username', async (req, res, next) => {
        try{
          const updated = await User.updateByUsername(req.body.username, req.body);
          res.status(200).send({updated});
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the updateByEmail method

      app.put('/user-email', async (req, res, next) => {
        try{
          const updated = await User.updateByEmail(req.body.email, req.body);
          res.status(200).send({updated});
        }catch(error){
          res.status(500).send({error});
        }
      });
  2. Using Callback

    • Using the create method

      app.post('/users', (req, res, next) => {
          User.create(req.body,{},(error, result) => {
              if(error) return res.status(500).send({error});
              res.status(200).send({result});
          });
      });
    • Using the insertOne method

      app.post('/users', (req, res, next) => {
         User.insertOne(req.body,{},(error, result) => {
            if(error) return res.status(500).send({error});
            res.status(200).send({result});
        });
      });
  3. Using Event

    • Using the create method

      app.post('/users', (req, res, next) => {
                 
          User.create(req.body);
      
          User.on('create', result => res.status(200).send({result}));
          User.on('create-error', error => res.status(500).send({error}));
      });
    • Using the insertOne method

      app.post('/users', (req, res, next) => {
      
          User.insertOne(req.body);
      
          User.on('insertOne', result => res.status(200).send({result}));
          User.on('insertOne-error', error => res.status(500).send({error}));
      });
DELETE
  1. Using Promise

    • Using the deleteOne method

      app.delete('/users/:id', async (req, res, next) => {
        try{
          const userId = User.objectId(req.params.id);
          const result = await deleteOne({_id: userId});
          res.status(200).send({result});
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the destroy method

      app.delete('/users/:id', async (req, res, next) => {
        try{
            const userId = User.objectId(req.params.id);
            const result = await destroy({_id: userId});
            res.status(200).send(result);
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the deleteById method

      app.delete('/users/:id', async (req, res, next) => {
        try{
          const result = await deleteById(req.params.id);
          res.status(200).send(result);
        }catch(error){
          res.status(500).send({error});
        }
      });
      • Using the remove method
      app.delete('/users/:id', async (req, res, next) => {
        try{
          const userId = User.objectId(req.params.id);
          const result = await remove({_id: userId});
          res.status(200).send(result);
        }catch(error){
          res.status(500).send({error});
        }
      });
    • Using the deleteByEmail method

      app.delete('/delete-user-by-email', async (req, res, next) => {
        try{
          const result = await User.deleteByEmail(req.body.email);
          res.status(200).send({result});
        }catch(error){
          res.status(500).send({error});
        }
      });
  2. Using Callback

    • Using the deleteOne method

        app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.deleteOne({_id: userId},{}, (error,result) => {
                if(error) console.log('error deleting user', error);
                console.log('user deleted', result);
            });
        });
    • Using the destroy method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.destroy({_id: userId},{}, (error,result) => {
                if(error) console.log('error deleting user', error);
                console.log('user deleted', result);
            });
        });
    • Using the deleteById method

       app.delete('/users/:id', (req, res, next) => {
            User.deleteById(req.params.id,{}, (error,result) => {
                if(error) console.log('error deleting user', error);
                console.log('user deleted', result);
            });
        });
    • Using the remove method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.remove({_id: userId},{}, (error,result) => {
                if(error) console.log('error deleting user', error);
                console.log('user deleted', result);
            });
        });
    • Using the deleteByEmail method

       app.delete('/delete-user-by-email', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.deleteByEmail(req.body.email,{}, (error,result) => {
                if(error) console.log('error deleting user', error);
                console.log('user deleted', result);
            });
        });
  3. Using Event

    • Using the deleteOne method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.deleteOne({_id: userId});
            User.on('deleteOne', result => console.log('user deleted', result));
            User.on('deleteOne-error', error => console.log('error user deleting user', error));
        });
    • Using the destroy method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.destroy({_id: userId});
            User.on('destroy', result => console.log('user destroyed', result));
            User.on('destroy-error', error => console.log('error user destroying user', error));
        });
    • Using the deleteById method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.deleteById(req.params.id);
            User.on('deleteById', result => console.log('user deleted by id', result));
            User.on('deleteById-error', error => console.log('error deleting user by id', error));
        });
    • Using the remove method

       app.delete('/users/:id', (req, res, next) => {
            const userId = User.objectId(req.params.id);
      
            User.remove({_id: userId});
            User.on('remove', result => console.log('user removed', result));
            User.on('remove-error', error => console.log('error user removing user', error));
        });
    • Using the deleteByEmail method

       app.delete('/delete-user-by-email', (req, res, next) => {
                
            User.deleteByEmail(req.body.email);
            User.on('deleteByEmail', result => console.log('user deleted by email', result));
            User.on('deleteByEmail-error', error => console.log('error user deleting user by email', error));
        });

Making HTTP/HTTPS Requests: Internal/External API calls

In today's interconnected world, applications often need to interact with external services and APIs to retrieve or manipulate data. Whether it's fetching weather information, integrating with social media platforms, or accessing internal microservices, the ability to make HTTP/HTTPS requests is a crucial aspect of modern application development.

With mongodb-model, developers can harness the power of MongoDB's document-based data model while effortlessly integrating with various APIs to create dynamic and data-driven experiences.

This section explores the mechanisms and best practices for making HTTP/HTTPS requests within the mongodb-model framework. We will delve into topics such as performing CRUD operations on external resources, handling authentication and authorization, managing request timeouts and retries, and efficiently processing API responses. By understanding these concepts, developers can extend the capabilities of their mongodb-model applications and leverage the vast array of services available through APIs. So, let's dive into the world of making HTTP/HTTPS requests with mongodb-model and unlock the potential for building truly interconnected applications.

To begin, we initialize the Model class, which automatically establishes a connection with the database. Hence, manual database connection becomes unnecessary as it is handled by the instantiation process itself.

   const Model = require('@mongodb-model/model');
   const User = new Model({collection: 'users'});

Usage

HTTPS
  • get

    • Using promise
        User.get('api_endpoint_https_url')
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.get('api_endpoint_https_url', (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.get('api_endpoint_https_url');
        User.on('get', result =>  /** Your success codes here**/);
        User.on('get-error', error =>  /** Your error codes here**/);
  • post

    • Using promise
        User.post('api_endpoint_https_url', postData)
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.post('api_endpoint_https_url', postData, (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.post('api_endpoint_https_url', postData);
        User.on('post', result =>  /** Your success codes here**/);
        User.on('post-error', error =>  /** Your error codes here**/);
  • put

    • Using promise
        User.put('api_endpoint_https_url', updateData)
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.put('api_endpoint_https_url', updateData,(error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.put('api_endpoint_https_url', updateData);
        User.on('put', result =>  /** Your success codes here**/);
        User.on('put-error', error =>  /** Your error codes here**/);
  • delete

    • Using promise
        User.delete('api_endpoint_https_url')
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.delete('api_endpoint_https_url', (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.delete('api_endpoint_https_url');
        User.on('delete', result =>  /** Your success codes here**/);
        User.on('delete-error', error =>  /** Your error codes here**/);
HTTP
  • GET

    • Using promise
        User.GET('api_endpoint_http_url')
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.GET('api_endpoint_http_url', (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.GET('api_endpoint_http_url');
        User.on('GET', result =>  /** Your success codes here**/);
        User.on('GET-error', error =>  /** Your error codes here**/);
  • POST

    • Using promise
        User.POST('api_endpoint_http_url', postData)
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.POST('api_endpoint_http_url', postData, (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.POST('api_endpoint_http_url', postData);
        User.on('POST', result =>  /** Your success codes here**/);
        User.on('POST-error', error =>  /** Your error codes here**/);
  • PUT

    • Using promise
        User.PUT('api_endpoint_http_url', updateData)
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.PUT('api_endpoint_http_url', updateData,(error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.PUT('api_endpoint_http_url', updateData);
        User.on('PUT', result =>  /** Your success codes here**/);
        User.on('PUT-error', error =>  /** Your error codes here**/);
  • DELETE

    • Using promise
        User.DELETE('api_endpoint_http_url')
            .then(response => /** Your response codes here**/)
            .catch(error => /** Your error codes here**/);
    • Using Callback
        User.DELETE('api_endpoint_http_url', (error, result) => {
          /** Your success and error codes here**/
      });
    • Using Event
        User.DELETE('api_endpoint_http_url');
        User.on('DELETE', result =>  /** Your success codes here**/);
        User.on('DELETE-error', error =>  /** Your error codes here**/);

Examples

We will use the following example data for POST and PUT requests throughout the remain of this section:

  const data =  {
    postId: 20,
    name: 'laudantium delectus nam',
    email: '[email protected]',
    body: 'NEW POST aut quam consequatur sit et\n' +
         'repellat maiores laborum similique voluptatem necessitatibus nihil\n' +
          'et debitis nemo occaecati cupiditate\n' +
          'modi dolorum quia aut'
  } 
HTTPS
  • get: perform a GET request to 'https://jsonplaceholder.typicode.com/comments'

    • Using promise
        User.get('https://jsonplaceholder.typicode.com/comments')
            .then(response => console.log(response))
            .catch(error => console.log(error));
    • Using Callback
          User.get('https://jsonplaceholder.typicode.com/comments', (error, result) => {
              if(error) return console.log(error);
              console.log(result);
          });
    • Using Event
        User.get('https://jsonplaceholder.typicode.com/comments');
        User.on('get', result => console.log(result));
        User.on('get-error', error => console.log(error));
  • post: perform a POST request to 'https://jsonplaceholder.typicode.com/comments'

    • Using promise
        User.post('https://jsonplaceholder.typicode.com/comments', data)
            .then(response => console.log(response))
            .catch(error => console.log(error));
    • Using Callback
        User.post('https://jsonplaceholder.typicode.com/comments', data, (error, result) => {
          if(error) return console.log(error);
          console.log(result);
        });
    • Using Event
          User.post('https://jsonplaceholder.typicode.com/comments', data);
          User.on('post', result => console.log(result));
          User.on('post-error', error => console.log(error));
  • put: perform a PUT request to 'https://jsonplaceholder.typicode.com/comments/1'

    • Using promise
        User.put('https://jsonplaceholder.typicode.com/comments/1', data)
          .then(response => console.log(response))
          .catch(error => console.log(error));
    • Using Callback
        User.put('https://jsonplaceholder.typicode.com/comments/1', data, (error, result) => {
            if(error) return console.log(error);
            console.log(result);
        });
    • Using Event
        User.put('https://jsonplaceholder.typicode.com/comments/1', data);
        User.on('put', result => console.log(result));
        User.on('put-error', error => console.log(error));
  • delete: perform a DELETE request to 'https://jsonplaceholder.typicode.com/comments/1

    • Using promise
       User.delete('https://jsonplaceholder.typicode.com/comments/1')
          .then(response => console.log(response))
          .catch(error => console.log(error));
    • Using Callback
        User.delete('https://jsonplaceholder.typicode.com/comments/1', (error, result) => {
          if(error) return console.log(error);
          console.log(result);
        });
    • Using Event
        User.delete('https://jsonplaceholder.typicode.com/comments/1');
        User.on('delete', result => console.log(result));
        User.on('delete-error', error => console.log(error));
HTTP
  • GET: perform a GET request to a local server 'http://localhost:3000/users'

    • Using promise
        User.GET('http://localhost:3000/users')
          .then(users => console.log(users))
          .catch(error => console.log(error));
    • Using Callback
         User.GET('http://localhost:3000/users', (error, users) => {
          if(error) return console.log(error);
          console.log(users);
        });
    • Using Event
        User.GET('http://localhost:3000/users');
        User.on('GET', users => console.log(users));
        User.on('GET-error', error => console.log(error));
  • POST: Perform a POST request to a local server 'http://localhost:3000/users'

    • Using promise
        User.POST('http://localhost:3000/users', data)
            .then(result => console.log(result))
            .catch(error => console.log(error));
    • Using Callback
        User.post('https://jsonplaceholder.typicode.com/comments', data, (error, result) => {
          if(error) return console.log(error);
          console.log(result);
        });
    • Using Event
        User.POST('http://localhost:3000/users', data);
        User.on('POST', result => console.log(result));
        User.on('POST-error', error => console.log(error));      
  • PUT: perform a PUT request to a local server 'http://localhost:3000/users/1'

    • Using promise
        User.PUT('http://localhost:3000/users/1', data)
            .then(result => console.log(result))
            .catch(error => console.log(error));
    • Using Callback
       User.PUT('http://localhost:3000/users/1', data, (error, result) => {
          if(error) return console.log(error);
          console.log(result);
      });
    • Using Event
        User.put('https://jsonplaceholder.typicode.com/comments/1', data);
        User.on('put', result => console.log(result));
        User.on('put-error', error => console.log(error));
  • DELETE: perform a DELETE request to a local server 'http://localhost:3000/users/1'

    • Using promise
       User.DELETE('http://localhost:3000/users/1')
            .then(result => console.log(result))
            .catch(error => console.log(error));
    • Using Callback
        User.DELETE('http://localhost:3000/users/1', (error, result) => {
          if(error) return console.log(error);
          console.log(result);
      });
    • Using Event
        User.DELETE('http://localhost:3000/users/1');
        User.on('DELETE', result => console.log(result));
        User.on('DELETE-error', error => console.log(error));

Making TCP Requests

When working with Mongodb model, making TCP requests is a crucial aspect of communication between the client and the MongoDB server. TCP (Transmission Control Protocol) provides a reliable and ordered channel for transmitting data, ensuring the integrity and accuracy of the information exchanged.

With the Mongodb model, you can easily make TCP requests to perform various operations on the MongoDB database. Whether it's inserting new data, updating existing records, or querying for specific information, the framework provides intuitive methods and functions to interact with the database using TCP/IP protocols.

To begin, we initialize the Model class, which automatically establishes a connection with the database. Hence, manual database connection becomes unnecessary as it is handled by the instantiation process itself.

 const Model = require('@mongodb-model/model');
 const User = new Model({collection: 'users'});

Basics

Creating a TCP Server

  1. Create a TCP server with Redis using the User model.

      const server = User.createTCPServerWithRedis();
  2. Listen for 'connection' event on the TCP server

      server.on('connection', socket => {
        console.log('Client is ready!');
      });
  3. Start listening on a port. Port 8000 is used in this example

      server.listen(8000);

    Basic TCP Server Creation Full Code

      // Import the Model module
      const Model = require('@mongodb-model/model');
           
      // Create a new instance of Model for the 'users' collection
      const User = new Model({ collection: 'users' });
           
      // Create a TCP server with Redis using the User model
      const server = User.createTCPServerWithRedis();
           
      // Listen for 'connection' event on the TCP server
      server.on('connection', socket => {
        console.log('Client is ready!');
      });
      // Start listening on port 8000
      server.listen(8000);

Creating a TCP Client

  1. Create a TCP client for the server at 'http://localhost:8000'

      const client = User.createTCPClient('http://localhost:8000');
  2. Handle the 'connect' event when the client connects to the server

      client.on('connect', () => {
        console.log('Connected to server');
      });

    Basic TCP Client Creation Full Code

      // Import the Model module
      const Model = require('@mongodb-model/model');
    
      // Create a new instance of Model for the 'users' collection
      const User = new Model({ collection: 'users' });
    
      // Create a TCP client for the server at 'http://localhost:8000';
      const client = User.createTCPClient('http://localhost:8000');
    
      // Handle the 'connect' event when the client connects to the server
      client.on('connect', () => {
        console.log('Connected to server');
      });

Example

TCP Server

  1. Create a TCP server with Redis using the User model.

      const server = User.createTCPServerWithRedis();
  2. Function to handle socket event listener for finding models

     /**
    * Registers a socket event listener for finding models.
    * @param {Socket} socket - The socket object
    * @param {string} [event='find'] - The event name
    * @param {Model} [Model=User] - The model class to perform the find operation on
    */
          
    const onFind = (socket, event = 'find', Model = User) => socket.on(event, () => {
      // Find models
      Model.find();
             
      // Handle 'find' event
      Model.on('find', models => socket.emit(`${Model.collection}-${event}-success`, models));
                 
      // Handle 'find-error' event
      Model.on('find-error', error => socket.emit(`${Model.collection}-${event}-error`, error));
                 
      // Handle 'find-done' event
      socket.on(`${event}-done`, () => console.log(`${Model.collection}-${event} done!`));
                 
      // Handle 'find-failed' event
      socket.on(`${event}-failed`, () => console.log(`${Model.collection}-${event} failed!`));
    }); 
  3. Function to handle socket event listener for finding a model by ID.

      /**
    * Registers a socket event listener for finding a model by ID.
    * @param {Socket} socket - The socket object
    * @param {string} [event='findById'] - The event name
    * @param {Model} [Model=User] - The model class to perform the find operation on
    */
          
    const onFindById = (socket, event = 'findById', Model = User) => socket.on(event, modelId => {
          
        //Find model by id
        Model.findById(modelId);
    
        // Handle 'findById' event
        Model.on('findById', model => socket.emit(`${Model.collection}-${event}-success`, model));
             
        // Handle 'findById-error' event
        Model.on('findById-error', error => socket.emit(`${Model.collection}-${event}-error`, error));
             
        // Handle 'findById-done' event
        socket.on(`${event}-done`, () => console.log(`${Model.collection}-${event} done!`));
             
        // Handle 'findById-failed' event
        socket.on(`${event}-failed`, () => console.log(`${Model.collection}-${event} failed!`));
    }); 
  4. Function to handle socket event listener for creating a model.

    /**
    * Registers a socket event listener for creating a model.
    * @param {Socket} socket - The socket object
    * @param {string} [event='create'] - The event name
    * @param {Model} [Model=User] - The model class to perform the create operation on
    */
    const onCreate = (socket, event = 'create', Model = User) => socket.on(event, modelData => {
        // Create model
        Model.create(modelData);
             
        // Handle 'create' event
        Model.on('create', result => socket.emit(`${Model.collection}-${event}-success`, result));
             
        // Handle 'create-error' event
        Model.on('creat-error', error => socket.emit(`${Model.collection}-${event}-error`, error));
             
        // Handle 'create-done' event
        socket.on(`${event}-done`, () => console.l