gRPC importeren (.proto of reflection)

Er zijn twee wegen naar een gRPC-boom in Restorm.

Vanuit een .proto-bestand

Bestand ▸ Importeren (Ctrl+I) en daarna het .proto-bestand. Geplakte inhoud wordt ook herkend (aanwezigheid van syntax = "proto…", of van een service met rpc’s).

Element	Wat Restorm daarmee doet
Elke service	Een map
Elke rpc	Een gRPC-verzoek
De streamingindicatoren	Het aanroeptype (unary, server-stream, client-stream, bidirectional-stream)
Het invoerbericht	Een vooraf gevuld voorbeeldbericht, opgebouwd naar de vorm van het bericht
Beschrijvingen en typen	De API-documentatie en de enumeraties

Via serverreflection

Geef in het gRPC-importdialoogvenster het adres host:port van een draaiende server op. Restorm ondervraagt de reflectionservice en bouwt dezelfde boom op als vanuit een .proto.

Twee opvallende voordelen:

1. Het werkt daarna offline. De set descriptors die is opgehaald, wordt op elk aangemaakt verzoek opgeslagen: de aanroepen werken ook als de reflectionserver niet meer bereikbaar is.
2. Het is opnieuw te synchroniseren. Opnieuw verbinden met hetzelfde adres wordt herkend als een update van de bestaande boom, niet als een nieuwe import. Op het verzoektabblad staat ook een knop Vernieuwen via reflection.

Als de server geen reflection implementeert, meldt Restorm dat expliciet: importeer dan de .proto.

Bijwerken

gRPC hoort bij de formaten die opnieuw te synchroniseren zijn, in beide modi. Zie Bijwerken vanaf de bron.