Ana içeriğe geç

gRPC (Geliştirici Görünümü)

gRPC ikili RPC'dir. Bu araç .proto dosyası hazırlamanızı gerektirmez — sunucuda Server Reflection açık olduğu sürece istemci servisleri ve metotları otomatik keşfeder, sonra alanları inceleyip talep üzerine çağırır.

Temel Akış​

UI'da Nasıl Kullanılır (Üç Adım)​

Örnek servis qrtest.v1.EchoService üzerinde (grpc://127.0.0.1:18089, açık metin h2c):

  1. gRPC isteğini Bağlayın (url host:port saklar). Reflection otomatik çalışır ve metot ağacını verir:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — çift yönlü streaming
  2. Echo metodunun şemasını İnceleyin:
    • Girdi EchoRequest { message: string, count: int32 }
    • Çıktı EchoResponse { message: string, seq: int64, metadataJson: string }
  3. {"message":"hello-grpc","count":3} ile Echo'yu Çağırın:
    • Unary: tek {message:"hello-grpc", seq, metadataJson} yanıtı, durum OK
    • Aynı girdiyle server-streaming EchoStream: 3 çerçeve stream#1/#2/#3

Meta Veriler (gRPC Header'ları)​

Kimlik doğrulama/izleme header'ları küçük harfli anahtarlarla meta veri olarak iletilir; grpc-* ve content-type gibi rezerve header'lar filtrelenir.

TLS / mTLS​

grpcs:// Pre-URL kullanın ve ayarlardan istemci sertifikalarını içe aktarın.

Dikkat Edilmesi Gerekenler (Önemli)​

  • OK dışı durum normal bir iş sonucudur, bağlantı hatası değildir: zaman aşımları ve iş hataları muhtemelen boş bir yanıtla birlikte bir durum kodu olarak döner — bunları aktarım hatası saymayın. Yalnızca HTTP 4xx gerçek bir hatayı gösterir.
  • Araç yalnızca unary ve server-streaming'i destekler; client-streaming / çift yönlü streaming henüz çağrılamaz (uygulama içinde tam streaming için UI yetkilidir).
  • Karmaşık tipler: map alanları iç içe mapEntry olarak görünür; dolaylı referans verilen tipler de çekilir.

İlgili: ortam Pre-URL'leri ve TLS yapılandırması concepts içinde.