nodejs construit grpc

Avant-propos

gRPC est le framework RPC multilingue open source et hautes performances de Google. Son objectif est de permettre aux applications clientes d'appeler des méthodes côté serveur tout comme l'appel de fonctions locales. Il prend en charge plusieurs langages de programmation, notamment : C++, Python, Java, Go, des langages tels que Node.js.

L'utilisation de gRPC dans Node.js peut grandement faciliter notre interaction entre le serveur et le client, et tout en garantissant des performances élevées, elle peut également assurer la sécurité et la confidentialité des données. Cet article expliquera comment utiliser Node.js pour créer un service gRPC. terminal et client.

Étape 1 : Installez Node.js et gRPC

Tout d'abord, vous devez vous assurer que Node.js et npm ont été installés localement. Ensuite, entrez la commande suivante dans le terminal pour installer gRPC :

npm install -g grpc

Une fois l'installation terminée, vous pouvez voir les informations de version de gRPC dans le fichier package.json.

Étape 2 : Définir le fichier .proto

gRPC définit le service via un proto-fichier, qui est utilisé pour définir l'interface du service, le format du message, etc. Ensuite, nous définissons d'abord un service simple qui permet au client d'envoyer un message au serveur et de renvoyer un message modifié après réception du message. Créez un fichier nommé example.proto et définissez le contenu suivant :

syntax = "proto3";

package example;

service Example {
  rpc ModifyMessage (Message) returns (Message){}

}
message Message {
  string content = 1;
}

Étape 3 : Générer le code

Exécutez la commande suivante dans le répertoire où se trouve le fichier example.proto pour générer le code correspondant :

grpc_tools_node_protoc --js_out=import_style=commonjs,binary:./ --grpc_out=./ --plugin=protoc-gen-grpc=`which grpc_tools_node_protoc_plugin` example.proto

grpc_tools_node_protoc est utilisé ici Génère le code requis pour Node.js, en spécifiant le répertoire de sortie.

Le code généré comprend : example_pb.js et example_grpc_pb.js.

Étape 4 : Implémenter le serveur

Le code côté serveur est le suivant :

const grpc = require("grpc");
const example = require("./example_pb");
const exampleService = require("./example_grpc_pb");

const server = new grpc.Server();

function modifyMessage(call, callback) {
  const response = new example.Message();
  response.setContent(call.request.getContent().toUpperCase());
  callback(null, response);
}

server.addService(exampleService.ExampleService, {
  modifyMessage: modifyMessage,
});

server.bind("localhost:50051", grpc.ServerCredentials.createInsecure());
console.log("Server running at http://localhost:50051");
server.start();

Dans cet exemple, le serveur crée un nouveau serveur grpc et ajoute une méthode nommée modifierMessage sur le serveur. Cette méthode reçoit un objet Message en tant que paramètre, convertit le champ de contenu de l'objet Message en majuscule et le renvoie.

Enfin, nous utilisons la méthode bind() pour lier le service à localhost:50051 et démarrer le serveur.

Étape 5 : Implémenter le client

Le code du client est le suivant :

const grpc = require("grpc");
const example = require("./example_pb");
const exampleService = require("./example_grpc_pb");

const client = new exampleService.ExampleClient(
  "localhost:50051",
  grpc.credentials.createInsecure()
);

const request = new example.Message();

request.setContent("Hello World!");

client.modifyMessage(request, function (err, response) {
  console.log("Modified message: ", response.getContent());
});

Dans cet exemple, nous créons un objet ExempleClient et utilisons sa méthode modifierMessage() pour envoyer un objet Message au serveur. Enfin, nous générons la réponse du serveur, qui a converti les lettres de la chaîne en lettres majuscules.

Étape six : Exécuter le service

Maintenant, il ne nous reste plus qu'à démarrer le service en utilisant la commande suivante dans le répertoire où se trouve le code du serveur :

node server.js

Ensuite, exécutez la commande suivante dans le répertoire où se trouve le code client situé :

node client.js

Vous devriez Vous verrez le résultat suivant :

Modified message:  HELLO WORLD!

À ce stade, nous avons implémenté avec succès un processus d'interaction de base entre le serveur gRPC et le client.

Résumé

Cet article explique comment utiliser Node.js pour créer un serveur et un client gRPC, et utilise protobuf pour définir la structure des données et le format des messages entre la création de services et l'établissement de connexions. gRPC est un puissant framework RPC multilingue utile pour les applications qui ont besoin de transférer rapidement des données entre clients et serveurs.

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!