क्लास ara::tsync::TsyncException

अपवाद क्लास ara::tsync::TsyncException Adaptive Platform के भीतर Time Synchronization के दौरान होने वाली त्रुटियों के एनकैप्सुलेशन और अग्रेषण का कार्य करती है। यह ara::core::Exception से व्युत्पन्न होती है और अपने निर्माण के समय अनिवार्य रूप से एक विशिष्ट ara::core::ErrorCode प्राप्त करती है, जो त्रुटि के कारण का वर्णन करता है [SWS_TS_00903]। कंस्ट्रक्टर को noexcept के रूप में घोषित किया गया है, जिसके साथ अपवाद का इंस्टैंशिएशन गारंटीकृत रूप से अपवाद-सुरक्षित और थ्रेड-सुरक्षित रूप से होता है [SWS_TS_00903]। अनुप्रयोग निहित त्रुटि कोड का लक्षित मूल्यांकन करने के लिए अपने त्रुटि हैंडलिंग पथों में अपवाद को पकड़ सकते हैं। प्रश्न (खुला)

अधिक ›

संदर्भ

क्लास ara::tsync::TsyncException AUTOSAR Adaptive Platform के भीतर Time Synchronization (tsync) कार्यात्मक क्षेत्र के लिए समर्पित अपवाद क्लास का प्रतिनिधित्व करती है। विनिर्देश के अनुसार, इसे हेडर ara/tsync/tsync_error_domain.h में घोषित किया गया है और यह समय सिंक्रनाइज़ेशन द्वारा ट्रिगर किए गए अपवादों को मैप करने के लिए एक केंद्रीय प्रकार के रूप में कार्य करती है [SWS_TS_00903]। बेस क्लास ara::core::Exception से सार्वजनिक व्युत्पत्ति के माध्यम से, यह प्लेटफ़ॉर्म-व्यापी त्रुटि हैंडलिंग आर्किटेक्चर में सहजता से एकीकृत होती है।

सिस्टम आर्किटेक्चर में, ara::tsync::TsyncException टाइम सिंक्रनाइज़ेशन सेवा के कार्यान्वयन घटकों और एप्लिकेशन मॉड्यूल के बीच सूचना वाहक की भूमिका निभाती है। यदि सिंक्रनाइज़ेशन के दौरान कोई गंभीर त्रुटि होती है, तो इसे अलग से खारिज नहीं किया जाता है, बल्कि एक मानकीकृत अपवाद के रूप में रिपोर्ट किया जाता है। क्लास ara::core::ErrorCode के साथ मिलकर काम करती है, जो त्रुटि के विशिष्ट कारण को कोडित और एनकैप्सुलेट करता है [SWS_TS_00903]।

संदर्भ आरेख: Time Synchronization, ara::core::ErrorCode और ara::core::Exception के साथ परस्पर क्रिया में ara::tsync::TsyncException का वर्गीकरण। स्रोत: [SWS_TS_00903]

जीवनचक्र

ara::tsync::TsyncException के एक इंस्टेंस का जीवन चक्र इसके स्पष्ट इंस्टैंशिएशन के साथ शुरू होता है। विनिर्देश इसके लिए एक कंस्ट्रक्टर प्रदान करता है जो ara::core::ErrorCode प्रकार का ठीक एक त्रुटि कोड स्वीकार करता है: explicit TsyncException(ara::core::ErrorCode errorCode) noexcept [SWS_TS_00903]। explicit के रूप में घोषणा के माध्यम से, त्रुटि कोड को अंतर्निहित और अनपेक्षित रूप से अपवाद ऑब्जेक्ट्स में परिवर्तित होने से रोका जाता है।

ऑब्जेक्ट निर्माण के लिए AUTOSAR सख्त आश्वासन तैयार करता है: निर्माण को स्पष्ट रूप से अपवाद-सुरक्षित (exception safe) और थ्रेड-सुरक्षित (thread-safe) निर्दिष्ट किया गया है [SWS_TS_00903]। कीवर्ड noexcept यह गारंटी देता है कि कंस्ट्रक्टर स्वयं किसी भी परिस्थिति में दूसरा अपवाद नहीं फेंकता है [SWS_TS_00903]। यह आवश्यक है, क्योंकि अपवाद निर्माण आमतौर पर त्रुटि हैंडलिंग पथ में होता है और इस बिंदु पर विफलता एक अनियंत्रित सिस्टम स्थिति की ओर ले जाएगी।

निर्माण के बाद, ऑब्जेक्ट सामान्य C++ अपवाद सिमेंटिक्स के अधीन होता है: इसे कॉल स्टैक के साथ ले जाया जाता है जब तक कि यह एक संबंधित हैंडलर द्वारा पकड़ा न जाए। catch ब्लॉक से बाहर निकलने के साथ, अपवाद इंस्टेंस का जीवनकाल समाप्त हो जाता है, और संसाधन नियतात्मक रूप से जारी किए जाते हैं।

उपयोग पथ

ara::tsync::TsyncException का उपयोग करते समय विशिष्ट प्रवाह त्रुटि पहचान, ऑब्जेक्ट निर्माण और एप्लिकेशन-साइड इंटरसेप्शन में विभाजित होता है:

• त्रुटि पहचान: Time Synchronization रनटाइम पर विचलन या त्रुटि स्थिति का पता लगाता है और एक उपयुक्त ara::core::ErrorCode [SWS_TS_00903] उत्पन्न करता है।"
• अपवाद निर्माण और थ्रो: कंस्ट्रक्टर का उपयोग करके, निर्धारित त्रुटि कोड के साथ एक ara::tsync::TsyncException ऑब्जेक्ट को इंस्टैंशिएट किया जाता है और ट्रिगर किया जाता है [SWS_TS_00903]।
• त्रुटि हैंडलिंग: कॉलिंग घटक एक संरचित अपवाद हैंडलिंग ब्लॉक में अपवाद को पकड़ता है।

डेवलपर्स अपने अनुप्रयोगों में वैकल्पिक रूप से अपवाद को विशेष रूप से const ara::tsync::TsyncException& के रूप में संभाल सकते हैं या बेस क्लास const ara::core::Exception& [SWS_TS_00903] के माध्यम से बहुरूपी रूप से पकड़ सकते हैं। प्रश्न Q-0c8129359ef114e8 (खुला) प्रकार परिभाषा तक पहुंच के लिए हेडर ara/tsync/tsync_error_domain.h का समावेशन आवश्यक है [SWS_TS_00903]।

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

एक अपवाद क्लास के रूप में, ara::tsync::TsyncException त्रुटि परिदृश्यों के स्पष्ट प्रतिनिधित्व का कार्य करती है। केंद्रीय घटक यहाँ एनकैप्सुलेटेड ara::core::ErrorCode है, जो त्रुटि डोमेन के भीतर विशिष्ट त्रुटि कारण के बारे में विस्तृत जानकारी देता है [SWS_TS_00903]।

एक आवश्यक विशेषता पैरामीटर रहित डिफ़ॉल्ट कंस्ट्रक्टर की अनुपस्थिति है। यह सुनिश्चित करता है कि कोई भी अपवाद इंस्टेंस बिना किसी निर्दिष्ट त्रुटि कोड के मौजूद नहीं हो सकता है [SWS_TS_00903]। कंस्ट्रक्टर की noexcept गारंटी यह भी सुनिश्चित करती है कि त्रुटि का एनकैप्सुलेशन और संकेतन द्वितीयक अपवाद त्रुटियों से आच्छादित न हो [SWS_TS_00903]।