नेमस्पेस <SI-Namespace>::proxy::methods

नेमस्पेस <SI-Namespace>::proxy::methods AUTOSAR Adaptive Platform के मॉड्यूल com में किसी ServiceInterface के मेथड कॉल्स के लिए प्रॉक्सी-साइड क्लासेस प्रदान करता है। प्रत्येक ClientServerOperation के लिए, मेटा-मॉडल एट्रिब्यूट ClientServerOperation.fireAndForget के आधार पर, या तो नियमित कॉल्स के लिए क्लास <Method> या यूनिडायरेक्शनल कॉल्स के लिए <FnFMethod> को इंस्टैंशिएट किया जाता है। जहाँ नियमित मेथड्स सर्वर-साइड रिटर्न वैल्यूज और त्रुटि संदेशों का समर्थन करती हैं, वहीं फ़ायर-एंड-फ़ॉरगेट मेथड्स डिज़ाइन के अनुसार किसी भी प्रतिक्रिया संदेश को प्रोसेस नहीं करती हैं। इस दौरान मेथड ऑब्जेक्ट्स का लाइफ़टाइम सीधे मूल प्रॉक्सी इंस्टेंस के अस्तित्व से बंधा होना संभावित है। प्रश्न (खुला)

अधिक ›

संदर्भ

नेमस्पेस <SI-Namespace>::proxy::methods AUTOSAR Adaptive Platform के मॉड्यूल com के अंतर्गत सर्विस प्रॉक्सीज़ के लिए मेथड-विशिष्ट इंटरफ़ेस क्लासेस को मैप करता है। किसी ServiceInterface में मॉडल किया गया प्रत्येक ClientServerOperation अपनी कॉन्फ़िगरेशन विशेषताओं के आधार पर एक संगत मेथड क्लास में मैप किया जाता है। इस नेमस्पेस में मुख्य रूप से दो क्लास पैटर्न शामिल हैं: प्रतिक्रिया व्यवहार वाले ऑपरेशन्स के लिए <Method> और तथाकथित फ़ायर-एंड-फ़ॉरगेट ऑपरेशन्स के लिए <FnFMethod>।

इन क्लासेस की प्राथमिक ज़िम्मेदारी किसी क्लाइंट एप्लिकेशन से मेथड कॉल्स प्राप्त करना, ट्रांसमिशन के लिए इनपुट पैरामीटर्स तैयार करना और अंतर्निहित मिडलवेयर लेयर के साथ संचार को संभालना है। इंटरेक्शन पार्टनर्स में कॉलर साइड पर एप्लिकेशन-विशिष्ट क्लाइंट कंपोनेंट्स और मेडिएशन साइड पर नेमस्पेस <SI-Namespace>::proxy की मूल प्रॉक्सी क्लास शामिल हैं, जो मेथड इंस्टेंसेस को एग्रीगेट करती है।

दोनों क्लासेस का विभेदन मेटा-मॉडल एट्रिब्यूट ClientServerOperation.fireAndForget पर आधारित है:

• <Method> उन ऑपरेशन्स के लिए जनरेट किया जाता है जहाँ ClientServerOperation.fireAndForget == FALSE कॉन्फ़िगर किया गया हो। संभवतः इस क्लास का कोई इंस्टेंस किसी सर्विस के एसिंक्रोनस कॉल को एनकैप्सुलेट करता है और किसी भविष्योन्मुखी परिणाम प्रकार (फ्यूचर रिजल्ट टाइप) के माध्यम से परिणाम या संभावित एप्लिकेशन त्रुटियाँ प्रदान करता है। प्रश्न Q-75c8a4495ee9c1cb (खुला)
• <FnFMethod> तब जनरेट किया जाता है जब ClientServerOperation.fireAndForget == TRUE कॉन्फ़िगर किया गया हो। इस क्लास की किसी मेथड का एक यूनिडायरेक्शनल कॉल के रूप में लागू होना संभावित है, जो सर्वर से किसी प्रतिक्रिया की अपेक्षा नहीं करती है और कॉलर को कोई रिटर्न वैल्यू नहीं देती है। प्रश्न Q-1f9698a27137b73d (खुला)

जीवनचक्र

इस नेमस्पेस में परिभाषित मेथड क्लासेस का निर्माण और विनाश मूल प्रॉक्सी से दृढ़ता से जुड़ा हुआ है। मेथड ऑब्जेक्ट्स का लाइफ़टाइम नेमस्पेस <SI-Namespace>::proxy में समाहित प्रॉक्सी इंस्टेंस के लाइफ़टाइम से बंधा होना संभावित है। प्रश्न Q-ec1ef4d1ebc90d5a (खुला) प्रॉक्सी ऑब्जेक्ट के इंस्टैंशिएशन के दौरान, <Method> और <FnFMethod> के संबंधित इंस्टेंसेस मेंबर्स के रूप में इनिशियलाइज़ किए जाते हैं और कॉल्स के लिए एप्लिकेशन को तुरंत उपलब्ध होते हैं।

