Un guide sur les requêtes POST avec Express et NodeJS

Les applications web modernes reposent sur l'échange de données entre les utilisateurs et les serveurs. C'est ce qui fait fonctionner les interactions web. Heureusement, les développeurs NodeJS peuvent utiliser ExpressJS pour gérer facilement cette communication.

L'expression "NodeJS Express POST Requests" contient quelques termes importants. Sans les comprendre individuellement, vous risquez de vous embrouiller facilement, alors séparons-les.

Qu'est-ce que NodeJS ?

NodeJS est un environnement d'exécution open-source et multiplateforme spécialement conçu pour exécuter du code JavaScript en dehors du contexte traditionnel du navigateur web. Ce document fournit une exploration complète de NodeJS, en approfondissant ses fonctionnalités de base et le changement de paradigme qu'il a introduit dans le paysage du développement logiciel.

Principales caractéristiques de NodeJS

Asynchrone et basé sur les événements

NodeJS utilise un seul thread, mais ne vous laissez pas berner par la simplicité. Il utilise une approche astucieuse appelée architecture basée sur les événements. Cela signifie que NodeJS jongle efficacement avec plusieurs requêtes comme un serveur gérant un restaurant bondé. Lorsqu'une requête arrive, elle est enregistrée comme un événement. NodeJS suit ensuite ces événements et déclenche des fonctions (callbacks) pour les traiter dès qu'ils sont prêts. Cette nature asynchrone permet à NodeJS d'exceller dans la gestion des tâches qui impliquent de l'attente, comme les requêtes réseau, sans ralentir l'ensemble du système.

JavaScript sur le serveur

Traditionnellement, le terrain de jeu de JavaScript était le navigateur web, où il rendait les pages web interactives. NodeJS brise cette barrière en établissant un environnement d'exécution robuste qui permet l'exécution du code JavaScript en dehors du navigateur - sur le serveur. Cette innovation change la donne pour les développeurs. Ils peuvent désormais exploiter leurs connaissances existantes en JavaScript pour le développement front-end (interface utilisateur) et back-end (logique côté serveur), ce qui simplifie l'ensemble du processus.

NPM

NPM, une fonctionnalité intégrée de NodeJS, agit comme un référentiel central hébergeant une vaste collection de modules et de bibliothèques de code pré-construits. Les développeurs peuvent utiliser NPM pour rechercher des fonctionnalités spécifiques dont ils ont besoin, les télécharger facilement et les intégrer dans leurs applications. Cet écosystème de bibliothèques étendu accélère considérablement le développement et permet aux développeurs d'incorporer un large éventail de fonctionnalités sans partir de zéro.

Évolutivité à un seul thread avec E/S non bloquantes

Bien que NodeJS utilise un seul thread, il atteint une évolutivité impressionnante grâce à une technique appelée E/S non bloquantes. Cela signifie que NodeJS n'attend pas que les tâches lentes (comme les requêtes réseau) se terminent avant de traiter d'autres requêtes. Au lieu de cela, il passe intelligemment à la requête suivante tout en gardant une trace de l'opération d'E/S en attente. Une fois la tâche lente terminée, NodeJS revient en arrière et gère la réponse.

Muscle HTTP intégré

NodeJS est pré-équipé de tous les outils nécessaires à la création de serveurs web. Les modules HTTP intégrés simplifient le processus de développement en permettant aux développeurs de créer des serveurs HTTP robustes et de gérer facilement diverses méthodes HTTP (GET, POST, PUT, DELETE).

Communauté open-source florissante

NodeJS bénéficie d'une communauté open-source large et active. Cela se traduit par une multitude de ressources facilement disponibles pour les développeurs. Une documentation complète, des tutoriels et des forums ne sont que quelques exemples du soutien offert par la communauté. De plus, la nature open-source permet à quiconque de contribuer à la croissance du projet et de bénéficier des connaissances et de l'expertise collectives de la communauté.

Qu'est-ce qu'Express ?

Express, également connu sous le nom de ExpressJS, est un framework d'application web de premier plan construit sur la base de NodeJS. Il sert de puissante couche d'abstraction, offrant un niveau de développement supérieur à celui des capacités brutes de NodeJS. Cette abstraction se traduit par une réduction significative du code passe-partout, ce qui accélère le processus de développement des applications web et des API.

Principales caractéristiques d'ExpressJS

Développement simplifié avec des abstractions

NodeJS offre une plate-forme puissante pour l'exécution de JavaScript côté serveur, mais cela peut impliquer d'écrire du code de bas niveau pour les fonctionnalités courantes des applications web. ExpressJS agit comme une couche d'abstraction, fournissant des fonctionnalités et des structures pré-construites qui simplifient le développement. Cela se traduit par moins de code passe-partout et une concentration sur la logique de base de votre application.

