Node.js MongoDB Tutorial con ejemplos

Casi todas las aplicaciones web modernas tienen algún tipo de sistema de almacenamiento de datos en el backend. Por ejemplo, si tomamos el caso de una tienda en línea.ping En la aplicación, datos como el precio de un artículo se almacenarían en la base de datos.

El marco Node js puede trabajar con bases de datos tanto relacionales (como Oracle y MS SQL Server) y bases de datos no relacionales (como MongoDB). En este tutorial, veremos cómo podemos usar bases de datos desde aplicaciones de Node js.

Bases de datos Node.js y NoSQL

A lo largo de los años, las bases de datos NoSQL como MongoDB y bases de datos relacionales como MySQL Se han vuelto muy populares como bases de datos para almacenar información. La capacidad de estas bases de datos para almacenar cualquier tipo de datos, y en particular en cualquier formato, es lo que las hace tan utilizadas.

Node.js tiene la capacidad de trabajar con ambos MySQL y MongoDB como bases de datos. Para utilizar cualquiera de estas bases de datos, debe descargar y utilizar los módulos necesarios mediante el administrador de paquetes de Node.

Para MySQL, el módulo requerido se llama “mysql”. Para MongoDBLos desarrolladores pueden instalar la versión nativa oficial. mongodb controlador, que es el paquete utilizado en todos los ejemplos de código de este artículo, o una biblioteca basada en esquemas como Mangosta una vez que la aplicación necesite más estructura.

Con estos módulos, puedes realizar las siguientes operaciones en Node.js

1. Administrar el pool de conexiones: aquí es donde puede especificar la cantidad de conexiones. MySQL Conexiones de bases de datos que Node.js debe mantener y guardar.
2. Crear y cerrar una conexión a una base de datos. En cualquier caso, puede proporcionar una función de devolución de llamada que se puede llamar cada vez que se ejecutan los métodos de conexión "crear" y "cerrar".
3. Se pueden ejecutar consultas para obtener datos de las respectivas bases de datos para recuperar datos.
4. La manipulación de datos, como insertar, eliminar y actualizar datos, también se puede lograr con estos módulos.

Para los temas restantes, veremos cómo podemos trabajar con MongoDB bases de datos dentro Node.js, comenzando con una rápida comparación de las dos formas más comunes de hablar MongoDB de un proyecto Node.js.

MongoDB Controlador nativo vs. Mongoose en Node.js

Los nombres de los módulos mencionados anteriormente pueden resultar confusos, ya que Node.js ofrece dos formas diferentes de comunicarse con MongoDB: el nativo mongodb el conductor y el Mangosta ODM (biblioteca de modelado de datos de objetos). Cada ejemplo de código posterior en este artículo utiliza el controlador nativo, instalado con npm instala mongodb y se accede a través de Cliente MongoMongoose envuelve ese mismo controlador y agrega definiciones de esquema, validación y métodos de modelo reutilizables, lo que resulta adecuado para aplicaciones más grandes que necesitan una estructura de datos predecible en muchas colecciones. Entender la diferencia de antemano evita confusiones al instalar paquetes o leer otros documentos de Node.js. MongoDB Ejemplos disponibles en línea. La siguiente tabla compara ambas opciones para que el desarrollador pueda elegir la herramienta adecuada para cada proyecto.

Tip: Sigue utilizando el controlador nativo mientras aprendes los fundamentos. MongoDB comandos, luego pasar a Mangosta una vez que la aplicación necesite validación de esquema en varias colecciones.

El uso de MongoDB y Node.js

Una vez aclarada la terminología, el resto de este artículo utiliza exclusivamente el controlador nativo, tal como aparece en los ejemplos de código a continuación. Como se comentó en el tema anterior, MongoDB es una de las bases de datos más populares utilizadas junto con Node.js.

Durante este capítulo, veremos cómo establecer conexiones con un MongoDB base de datos y cómo realizar las operaciones normales de lectura de datos de una base de datos, así como insertar, eliminar y actualizar registros en una MongoDB base de datos.

