Przejdź do głównej zawartości

gRPC (widok dewelopera)

gRPC to binarne RPC. To narzędzie nie wymaga przygotowania pliku .proto — gdy serwer ma włączone Server Reflection, klient sam odkrywa usługi i metody, a potem pozwala oglądać pola i wywoływać je na żądanie.

Przebieg podstawowy​

Jak używać w UI (trzy kroki)​

Na przykładowej usłudze qrtest.v1.EchoService (grpc://127.0.0.1:18089, jawne h2c):

  1. Połącz żądanie gRPC (url przechowuje host:port). Refleksja uruchamia się automatycznie i daje drzewo metod:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Obejrzyj schemat metody Echo:
    • Wejście EchoRequest { message: string, count: int32 }
    • Wyjście EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Wywołaj Echo z {"message":"hello-grpc","count":3}:
    • Unary: jedna odpowiedź {message:"hello-grpc", seq, metadataJson}, status OK
    • Server-streaming EchoStream z tym samym wejściem: 3 ramki stream#1/#2/#3

Metadane (nagłówki gRPC)​

Nagłówki autoryzacji/śledzenia są przekazywane jako metadane z kluczami zapisanymi małymi literami; nagłówki zastrzeżone jak grpc-* i content-type są odfiltrowywane.

TLS / mTLS​

Użyj Pre-URL grpcs:// i zaimportuj certyfikaty klienta w ustawieniach.

Pułapki (ważne)​

  • Status nie-OK to normalny wynik biznesowy, nie błąd połączenia: timeouty i błędy biznesowe wracają jako kod statusu z być może pustą odpowiedzią — nie traktuj ich jako błędów transportu. Tylko HTTP 4xx oznacza rzeczywisty błąd.
  • Narzędzie obsługuje tylko unary i server-streaming; client-streaming / bidirectional streaming nie mogą być jeszcze wywoływane (dla pełnego streamingu w aplikacji autorytetem jest UI).
  • Typy złożone: pola map pojawiają się jako zagnieżdżone mapEntry; typy wskazywane pośrednio też są pobierane.

Powiązane: Pre-URL środowisk i konfiguracja TLS w concepts.