Bâtiment API GraphQL sans serveur dans le nœud avec express et netlify

Construire une API peut sembler intimidant, mais il ne doit pas l'être. Ce tutoriel montre comment créer et déployer une API simple et en lecture seule en moins d'une heure en utilisant un code minimal et des outils facilement disponibles. Aucune expérience back-end n'est nécessaire; Une compréhension de base de JavaScript et de NPM est suffisante.

Ce guide démystifie des concepts d'API communs comme REST et présente des architectures GraphQL et sans serveur. Nous utiliserons des outils facilement disponibles et expliquerons leur objectif en cours de route. À la fin, vous aurez une API déployée sans maux de tête de gestion de serveur.

Concepts clés: GraphQL et sans serveur

Les API impliquent fondamentalement la lecture et la mise à jour des données. Les API REST utilisent des URL pour définir les points d'accès aux données, nécessitant plusieurs demandes de récupération de données complexes. GraphQL améliore l'efficacité en permettant aux clients de spécifier les données exactes nécessaires dans une seule demande. Les relations de données sont représentées comme un graphique, optimisant la récupération des données.

L'architecture sans serveur élimine le besoin de gestion des serveurs. Vous ne payez que pour les ressources consommées, simplifiant le déploiement et la maintenance. Nous exploiterons les fonctions Netlify pour cette fonctionnalité sans serveur.

Outils du commerce

1. Node.js et Express: Node.js permet l'exécution JavaScript côté serveur, tandis que Express simplifie le développement de l'API avec des fonctionnalités telles que le routage et le middleware.

2. Fonctions Netlify: une plate-forme sans serveur offrant un déploiement gratuit et une mise à l'échelle des fonctions. Netlify Dev permet des tests locaux.

Configuration du projet

1. Créez un nouveau répertoire de projet et initialisez-le avec npm init .

2. Installez les packages nécessaires: npm i express express-graphql graphql body-parser serverless-http netlify-cli -g

Structure et configuration des fichiers

• netlify.toml : configure Netlify pour la construction et le déploiement. Surtout, il spécifie l'emplacement des fonctions sans serveur:

 [construire]
Command = "NPM Run build"
publier = "build"
fonctions = "fonctions"

• /functions/api.js : contient le code API.

Répartition du code api.js

1. Dépendances d'importation:

 const Express = require ("express");
const bodyParser = require ("body-parser");
const ExpressGraphQl = require ("express-graphQl");
const Serverless = require ("serverless-http");
const {graphQlschema, graphQlobjectType, graphQlString} = require ("graphQl");

2. Initialiser l'express et l'emballage sans serveur:

 const app = express ();
module.exports.handler = serverless (app);

3. Configurer le middleware express:

 app.use (bodyParser.json ());
app.use ("/", expressGraphql ({schéma: schéma, graphiql: true}));

4. Définissez le schéma GraphQL:

 const Schema = new GraphQlschema ({{
  Query: new GraphQloBjectType ({
    Nom: "Helloworld",
    champs: () => ({
      message: {
        Type: GraphQlString,
        Resolve: () => "Hello World",
      },
    }),
  }),
});

Développement et test locaux

Exécutez netlify dev dans votre terminal. Accédez au terrain de jeu Graphiql sur http://localhost:8888/.netlify/functions/api . Testez votre API en interrogeant { message } .

Déploiement

Connectez votre projet à NetLify (par exemple, via GitHub) pour le déploiement automatique. Netlify gérera la construction et le déploiement de votre fonction sans serveur.

Facultatif: demande de redirection

Créez un fichier _redirects dans la racine de votre projet pour rediriger les demandes de /api vers votre fonction Netlify:

 <code>/api /.netlify/functions/api 200!</code>

Cela simplifie l'accès à l'API.

Conclusion

Ce tutoriel fournit une base pour la construction et le déploiement des API GraphQL sans serveur avec facilité. L'approche est évolutive et permet un développement API plus complexe selon les besoins. N'oubliez pas d'explorer les ressources liées pour des plongées plus profondes dans GraphQL et les technologies sans serveur. Le code source complet est disponible sur GitHub (lien fourni dans l'article d'origine).

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!