Système de routage élégant

ExpressJS possède un système de routage robuste qui permet aux développeurs de définir des routes à l'aide de méthodes claires et concises. Vous pouvez définir des routes pour différentes URL (par exemple, "/produits", "/à-propos-de-nous") et les associer à des fonctions spécifiques (gestionnaires) qui gèrent la requête de l'utilisateur pour cette page particulière. Cette séparation claire des préoccupations favorise l'organisation et la maintenabilité du code.

Fonctionnalité modulaire avec middleware

Middleware est un concept puissant qui permet aux développeurs de définir des fonctions qui agissent comme des intermédiaires entre les requêtes entrantes et les réponses sortantes. Chaque fonction middleware peut effectuer des tâches spécifiques comme la journalisation des requêtes, l'analyse des données du corps de la requête (par exemple, les données de formulaire, JSON) ou la mise en œuvre de contrôles d'authentification. Les fonctions middleware sont enchaînées et les requêtes passent par cette chaîne, ce qui permet une fonctionnalité modulaire et réutilisable dans votre application.

Contenu dynamique avec le moteur de modèles

Les applications web nécessitent souvent la génération de contenu dynamique basé sur les entrées de l'utilisateur ou la récupération de données. ExpressJS s'intègre de manière transparente avec divers moteurs de modèles comme Pug (anciennement Jade) ou EJS (Embedded JavaScript). Ces moteurs fournissent aux développeurs un moyen de définir des modèles qui agissent comme des plans pour les pages HTML. Les modèles peuvent contenir des espaces réservés pour le contenu dynamique. Au moment de l'exécution, ExpressJS remplit ces espaces réservés avec les données de votre application, générant le contenu HTML final qui est livré au navigateur de l'utilisateur.

Utilitaires HTTP intégrés

ExpressJS exploite les modules HTTP intégrés fournis avec Node.js. Cette héritage permet aux développeurs de créer facilement des serveurs web, de gérer les requêtes et les réponses HTTP et de gérer facilement diverses méthodes HTTP (GET, POST, PUT, DELETE). Vous n'avez pas besoin d'écrire du code complexe à partir de zéro pour configurer les fonctionnalités de base du serveur.

Écosystème étendu de bibliothèques tierces

Tout comme Node.js prospère avec NPM (Node Package Manager), ExpressJS bénéficie d'un vaste écosystème de bibliothèques et d'outils tiers. Ces modules pré-construits peuvent être facilement intégrés dans votre application ExpressJS, en étendant ses fonctionnalités et en ajoutant des fonctionnalités telles que l'authentification des utilisateurs, les interactions avec les bases de données, les téléchargements de fichiers ou la messagerie en temps réel.

Comment faire des requêtes POST NodeJS Express ?

Cette section vous guidera sur la façon de commencer à faire des requêtes POST avec NodeJS Express !

Conditions préalables

Tout d'abord, vous devez vous assurer que NodeJS et npm (Node Package Manager) sont installés sur votre système. Vous pouvez vérifier leur installation en exécutant node -v et npm -v dans votre terminal.

• Créer un répertoire de projet : Créez un nouveau répertoire pour votre projet à l'aide de votre terminal. Accédez à l'emplacement souhaité et exécutez mkdir my-express-app pour créer le répertoire.
• Initialiser le projet : À l'intérieur du répertoire nouvellement créé, initialisez un nouveau projet à l'aide de npm en exécutant npm init -y. Cela créera un fichier package.json pour votre projet.

Étape 1 - Installer ExpressJS

Maintenant que votre projet est configuré, installons ExpressJS. Dans votre terminal, dans le répertoire du projet, exécutez la ligne de code suivante. Cela téléchargera et installera ExpressJS en tant que dépendance pour votre projet.

npm install express

Étape 2 - Créer un fichier serveur

Créez un nouveau fichier JavaScript nommé server.js dans votre répertoire de projet. Il contiendra le code de votre serveur Express.

Étape 3 - Importer Express et définir l'application

Ouvrez votre fichier server.js dans votre éditeur de code et incluez la ligne de code suivante :

const express = require('express');

Ensuite, créez une instance d'application Express :

const app = express();

Étape 4 - Définir la route et gérer les requêtes POST :

Utilisez la méthode app.post pour spécifier le chemin de l'URL et la fonction qui gérera la requête :

app.post('/your-endpoint', (req, res) -> {
	// Handle POST request logic here
});

