Zum Hauptinhalt springen

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):

  1. 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
  2. Das Schema der Methode Echo einsehen:
    • Input EchoRequest { message: string, count: int32 }
    • Output EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Echo mit {"message":"hello-grpc","count":3} aufrufen:
    • Unary: eine Antwort {message:"hello-grpc", seq, metadataJson}, Status OK
    • Server-streaming EchoStream mit derselben Eingabe: 3 Frames stream#1/#2/#3

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 verschachtelte mapEntry; indirekt referenzierte Typen werden mitgezogen.

Verwandt: Umgebung-Pre-URLs und TLS-Konfiguration in den Kernkonzepten.