Para los fines de este capítulo, supongamos que tenemos lo siguiente MongoDB datos en su lugar.

Nombre de la base de datos: EmployeeDB

Nombre de la colección: Empleado

Documents
{
	{Employeeid : 1, Employee Name : Guru99},
	{Employeeid : 2, Employee Name : Joe},
	{Employeeid : 3, Employee Name : Martin},
}

1. Instalación de los módulos NPM

Necesita un controlador para acceder a Mongo desde una aplicación Node. Hay varios controladores Mongo disponibles, pero MongoDB está entre los más populares. Para instalar el MongoDB módulo, ejecute el siguiente comando

npm instala mongodb

2. Crear y cerrar una conexión a un MongoDB base de datos. El siguiente fragmento de código muestra cómo crear y cerrar una conexión a un MongoDB base de datos.

Code Explicación:

1. El primer paso es incluir el MongoDB El módulo del controlador se configura mediante la función require. Una vez instalado este módulo, podemos utilizar las funciones necesarias para establecer conexiones con la base de datos.
2. A continuación, especificamos nuestra cadena de conexión a la base de datos. En la cadena de conexión, se pasan 3 valores clave.

• El primero es 'mongodb', que especifica que nos estamos conectando a una base de datos mongoDB.
• El siguiente es "localhost", lo que significa que nos estamos conectando a una base de datos en la máquina local.
• El siguiente es 'EmployeeDB' que es el nombre de la base de datos definida en nuestro MongoDB base de datos.

3. El siguiente paso es conectarnos a nuestra base de datos. La función de conexión toma nuestra URL Además, permite especificar una función de devolución de llamada. Esta se ejecutará cuando se establezca la conexión con la base de datos. Esto nos permite saber si la conexión con la base de datos se realizó correctamente o no.
4. En la función, escribimos la cadena “Conexión establecida” en la consola para indicar que se creó una conexión exitosa.
5. Finalmente, cerramos la conexión usando la declaración db.close.

Si el código anterior se ejecuta correctamente, la cadena "Conectado" se escribirá en la consola como se muestra a continuación.

3. Consulta de datos en un MongoDB base de datos de CRISPR Medicine News - Utilizando la MongoDB controlador también podemos recuperar datos del MongoDB base de datos. La siguiente sección mostrará cómo podemos usar el controlador para recuperar todos los documentos de nuestra colección Employee en nuestra base de datos EmployeeDB. Esta es la colección en nuestra MongoDB base de datos, que contiene todos los documentos relacionados con los empleados. Cada documento tiene una identificación de objeto, un nombre de empleado y una identificación de empleado para definir los valores del documento.

var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';

MongoClient.connect(url, function(err, db) {

var cursor = db.collection('Employee').find();

cursor.each(function(err, doc) {

console.log(doc);

});
});

Code Explicación:

1. En el primer paso, creamos un cursor (un cursor es un puntero que se utiliza para apuntar a los distintos registros obtenidos de una base de datos. El cursor se utiliza luego para iterar a través de los diferentes registros en la base de datos. Aquí definimos un nombre de variable llamado cursor que se utilizará para almacenar el puntero a los registros obtenidos de la base de datos) que apunta a los registros que se obtienen de la colección MongoDb. También tenemos la facilidad de especificar la colección 'Employee' de la que obtener los registros. La función find() se utiliza para especificar que queremos recuperar todos los documentos de la MongoDB colección.
2. Ahora estamos iterando a través de nuestro cursor y para cada documento en el cursor vamos a ejecutar una función.
3. Nuestra función simplemente va a imprimir el contenido de cada documento a la consola.

Nota: - También es posible obtener un registro específico de una base de datos. Esto se puede hacer especificando la condición de búsqueda en la función find(). Por ejemplo, supongamos que solo desea obtener el registro que tiene el nombre del empleado como Guru99, entonces esta afirmación se puede escribir de la siguiente manera

var cursor=db.collection('Employee').find({EmployeeName: "guru99"})

