Comment construire un backend pour MeteorJS ?

introduction dans ce tutoriel, vous apprendrez à construire un backend complet pour une application meteorjs en utilisant back4app nous allons passer en revue l'intégration des fonctionnalités essentielles de back4app—telles que la gestion de base de données, les fonctions cloud code, les api rest et graphql, l'authentification des utilisateurs et les requêtes en temps réel (live queries)—pour créer un backend sécurisé, évolutif et robuste qui communique sans problème avec votre application meteorjs vous verrez également comment la configuration rapide et l'environnement intuitif de back4app peuvent réduire considérablement le temps et les efforts par rapport à la configuration manuelle des serveurs et des bases de données en cours de route, vous acquerrez une expérience pratique avec des fonctionnalités clés, y compris des fonctionnalités de sécurité avancées, la planification de tâches avec cloud jobs, et la configuration de webhooks pour des intégrations externes à la fin de ce tutoriel, vous serez bien préparé à améliorer cette configuration de base en une application prête pour la production, ou à incorporer facilement une logique personnalisée et des api tierces selon vos besoins conditions préalables pour compléter ce tutoriel, vous aurez besoin de un compte back4app et un nouveau projet back4app commencer avec back4app https //www back4app com/docs/get started/new parse app si vous n'avez pas de compte, vous pouvez en créer un gratuitement suivez le guide ci dessus pour préparer votre projet environnement de développement meteorjs de base assurez vous d'avoir meteor installé si ce n'est pas le cas, suivez le guide d'installation de meteor https //docs meteor com/install html node js (version 14 ou supérieure) installé vous aurez besoin de node js pour exécuter des serveurs de développement locaux installer node js https //nodejs org/en/download/ familiarité avec javascript et concepts de base de meteorjs documentation officielle de meteorjs https //docs meteor com/ si vous êtes nouveau sur meteor, consultez la documentation officielle ou un tutoriel pour débutants avant de commencer assurez vous d'avoir toutes ces conditions préalables en place avant de commencer avoir votre projet back4app configuré et votre environnement local meteorjs prêt vous aidera à suivre plus facilement étape 1 – configuration du projet back4app créer un nouveau projet la première étape pour construire votre backend meteorjs sur back4app est de créer un nouveau projet si vous ne l'avez pas encore fait, suivez ces étapes connectez vous à votre compte back4app cliquez sur le bouton “nouvelle application” dans votre tableau de bord back4app donnez un nom à votre application (par exemple, “meteor backend tutorial”) une fois le projet créé, vous le verrez listé dans votre tableau de bord back4app ce projet sera la base de toutes les configurations backend discutées dans ce tutoriel connectez le sdk parse back4app s'appuie sur la plateforme parse pour gérer vos données, fournir des fonctionnalités en temps réel, gérer l'authentification des utilisateurs, et plus encore connecter votre application meteorjs à back4app implique d'installer le package npm parse et de l'initialiser avec les identifiants de votre tableau de bord back4app récupérez vos clés parse dans votre tableau de bord back4app, accédez à la section “paramètres de l'application” ou “sécurité & clés” de votre application pour trouver votre id d'application et clé javascript vous trouverez également l' url du serveur parse (souvent au format https //parseapi back4app com ) installez le sdk parse dans votre projet meteorjs meteor npm install parse initialisez parse dans votre application meteorjs vous pouvez créer un fichier de démarrage ou un fichier de configuration (par exemple, parseconfig js ) dans un dossier que meteor charge tôt (tel que imports/ ou client/compatibility/ ) une option consiste à placer ce code dans imports/startup/client/parseconfig js ou un chemin similaire pertinent imports/startup/client/parseconfig js import parse from 'parse'; // replace the placeholders with your back4app credentials parse initialize('your application id', 'your javascript key'); parse serverurl = 'https //parseapi back4app com'; export default parse; ce fichier garantit que chaque fois que vous importez parse ailleurs dans votre application meteor, il est préconfiguré pour se connecter à votre instance back4app spécifique en complétant cette étape, vous avez établi une connexion sécurisée entre votre front end meteorjs (et/ou serveur) et le backend back4app toutes les demandes et transactions de données sont acheminées en toute sécurité via ce sdk, réduisant la complexité des appels rest ou graphql manuels (bien que vous puissiez toujours les utiliser si nécessaire) étape 2 – configuration de la base de données sauvegarde et requête de données avec votre projet back4app configuré et le sdk parse intégré dans votre application meteor, vous pouvez maintenant commencer à sauvegarder et à récupérer des données la manière la plus simple de créer un enregistrement est d'utiliser la classe parse object // example create a todo item import parse from '/imports/startup/client/parseconfig js'; async function createtodoitem(title, iscompleted) { const todo = parse object extend('todo'); const todo = new todo(); todo set('title', title); todo set('iscompleted', iscompleted); try { const savedtodo = await todo save(); console log('todo saved successfully ', savedtodo); return savedtodo; } catch (error) { console error('error saving todo ', error); } } // example query all todo items async function fetchtodos() { const todo = parse object extend('todo'); const query = new parse query(todo); try { const results = await query find(); console log('fetched todo items ', results); return results; } catch (error) { console error('error fetching todos ', error); } } alternativement, vous pouvez utiliser les points de terminaison de l'api rest de back4app curl x post \\ h "x parse application id your application id" \\ h "x parse rest api key your rest api key" \\ h "content type application/json" \\ d '{"title" "buy groceries", "iscompleted" false}' \\ https //parseapi back4app com/classes/todo back4app fournit également une interface graphql mutation { createtodo(input { fields { title "clean the house" iscompleted false } }) { todo { objectid title iscompleted } } } ces options diverses vous permettent d'intégrer des opérations de données de la manière qui convient le mieux à votre processus de développement, que ce soit via le sdk parse, rest ou graphql conception de schéma et types de données par défaut, parse permet la création de schéma à la volée , mais vous pouvez également définir vos classes et types de données dans le tableau de bord back4app pour plus de contrôle accédez à la section “base de données” dans votre tableau de bord back4app créez une nouvelle classe (par exemple, “todo”) et ajoutez des colonnes pertinentes, telles que titre (string) et iscompleted (boolean) back4app prend également en charge divers types de données string , number , boolean , object , date , file , pointer , array , relation , geopoint , et polygon vous pouvez choisir le type approprié pour chaque champ si vous le souhaitez, vous pouvez également laisser parse créer automatiquement ces colonnes lorsque vous enregistrez pour la première fois un objet depuis votre application meteor back4app propose un agent ia qui peut vous aider à concevoir votre modèle de données ouvrez l'agent ia depuis votre tableau de bord d'application ou dans le menu décrivez votre modèle de données dans un langage simple (par exemple, “veuillez créer une nouvelle application todo sur back4app avec un schéma de classe complet ”) laissez l'agent ia créer le schéma pour vous utiliser l'agent ia peut vous faire gagner du temps lors de la configuration de votre architecture de données et garantir la cohérence de votre application données relationnelles si vous avez des données relationnelles—disons, un objet catégorie qui pointe vers plusieurs éléments todo —vous pouvez utiliser pointeurs ou relations dans parse par exemple, ajouter un pointeur à une catégorie // linking a task to a category with a pointer async function createtaskforcategory(categoryobjectid, title) { const todo = new parse object('todo'); // construct a pointer to the category const categorypointer = new parse object('category'); categorypointer id = categoryobjectid; // set fields todo set('title', title); todo set('category', categorypointer); try { return await todo save(); } catch (err) { console error('error creating task with category relationship ', err); } } lorsque vous interrogez, vous pouvez également inclure des données de pointeur const query = new parse query('todo'); query include('category'); const todoswithcategory = await query find(); cet include('category') appel récupère les détails de la catégorie avec chaque todo, rendant vos données relationnelles facilement accessibles requêtes en direct pour des mises à jour en temps réel, back4app fournit des requêtes en direct dans votre application meteorjs, vous pouvez vous abonner aux changements dans une classe spécifique activer les requêtes en direct dans votre tableau de bord back4app sous les paramètres du serveur assurez vous que les “requêtes en direct” sont activées initialiser une souscription de requête en direct dans votre code imports/startup/client/parseconfig js import parse from 'parse'; // replace the placeholders with your back4app credentials parse initialize('your application id', 'your javascript key'); parse serverurl = 'https //parseapi back4app com'; // live query's subdomain parse livequeryserverurl = 'wss\ //your subdomain here b4a io'; export default parse; import parse from '/imports/startup/client/parseconfig js'; async function subscribetotodos(callback) { const query = new parse query('todo'); const subscription = await query subscribe(); subscription on('create', (newtodo) => { console log('new todo created ', newtodo); callback('create', newtodo); }); subscription on('update', (updatedtodo) => { console log('todo updated ', updatedtodo); callback('update', updatedtodo); }); subscription on('delete', (deletedtodo) => { console log('todo deleted ', deletedtodo); callback('delete', deletedtodo); }); return subscription; } en vous abonnant, vous recevez des notifications en temps réel chaque fois qu'une nouvelle todo est créée, mise à jour ou supprimée cette fonctionnalité est particulièrement précieuse pour les applications collaboratives ou dynamiques où plusieurs utilisateurs doivent voir les dernières données sans actualiser la page étape 3 – application de la sécurité avec les acl et les clp mécanisme de sécurité back4app back4app prend la sécurité au sérieux en fournissant listes de contrôle d'accès (acl) et permissions au niveau de la classe (clp) ces fonctionnalités vous permettent de restreindre qui peut lire ou écrire des données sur une base par objet ou par classe, garantissant que seuls les utilisateurs autorisés peuvent modifier vos données listes de contrôle d'accès (acl) une acl est appliquée à des objets individuels pour déterminer quels utilisateurs, rôles ou le public peuvent effectuer des opérations de lecture/écriture par exemple async function createprivatetodo(title, owneruser) { const todo = parse object extend('todo'); const todo = new todo(); todo set('title', title); // create an acl granting read/write access only to the owner const acl = new parse acl(owneruser); acl setpublicreadaccess(false); acl setpublicwriteaccess(false); todo setacl(acl); try { return await todo save(); } catch (err) { console error('error saving private todo ', err); } } listes de contrôle d'accès (acl) lorsque vous enregistrez l'objet, il a un acl qui empêche quiconque, sauf l'utilisateur spécifié, de le lire ou de le modifier permissions au niveau de la classe (clp) les clp régissent les permissions par défaut d'une classe entière, telles que si la classe est lisible ou modifiable publiquement, ou si seules certains rôles peuvent y accéder allez sur votre tableau de bord back4app , sélectionnez votre application et ouvrez la base de données section sélectionnez une classe (par exemple, “todo”) ouvrez l'onglet des permissions au niveau de la classe configurez vos paramètres par défaut, tels que “nécessite une authentification” pour la lecture ou l'écriture, ou “aucun accès” pour le public ces permissions établissent la base, tandis que les acl affinent les permissions pour des objets individuels un modèle de sécurité robuste combine généralement à la fois les clp (restrictions larges) et les acl (restrictions fines par objet) pour plus d'informations, allez à directives de sécurité de l'application étape 4 – écriture et déploiement des fonctions cloud le code cloud est une fonctionnalité de l'environnement parse server qui vous permet d'exécuter du code javascript personnalisé côté serveur—sans avoir besoin de gérer vos serveurs ou votre infrastructure en écrivant du code cloud, vous pouvez étendre votre backend back4app avec une logique métier supplémentaire, des validations, des déclencheurs et des intégrations qui s'exécutent de manière sécurisée et efficace sur le serveur parse comment ça fonctionne lorsque vous écrivez du code cloud, vous placez généralement vos fonctions javascript, déclencheurs et tous les modules npm requis dans un fichier main js (ou app js ) ce fichier est ensuite déployé sur votre projet back4app, qui s'exécute dans l'environnement parse server étant donné que ces fonctions et déclencheurs s'exécutent sur le serveur, vous pouvez leur faire confiance pour gérer une logique confidentielle, traiter des données sensibles ou effectuer des appels api réservés au backend—des processus que vous ne voudriez peut être pas exposer directement au client tout le code cloud pour votre application back4app s'exécute à l'intérieur du serveur parse géré par back4app, donc vous n'avez pas à vous soucier de la maintenance du serveur, de la mise à l'échelle ou de l'approvisionnement chaque fois que vous mettez à jour et déployez votre fichier main js, le serveur parse en cours d'exécution est mis à jour avec votre dernier code structure du fichier main js un main js typique pourrait contenir cas d'utilisation typiques logique métier par exemple, vous pouvez calculer le score d'un utilisateur dans un jeu en agrégeant plusieurs propriétés d'objet, puis stocker ces données automatiquement validations de données assurez vous que certains champs sont présents ou qu'un utilisateur a les bonnes autorisations avant de sauvegarder ou de supprimer un enregistrement déclencheurs effectuez des actions lorsque les données changent (par exemple, envoyez une notification lorsqu'un utilisateur met à jour son profil) intégrations connectez vous à des api ou services tiers par exemple, vous pourriez vous intégrer à des passerelles de paiement, des notifications slack ou des plateformes de marketing par e mail directement depuis cloud code application de la sécurité ajoutez une couche de sécurité supplémentaire en validant et en nettoyant les paramètres d'entrée dans vos fonctions cloud code déployez votre fonction voici une fonction cloud code simple qui calcule la longueur d'une chaîne de texte envoyée par le client main js // main js parse cloud define('calculatetextlength', async (request) => { const { text } = request params; if (!text) { throw new error('no text provided'); } return { length text length }; }); déployer via le back4app cli 1 installer le cli pour linux/macos curl https //raw\ githubusercontent com/back4app/parse cli/back4app/installer sh | sudo /bin/bash pour windows téléchargez le b4a exe fichier depuis la page des versions https //github com/back4app/parse cli/releases 2 configurez votre clé de compte b4a configure accountkey 3 déployez votre code cloud b4a deploy déployer via le tableau de bord dans le tableau de bord de votre application, allez à cloud code > fonctions copiez/collez la fonction dans l'éditeur main js cliquez sur déployer appel de votre fonction depuis meteorjs en utilisant le sdk parse (par exemple, dans une méthode client ou après une action utilisateur) import parse from '/imports/startup/client/parseconfig js'; async function gettextlength(text) { try { const result = await parse cloud run('calculatetextlength', { text }); console log('text length ', result length); } catch (err) { console error('error calling cloud function ', err); } } vous pouvez également l'appeler via rest curl x post \\ h "x parse application id your app id" \\ h "x parse rest api key your rest api key" \\ h "content type application/json" \\ d '{"text" "hello back4app"}' \\ https //parseapi back4app com/functions/calculatetextlength ou via graphql mutation { calculatetextlength(input { text "hello graphql" }) { result } } cette flexibilité vous permet d'intégrer votre logique personnalisée dans votre application meteorjs ou tout autre client qui prend en charge rest ou graphql étape 5 – configuration de l'authentification des utilisateurs authentification des utilisateurs dans back4app back4app utilise la classe parse user comme base pour l'authentification par défaut, parse gère le hachage des mots de passe, les jetons de session et le stockage sécurisé cela signifie que vous n'avez pas à configurer manuellement des flux de sécurité complexes configuration de l'authentification des utilisateurs dans une application meteorjs, vous pouvez créer un nouvel utilisateur avec import parse from '/imports/startup/client/parseconfig js'; async function signupuser(username, password, email) { const user = new parse user(); user set('username', username); user set('password', password); user set('email', email); try { await user signup(); console log('user signed up successfully!'); } catch (error) { console error('error signing up user ', error); } } async function loginuser(username, password) { try { const user = await parse user login(username, password); console log('user logged in ', user); } catch (error) { console error('error logging in user ', error); } } via rest, une connexion pourrait ressembler à curl x get \\ h "x parse application id your app id" \\ h "x parse rest api key your rest api key" \\ g \\ \ data urlencode 'username=alice' \\ \ data urlencode 'password=secret123' \\ https //parseapi back4app com/login gestion des sessions après une connexion réussie, parse crée un jeton de session qui est stocké dans l'objet utilisateur dans votre application meteorjs, vous pouvez accéder à l'utilisateur actuellement connecté const currentuser = parse user current(); if (currentuser) { console log('currently logged in user ', currentuser getusername()); } else { console log('no user is logged in'); } parse gère automatiquement les sessions basées sur des jetons en arrière plan, mais vous pouvez également les gérer ou les révoquer manuellement cela est utile lorsque vous devez vous déconnecter await parse user logout(); intégration de la connexion sociale back4app et parse peuvent s'intégrer avec des fournisseurs oauth populaires, tels que google ou facebook , en installant des packages supplémentaires ou en utilisant des adaptateurs existants par exemple, vous pouvez configurer une connexion facebook en configurant votre id d'application facebook et en utilisant parse facebookutils login() les instructions détaillées varient, alors référez vous aux docs de connexion sociale https //www back4app com/docs/platform/sign in with apple const facebooklogin = async () => { try { const user = await parse facebookutils login('email'); console log(user existed() ? 'user logged in' 'user signed up and logged in'); } catch (error) { console error('error logging in with facebook ', error); } }; vérification par e mail et réinitialisation du mot de passe pour activer la vérification par e mail et la réinitialisation du mot de passe accédez aux paramètres d'e mail dans votre tableau de bord back4app activez la vérification par e mail pour garantir que les nouveaux utilisateurs vérifient la propriété de leurs adresses e mail configurez l'adresse d'expédition , les modèles d'e mail et votre domaine personnalisé si désiré ces fonctionnalités améliorent la sécurité des comptes et l'expérience utilisateur en validant la propriété des e mails par les utilisateurs et en fournissant une méthode de récupération de mot de passe sécurisée étape 6 – gestion du stockage de fichiers téléchargement et récupération de fichiers parse inclut la classe parse file pour gérer les téléchargements de fichiers, que back4app stocke de manière sécurisée import parse from '/imports/startup/client/parseconfig js'; async function uploadimage(file) { // file is typically from an \<input type="file" /> in a meteor template or react like ui const name = file name; const parsefile = new parse file(name, file); try { const savedfile = await parsefile save(); console log('file saved ', savedfile url()); return savedfile url(); } catch (err) { console error('error uploading file ', err); } } async function createphotoobject(file) { const photo = parse object extend('photo'); const photo = new photo(); const parsefile = new parse file(file name, file); photo set('imagefile', parsefile); return await photo save(); } récupérer l'url du fichier est simple const imagefile = photo get('imagefile'); const imageurl = imagefile url(); vous pouvez afficher cet imageurl dans vos modèles meteor ou composants front end en le définissant comme le src d'un \<img> tag sécurité des fichiers parse server fournit des configurations flexibles pour gérer la sécurité du téléchargement de fichiers l'exemple suivant montre comment vous pouvez définir des autorisations pour contrôler qui peut télécharger des fichiers sur le serveur enableforpublic lorsqu'il est défini sur true, permet à quiconque, quel que soit son statut d'authentification, de télécharger des fichiers enableforanonymoususer contrôle si les utilisateurs anonymes (non inscrits) peuvent télécharger des fichiers enableforauthenticateduser spécifie si seuls les utilisateurs authentifiés peuvent télécharger des fichiers étape 7 – planification des tâches avec cloud jobs cloud jobs cloud jobs dans back4app vous permettent de planifier et d'exécuter des tâches de routine sur votre backend, comme nettoyer les anciennes données ou envoyer un e mail récapitulatif quotidien un cloud job typique pourrait ressembler à ceci // main js parse cloud job('cleanupoldtodos', async (request) => { // this runs in the background, not triggered by a direct user request const todo = parse object extend('todo'); const query = new parse query(todo); // for example, remove todos older than 30 days const now = new date(); const thirty days = 30 24 60 60 1000; const cutoff = new date(now thirty days); query lessthan('createdat', cutoff); try { const oldtodos = await query find({ usemasterkey true }); await parse object destroyall(oldtodos, { usemasterkey true }); return `deleted ${oldtodos length} old todos `; } catch (err) { throw new error('error during cleanup ' + err message); } }); déployez votre cloud code avec le nouveau job (via cli ou le tableau de bord) allez sur le tableau de bord back4app > paramètres de l'application > paramètres du serveur > jobs en arrière plan planifiez le job pour qu'il s'exécute quotidiennement ou à l'intervalle qui vous convient les jobs cloud vous permettent d'automatiser la maintenance en arrière plan ou d'autres processus périodiques—sans nécessiter d'intervention manuelle étape 8 – intégration des webhooks webhooks permettent à votre application back4app d'envoyer des requêtes http à un service externe chaque fois que certains événements se produisent c'est puissant pour s'intégrer à des systèmes tiers comme des passerelles de paiement (par exemple, stripe), des outils de marketing par e mail ou des plateformes d'analyse accédez à la configuration des webhooks dans votre tableau de bord back4app > plus > webhooks, puis cliquez sur ajouter un webhook configurez un point de terminaison (par exemple, https //your external service com/webhook endpoint https //your external service com/webhook endpoint ) configurez des déclencheurs pour spécifier quels événements dans vos classes back4app ou fonctions cloud code déclencheront le webhook par exemple, si vous souhaitez notifier un canal slack chaque fois qu'un nouveau todo est créé créez une application slack qui accepte les webhooks entrants copiez l'url du webhook slack dans votre tableau de bord back4app, définissez le point de terminaison sur cette url slack pour l'événement « nouvel enregistrement dans la classe todo » vous pouvez également ajouter des en têtes http ou des charges utiles personnalisées si nécessaire vous pouvez également définir des webhooks dans cloud code en effectuant des requêtes http personnalisées dans des déclencheurs comme beforesave, aftersave étape 9 – exploration du panneau d'administration back4app l' application d'administration back4app est une interface de gestion basée sur le web conçue pour les utilisateurs non techniques afin d'effectuer des opérations crud et de gérer des tâches de données courantes sans écrire de code elle fournit une interface centrée sur le modèle , conviviale qui rationalise l'administration de la base de données, la gestion des données personnalisées et les opérations de niveau entreprise activation de l'application d'administration activez en allant dans tableau de bord de l'application > plus > application d'administration et en cliquant sur le bouton “activer l'application d'administration” créez un premier utilisateur administrateur (nom d'utilisateur/mot de passe), ce qui génère automatiquement un nouveau rôle (b4aadminuser) et des classes (b4asetting, b4amenuitem et b4acustomfield) dans le schéma de votre application choisissez un sous domaine pour accéder à l'interface d'administration et complétez la configuration connectez vous en utilisant les identifiants administratifs que vous avez créés pour accéder à votre nouveau tableau de bord de l'application admin une fois activée, l'application admin back4app facilite la visualisation, l'édition ou la suppression d'enregistrements de votre base de données—sans nécessiter l'utilisation directe du tableau de bord parse ou du code backend avec des contrôles d'accès configurables, vous pouvez partager en toute sécurité cette interface avec des membres de l'équipe ou des clients qui ont besoin d'une manière claire et simple de gérer les données conclusion en suivant ce tutoriel complet, vous avez créé un backend sécurisé pour une application meteorjs sur back4app configuré une base de données avec des schémas de classe, des types de données et des relations intégré des requêtes en temps réel (requêtes en direct) pour des mises à jour de données immédiates appliqué des mesures de sécurité en utilisant des acl et des clp pour protéger et gérer l'accès aux données implémenté des fonctions cloud code pour exécuter une logique métier personnalisée côté serveur mis en place l'authentification des utilisateurs avec prise en charge de la vérification par e mail et des réinitialisations de mot de passe géré les téléchargements de fichiers et la récupération, avec des contrôles de sécurité des fichiers en option planifié des tâches cloud pour des tâches automatisées en arrière plan utilisé des webhooks pour s'intégrer à des services externes exploré le panneau d'administration back4app pour la gestion des données avec une plateforme meteorjs solide et un backend back4app robuste, vous êtes maintenant bien équipé pour développer des applications riches en fonctionnalités, évolutives et sécurisées continuez à explorer des fonctionnalités plus avancées, intégrez votre logique métier et exploitez la puissance de back4app pour vous faire gagner d'innombrables heures dans l'administration des serveurs et des bases de données bon codage! prochaines étapes construire une application meteorjs prête pour la production en étendant ce backend pour gérer des modèles de données plus complexes, des stratégies de mise en cache et des optimisations de performance intégrer des fonctionnalités avancées telles que des flux d'authentification spécialisés, un contrôle d'accès basé sur les rôles ou des api externes (comme des passerelles de paiement) consultez la documentation officielle de back4app pour des plongées plus profondes dans la sécurité avancée, le réglage des performances et l'analyse des journaux explorez d'autres tutoriels sur les applications de chat en temps réel, les tableaux de bord iot ou les services basés sur la localisation vous pouvez combiner les techniques apprises ici avec des api tierces pour créer des applications complexes et réelles