gRPC importieren (.proto oder Reflexion)

Zwei Wege führen zu einem gRPC-Baum in Restorm.

Aus einer .proto-Datei

Datei ▸ Importieren (Ctrl+I), dann die .proto-Datei. Eingefügter Inhalt wird ebenfalls erkannt (Vorhandensein von syntax = "proto…" oder eines service mit rpcs).

Element	Was Restorm daraus macht
Jeder service	Ein Ordner
Jede rpc	Eine gRPC-Anfrage
Die Stream-Indikatoren	Der Aufruftyp (unary, server-stream, client-stream, bidirectional-stream)
Die Eingabenachricht	Eine vorausgefüllte Beispielnachricht, gemäß der Form der Nachricht aufgebaut
Beschreibungen und Typen	Die API-Dokumentation und die Enumerationen

Per Server-Reflexion

Geben Sie im Import-Dialog für gRPC die Adresse host:port eines laufenden Servers an. Restorm fragt dessen Reflexionsdienst ab und baut denselben Baum wie aus einer .proto-Datei auf.

Zwei nennenswerte Vorteile:

1. Es funktioniert danach offline. Der erhaltene Descriptor-Satz wird bei jeder erstellten Anfrage gespeichert: Die Aufrufe funktionieren auch, wenn der Reflexionsserver nicht mehr erreichbar ist.
2. Es ist re-synchronisierbar. Eine erneute Verbindung zur selben Adresse wird als Aktualisierung des bestehenden Baums erkannt, nicht als neuer Import. Eine Schaltfläche Von der Reflexion aktualisieren existiert ebenfalls im Anfrage-Tab.

Falls der Server keine Reflexion implementiert, meldet Restorm dies ausdrücklich: Importieren Sie dann die .proto-Datei.

Aktualisieren

gRPC gehört in beiden Modi zu den re-synchronisierbaren Formaten. Siehe Aktualisierung aus der Quelle.