Quickstarters

Comment construire une application CRUD avec ReactJS ?

43min

Introduction

Dans ce tutoriel, vous allez créer une application CRUD complète (créer, lire, mettre à jour et supprimer) en utilisant ReactJS.

Ce guide est conçu pour effectuer les opérations de base d'une application logicielle en démontrant comment construire des applications CRUD qui gèrent et mettent à jour efficacement les données.

Vous commencerez par créer et configurer un projet Back4app nommé Basic-CRUD-App-ReactJS, qui sert de système backend robuste pour votre application web.

Ensuite, vous concevrez un schéma de base de données évolutif en définissant des collections et des champs détaillés—soit manuellement, soit avec l'aide de l'Agent IA de Back4app.

Puis, vous utiliserez l'Application Admin de Back4app—un outil de gestion convivial avec une interface de glisser-déposer—pour gérer facilement vos collections de données.

Cette interface d'administration améliore l'expérience utilisateur et simplifie l'interface utilisateur, permettant aux utilisateurs d'effectuer rapidement des opérations CRUD.

Enfin, vous déploierez votre frontend ReactJS et l'intégrerez avec Back4app en utilisant REST/GraphQL (ou le SDK Parse, lorsque disponible), tout en sécurisant votre backend avec des contrôles d'accès avancés.

À la fin de ce guide, vous aurez construit une application web prête pour la production qui non seulement prend en charge les opérations CRUD de base, mais inclut également l'authentification des utilisateurs et des capacités robustes de mise à jour des données.

