gRPC

Høyreklikk i treet ▸ Legg til ▸ gRPC-forespørsel.

Konfigurasjon

Felt	Rolle
URL	host:port til serveren
Tjeneste / Metode	Tjenesten og RPC-en som kalles
Kalltype	unary, server-stream, client-stream, bidirectional-stream
Forespørselsmelding	Selve meldingen, som JSON
Metadata	Nøkkel/verdi-parene som sendes med kallet (det er her legitimasjonen går)

Hvor tjenestedefinisjonen kommer fra

Tre mulige kilder, i prioritert rekkefølge:

1. et deskriptorsett hentet via server-reflection — det er dette importen ved reflection legger igjen, og det har forrang over resten;
2. .proto-innholdet inline, lagret i prosjektet;
3. en sti til en .proto-fil på disken.

Det første alternativet har en viktig praktisk konsekvens: en forespørsel som er importert via reflection fortsetter å fungere offline, uten at serveren er tilgjengelig.

Importere via reflection

I import-dialogen for gRPC oppgir du host:port: Restorm spør reflection-tjenesten, laster inn deskriptorene og bygger treet — én mappe per tjeneste, én forespørsel per RPC, med en eksempelmelding.

Kobler du deg til samme adresse igjen, gjenkjennes det som en resynkronisering, og det eksisterende treet oppdateres i stedet for å bli duplisert.

Hvis serveren ikke implementerer reflection, sier Restorm det rett ut: importer .proto-filen i stedet. Se Importere en gRPC-.proto.

Transporter

Tre transporter er tilgjengelige:

Transport	Når du bruker den
grpc (standard)	Native gRPC over HTTP/2
grpc-web	Server bak en gRPC-Web-proxy
connect	Connect-RPC-server

Strømmekall

For alle de tre strømmemodusene viser svarpanelet meldingene løpende. I et scenario bruker du handlingene gRPC connect, gRPC send og Lukk gRPC-tilkobling: tilkoblingen holdes åpen mellom boksene, hver mottatte melding sender ut en hendelse, og lukkingen utfører halvlukkingen på klientsiden.

Servermodus

Restorm kan være vert for en gRPC-mockserver: en liste over mock-metoder, hver med sin svarmelding (en JSON-liste for en strøm), sin statuskode, sine avsluttende metadata — eller et skript. Server-reflection eksponeres som standard, og TLS kan konfigureres med sertifikat og nøkkel i PEM-format. Se Mocke et gRPC-API.

Kodeeksempler

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