Importare gRPC (.proto o reflection)

Due strade portano a un albero gRPC in Restorm.

Da un file .proto

File ▸ Importa (Ctrl+I) e poi il file .proto. Viene riconosciuto anche il contenuto incollato (presenza di syntax = "proto…", oppure di un service con dei rpc).

Elemento	Ciò che Restorm ne fa
Ogni service	Una cartella
Ogni rpc	Una richiesta gRPC
Gli indicatori di streaming	Il tipo di chiamata (unary, server-stream, client-stream, bidirectional-stream)
Il messaggio di input	Un messaggio di esempio precompilato, costruito in base alla forma del messaggio
Descrizioni e tipi	La documentazione di API e le enumerazioni

Per reflection del server

Dalla finestra modale di importazione gRPC, occorre indicare l’indirizzo host:port di un server in funzione. Restorm interroga il suo servizio di reflection e costruisce lo stesso albero che otterrebbe da un .proto.

Due vantaggi notevoli:

1. Poi funziona offline. L’insieme di descrittori ottenuto viene archiviato su ciascuna richiesta creata: le chiamate funzionano anche se il server di reflection non è più raggiungibile.
2. È risincronizzabile. Ricollegarsi allo stesso indirizzo viene riconosciuto come un aggiornamento dell’albero esistente, non come una nuova importazione. Esiste anche un pulsante Aggiorna dalla reflection nella scheda di richiesta.

Se il server non implementa la reflection, Restorm lo segnala esplicitamente: in tal caso occorre importare il .proto.

Aggiornare

gRPC fa parte dei formati risincronizzabili, in entrambe le modalità. Si veda Aggiornare dalla sorgente.