आंतरिक स्थिति के संबंध में, मेथड ऑब्जेक्ट्स अपने इनिशियलाइज़ेशन के बाद निरंतर कॉल-रेडी स्थिति में रहते हैं, जब तक कि प्रॉक्सी इंस्टेंस मान्य रहता है। अलग-अलग कॉल्स के स्टेट ट्रांज़िशन्स स्वयं मेथड इंस्टेंस को प्रभावित नहीं करते हैं, बल्कि व्यक्तिगत कॉल कॉन्टेक्स्ट्स को प्रभावित करते हैं। क्लाइंट एप्लिकेशन के कई थ्रेड्स से समवर्ती एक्सेस के मामले में, यह सुनिश्चित किया जाना चाहिए कि उसी मेथड इंस्टेंस के समानांतर कॉल्स थ्रेड-सुरक्षित रूप से शुरू किए जा सकें। स्कोप से बाहर निकलने पर या प्रॉक्सी इंस्टेंस के स्पष्ट विनाश पर विनाश परोक्ष रूप से होता है, जिससे खुले संचार संसाधन साफ़ हो जाते हैं।

उपयोग पथ

क्लाइंट एप्लिकेशन द्वारा मेथड क्लासेस का उपयोग करने का विशिष्ट क्रम एक निर्धारित अनुक्रम का पालन करता है:

1. प्रॉक्सी प्रावधान: एप्लिकेशन नेमस्पेस <SI-Namespace>::proxy से सर्विस प्रॉक्सी का एक इनिशियलाइज़्ड इंस्टेंस जनरेट या प्राप्त करता है।
2. मेथड एक्सेस: वांछित ऑपरेशन का कॉल प्रॉक्सी इंस्टेंस के मेथड मेंबर्स के माध्यम से होता है, जो क्लासेस <Method> या <FnFMethod> को इंस्टैंशिएट करते हैं।
3. एक नियमित ऑपरेशन का निष्पादन: <Method> के किसी इंस्टेंस को कॉल करते समय, क्लाइंट आवश्यक इनपुट पैरामीटर्स पास करता है। कॉल टारगेट सिस्टम में ट्रांसमिशन को ट्रिगर करता है। रिटर्न ऑब्जेक्ट एप्लिकेशन को परिणाम आने की प्रतीक्षा करने या एसिंक्रोनस रूप से काम जारी रखने में सक्षम बनाता है।
4. एक फ़ायर-एंड-फ़ॉरगेट ऑपरेशन का निष्पादन: <FnFMethod> के किसी इंस्टेंस को कॉल करते समय, पैरामीटर्स पास किए जाते हैं और ट्रांसमिशन लेयर पर अग्रेषित करने के लिए तुरंत सबमिट किए जाते हैं। मेथड कॉलर को सौंपने के तुरंत बाद वापस लौट आती है।
5. परिणाम प्रोसेसिंग: नियमित मेथड कॉल्स के मामले में, क्लाइंट प्रदान किए गए परिणाम का मूल्यांकन करता है और जाँचता है कि क्या ऑपरेशन सफलतापूर्वक पूरा हुआ था।

त्रुटि परिदृश्य

त्रुटि प्रबंधन दोनों प्रकार की मेथड्स के बीच मौलिक रूप से भिन्न होता है: <Method> के माध्यम से नियमित ऑपरेशन्स के दौरान, ट्रांसमिशन लेयर त्रुटियाँ और इंटरफ़ेस परिभाषा में निर्दिष्ट विशिष्ट एप्लिकेशन त्रुटियाँ दोनों हो सकती हैं। चूँकि ClientServerOperation.fireAndForget == FALSE कॉन्फ़िगर किया गया है, संभावित त्रुटि संदेशों सहित प्रतिक्रिया संदेश सर्वर द्वारा प्रॉक्सी को वापस रिपोर्ट किए जाते हैं। क्लाइंट एप्लिकेशन कॉल के रिटर्न ऑब्जेक्ट के माध्यम से इन त्रुटियों का मूल्यांकन कर सकता है और उपयुक्त हैंडलिंग रूटीन्स शुरू कर सकता है।

इसके विपरीत, ClientServerOperation.fireAndForget == TRUE के कारण <FnFMethod> का डिज़ाइन कॉलर को किसी भी सर्वर-साइड त्रुटि रिपोर्टिंग को सिद्धांत रूप से बाहर करता है। ऑपरेशन के निष्पादन के दौरान सर्वर पर होने वाली त्रुटियों को प्रॉक्सी तक प्रेषित नहीं किया जा सकता है। प्रीकंडीशन्स और पोस्टकंडीशन्स स्थानीय कॉल साइड तक सीमित हैं: प्रीकंडीशन्स के लिए मान्य पैरामीटर वैल्यूज और एक तैयार संचार इंफ्रास्ट्रक्चर की आवश्यकता होती है। यदि ट्रांसमिशन के दौरान कोई स्थानीय त्रुटि होती है, तो इसे मेथड कॉल के समय सीधे संकेतित किया जा सकता है, जबकि सर्वर-साइड निष्पादन त्रुटियाँ कॉलर के लिए अनदेखी रह जाती हैं।