Comment construire un backend pour le framework Play ?

introduction dans ce tutoriel, vous apprendrez à construire un backend complet pour le play framework en utilisant back4app nous passerons en revue les fonctionnalités essentielles pour les backends de serveur, y compris la configuration, la gestion de base de données, les fonctions cloud code, les api rest et graphql, l'authentification des utilisateurs, le stockage de fichiers et les requêtes en temps réel vous verrez comment back4app simplifie le processus de configuration, de mise à l'échelle et de maintenance d'un backend d'application web tout en vous permettant de vous concentrer sur votre code play framework en apprenant à construire un backend pour play framework avec back4app, vous réduirez le temps de développement et minimiserez les maux de tête liés aux opérations de développement vous ajouterez également des fonctionnalités robustes telles que la connexion sociale, la planification de tâches (cloud jobs) et les webhooks une fois que vous aurez terminé cela, vous pourrez étendre le système en une solution de qualité production, en intégrant des fonctionnalités plus avancées selon les besoins lorsque vous aurez terminé, vous disposerez d'un plan solide pour créer votre prochaine application web play framework évolutive et sécurisée vous serez prêt à plonger plus profondément dans les améliorations de performance, les intégrations ou les optimisations en mode développement pour répondre aux exigences du monde réel 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 un environnement play framework fonctionnel assurez vous d'avoir java 8+ https //adoptium net/ installé installez sbt https //www scala sbt org/download html ou utilisez sbt via votre ide https //www playframework com/documentation/latest/ide connaissances de base du play framework référez vous à la documentation play https //www playframework com/documentation/latest si vous avez besoin de revoir les fondamentaux familiarité avec rest ou graphql cela vous aidera à interagir avec back4app, surtout si vous décidez de ne pas utiliser ou si vous ne pouvez pas utiliser le sdk parse directement assurez vous d'avoir ces conditions préalables en place avant de commencer avoir votre projet back4app configuré et votre environnement play framework prêt vous aidera à suivre facilement étape 1 – création d'un nouveau projet sur back4app et connexion pourquoi vous avez besoin d'un nouveau projet back4app un nouveau projet back4app est la colonne vertébrale de votre backend car il gère les données de votre application, l'authentification et la logique cloud que vous construisiez un petit prototype ou une application web à grande échelle, il est facile de connecter votre application play framework à un nouveau projet back4app création d'un projet back4app connectez vous à votre compte back4app cliquez sur “nouvelle application” dans votre tableau de bord back4app nommez votre application , par exemple, “play framework backend” une fois créé, votre nouveau projet apparaîtra dans le tableau de bord connexion avec back4app back4app utilise parse server si votre application play framework prévoit d'interagir avec back4app via le sdk java de parse, vous pouvez l'ajouter à votre build sbt si nécessaire sinon, vous pouvez utiliser des points de terminaison rest ou graphql récupérez vos clés parse dans votre tableau de bord back4app, ouvrez paramètres de l'application ou sécurité et clés pour trouver votre id d'application , clé api rest , clé javascript (si vous utilisez des appels front end), ou clé client , ainsi que l’ url du serveur , (généralement https //parseapi back4app com ) utiliser le sdk java/parse (optionnel) si vous souhaitez une intégration directe côté serveur en utilisant le sdk parse, ajoutez une dépendance dans votre build sbt librarydependencies += "com parse" % "parse" % "1 0 40" // example version ensuite, dans votre code play framework, vous pouvez initialiser parse object parseconfig { def init() unit = { parse initialize(new parse configuration builder("your app id") server("https //parseapi back4app com") clientkey("your client key") build() ) } } vous pouvez placer cela dans votre global scala ou l'appeler depuis un point d'initialisation approprié cela vous prépare à une interaction directe avec votre projet back4app si vous préférez, utilisez les points de terminaison rest ou graphql pour les opérations de données, surtout si vous souhaitez plus de contrôle sur vos requêtes http ou si vous construisez des microservices étape 2 – configuration de la base de données le service de stockage de données de back4app prend en charge une large gamme de types de données et la création de schémas dynamiques cela vous permet de stocker les données de votre application play avec un minimum de tracas création d'un modèle de données ouvrez la section “base de données” dans votre tableau de bord back4app créez une nouvelle classe (par exemple, “todo”) et ajoutez des colonnes (par exemple, titre comme string, estterminé comme boolean) enregistrez pour finaliser votre schéma de base de données création d'un modèle de données avec l'agent ia si vous souhaitez définir rapidement votre structure de données ouvrez l'agent ia dans votre tableau de bord d'application décrivez votre modèle de données souhaité en langage simple (par exemple, “créez un modèle todo simple ”) l'agent génère automatiquement le schéma pour vous lecture et écriture de données en utilisant le sdk parse (optionnel) si vous avez choisi d'inclure le sdk java parse dans votre application play framework, vous pouvez enregistrer et interroger des données import com parse {parseobject, parsequery} object todoservice { def createtodo(title string, iscompleted boolean) either\[throwable, parseobject] = { try { val todo = new parseobject("todo") todo put("title", title) todo put("iscompleted", iscompleted) right(todo save()) } catch { case e throwable => left(e) } } def fetchtodos() either\[throwable, java util list\[parseobject]] = { try { val query = parsequery getquery("todo") val results = query find() right(results) } catch { case e throwable => left(e) } } } lecture et écriture de données en utilisant rest vous pouvez envoyer des requêtes http depuis vos contrôleurs ou services play framework 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 lecture et écriture de données en utilisant graphql back4app fournit également une api graphql mutation { createtodo(input { fields { title "clean the house" iscompleted false } }) { todo { objectid title iscompleted } } } c'est pratique si vous construisez des microservices ou si vous souhaitez une api flexible pour vos clients front end travailler avec des requêtes en direct si votre application web nécessite des données en temps réel, activez les requêtes en direct activer les requêtes en direct dans le tableau de bord back4app sous paramètres du serveur configurez votre abonnement dans le code si vous utilisez le sdk parse ou un code personnalisé, assurez vous de configurer le livequeryserverurl abonnez vous aux changements pour des classes comme “todo ” étape 3 – appliquer la sécurité avec les acl et les clp aperçu des acl et des clp back4app fournit des listes de contrôle d'accès (acl) pour la sécurité au niveau des objets et des permissions au niveau de la classe (clp) pour des restrictions générales cela aide à garder vos serveurs en sécurité et garantit que seules des opérations autorisées se produisent permissions au niveau de la classe dans la section base de données de votre tableau de bord back4app sélectionnez une classe (par exemple, “todo”) ouvrez les clp pour limiter la lecture/écriture aux utilisateurs authentifiés, rôles ou au public configurez selon vos besoins (par exemple, “nécessite une authentification” pour toute écriture) acls les acl protègent des objets individuels par exemple, vous pouvez vous assurer qu'un utilisateur particulier peut lire ou écrire un enregistrement spécifique si vous utilisez le sdk parse depuis le code scala import com parse {parseacl, parseuser, parseobject} def createprivatetodo(title string, owner parseuser) parseobject = { val todo = new parseobject("todo") todo put("title", title) val acl = new parseacl(owner) acl setpublicreadaccess(false) acl setpublicwriteaccess(false) todo setacl(acl) todo save() todo } étape 4 – écriture des fonctions cloud code pourquoi cloud code le cloud code vous permet d'exécuter une logique personnalisée sur les serveurs de back4app, ajoutant des règles commerciales ou des validations avant ou après les transactions de données vous n'aurez pas besoin de gérer votre propre approvisionnement de serveur ou de redémarrages en mode développement pour mettre en œuvre de telles fonctions fonction d'exemple // main js parse cloud define('calculatetextlength', async (request) => { const { text } = request params; if (!text) { throw new error('no text provided'); } return { length text length }; }); vous pouvez appeler cela depuis votre application play via rest, graphql, ou si vous utilisez le sdk parse, directement déploiement utilisez le back4app cli ou le tableau de bord installez le cli (exemple linux/macos) configurez la clé de compte déployez ou déployez via le tableau de bord en collant votre fonction dans cloud code > functions et en cliquant sur “déployer” utilisation des modules npm le cloud code prend en charge les modules npm par exemple, si vous avez besoin d'un client http comme axios const axios = require('axios'); parse cloud define('fetchdata', async (req) => { const response = await axios get(req params url); return response data; }); étape 5 – configuration de l'authentification activation de l'authentification des utilisateurs back4app utilise la parse user classe pour l'inscription, la connexion et la gestion des sessions dans votre paramètre de configuration , assurez vous d'activer « vérification par e mail » et « réinitialisation du mot de passe » si désiré code d'exemple (parse sdk) import com parse {parseuser} object authservice { def signupuser(username string, password string, email string) either\[throwable, parseuser] = { try { val user = new parseuser() user setusername(username) user setpassword(password) user setemail(email) right(user signup()) } catch { case e throwable => left(e) } } def loginuser(username string, password string) either\[throwable, parseuser] = { try { right(parseuser login(username, password)) } catch { case e throwable => left(e) } } } connexion sociale si vous avez besoin de connexions sociales (google, apple ou facebook), configurez les dans votre tableau de bord back4app parse fournit des méthodes utilitaires ou vous pouvez vous appuyer sur des flux oauth standard, selon vos besoins et votre approche étape 6 – gestion du stockage de fichiers back4app stocke des fichiers via parse file depuis play framework, vous pouvez télécharger avec rest ou parse sdk // example with parse sdk import com parse {parsefile, parseobject} import java nio file {files, paths} def uploadimage(filepath string) either\[throwable, string] = { try { val data = files readallbytes(paths get(filepath)) val parsefile = new parsefile("myimage jpg", data) parsefile save() right(parsefile geturl) } catch { case e throwable => left(e) } } considérations de sécurité vous pouvez configurer les autorisations de téléchargement de fichiers (activer pour le public, anonyme ou authentifié) dans les paramètres du serveur back4app étape 7 – vérification par e mail et réinitialisation du mot de passe naviguez vers les paramètres de messagerie dans le tableau de bord back4app activer la vérification par e mail et configurer les modèles d'e mail pour les réinitialisations de mot de passe dans votre application play, vous pouvez appeler 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 '{"email" "user\@example com"}' \\ https //parseapi back4app com/requestpasswordreset cela déclenchera back4app pour envoyer des instructions de réinitialisation de mot de passe à l'email de l'utilisateur étape 8 – planification des tâches avec les cloud jobs cloud jobs si vous avez besoin d'un tâche de démarrage pour un travail en arrière plan (par exemple, nettoyage des données ou génération de rapports), vous pouvez planifier des cloud jobs sur back4app // main js parse cloud job('cleanupoldtodos', async (request) => { const todo = parse object extend('todo'); const query = new parse query(todo); 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); } }); planification déployez votre cloud code dans paramètres de l'application > paramètres du serveur > tâches en arrière plan , planifiez la tâche pour qu'elle s'exécute quotidiennement, hebdomadairement ou selon les besoins étape 9 – intégration des webhooks si vous souhaitez notifier des services externes chaque fois que les données changent, configurez webhooks dans back4app allez à plus > webhooks dans votre tableau de bord back4app ajouter un webhook avec un point de terminaison (par exemple, slack ou stripe) choisissez des déclencheurs, tels que “nouvel enregistrement dans la classe todo ” vous pouvez également créer des webhooks dans les déclencheurs de cloud code, en effectuant des requêtes http directes vers des services tiers étape 10 – explorer le panneau d'administration back4app le back4app admin app est une interface conviviale pour la gestion des données et des enregistrements les utilisateurs non techniques peuvent effectuer des opérations crud sans plonger dans le code activation de l'admin app allez à app dashboard > plus > admin app activez le et créez un utilisateur administrateur choisissez un sous domaine pour un accès pratique une fois connecté, vous pouvez gérer les entrées de données sans vous mêler des tableaux de bord de niveau inférieur ou des outils cli conclusion félicitations ! vous avez appris comment construire un backend pour play framework en utilisant les services de back4app tout au long de ce tutoriel, vous avez créé un backend sécurisé pour une application play framework sur back4app mis en place une base de données , y compris la conception du schéma, les relations et les requêtes en temps réel appliqué des acl et des clp pour un accès sécurisé aux données écrit du cloud code pour une logique personnalisée, des déclencheurs et des intégrations externes configuré l'authentification des utilisateurs , la connexion sociale et les réinitialisations de mot de passe géré les téléchargements de fichiers et ajouté une sécurité de fichier optionnelle planifié des tâches en arrière plan avec cloud jobs intégré avec des services tiers via webhooks exploré le panneau d'administration back4app pour une gestion des données simplifiée avec ces outils en place, vous pouvez optimiser le mode développement, évoluer selon les besoins et construire des applications web robustes sur le play framework adoptez des intégrations supplémentaires, un réglage des performances et des mesures de sécurité avancées pour amener vos backends de serveur au niveau supérieur prochaines étapes améliorez votre configuration de production avec des outils de mise en cache, de journalisation ou de surveillance explorez la sécurité avancée avec des contrôles d'accès basés sur les rôles ou des configurations de confiance zéro intégrez des passerelles de paiement ou d'autres api tierces pour le commerce ou l'analyse consultez la documentation officielle de back4app pour des informations plus approfondies sur les performances et le dépannage revoyez plus de tutoriels sur les applications de chat en temps réel, les solutions iot ou les services basés sur la localisation — dont beaucoup s'appuient sur les techniques de ce guide