Créer des applications et services avec le cadre HAPI.JS

hapi.js, un cadre robuste pour fabriquer des applications et des services, simplifie le développement de l'API JSON avec ses valeurs par défaut intelligentes. Son architecture modulaire et son écosystème de plugin permettent une extension et une personnalisation transparentes. La version 17.0 intègre entièrement async / await, offrant la lisibilité du code synchrone avec l'efficacité non bloquante des opérations asynchrones, éliminant les complexités de rappel.

Caractéristiques de clé:

• Framework complet: Conçu pour la création d'applications et de services, HAPI.js possède des valeurs par défaut intelligentes et une conception modulaire, rationaliser la création de l'API JSON.
• Support JavaScript moderne: Full async / await La compatibilité améliore la clarté du code et évite l'enfer du rappel.
• routage flexible: prend en charge la manipulation détaillée des itinéraires, y compris divers types de contenu et méthodes HTTP, personnalisables via les plugins.
• Intégration de la base de données: s'intègre de manière transparente aux bases de données via ORMS comme Sequelize, offrant une API d'interaction de base de données propre sans dicter la structure de la base de données.
• Authentification robuste: fournit des mécanismes d'authentification solides à l'aide de jetons Web JSON (JWT).
• Validation d'entrée: inclut la validation d'entrée intégrée avec des outils comme JOI, assurant l'intégrité des données.
• Idéal pour les API reposantes: bien adapté à la construction d'API RESTful, comme le montre sa capacité à gérer des articles et des commentaires de blog (opérations CRUD).

Construire une API de blog avec hapi.js:

Ce tutoriel détaille la création d'une API de blog, englobant:

• API Core HAPI: routage, demande et manipulation de la réponse.
• Modélisation et persistance de la base de données relationnelles (en utilisant SQLite et séquelle).
• Articles et commentaires et actions (crud).
• REST TEST API avec httpie.
• Authentification JWT et sécurité de l'itinéraire.
• Validation des données avec Joi.
• Vue HTML et mise en page pour la route racine (/).

PRENDRE:

Assurez-vous d'avoir une version récente Node.js (8.9.0 ou plus). Clone The Starter Code:

git clone https://github.com/markbrown4/hapi-api.git
cd hapi-api
npm install

Le script package.json "start" utilise nodemon pour redémarrer automatiquement le serveur lors des modifications de fichier. Exécutez npm start et accès http://localhost:3000/ pour voir la sortie initiale.

Handlers d'itinéraire:

Les gestionnaires d'itinéraire sont essentiels. La gestion de la réponse de HAPI est flexible:

• Les objets sont stringified en json (Content-Type: application/json).
• Les chaînes deviennent HTML (Content-Type: text/html).
• Les promesses et les flux sont également pris en charge.

async Les fonctions améliorent souvent le flux de code lors de l'utilisation des promesses:

Couche du modèle (SQLite & Sequelize):

La flexibilité de HAPI s'étend à la couche modèle; Vous êtes libre de choisir votre base de données et votre ORM. Ce tutoriel utilise SQLite et séquelle:

git clone https://github.com/markbrown4/hapi-api.git
cd hapi-api
npm install

Le fichier models.js définit le modèle Article et établit la connexion de la base de données. Article.sync() crée le tableau de la base de données.

Actions reposantes:

Le fichier routes.js définit les itinéraires pour la gestion des articles (CRUD). Ces routes utilisent des méthodes séquentielles (findAll, findById, create, update, destroy) pour l'interaction de la base de données.

Test de l'API avec httpie:

httpie simplifie les tests d'API à partir de la ligne de commande. Des commandes comme http GET, http POST, http PUT, et http DELETE sont utilisées pour interagir avec les points de terminaison de l'API.

Gestion des erreurs:

Le tutoriel démontre une gestion des erreurs robuste, en utilisant Boom pour générer des réponses d'erreur standardisées (par exemple, 404 non trouvé). Une méthode personnalisée find est ajoutée au modèle de séquelle pour gérer les cas où les enregistrements ne sont pas trouvés.

Authentification (JWT):

L'authentification JWT est implémentée à l'aide du plugin hapi-auth-jwt2 (une fourche compatible avec HAPI 17.0 est utilisée). Un itinéraire de connexion génère des JWT, et les itinéraires sont sécurisés par défaut, nécessitant l'authentification, sauf s'il est explicitement marqué comme public (config: { auth: false }).

Validation (Joi):

JOI est utilisé pour la validation des entrées, assurant l'intégrité des données. Les règles de validation sont définies dans les configurations d'itinéraire.

Servant du contenu et des vues statiques:

Le tutoriel montre comment servir le contenu statique (HTML) et suggère des approches pour gérer les vues et les dispositions. La configuration CORS est également discutée pour les demandes d'origine transversale.

Questions fréquemment posées (FAQ):

L'article se termine par une section complète de la FAQ concernant divers aspects du développement hapi.js, y compris ses différenciateurs, le démarrage, la compatibilité de la base de données, l'évolutivité, la sécurité, l'intégration des applications mobiles, le support communautaire, les directives de contribution, les cas d'utilisation communs et les erreurs manipulation.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!