gRPC

Klik kanan di pohon ▸ Tambah ▸ Permintaan gRPC.

Konfigurasi

Kolom	Peran
URL	host:port server
Layanan / Metode	Layanan dan RPC yang dipanggil
Tipe panggilan	unary, server-stream, client-stream, bidirectional-stream
Pesan permintaan	Pesannya, dalam JSON
Metadata	Pasangan kunci / nilai yang dikirim bersama panggilan (di sinilah kredensial lewat)

Dari mana definisi layanannya berasal

Tiga sumber yang mungkin, menurut urutan prioritas:

1. sebuah himpunan deskriptor yang diperoleh melalui refleksi server — inilah yang dipasang oleh impor lewat refleksi, dan ia mengalahkan yang lain;
2. isi .proto sebaris, yang disimpan di dalam proyek;
3. sebuah jalur menuju .proto di disk.

Opsi pertama membawa konsekuensi praktis yang penting: sebuah permintaan yang diimpor lewat refleksi tetap berfungsi tanpa koneksi, tanpa perlu servernya dapat dihubungi.

Mengimpor lewat refleksi

Dari modal impor gRPC, masukkan host:port: Restorm mengueri layanan refleksinya, memuat deskriptornya, dan membangun strukturnya — satu folder per layanan, satu permintaan per RPC, lengkap dengan pesan contoh.

Menyambung kembali ke alamat yang sama dikenali sebagai sinkronisasi ulang dan memperbarui struktur yang sudah ada alih-alih menggandakannya.

Jika servernya tidak mengimplementasikan refleksi, Restorm menyatakannya secara eksplisit: impor saja .proto-nya. Lihat Mengimpor .proto gRPC.

Transport

Tersedia tiga transport:

Transport	Kapan digunakan
grpc (bawaan)	gRPC bawaan di atas HTTP/2
grpc-web	Server di balik proxy gRPC-Web
connect	Server Connect-RPC

Panggilan streaming

Untuk ketiga mode streaming, panel respons menampilkan pesannya secara berkelanjutan. Di dalam skenario, gunakan aksi gRPC connect, gRPC send, dan Tutup koneksi gRPC: koneksinya tetap terbuka di antara kotak-kotaknya, setiap pesan yang diterima memancarkan sebuah peristiwa, dan penutupannya melakukan setengah-penutupan di sisi klien.

Mode server

Restorm mampu menghosting server gRPC simulasi: sebuah daftar metode yang disimulasikan, masing-masing dengan pesan responsnya (sebuah larik JSON untuk aliran), kode statusnya, metadata akhirnya, atau sebuah skrip. Refleksi server diekspos secara bawaan, dan TLS dapat dikonfigurasi lewat sertifikat dan kunci berformat PEM. Lihat Menyimulasikan API gRPC.

Cuplikan kode

Empat belas sasaran: grpcurl, grpc_cli, grpcurl dalam gRPC-Web, curl dalam Connect-RPC, JavaScript dan TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).