Using MongoDB On Node.js Application Using Mongoose

Introduction
Why MongoDB?
Source Code
Background
Setting up Node application
Getting the required packages
Creating the Node App
Setting up database
Creating a Mongoose model
Setup the data
Inserting the data into MongoDB
Verify the data
Todo
Conclusion
Your turn. What do you think?

Introduction

In this post, we are going to see how we can use MongoDB on our Node JS application with the help of the package Mongoose. We will also be covering some facts about MongoDB so that as a reader, you will understand why we have chosen MongoDB as our backend. We will be going through some steps to install the required packages using a node package manager terminal, so please bear with me. At the end of this article, I guarantee that you will be proficient on how to connect a MongoDB in our Node JS application. I hope you will like this article.

You can always see this article on my blog here.

Why MongoDB?

Here, I am going to list down the reasons why I had chosen MongoDB.

MongoDB is a NoSQL database when I say NoSQL, it means that it doesn’t have any structure to be followed.
There are no relationships, we can perform the relation using separate packages like Mongoose
Everything is JSON, even the data and collections are stored as JSON
Since the data is stored as JSON, no more conversions are needed. We can directly use it in our application.

Source Code

You can always clone or download the source code here

Background

Node JS has become a trend now. One of the recommended databases for a Node application is MongoDB. As we discussed, MongoDB doesn’t have any structure inbuilt, here we are going to use a package called Mongoose, and with that, we can create some structure for our Database. Let’s just skip the talking and start developing.

Setting up Node application

To get started with the Node JS, create a folder and name it as per your wish, this is going to be our project directory. Here I am going to use one of my favorite editors, Visual Studio Code. Now please point to your project container, and run the command below.

NPM

NPM Init

This will create a file named “Package.json” in your directory. We will be adding all of our dependencies in this file very soon. The command may ask you some default questions which you need to answer. If you need to create the package.json file with default values in it, you may consider running the below command.

npm init --yes

Let’s review our package.json file.

{
    "name": "node-mongodb-mongoose",
    "version": "1.0.0",
    "description": "A Node application with MongoDB and Mongoose",
    "main": "index.js",
    "scripts": {
        "test": "echo \"Error: no test specified\" && exit 1"
    },
    "keywords": ["Node", "Mongoose", "MongoDB"],
    "author": "Sibeesh Venu",
    "license": "ISC"
}

Getting the required packages

Now that we have the application ready, let’s get the required packages ready.

npm install --save mongoose

This will create a new folder npm_modules in your project directory where you can see the package Mongoose.

npm install --save express

The above command will add the package express to our application.

Creating the Node App

Now we can create our server.js file where we are going to write most of our application code.

var express = require("express");
var app = express();

app.listen("3010", () => {
    console.log("I just started listening!");
});

Now run the command node server. and make sure that you are getting a console as ” I just started listening!.”.

If you are getting an error as preceding, please make sure that you are running the application on an unused port.

PS F:\Visual Studio\Node.JS\Node-MongoDB-Mongoose> node server.js
events.js:136
      throw er; // Unhandled ‘error’ event
      ^

Error: listen EADDRINUSE :::3000
    at Object._errnoException (util.js:1031:13)
    at _exceptionWithHostPort (util.js:1052:20)
    at Server.setupListenHandle [as _listen2] (net.js:1367:14)
    at listenInCluster (net.js:1408:12)
    at Server.listen (net.js:1496:7)
    at Function.listen (F:\Visual Studio\Node.JS\Node-MongoDB-Mongoose\node_modules\express\lib\application.js:618:24)
    at Object.<anonymous> (F:\Visual Studio\Node.JS\Node-MongoDB-Mongoose\server.js:3:5)
    at Module._compile (module.js:641:30)
    at Object.Module._extensions..js (module.js:652:10)
    at Module.load (module.js:560:32)

Setting up database

Now that we have our application ready, let’s go and create our database. I am going to use mLab to create the database. If you have not installed MongoDB on your machine, I strongly recommend creating a database in mLab.I had created a database there and got my connection string as preceding.

mongodb://<dbuser>:<dbpassword>@ds038319.mlab.com:38319/mylearning

We will be updating the connection string with the actual DB user and password later. Please make sure that you are creating a user for your DB and remember the password.

Creating a Mongoose model

Let’s create a Mongoose model and set up our connection string now, which is going to be our collection. No worries, it is just a JavaScript model.

var conString = "mongodb://admin:[email protected]:38319/mylearning";

/** 
 * Models 
 */
var User = mongoose.model("User", {
    firstName: String,
    lastName: String
});

Please note that, when you move the codes to production, make sure that your password and user fields on the connection string are separated from this file and encrypted

Now let’s connect our database.

mongoose.connect(conString, { useMongoClient: true }, () => {
    console.log("DB is connected");
});

Setup the data

We have our model ready, what else is needed now? Yes, you are right, we need data.

var dummyUser = {
    firstName: "Sibeesh",
    lastName: "Venu"
};

Inserting the data into MongoDB

We have got everything ready, we can insert the model now. Let’s do the saving logic now.

mongoose.connect(conString, {
    useMongoClient: true
}, () => {
    console.log("DB is connected");
    saveData();
});

function saveData() {
    var user = new User(dummyUser);
    user.save();
}

Verify the data

Once you run your application, go to your database and check for the entries there. I am sure there will be a new collection “User” and our inserted data. As I am using the mLab database, here is how my data is saved.

Data

MongoDB Data Insertion

If you have noticed, you can see there are other property names “_id” in our database collection. This is a unique ID generated by MongoDB for us, so no need to think about it.

Todo

As the purpose of this article is to show how we can insert data into MongoDB, I called the save method right after the database was connected. In our real life, this is not a recommended way. You must create an Ajax post request and handle the same. I am leaving that task to you. Please try to do that and let me know. I would love to hear back from you.

Conclusion

Thanks a lot for reading. Did I miss anything that you may think is needed? Did you find this post useful? I hope you liked this article. Please share with me your valuable suggestions and feedback.

Your turn. What do you think?

A blog isn’t a blog without comments, but do try to stay on topic. If you have a question unrelated to this post, you’re better off posting it on C# Corner, Code Project, Stack Overflow, or Asp.Net Forum instead of commenting here. Tweet or email me a link to your question there and I’ll definitely try to help if I can.

Table of contents