gRPC कोड जनरेट करना

फिर से स्वागत है! पिछले पाठ में हमने प्रोटोबफ़ का उपयोग करके अपनी डेटा संरचनाओं और सेवाओं को परिभाषित करना सीखा।

अब अपनी पसंदीदा प्रोग्रामिंग भाषा में इन परिभाषाओं का वास्तव में उपयोग कैसे करें? यहीं कोड निर्माण काम आता है!

यह किसी योजना से स्रोत कोड अपने-आप बनाने की प्रक्रिया है, जिससे आपको बार-बार लिखा जाने वाला अनावश्यक प्रारंभिक कोड लिखने से बचाया जाता है।

gRPC बड़े पैमाने पर उत्पन्न कोड पर निर्भर करता है, जिसे अक्सर स्टब्स या प्रॉक्सी कहा जाता है। ये स्टब्स आपके अनुप्रयोग के तर्क और अंतर्निहित gRPC संचार तंत्र के बीच सेतु का काम करते हैं।

• क्लाइंट स्टब्स: आपकी .proto फ़ाइल में परिभाषित सेवा जैसी विधियाँ प्रदान करते हैं। जब आप क्लाइंट स्टब की किसी विधि को कॉल करते हैं, तो वह डेटा को पैकेज करके नेटवर्क पर भेजती है और उत्तर को खोलती है।
• सर्वर स्टब्स: एक अंतराफलक परिभाषित करते हैं, जिसे आपके सर्वर कार्यान्वयन को पूरा करना होता है। यह अनुरोध प्राप्त करता है, उन्हें आपके कोड तक पहुँचाता है और उत्तर वापस भेजता है।

इन स्टब को बनाने के पीछे की जादुई शक्ति Protobuf Compiler है, जिसे आमतौर पर protoc कहा जाता है।

protoc एक कमांड-लाइन टूल है, जो आपकी .proto फाइलों को पढ़कर, आपके द्वारा निर्दिष्ट प्लगइन के आधार पर विभिन्न भाषाओं में स्रोत कोड तैयार करता है।

यह किसी भी gRPC प्रोजेक्ट का एक महत्वपूर्ण घटक है, क्योंकि यह विभिन्न सेवाओं और भाषाओं के बीच सशक्त टाइपिंग और एकसमान संचार इंटरफ़ेस सुनिश्चित करता है।

protoc का उपयोग करने का सामान्य सिंटैक्स कुछ इस प्रकार होता है:

protoc --<LANG>_out=. --grpc_out=. my_service.proto

• --<LANG>_out=.: यह फ्लैग protoc को किसी विशेष भाषा के लिए Protobuf संदेश क्लास बनाने और उन्हें रखने का स्थान बताता है (जैसे, --java_out, --python_out और वर्तमान निर्देशिका के लिए .)।
• --grpc_out=.: यह फ्लैग, जिसका उपयोग अक्सर gRPC-विशिष्ट प्लगइन के साथ किया जाता है, gRPC सेवा इंटरफ़ेस और स्टब क्लास तैयार करता है।
• my_service.proto: आपकी Protobuf परिभाषा फाइल का पथ।

कोड तैयार करने से पहले आपको protoc इंस्टॉल करना होगा। इंस्टॉल करने की प्रक्रिया ऑपरेटिंग सिस्टम के अनुसार अलग-अलग होती है:

• बाइनरी डाउनलोड करें: आप आधिकारिक Protobuf GitHub रिलीज़ पेज से पहले से संकलित बाइनरी डाउनलोड कर सकते हैं।
• पैकेज प्रबंधक: Linux पर आप apt-get install protobuf-compiler का उपयोग कर सकते हैं। macOS पर brew install protobuf का उपयोग कर सकते हैं।
• स्रोत कोड से बनाएँ: उन्नत उपयोगकर्ता इसे इसके स्रोत कोड से संकलित कर सकते हैं।

हमेशा सुनिश्चित करें कि protoc आपके सिस्टम के PATH में मौजूद हो।

कोड तैयार करने की प्रक्रिया दिखाने के लिए आइए एक सरल greet.proto फाइल का उपयोग करें। यह फाइल एक Greeter सेवा और उसके संदेशों को परिभाषित करती है:

syntax = "proto3";

package greeter;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

यह हमारे protoc कंपाइलर के लिए इनपुट है।

अपने greet.proto के लिए Java कोड तैयार करने हेतु हम आमतौर पर इस जैसी कमांड का उपयोग करेंगे:

protoc \
  --plugin=protoc-gen-grpc-java=/path/to/grpc-java-plugin \
  --java_out=. \
  --grpc_out=. \
  greet.proto

यहाँ --plugin स्पष्ट रूप से protoc को बताता है कि gRPC Java प्लगइन कहाँ ढूँढना है। gRPC सेवा इंटरफ़ेस तैयार करने के लिए यह आवश्यक है।

protoc चलाने के बाद आपको अपनी निर्दिष्ट आउटपुट निर्देशिका में नई Java फाइलें मिलेंगी। हमारे greet.proto उदाहरण के लिए, आपको आमतौर पर ये फाइलें दिखाई देंगी:

• GreeterGrpc.java: इसमें अमूर्त GreeterImplBase सेवा और क्लाइंट स्टब क्लास शामिल होती हैं (जैसे, GreeterBlockingStub, GreeterFutureStub)।
• Greet.java: यह एक कंटेनर क्लास है, जिसमें HelloRequest और HelloReply जैसी तैयार की गई Protobuf संदेश क्लास, साथ ही उनके बिल्डर और एक्सेसर शामिल होते हैं।

ये फाइलें क्रमबद्धन, विपरीत-क्रमबद्धन और नेटवर्क संचार से जुड़े सभी विवरणों को संभालती हैं।

यह समझना महत्वपूर्ण है कि protoc स्वयं केवल मूल Protobuf संदेश क्लास तैयार करता है।

gRPC-विशिष्ट सेवा इंटरफ़ेस और स्टब तैयार करने के लिए यह प्लगइन पर निर्भर करता है। उदाहरण के लिए, Java के लिए आपको protoc-gen-grpc-java प्लगइन की आवश्यकता होती है।

gRPC द्वारा समर्थित प्रत्येक भाषा (Python, Go, C++, Node.js आदि) का अपना विशिष्ट प्लगइन होता है, जो protoc के साथ मिलकर आवश्यक gRPC कोड तैयार करता है।

बहुत अच्छा! आपने gRPC कोड तैयार करने की मूल प्रक्रिया सीख ली है:

• हमने समझा कि gRPC संचार के लिए स्टब क्यों आवश्यक हैं।
• हमने protoc कंपाइलर के बारे में जाना, जो कोड तैयार करने वाला टूल है।
• हमने देखा कि प्लगइन भाषा-विशिष्ट gRPC कोड तैयार करने के लिए protoc की क्षमताओं का विस्तार करते हैं।
• हमने .proto परिभाषा से Java कोड तैयार करने का एक उदाहरण देखा।

अगले चरण में, हम इस तैयार किए गए कोड का उपयोग करके एक सरल एकल-प्रतिक्रिया gRPC सेवा और क्लाइंट लागू करेंगे!