Si el código anterior se ejecuta correctamente, se mostrará el siguiente resultado en su consola.

Salida:

Desde la salida,

• Podrás ver claramente que se han recuperado todos los documentos de la colección. Esto es posible utilizando el método find() de la conexión mongoDB (db) e iterando por todos los documentos utilizando el cursor.

4. Insertar documentos en una colección – Los documentos se pueden insertar en una colección utilizando el método insertOne proporcionado por MongoDB Biblioteca. El siguiente fragmento de código muestra cómo podemos insertar un documento en una colección de MongoDB.

var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';

MongoClient.connect(url, function(err, db) {

db.collection('Employee').insertOne({
Employeeid: 4,
EmployeeName: "NewEmployee"
});
});

Code Explicación:

1. Aquí estamos usando el método insertOne del MongoDB biblioteca para insertar un documento en la colección de Empleados.
2. Estamos especificando los detalles del documento que debe insertarse en la colección de Empleados.

Si ahora compruebas el contenido de tu MongoDB base de datos, encontrará el registro con Employeeid de 4 y EmployeeName de “NewEmployee” insertado en la colección Employee.

Nota: La consola no mostrará ningún resultado porque el registro se está insertando en la base de datos y no se puede mostrar ningún resultado aquí.

Para comprobar que los datos se han insertado correctamente en la base de datos, es necesario ejecutar los siguientes comandos en MongoDB

1. Utilice la base de datos de empleados
2. db.Empleado.find({Empleadoid:4})

La primera declaración garantiza que está conectado a la base de datos de EmployeeDb. La segunda declaración busca el registro que tiene la identificación de empleado 4.

5. Actualizar documentos en una colección – Los documentos se pueden actualizar en una colección utilizando el método updateOne proporcionado por MongoDB Biblioteca. El siguiente fragmento de código muestra cómo actualizar un documento en una colección de MongoDB.

var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';

MongoClient.connect(url, function(err, db) {

db.collection('Employee').updateOne({
"EmployeeName": "NewEmployee"
}, {
$set: {
"EmployeeName": "Mohan"
}
});
});

Code Explicación:

1. Aquí estamos usando el método "updateOne" del MongoDB biblioteca, que se utiliza para actualizar un documento en una colección mongoDB.
2. Estamos especificando los criterios de búsqueda de qué documento necesita ser actualizado. En nuestro caso, queremos encontrar el documento que tiene el Nombre de Empleado de "Nuevo Empleado".
3. Luego queremos establecer el valor del nombre del empleado del documento de "Nuevo empleado" a "Mohan".

Si ahora compruebas el contenido de tu MongoDB base de datos, encontrará el registro con Employeeid de 4 y EmployeeName de "Mohan" actualizado en la colección de Empleados.

Para comprobar que los datos se han actualizado correctamente en la base de datos, es necesario ejecutar los siguientes comandos en MongoDB

1. Utilice la base de datos de empleados
2. db.Empleado.find({Empleadoid:4})

La primera declaración garantiza que está conectado a la base de datos de EmployeeDb. La segunda declaración busca el registro que tiene la identificación de empleado 4.

6. Eliminar documentos de una colección – Los documentos se pueden eliminar en una colección utilizando el método "deleteOne" proporcionado por el MongoDB Biblioteca. El siguiente fragmento de código muestra cómo eliminar un documento en una colección de MongoDB.

var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';

MongoClient.connect(url, function(err, db) {

db.collection('Employee').deleteOne(

{
"EmployeeName": "Mohan"
}

);
});

Code Explicación:

1. Aquí estamos usando el método "deleteOne" del MongoDB biblioteca, que se utiliza para eliminar un documento en una colección mongoDB.
2. Estamos especificando los criterios de búsqueda de qué documento debe eliminarse. En nuestro caso, queremos encontrar el documento que tiene el nombre de empleado "Mohan" y eliminarlo.

Si ahora compruebas el contenido de tu MongoDB base de datos, encontrará el registro con Employeeid de 4 y EmployeeName de "Mohan" eliminado de la colección de Empleados.

