Passa al contenuto principale

gRPC (vista sviluppatore)

gRPC è RPC binario. Questo strumento non richiede di preparare un file .proto — finché il server abilita Server Reflection, il client scopre servizi e metodi automaticamente, poi ispeziona i campi e li invoca a richiesta.

Flusso principale​

Come usare nella UI (tre passi)​

Usando il servizio di esempio qrtest.v1.EchoService (grpc://127.0.0.1:18089, h2c in chiaro):

  1. Connetti la richiesta gRPC (l'url memorizza host:port). La reflection gira automaticamente e produce l'albero dei metodi:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Ispeziona lo schema del metodo Echo:
    • Input EchoRequest { message: string, count: int32 }
    • Output EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Invoca Echo con {"message":"hello-grpc","count":3}:
    • Unary: una risposta {message:"hello-grpc", seq, metadataJson}, stato OK
    • Server-streaming EchoStream con lo stesso input: 3 frame stream#1/#2/#3

Metadata (header gRPC)​

Gli header di autenticazione/tracing vengono passati come metadata con chiavi in minuscolo; gli header riservati come grpc-* e content-type sono filtrati.

TLS / mTLS​

Usa un Pre-URL grpcs:// e importa i certificati client nelle impostazioni.

Punti di attenzione (importanti)​

  • Uno stato non-OK è un risultato di business normale, non un fallimento di connessione: timeout ed errori di business tornano come codice di stato con risposta eventualmente vuota — non trattarli come errori di trasporto. Solo HTTP 4xx indica un errore reale.
  • Lo strumento supporta solo unary e server-streaming; client-streaming / bidirectional streaming non sono ancora invocabili (per lo streaming completo dentro l'app fa fede la UI).
  • Tipi complessi: i campi map appaiono come mapEntry annidati; anche i tipi referenziati indirettamente vengono tirati dentro.

Correlato: Pre-URL d'ambiente e configurazione TLS in concepts.