gRPC

Högerklicka i trädet ▸ Lägg till ▸ gRPC-begäran.

Konfiguration

Fält	Roll
URL	Serverns host:port
Tjänst / Metod	Tjänsten och den RPC som anropas
Anropstyp	unary, server-stream, client-stream, bidirectional-stream
Begärandemeddelande	Meddelandet, i JSON
Metadata	Nyckel/värde-paren som skickas med anropet (det är där autentiseringsuppgifterna går)

Var tjänstedefinitionen kommer ifrån

Tre möjliga källor, i prioritetsordning:

1. en uppsättning deskriptorer som hämtats via serverreflektion — det är vad importen via reflektion lägger på plats, och den tar över allt annat;
2. det inbäddade .proto-innehållet, som lagras i projektet;
3. en sökväg till en .proto på disken.

Det första alternativet har en viktig praktisk konsekvens: en begäran som importerats via reflektion fortsätter att fungera offline, utan att servern behöver vara nåbar.

Importera via reflektion

Ange host:port i modalen för gRPC-import: Restorm frågar reflektionstjänsten, läser in deskriptorerna och bygger upp trädet — en mapp per tjänst, en begäran per RPC, med ett exempelmeddelande.

Att ansluta till samma adress igen känns igen som en omsynkronisering och uppdaterar det befintliga trädet i stället för att duplicera det.

Om servern inte implementerar reflektion säger Restorm det uttryckligen: importera då .proto-filen i stället. Se Importera en gRPC-.proto.

Transporter

Tre transporter är tillgängliga:

Transport	När du använder den
grpc (standard)	Inbyggd gRPC över HTTP/2
grpc-web	Server bakom en gRPC-Web-proxy
connect	Connect-RPC-server

Strömmande anrop

För de tre strömmande lägena visar svarspanelen meddelandena löpande. I ett scenario använder du åtgärderna gRPC connect, gRPC send och Stäng gRPC-anslutning: anslutningen förblir öppen mellan noderna, varje mottaget meddelande utlöser en händelse, och stängningen gör en halvstängning på klientsidan.

Serverläge

Restorm kan hosta en gRPC-mockserver: en lista över simulerade metoder, var och en med sitt svarsmeddelande (en JSON-array för en ström), sin statuskod, sina avslutande metadata, eller ett skript. Serverreflektion exponeras som standard, och TLS konfigureras med certifikat och nyckel i PEM-format. Se Simulera en gRPC-tjänst.

Kodavsnitt

Fjorton mål: grpcurl, grpc_cli, grpcurl i gRPC-Web, curl i Connect-RPC, JavaScript och TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).