Lors de la mise en œuvre des extraits de code, assurez-vous de remplacer /your-endpoint par le chemin d'URL réel où vous avez l'intention de recevoir les requêtes POST.

Les fonctions passées à app.post prennent deux arguments :

• req : L'objet de requête qui contient des informations sur la requête entrante, y compris les données envoyées dans le corps.
• res : L'objet de réponse que vous pouvez utiliser pour renvoyer une réponse au client.

Étape 5 - Accéder aux données POST

À l'intérieur de la fonction gérant la requête POST, vous pouvez accéder aux données envoyées dans le corps de la requête à l'aide de l'objet req.body - il s'agit d'un objet JavaScript contenant les paires clé-valeur des données envoyées dans le corps de la requête.

app.post('/your-endpoint', (req, res) => {
    const name = req.body.name; // Assuming data has a key 'name'
    const message = req.body.message; // Assuming data has a key 'message'
    // Process the data here (e.g., store in database, send an email)
    res.send('POST request received successfully!');
});

Étape 6 - Envoi d'une réponse

Après avoir traité les données de la requête POST, vous pouvez renvoyer une réponse au client à l'aide de l'objet res.

app.post('/your-endpoint', (req, res) => {
    // ... (process data)
    res.send('POST request received successfully!');  // Send a simple message
    // OR
    res.json({ message: 'Data received and processed successfully!' });  // Send JSON data
});

Étape 7 - Démarrer le serveur

Enfin, démarrez le serveur en écoutant un port spécifique à l'aide de la méthode app.listen. Habituellement, le numéro de port utilisé pour le développement est 3000, comme indiqué dans l'exemple de code ci-dessous :

app.listen(3000, () => {
    console.log('Server listening on port 3000!');
});

Apidog - Accélérer les requêtes GET Express avec la génération de code

Accélérez le développement d'API et d'applications en envisageant d'utiliser Apidog, une plate-forme de développement d'API complète qui dispose d'une fonctionnalité de génération de code pour le langage de programmation JavaScript.

Jetons un coup d'œil à la façon dont vous pouvez générer du code client JavaScript en quelques clics.

Générez rapidement du code JavaScript pour votre application avec Apidog

Cette section mettra en évidence comment vous pouvez générer du code JavaScript (ou d'autres langages de programmation disponibles) pour votre application.

Tout d'abord, recherchez le bouton </> situé dans le coin supérieur droit de l'écran. Si vous avez du mal à localiser le bouton, vous pouvez vous référer à l'image ci-dessus.

Passez ensuite à la sélection du langage de programmation côté client dont vous avez besoin. Vous avez le pouvoir de choisir la bibliothèque JavaScript avec laquelle vous êtes le plus à l'aise.

Il vous suffit de copier et de coller le code dans votre IDE et de continuer à l'éditer pour vous assurer qu'il correspond à votre application NodeJS ! Cependant, si vous souhaitez utiliser Unirest comme indiqué dans l'image ci-dessus, vous pouvez vous référer à l'article ici :

Testez les API avec Apidog

Apidog fournit aux développeurs une interface utilisateur confortable mais magnifique pour le débogage des API.

Fournissez le point de terminaison de l'API dans la barre mise en évidence par la flèche dans l'image ci-dessus.

Si vous n'êtes pas sûr d'utiliser plusieurs paramètres dans une URL, cet article peut vous guider sur la façon d'atteindre la ressource exacte dans des ensembles de données plus volumineux !

Une fois que vous êtes sûr de votre API, vous pouvez cliquer sur Envoyer, ce qui envoie la requête à l'API. Vous devriez vous attendre à une réponse complète. Un coup d'œil au code d'état vous indique si cela a réussi. Vous pouvez également examiner la réponse brute, qui montre la structure exacte des données dont votre code a besoin pour comprendre les informations des serveurs de l'API.

Conclusion

NodeJS et Express offrent une combinaison puissante pour la création d'applications web modernes qui interagissent avec les données. En tirant parti du système de routage et des capacités de middleware d'Express, les développeurs peuvent gérer efficacement les requêtes POST, le cheval de bataille des soumissions de formulaires et de l'échange de données sur le web. Avec des outils comme body-parser pour l'analyse des corps de requêtes, l'accès et le traitement des données deviennent simples.

Cela permet aux développeurs de créer des applications capables de collecter les entrées des utilisateurs, de stocker des données dans des bases de données ou de déclencher des actions en fonction des informations reçues. La facilité d'utilisation et la flexibilité offertes par NodeJS et Express en font un choix incontournable pour les développeurs qui cherchent à créer des applications web dynamiques et axées sur les données.