Points clés à retenir

  • Apprenez à construire des applications CRUD qui gèrent efficacement les données à l'aide d'un système de gestion de base de données fiable.
  • Obtenez des informations pratiques sur la conception d'un backend évolutif et son intégration avec un frontend ReactJS pour améliorer l'expérience utilisateur.
  • Découvrez comment utiliser un outil de gestion par glisser-déposer (l'application Back4app Admin) pour simplifier les opérations de création, de lecture, de mise à jour et de suppression.
  • Comprenez les techniques de déploiement, y compris la conteneurisation Docker, pour lancer rapidement votre application web.


Prérequis

Avant de commencer, assurez-vous d'avoir ce qui suit :

  • Un compte Back4app et un nouveau projet configuré. Si vous avez besoin d'aide, consultez Démarrer avec Back4app.
  • Un environnement de développement ReactJS. Utilisez Create React App ou un outil similaire. Assurez-vous que Node.js (version 14 ou supérieure) est installé.
  • Compréhension de base de JavaScript, ReactJS et des API REST. Consultez la documentation ReactJS si nécessaire.


Étape 1 – Configuration du projet

Créer un nouveau projet Back4app

  1. Connectez-vous à votre compte Back4app.
  2. Cliquez sur le bouton “Nouvelle application” dans votre tableau de bord.
  3. Entrez le nom du projet : Basic-CRUD-App-ReactJS et suivez les instructions pour créer votre projet.
Créer un nouveau projet
Créer un nouveau projet


Une fois créé, votre nouveau projet apparaîtra sur votre tableau de bord Back4app, fournissant une base solide pour votre configuration backend et la gestion de votre projet.



Étape 2 – Conception du schéma de base de données

Conception de votre modèle de données

Pour l'application CRUD de base, vous allez créer plusieurs collections.

Voici quelques exemples des collections dont vous aurez besoin, décrivant les champs nécessaires et les types de données pour vous aider à configurer efficacement le schéma de votre base de données.

Ces collections sont conçues pour effectuer les opérations CRUD fondamentales qui permettent aux utilisateurs de créer, lire, mettre à jour et supprimer des données.

1. Collection d'articles

Cette collection stocke des informations sur chaque article.

Champ

Type de données

Description

_id

Identifiant d'objet

Clé primaire générée automatiquement.

titre

Chaîne

Le titre de l'élément.

description

Chaîne

Une brève description de l'article.

créé à

Date

Horodatage lorsque l'élément a été créé.

mis à jour le

Date

Horodatage de la dernière mise à jour de l'élément.

2. Collection des utilisateurs

Cette collection stocke les informations utilisateur et les détails d'authentification.

Champ

Type de données

Description

_id

Identifiant d'objet

Clé primaire générée automatiquement.

nom d'utilisateur

Chaîne

Nom d'utilisateur unique pour l'utilisateur.

email

Chaîne

Adresse e-mail unique.

hash_de_mot_de_passe

Chaîne

Mot de passe haché pour l'authentification.

créé à

Date

Horodatage de la création du compte utilisateur.

mis à jour le

Date

Horodatage de la mise à jour du compte utilisateur.

Vous pouvez configurer ces collections manuellement dans le tableau de bord Back4app en créant une nouvelle classe pour chaque collection et en ajoutant des colonnes pour définir les champs.

Créer une nouvelle classe
Créer une nouvelle classe


Vous pouvez facilement créer des champs pour votre base de données en sélectionnant un type de données, en nommant le champ, en définissant une valeur par défaut et en précisant s'il est requis.

Créer une colonne
Créer une colonne



Utiliser l'agent AI Back4app pour la génération de schémas

L'agent AI Back4app est un outil puissant disponible directement depuis votre tableau de bord Back4app.

Il vous permet de générer automatiquement le schéma de votre base de données en fonction d'un prompt qui décrit vos collections et champs souhaités.

Cette fonctionnalité permet de gagner un temps précieux pour la gestion de projet et aide à garantir que votre système de gestion de base de données est configuré pour effectuer les opérations de base requises par votre application web.

Comment utiliser l'agent IA :

  1. Ouvrez l'agent IA : Connectez-vous à votre tableau de bord Back4app et localisez l'agent IA dans le menu ou dans les paramètres de votre projet.
  2. Décrivez votre modèle de données : Dans l'interface de l'agent IA, collez un prompt détaillé qui décrit les collections et champs dont vous avez besoin.
  3. Examinez et appliquez : Une fois soumis, l'agent IA générera les collections et les définitions de champs. Examinez ces suggestions et appliquez-les à votre projet.

Exemple de prompt

Text


Utiliser l'agent IA de cette manière permet de gagner du temps et garantit que votre schéma est cohérent et optimisé pour les besoins de votre application.



Étape 3 – Activation de l'application Admin et opérations CRUD

Aperçu de l'application Admin

L'application Admin de Back4app est une interface puissante sans code qui vous permet de gérer vos données backend.

Cet outil de gestion fournit une interface utilisateur par glisser-déposer qui permet aux utilisateurs d'effectuer facilement des opérations CRUD telles que créer, lire, mettre à jour et supprimer des enregistrements.

Activation de l'application Admin

  1. Accédez au menu “Plus” dans votre tableau de bord Back4app.
  2. Cliquez sur “Admin App” puis sur “Activer l'application Admin.”
  3. Configurez vos identifiants administratifs en créant votre premier utilisateur admin. Ce processus configure également les rôles (par exemple, B4aAdminUser) et les collections système.
Activer l'application Admin
Activer l'application Admin


Après l'activation, connectez-vous à l'application Admin pour gérer vos données.

Tableau de bord de l'application Admin
Tableau de bord de l'application Admin


Utiliser l'application Admin pour les opérations CRUD

Dans l'application Admin, vous pouvez :

  • Créer des enregistrements : Cliquez sur le bouton “Ajouter un enregistrement” dans une collection (par exemple, Articles) pour créer de nouvelles entrées.
  • Lire/Mettre à jour des enregistrements : Sélectionnez un enregistrement pour voir ses détails ou modifier des champs, garantissant une mise à jour fluide des données.
  • Supprimer des enregistrements : Utilisez l'option de suppression pour retirer les enregistrements qui ne sont plus nécessaires. Cet outil de gestion facile à utiliser améliore l'expérience utilisateur globale en fournissant une interface simple de glisser-déposer pour les fonctions CRUD.


Étape 4 – Intégration de ReactJS avec Back4app

Maintenant que votre backend est configuré et géré via l'application Admin, il est temps de connecter votre frontend ReactJS à Back4app.

Option A : Utiliser le SDK Parse

  1. Installer le SDK Parse :

    Bash
    
  2. Initialiser Parse dans votre application React : Créer un fichier (par exemple, src/parseConfig.js) :

    JS
    
  3. Utiliser Parse dans un composant React : Par exemple, créez un composant pour récupérer et afficher des éléments :

    JS
    

Option B : Utiliser REST ou GraphQL

Si votre environnement ne prend pas en charge le SDK Parse, vous pouvez effectuer des opérations CRUD en utilisant REST ou GraphQL. Par exemple, pour récupérer des éléments en utilisant REST :

JS


Intégrez ces appels API dans vos composants React selon vos besoins.



Étape 5 – Sécuriser votre Backend

Listes de Contrôle d'Accès (ACLs)

Sécurisez vos données en attribuant des ACL aux objets. Par exemple, pour créer un élément privé :

JS


Permissions au Niveau de la Classe (CLPs)

Dans le tableau de bord Back4app, configurez les CLPs pour chaque collection afin de définir des règles d'accès par défaut. Cela garantit que seuls les utilisateurs authentifiés ou autorisés peuvent accéder aux données sensibles.



Étape 6 – Authentification des Utilisateurs

Configuration des Comptes Utilisateurs

Back4app utilise la classe User de Parse pour l'authentification. Dans votre application React, gérez l'inscription et la connexion des utilisateurs comme suit :

JS


Une approche similaire peut être utilisée pour la connexion et la gestion des sessions. Des fonctionnalités supplémentaires telles que les connexions sociales, la vérification des emails et la réinitialisation des mots de passe peuvent être configurées dans le tableau de bord de Back4app.



Étape 7 – Déployer votre frontend ReactJS avec le déploiement Web

La fonctionnalité de déploiement Web de Back4app vous permet d'héberger votre frontend ReactJS sans effort en déployant votre code depuis un dépôt GitHub.

Dans cette section, vous apprendrez à préparer votre build de production, à valider votre code source sur GitHub, à intégrer votre dépôt avec le déploiement Web et à déployer votre site.

7.1 Préparez votre build de production

  1. Ouvrez votre dossier de projet dans un terminal.
  2. Exécutez la commande de construction :

    Bash
    

    Cette commande crée un dossier de construction contenant tous les fichiers statiques optimisés (y compris index.html, JavaScript, CSS et images).

  3. Vérifiez la construction : Assurez-vous que le dossier de construction contient un fichier index.html ainsi que les sous-répertoires d'actifs nécessaires.


7.2 Organisez et téléchargez votre code source

Votre dépôt doit inclure l'intégralité du code source de votre frontend ReactJS. Une structure de fichiers typique pourrait ressembler à ceci :

Text


Exemples de fichiers de code source

src/parseConfig.js

JS


src/App.js

JS

  1. Ajoutez vos fichiers sources :

    Bash
    
  2. Engagez vos modifications :

    Bash
    
  3. Créez un dépôt GitHub : Par exemple, créez un dépôt nommé Basic-CRUD-App-ReactJS-Frontend sur GitHub.
  4. Poussez votre code sur GitHub :

    Bash
    


7.3 Intégrez votre dépôt GitHub avec le déploiement Web

  1. Accéder au déploiement Web : Connectez-vous à votre tableau de bord Back4app, naviguez vers votre projet (Basic-CRUD-App-ReactJS), et cliquez sur la fonctionnalité de déploiement Web.
  2. Connectez-vous à GitHub : Si vous ne l'avez pas encore fait, intégrez votre compte GitHub en suivant les instructions à l'écran. Cette connexion permet à Back4app d'accéder à votre dépôt.
  3. Sélectionnez votre dépôt et votre branche : Choisissez le dépôt que vous avez créé (par exemple, Basic-CRUD-App-ReactJS-Frontend) et sélectionnez la branche (par exemple, main) qui contient votre code ReactJS.


7.4 Configurez votre déploiement

Fournissez des détails de configuration supplémentaires :

  • Commande de construction : Si votre dépôt n'inclut pas de dossier de construction pré-construit, spécifiez la commande de construction (par exemple, npm run build). Back4app exécutera cette commande lors du déploiement.
  • Répertoire de sortie : Définissez le répertoire de sortie sur build afin que Back4app sache quel dossier contient vos fichiers de site statiques.
  • Variables d'environnement : Si votre application dépend de variables d'environnement (par exemple, des clés API), ajoutez-les dans les paramètres de configuration.


7.5 Dockerisez votre projet d'application ReactJS

Si vous préférez utiliser Docker pour le déploiement, vous pouvez containeriser votre application ReactJS. Incluez un Dockerfile dans votre dépôt avec un contenu similaire à ce qui suit :

Dockerfile


Incluez ce Dockerfile dans votre dépôt. Ensuite, dans votre configuration de déploiement Web, sélectionnez l'option de déploiement Docker pour construire et déployer votre application conteneurisée.



7.6 Déployez votre application

  1. Cliquez sur le bouton Déployer : Une fois que vous avez configuré les paramètres de déploiement, cliquez sur le Déployer bouton.
  2. Surveillez le processus de construction : Back4app récupérera votre code depuis GitHub, exécutera la commande de construction (si configurée) et déploiera votre application dans un conteneur.
  3. Obtenez votre URL : Après la fin du déploiement, Back4app fournira une URL où votre application ReactJS est hébergée.


7.7 Vérifiez votre déploiement

  1. Visitez l'URL fournie : Ouvrez l'URL dans votre navigateur web pour voir votre site déployé.
  2. Testez l'application : Vérifiez que votre application se charge correctement, que toutes les routes fonctionnent comme prévu et que tous les actifs (CSS, JavaScript, images) sont correctement servis.
  3. Déboguez si nécessaire : Utilisez les outils de développement de votre navigateur pour vérifier les erreurs. Si des problèmes surviennent, consultez les journaux de déploiement dans Back4app et vérifiez votre intégration GitHub et vos paramètres de construction.


Étape 8 – Conclusion et Prochaines Étapes

Félicitations ! Vous avez construit une application CRUD de base complète en utilisant ReactJS et Back4app.

Vous avez configuré un projet nommé Basic-CRUD-App-ReactJS, conçu des collections de base de données détaillées pour les Articles et les Utilisateurs, et géré vos données via la puissante Admin App.

Vous avez également intégré votre frontend ReactJS avec votre backend et sécurisé vos données avec des contrôles d'accès robustes.

Prochaines Étapes :

  • Améliorez Votre Frontend : Étendez votre application ReactJS avec des fonctionnalités telles que des vues détaillées des articles, une fonctionnalité de recherche et des notifications en temps réel.
  • Intégrez des Fonctionnalités Supplémentaires : Envisagez d'ajouter une logique backend plus avancée (par exemple, des fonctions Cloud), des intégrations d'API tierces ou des contrôles d'accès basés sur les rôles.
  • Explorez d'Autres Ressources : Consultez la documentation de Back4app et des tutoriels supplémentaires pour des plongées plus profondes dans l'optimisation des performances et les intégrations personnalisées.

En suivant ce tutoriel, vous avez maintenant les compétences nécessaires pour créer un backend CRUD robuste et évolutif pour votre application ReactJS en utilisant Back4app. Bon codage !