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):
- 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
- Ispeziona lo schema del metodo
Echo:- Input
EchoRequest { message: string, count: int32 } - Output
EchoResponse { message: string, seq: int64, metadataJson: string }
- Input
- Invoca
Echocon{"message":"hello-grpc","count":3}:- Unary: una risposta
{message:"hello-grpc", seq, metadataJson}, statoOK - Server-streaming
EchoStreamcon lo stesso input: 3 framestream#1/#2/#3
- Unary: una risposta
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
mapappaiono comemapEntryannidati; anche i tipi referenziati indirettamente vengono tirati dentro.
Correlato: Pre-URL d'ambiente e configurazione TLS in concepts.