Para comprobar que los datos se han actualizado correctamente en la base de datos, es necesario ejecutar los siguientes comandos en MongoDB

1. Utilice la base de datos de empleados
2. db.Empleado.find()

La primera declaración garantiza que está conectado a la base de datos de EmployeeDb. La segunda declaración busca y muestra todos los registros en la colección de empleados. Aquí podrás ver si el registro ha sido eliminado o no.

Modern Async/Await MongoDB Conexiones en Node.js

El MongoClient.connect(url, callback) El patrón utilizado a lo largo de este artículo coincide con el MongoDB Versión del controlador de Node.js vigente cuando se escribieron los ejemplos anteriores. Las versiones recientes del controlador aún admiten ese estilo de devolución de llamada, pero la mayoría de los proyectos nuevos ahora prefieren promesas y async/await, ya que el código resultante se lee de arriba a abajo sin devoluciones de llamada anidadas. Los pasos a continuación reescriben la misma conexión de empleado utilizando la sintaxis moderna.

1. Cree una única instancia de MongoClient fuera de cualquier función, pasando la cadena de conexión una sola vez, por ejemplo const cliente = nuevo MongoClient(url);
2. Llame hoy al esperar cliente.connect() dentro de una función asíncrona para abrir la conexión en lugar de pasar una función de devolución de llamada.
3. Obtén la base de datos con cliente.db('EmployeeDB') en lugar de depender del objeto devuelto dentro de una función de devolución de llamada.
4. Ejecutar consultas con await, Por ejemplo esperar a que db.collection('Employee').find().toArray(), que devuelve una matriz directamente en lugar de requerir una función de devolución de llamada del cursor.
5. Cierre la conexión con esperar cliente.close() dentro de un bloque finally para que siempre se ejecute, incluso si una consulta arroja un error.

const { MongoClient } = require('mongodb');

const url = 'mongodb://localhost:27017';
const client = new MongoClient(url);

async function run() {
try {
await client.connect();
const db = client.db('EmployeeDB');
const employees = await db.collection('Employee').find().toArray();
console.log(employees);
} finally {
await client.close();
}
}

run().catch(console.error);

Ambos estilos se conectan a la misma base de datos EmployeeDB y a la misma colección Employee, por lo que no es necesario reescribir inmediatamente el código existente basado en callbacks. Los dos enfoques pueden coexistir mientras un proyecto migra gradualmente, y la elección depende principalmente de cuál MongoDB La versión del controlador Node.js ya tiene un archivo package.json fijado.

Cómo crear una aplicación Node Express con MongoDB para almacenar y servir contenido

Una vez cubiertos ambos estilos de conexión, la siguiente sección aplica el patrón clásico de devolución de llamada dentro de una aplicación Express completa, ya que esa es la sintaxis que utiliza el servidor de ejemplo original a continuación. Construir una aplicación con una combinación de Express y MongoDB es bastante común hoy en día.

Cuando se trabaja con JavaScript En el caso de las aplicaciones web, normalmente se oye hablar del término pila MEAN.

• El término pila MEAN se refiere a una colección de JavaTecnologías basadas en scripts utilizadas para desarrollar aplicaciones web.
• MEAN es un acrónimo de MongoDB, ExpressJS, AngularJSy Node.js.

Por lo tanto, siempre es bueno entender cómo funcionan Node.js y MongoDB trabajar juntos para ofrecer aplicaciones que interactúan con bases de datos backend.

Veamos un ejemplo simple de cómo podemos usar "express" y "MongoDB" juntos. Nuestro ejemplo hará uso de la misma colección de Empleados en el MongoDB Base de datos de EmployeeDB.

Ahora incorporaremos Express para mostrar los datos en nuestra página web cuando el usuario los solicite. Cuando nuestra aplicación se ejecuta en Node.js, es posible que necesite navegar a la URL http://localhost:3000/Employeeid.

