gRPC (Entwicklersicht)
gRPC ist binäres RPC. Dieses Tool verlangt keine .proto-Datei von Ihnen — solange der Server Server Reflection aktiviert hat, entdeckt der Client Dienste und Methoden automatisch, kann Felder einsehen und sie bei Bedarf aufrufen.
Kernablauf
Nutzung in der UI (drei Schritte)
Am Beispieldienst qrtest.v1.EchoService (grpc://127.0.0.1:18089, unverschlüsseltes h2c):
- Die gRPC-Anfrage verbinden (URL speichert
host:port). Reflection läuft automatisch und liefert den Methodenbaum:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirektionales Streaming
- Das Schema der Methode
Echoeinsehen:- Input
EchoRequest { message: string, count: int32 } - Output
EchoResponse { message: string, seq: int64, metadataJson: string }
- Input
Echomit{"message":"hello-grpc","count":3}aufrufen:- Unary: eine Antwort
{message:"hello-grpc", seq, metadataJson}, StatusOK - Server-streaming
EchoStreammit derselben Eingabe: 3 Framesstream#1/#2/#3
- Unary: eine Antwort
Metadaten (gRPC-Header)
Auth-/Tracing-Header werden als Metadaten mit kleingeschriebenen Schlüsseln übergeben; reservierte Header wie grpc-* und content-type werden herausgefiltert.
TLS / mTLS
Eine grpcs://-Pre-URL verwenden und Client-Zertifikate in den Einstellungen importieren.
Stolperfallen (wichtig)
- Ein Nicht-OK-Status ist ein normales Geschäftsergebnis, kein Verbindungsfehler: Timeouts und Fachfehler kommen als Statuscode mit eventuell leerer Antwort zurück — nicht als Transportfehler behandeln. Nur HTTP 4xx zeigt einen echten Fehler an.
- Das Tool unterstützt nur unary und server-streaming; client-streaming / bidirektionales Streaming ist noch nicht aufrufbar (für volles Streaming in der App ist die UI maßgeblich).
- Komplexe Typen:
map-Felder erscheinen als verschachteltemapEntry; indirekt referenzierte Typen werden mitgezogen.
Verwandt: Umgebung-Pre-URLs und TLS-Konfiguration in den Kernkonzepten.