Gå til hovedinnhold

gRPC (utviklerperspektiv)

gRPC er binær RPC. Dette verktøyet krever ikke at du forbereder en .proto-fil — så lenge serveren har aktivert Server Reflection, oppdager klienten tjenester og metoder automatisk, og inspiserer deretter felter og kaller dem etter behov.

Kjerneflyt​

Slik bruker du det i UI (tre trinn)​

Med eksempeltjenesten qrtest.v1.EchoService (grpc://127.0.0.1:18089, plaintext h2c):

  1. Koble til gRPC-forespørselen (url lagrer host:port). Reflection kjører automatisk og gir metodetreet:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Inspiser skjemaet til Echo-metoden:
    • Input EchoRequest { message: string, count: int32 }
    • Output EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Kall Echo med {"message":"hello-grpc","count":3}:
    • Unary: ett svar {message:"hello-grpc", seq, metadataJson}, status OK
    • Server-streaming EchoStream med samme input: 3 frames stream#1/#2/#3

Metadata (gRPC-headere)​

Auth/tracing-headere sendes som metadata med nøkler i små bokstaver; reserverte headere som grpc-* og content-type filtreres ut.

TLS / mTLS​

Bruk en grpcs://-Pre-URL og importer klientsertifikater i innstillingene.

Fallgruver (viktig)​

  • En ikke-OK-status er et normalt forretningsresultat, ikke en tilkoblingsfeil: tidsavbrudd og forretningsfeil kommer tilbake som en statuskode med et muligens tomt svar — ikke behandle dem som transportfeil. Bare HTTP 4xx indikerer en reell feil.
  • Verktøyet støtter kun unary og server-streaming; client-streaming / bidirectional streaming kan ikke kalles ennå (for full streaming inne i appen er UI-en autoritativ).
  • Komplekse typer: map-felter vises som nestede mapEntry; indirekte refererte typer trekkes også inn.

Relatert: miljø-Pre-URL-er og TLS-konfigurasjon i konsepter.