gRPC

Ağaçta sağ tıklayın ▸ Ekle ▸ gRPC isteği.

Yapılandırma

Alan	Rolü
URL	Sunucunun host:port adresi
Servis / Yöntem	Çağrılan servis ve RPC
Çağrı türü	unary, server-stream, client-stream, bidirectional-stream
İstek mesajı	Mesajın kendisi, JSON biçiminde
Meta veriler	Çağrıyla birlikte iletilen anahtar / değer çiftleri (kimlik bilgileri buradan geçer)

Servis tanımı nereden gelir

Öncelik sırasına göre üç olası kaynak vardır:

1. sunucu yansımasıyla elde edilen bir tanımlayıcı kümesi — yansımayla içe aktarmanın bıraktığı şey budur ve diğerlerinin önüne geçer;
2. projede saklanan satır içi .proto içeriği;
3. diskteki bir .proto dosyasının yolu.

İlk seçeneğin pratikte önemli bir sonucu vardır: yansımayla içe aktarılmış bir istek, sunucuya erişilemese bile çevrimdışı çalışmayı sürdürür.

Yansımayla içe aktarma

gRPC içe aktarma penceresinde host:port adresini girin: Restorm yansıma servisini sorgular, tanımlayıcıları yükler ve ağacı oluşturur — servis başına bir klasör, RPC başına bir istek ve bir örnek mesaj.

Aynı adrese yeniden bağlanmak bir yeniden eşitleme olarak algılanır ve mevcut ağacı çoğaltmak yerine günceller.

Sunucu yansımayı uygulamıyorsa Restorm bunu açıkça bildirir: o durumda .proto dosyasını içe aktarın. Bkz. gRPC içe aktarma (.proto veya yansıma).

Taşımalar

Üç taşıma kullanılabilir:

Taşıma	Ne zaman kullanılır
grpc (varsayılan)	HTTP/2 üzerinde yerel gRPC
grpc-web	Bir gRPC-Web ara sunucusunun arkasındaki sunucu
connect	Connect-RPC sunucusu

Akış çağrıları

Üç akış modunun tümünde yanıt paneli mesajları geldikçe gösterir. Bir senaryoda gRPC bağlantısı, gRPC gönderimi ve gRPC bağlantısını kapat eylemlerini kullanın: bağlantı kutular arasında açık kalır, alınan her mesaj bir olay yayar ve kapatma istemci tarafında yarı kapatma gerçekleştirir.

Sunucu modu

Restorm bir simülasyon gRPC sunucusu barındırabilir: her biri kendi yanıt mesajıyla (bir akış için JSON dizisi), durum koduyla, sonlandırma meta verileriyle ya da bir betikle tanımlanmış simüle edilmiş yöntemlerin listesi. Sunucu yansıması varsayılan olarak sunulur ve TLS, PEM biçiminde sertifika ve anahtarla yapılandırılabilir. Bkz. Bir gRPC servisini simüle etme.

Kod parçacıkları

On dört hedef: grpcurl, grpc_cli, gRPC-Web için grpcurl, Connect-RPC için curl, JavaScript ve TypeScript (@grpc/grpc-js), Python (grpcio), Go, Java (grpc-java), C# (Grpc.Net.Client), Ruby, Rust (tonic), Kotlin (grpc-kotlin), Swift (grpc-swift).