gRPC (डेवलपर व्यू)
gRPC बाइनरी RPC है। यह टूल आपसे .proto फ़ाइल तैयार करने की माँग नहीं करता — जब तक सर्वर Server Reflection चालू करता है, क्लाइंट सर्विस और मेथड अपने-आप खोज लेता है, फिर फ़ील्ड देखकर ज़रूरत पर उन्हें कॉल करता है।
कोर फ़्लो
UI में कैसे उपयोग करें (तीन चरण)
सैंपल सर्विस qrtest.v1.EchoService (grpc://127.0.0.1:18089, प्लेनटेक्स्ट h2c) के साथ:
- gRPC रिक्वेस्ट कनेक्ट करें (url
host:portरखता है)। Reflection अपने-आप चलता है और मेथड ट्री देता है:/qrtest.v1.EchoService/Echo— unary/qrtest.v1.EchoService/EchoStream— server-streaming/qrtest.v1.EchoService/Collect— client-streaming/qrtest.v1.EchoService/Chat— bidirectional streaming
Echoमेथड की स्कीम देखें:- इनपुट
EchoRequest { message: string, count: int32 } - आउटपुट
EchoResponse { message: string, seq: int64, metadataJson: string }
- इनपुट
Echoको{"message":"hello-grpc","count":3}के साथ इनवोक करें:- Unary: एक
{message:"hello-grpc", seq, metadataJson}रिस्पॉन्स, स्टेटसOK - समान इनपुट के साथ Server-streaming
EchoStream: 3 फ़्रेमstream#1/#2/#3
- Unary: एक
मेटाडेटा (gRPC हेडर)
प्रमाणीकरण/ट्रेसिंग हेडर लोअरकेस्ड कीज़ वाले मेटाडेटा के रूप में पास होते हैं; grpc-* और content-type जैसे आरक्षित हेडर फ़िल्टर हो जाते हैं।
TLS / mTLS
grpcs:// Pre-URL उपयोग करें और सेटिंग्स में क्लाइंट सर्टिफिकेट इंपोर्ट करें।
सावधानियाँ (महत्वपूर्ण)
- ग़ैर-OK स्टेटस एक सामान्य बिज़नेस परिणाम है, कनेक्शन विफलता नहीं: टाइमआउट और बिज़नेस त्रुटियाँ स्टेटस कोड और संभवतः खाली रिस्पॉन्स के साथ लौटती हैं — उन्हें ट्रांसपोर्ट त्रुटि न मानें। केवल HTTP 4xx वास्तविक त्रुटि दर्शाता है।
- टूल केवल unary और server-streaming समर्थन करता है; client-streaming / bidirectional streaming अभी इनवोक नहीं हो सकते (ऐप के अंदर पूर्ण स्ट्रीमिंग के लिए UI प्रामाणिक है)।
- जटिल प्रकार:
mapफ़ील्ड नेस्टेडmapEntryके रूप में दिखते हैं; अप्रत्यक्ष संदर्भित प्रकार भी खिंच आते हैं।
संबंधित: एनवायरनमेंट Pre-URL और TLS कॉन्फ़िगरेशन concepts में।