gRPC

Rechtsklik in de boom ▸ Toevoegen ▸ gRPC-verzoek.

Configuratie

Veld	Rol
URL	host:port van de server
Service / Methode	De service en de RPC die wordt aangeroepen
Aanroeptype	unary, server-stream, client-stream, bidirectional-stream
Verzoekbericht	Het bericht, in JSON
Metadata	De sleutel-waardeparen die met de aanroep worden meegestuurd (daar gaan de inloggegevens langs)

Waar de servicedefinitie vandaan komt

Er zijn drie mogelijke bronnen, in volgorde van prioriteit:

1. een set descriptors die via serverreflection is opgehaald — dat is wat de import via reflection neerzet, en die gaat vóór de rest;
2. de inline .proto-inhoud, opgeslagen in het project;
3. een pad naar een .proto op schijf.

De eerste optie heeft een belangrijk praktisch gevolg: een verzoek dat via reflection is geïmporteerd, blijft offline werken, zonder dat de server bereikbaar hoeft te zijn.

Importeren via reflection

Geef in het gRPC-importdialoogvenster host:port op: Restorm ondervraagt de reflectionservice, laadt de descriptors en bouwt de boomstructuur — één map per service, één verzoek per RPC, met een voorbeeldbericht.

Opnieuw verbinden met hetzelfde adres wordt herkend als een hersynchronisatie en werkt de bestaande boomstructuur bij in plaats van die te dupliceren.

Als de server geen reflection implementeert, zegt Restorm dat expliciet: importeer dan de .proto. Zie Een gRPC-.proto importeren.

Transporten

Er zijn drie transporten beschikbaar:

Transport	Wanneer u het gebruikt
grpc (standaard)	Native gRPC over HTTP/2
grpc-web	Server achter een gRPC-Web-proxy
connect	Connect-RPC-server

Aanroepen met streaming

Voor de drie streamingmodi toont het responspaneel de berichten doorlopend. Gebruik in een scenario de acties gRPC connect, gRPC send en gRPC-verbinding sluiten: de verbinding blijft tussen de vakjes open, elk ontvangen bericht stuurt een event uit, en het sluiten voert de half-close aan de clientzijde uit.

Servermodus

Restorm kan een gRPC-mockserver hosten: een lijst van gemockte methoden, elk met een responsbericht (een JSON-array voor een stream), een statuscode, afsluitmetadata, of een script. Serverreflection wordt standaard aangeboden, en TLS stelt u in met een certificaat en een sleutel in PEM-formaat. Zie Een gRPC-API mocken.

Codefragmenten

Veertien doelen: grpcurl, grpc_cli, grpcurl in gRPC-Web, curl in Connect-RPC, JavaScript en TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).