Lewati ke konten utama

gRPC (Perspektif Pengembang)

gRPC adalah RPC biner. Alat ini tidak mengharuskan Anda menyiapkan file .proto — selama server mengaktifkan Server Reflection, klien menemukan layanan dan metode secara otomatis, lalu menginspeksi bidang dan memanggilnya sesuai kebutuhan.

Alur Inti​

Cara Menggunakan di UI (Tiga Langkah)​

Menggunakan layanan contoh qrtest.v1.EchoService (grpc://127.0.0.1:18089, plaintext h2c):

  1. Hubungkan permintaan gRPC (url menyimpan host:port). Reflection berjalan otomatis dan menghasilkan pohon metode:
    • /qrtest.v1.EchoService/Echo — unary
    • /qrtest.v1.EchoService/EchoStream — server-streaming
    • /qrtest.v1.EchoService/Collect — client-streaming
    • /qrtest.v1.EchoService/Chat — bidirectional streaming
  2. Inspeksi skema metode Echo:
    • Input EchoRequest { message: string, count: int32 }
    • Output EchoResponse { message: string, seq: int64, metadataJson: string }
  3. Panggil Echo dengan {"message":"hello-grpc","count":3}:
    • Unary: satu respons {message:"hello-grpc", seq, metadataJson}, status OK
    • Server-streaming EchoStream dengan input yang sama: 3 frame stream#1/#2/#3

Metadata (Header gRPC)​

Header auth/tracing diteruskan sebagai metadata dengan key huruf kecil; header tercadang seperti grpc-* dan content-type disaring.

TLS / mTLS​

Gunakan Pre-URL grpcs:// dan impor sertifikat klien di pengaturan.

Perangkap (Penting)​

  • Status non-OK adalah hasil bisnis yang normal, bukan kegagalan koneksi: timeout dan error bisnis kembali sebagai kode status dengan respons yang mungkin kosong — jangan perlakukan sebagai error transport. Hanya HTTP 4xx yang menandakan error sesungguhnya.
  • Alat ini hanya mendukung unary dan server-streaming; client-streaming / bidirectional streaming belum dapat dipanggil (untuk streaming penuh di dalam aplikasi, UI adalah acuannya).
  • Tipe kompleks: bidang map muncul sebagai mapEntry bersarang; tipe yang dirujuk tidak langsung juga ditarik masuk.

Terkait: Pre-URL lingkungan dan konfigurasi TLS di konsep.