Cuando se inicia la página, se mostrarán todos los ID de empleados de la colección Employee. Veamos el fragmento de código en secciones que nos permitirá lograr esto.

Paso 1) Definir todas las bibliotecas que deben usarse en nuestra aplicación, que en nuestro caso es tanto la MongoDB y biblioteca exprés.

Code Explicación:

1. Estamos definiendo nuestra biblioteca 'express', que se utilizará en nuestra aplicación.
2. Estamos definiendo nuestro 'MongoDB' biblioteca, que se utilizará en nuestra aplicación para conectarse a nuestro MongoDB base de datos.
3. Aquí estamos definiendo el URL de nuestra base de datos a la que conectarse.
4. Finalmente, estamos definiendo una cadena que se utilizará para almacenar nuestra colección de identificaciones de empleados que deberán mostrarse en el navegador más adelante.

Paso 2) En este paso, ahora obtendremos todos los registros de nuestra colección "Empleado" y trabajaremos con ellos en consecuencia.

Code Explicación:

1. Estamos creando una ruta a nuestra aplicación llamada "Employeeid". Entonces, cada vez que alguien navega hacia http://localhost:3000/Employeeid de nuestra aplicación se ejecutará el fragmento de código definido para esta ruta.
2. Aquí obtenemos todos los registros de nuestra colección 'Empleado' a través del comando db.collection('Employee').find(). Luego asignamos esta colección a una variable llamada cursor. Usando esta variable de cursor podremos navegar por todos los registros de la colección.
3. Ahora estamos usando la función cursor.each() para navegar por todos los registros de nuestra colección. Para cada registro, definiremos un fragmento de código sobre qué hacer cuando se accede a cada registro.
4. Finalmente, vemos que si el registro devuelto no es nulo, entonces estamos tomando al empleado mediante el comando "item.Employeeid". El resto del código es sólo para construir un código HTML adecuado que permitirá que nuestros resultados se muestren correctamente en el navegador.

Paso 3) En este paso, enviaremos nuestra salida a la página web y haremos que nuestra aplicación escuche en un puerto en particular.

Code Explicación:

1. Aquí enviamos todo el contenido que se creó en el paso anterior a nuestra página web. El parámetro ‘res’ nos permite enviar contenido a nuestra página web como respuesta.
2. Estamos haciendo que toda nuestra aplicación Node.js escuche en el puerto 3000.

Salida:

Desde la salida,

• Muestra claramente que se recuperaron todos los ID de empleado de la colección Empleado. Esto se debe a que utilizamos el MongoDB controlador para conectarse a la base de datos y recuperar todos los registros de los empleados y posteriormente utilizó "express" para mostrar los registros.

Aquí está el código para su referencia.

var express = require('express');
var app = express();
var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';
var str = "";

app.route('/Employeeid').get(function(req, res)

{
MongoClient.connect(url, function(err, db) {
var cursor = db.collection('Employee').find();
//noinspection JSDeprecatedSymbols
cursor.each(function(err, item) {

if (item != null) {
str = str + " Employee id " + item.Employeeid + "</br>";
}
});
res.send(str);
db.close();
});
});

var server = app.listen(3000, function() {});

Nota: cursor.each puede estar obsoleto según la versión de su MongoDB conductor. Puede agregar //noinspection JSDeprecatedSymbols antes de cursor.each para evitar el problema. Alternativamente, puedes usar forEach. A continuación se muestra el código de muestra usando forEach

var express = require('express');
var app = express();
var MongoClient = require('mongodb').MongoClient;
var url = 'mongodb://localhost/EmployeeDB';
var str = "";

app.route('/Employeeid').get(function(req, res) {
MongoClient.connect(url, function(err, db) {
var collection = db.collection('Employee');
var cursor = collection.find({});
str = "";
cursor.forEach(function(item) {
if (item != null) {
str = str + "    Employee id  " + item.Employeeid + "</br>";
}
}, function(err) {
res.send(err);
db.close();
}
);
});
});
var server = app.listen(8080, function() {});

Preguntas Frecuentes