Aller au contenu

Importer gRPC (.proto ou réflexion)

Deux chemins mènent à un arbre gRPC dans Restorm.

Fichier ▸ Importer (Ctrl+I) puis le fichier .proto. Le contenu collé est reconnu aussi (présence de syntax = "proto…", ou d’un service avec des rpc).

ÉlémentCe que Restorm en fait
Chaque serviceUn dossier
Chaque rpcUne requête gRPC
Les indicateurs de fluxLe type d’appel (unary, server-stream, client-stream, bidirectional-stream)
Le message d’entréeUn message d’exemple pré-rempli, construit d’après la forme du message
Descriptions et typesLa documentation d’API et les énumérations

Depuis la modale d’import gRPC, indiquez l’adresse hôte:port d’un serveur en fonctionnement. Restorm interroge son service de réflexion et construit le même arbre qu’à partir d’un .proto.

La modale « Serveur gRPC (réflexion) » : le champ d'adresse hôte, l'option Utiliser TLS et la table de métadonnées d'authentification facultatives

Deux avantages notables :

  1. Ça marche hors ligne ensuite. Le jeu de descripteurs obtenu est stocké sur chaque requête créée : les appels fonctionnent même si le serveur de réflexion n’est plus joignable.
  2. C’est re-synchronisable. Se reconnecter à la même adresse est reconnu comme une mise à jour de l’arbre existant, pas comme un nouvel import. Un bouton Rafraîchir depuis la réflexion existe également sur l’onglet de requête.

Si le serveur n’implémente pas la réflexion, Restorm le signale explicitement : importez alors le .proto.

gRPC fait partie des formats re-synchronisables, dans les deux modes. Voir Mettre à jour depuis la source.