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):
- 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
- Inspeksi skema metode
Echo:- Input
EchoRequest { message: string, count: int32 } - Output
EchoResponse { message: string, seq: int64, metadataJson: string }
- Input
- Panggil
Echodengan{"message":"hello-grpc","count":3}:- Unary: satu respons
{message:"hello-grpc", seq, metadataJson}, statusOK - Server-streaming
EchoStreamdengan input yang sama: 3 framestream#1/#2/#3
- Unary: satu respons
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
mapmuncul sebagaimapEntrybersarang; tipe yang dirujuk tidak langsung juga ditarik masuk.
Terkait: Pre-URL lingkungan dan konfigurasi TLS di konsep.