Integrazione di MongoDB con Node.js

Un'applicazione moderna e robotizzata ha un mezzo di archiviazione dei dati nel suo backend come l'applicazione Node che è in grado di funzionare sia con soluzioni non relazionali (come PostgresQL, MongoDB) che relazionali (come MySQL, Oracle).

MongoDB è un database non relazionale relativamente facile da usare e potente e se sei uno sviluppatore Node.js che vuole apprendere i vantaggi che offre e come iniziare a creare un'integrazione sicura con la tua applicazione Node, questo è la guida che fa per te!

In questo articolo impareremo come integrare/connettersi a MongoDB; un database non relazionale molto popolare con Node.js e vediamo come possiamo usarlo all'interno delle applicazioni Node.

Brevi informazioni su MongoDB

MongoDB è il database basato su documenti più popolare e avanzato, in cui tutti i dati sono archiviati in Binary JSON (JavaScript Object Notation) noto come BSON. Un BSON è a documento, senza la necessità di uno schema di dati predefinito. Consente di archiviare nello stesso posto i dati a cui accede frequentemente insieme da un'applicazione e rende la lettura del database facile e veloce.

A differenza delle tabelle relazionali, le raccolte sono autonome, questo rende molto più facile lavorarci. Quando un nuovo documento viene creato su una raccolta MongoDB, gli viene assegnato un ID per renderlo univoco per quella raccolta e all'interno del documento è possibile definire più campi; dove il valore potrebbe essere una variante di tipi di dati che vanno da matrici, stringhe, numeri interi, oggetti e così via.

Per manipolare i dati, l'API di query è utile per eseguire le operazioni CRUD (Crea, Leggi, Aggiorna ed Elimina) di base nel database. È inoltre possibile creare indici secondari per garantire l'ottimizzazione e rendere estremamente veloci le query comuni. Sono supportate anche le query geospaziali, che consentono di trovare documenti in una posizione geografica specifica.

Iniziare con MongoDB

Prima di iniziare con la connessione a MongoDB da un'applicazione Node, vai al sito Web ufficiale di MongoDB per iscriverti al Try Free pulsante (se non hai già un account):

Dopo aver creato il tuo account, vai a fare clic su Build a Database pulsante e fare clic per creare un database:

Successivamente, crea un Cluster condiviso (è gratuito per sempre!) e dagli un nome a tua scelta.

Il cluster condiviso è ideale per sperimentare in un sandbox limitato. Puoi passare a un cluster di produzione in qualsiasi momento.

Una volta creato con successo un cluster, fare clic su Connect pulsante per connettersi al Cluster:

Ora ti vengono mostrati quattro modi diversi su come connetterti a MongoDB, ma poiché desideriamo connetterci a un'applicazione Node, scegliamo il Connect your application opzione:

Ti verrà quindi richiesto di scegliere un metodo di connessione. Qui, assicurati di selezionare Node.js come driver e scegli una versione appropriata (sto utilizzando la 4.1 o successiva mentre scrivo questo articolo).

Ci viene mostrata anche una stringa di connessione utile per connettere il nostro cluster MongoDB ad un'applicazione Node:

Ora dobbiamo creare un'applicazione Node.js per connetterci al database MongoDB.

Creazione dell'applicazione del nodo

Nella directory preferita per questo progetto, crea una nuova cartella:

$ mkdir integrating-mongodb-node

Allora, corri npm init nel terminale, per inizializzare un'applicazione Node con a package.json file che ci consente di tenere traccia delle dipendenze dell'applicazione:

$ npm init

package name: (codes) integrating-mongodb-node
version: (1.0.0)
description: learning how to connect mongodb to a node app
entry point: (server.js)
test command:
git repository:
keywords:
author:
Is this OK? (yes) yes

Ora che abbiamo inizializzato con successo package.json, procediamo con l'installazione di due pacchetti che ci saranno utili nella realizzazione del nostro server. Il primo è Express.js, che è un framework web per lo sviluppo semplice e veloce di applicazioni Node:

$ yarn add express -D

Il secondo pacchetto che installeremo è il pacchetto Mongoose, che ci aiuterebbe a creare uno schema appropriato per il nostro database nell'app Node:

$ yarn add mongoose -D

Con le dipendenze di sviluppo richieste ora installate correttamente, ora possiamo scrivere il codice per connettere il nostro database MongoDB alla nostra applicazione Node.

Nella directory che abbiamo appena creato per il progetto, crea un file server.js filetto

$ touch server.js

Successivamente, definiamo la configurazione di base per l'applicazione Node in server.js, creando un semplice server express.

const express = require("express");
const mongoose = require("mongoose");
const app = express();

const port = 8000;

app.listen(port, () => {
  console.log(`Server started at port ${port}`);
});

Possiamo confermare che il nostro server funziona come dovrebbe, eseguendo il seguente codice nel terminale.

$ node server.js

Che dovrebbe comportare:

Server started at port 8000

Ora puoi tornare alla dashboard di MongoDB per copiare l'URI (Uniform Resource Idenfier) ​​per connettere l'app Node al database.

I server.js creare una variabile per memorizzare l'identificatore uniforme della risorsa e sostituirla nell'URI con la password del tuo account MongoDB.

const express = require("express");
const mongoose = require("mongoose");
const app = express();

const uri =
  "mongodb+srv://UcheAzubuko:@stackabusecluster.fgavg5s.mongodb.net/?retryWrites=true&w=majority";

const port = 8000;

app.listen(port, () => {
  console.log(`Server started at port ${port}`);
});

Successivamente, creiamo una funzione asincrona per consentirci di connetterci a MongoDB, perché non sappiamo quanto tempo potrebbe richiedere il completamento della funzione prima di connetterci al database:

const express = require("express");
const mongoose = require("mongoose");
const app = express();

const uri =
  "mongodb+srv://UcheAzubuko:@stackabusecluster.fgavg5s.mongodb.net/?retryWrites=true&w=majority";
async function connect() {
  try {
    await mongoose.connect(uri);
    console.log("Connected to MongoDB");
  } catch (error) {
    console.log(error);
  }
}
connect();

const port = 8000;
app.listen(port, () => {
  console.log(`Server started at port ${port}`);
});

Abbiamo creato una funzione asincrona che registra a Connected to MongoDB messaggio quando una connessione è stata stabilita con successo tra MongoDB e l'app Node e registra eventuali errori se si verifica un errore.

Ora dovremmo riavviare il server:

$ node server.js

E ricevi un messaggio di successo che ci informa che ora è stata stabilita una connessione sicura tra il database MongoDB e l'applicazione Node:

Server started at port 8000
Connected to MongoDB

A questo punto, quando torni alla dashboard del cluster di progetto, vedrai le informazioni che mostrano che di recente c'è stata una connessione al database:

Va bene gente, è così! Abbiamo integrato con successo un database MongoDB all'interno di un'applicazione Node.js.

Conclusione

In questo articolo abbiamo imparato come creare una connessione sicura tra un'applicazione Node.js e un database MongoDB. Ora puoi facilmente fare lo stesso quando devi creare un'applicazione utilizzando MongoDB; un database non relazionale molto popolare nell'ecosistema.

Non dimenticare che il Documentazione MongoDB è il tuo migliore amico per conoscere MongoDB e per saperne di più sulla creazione di applicazioni Express, contatta il Documentazione espressa troppo.

Se rimani bloccato mentre segui il tutorial, sentiti libero di riflettere repository GitHub per il progetto per trovare la tua strada.

Risorse addizionali