क्लास ara::diag::DiagReportingException

अपवाद वर्ग ara::diag::DiagReportingException Adaptive Platform के डायग्नोस्टिक वर्गों के भीतर संचालन के दौरान होने वाली त्रुटि स्थितियों के सिंक्रोनस संकेतन के लिए कार्य करता है (AUTOSAR_AP_SWS_Diagnostics §8.11.8 “Class: DiagReportingException”)। इसे स्पष्ट रूप से एक विशिष्ट ara::core::ErrorCode के साथ इंस्टैंसिएट किया जाता है और त्रुटि के मूल कारण के विश्लेषण के लिए इसे कॉलिंग एप्लिकेशन [SWS_DM_00988] तक पहुँचाता है। एक केंद्रीय बाधा के रूप में, इसके कंस्ट्रक्टर को noexcept, exception safe और thread-safe निर्दिष्ट किया गया है, जो समवर्ती निष्पादन संदर्भों में भी त्रुटि रहित निर्माण की गारंटी देता है। अहैंडल किए गए इंस्टेंस से बचा जाना चाहिए, क्योंकि वे तत्काल प्रोग्राम निरस्तीकरण का कारण बनते हैं।

अधिक ›

संदर्भ

वर्ग ara::diag::DiagReportingException डायग्नोस्टिक कार्यात्मक क्लस्टर (AUTOSAR_AP_SWS_Diagnostics §8.11.8 “Class: DiagReportingException”) के भीतर रिपोर्टिंग और विवरण प्रक्रियाओं के लिए केंद्रीय अपवाद वर्ग का निर्माण करता है। इसे ara::core::Exception के सार्वजनिक विशेषज्ञता के रूप में परिभाषित किया गया है और यह डायग्नोस्टिक वर्गों [SWS_DM_00987] के साथ इंटरैक्शन के दौरान होने वाली विशिष्ट त्रुटि स्थितियों का प्रतिनिधित्व करता है। एक AUTOSAR Adaptive अनुप्रयोग में, अपवाद आंतरिक डायग्नोस्टिक सेवाओं और कॉलिंग अनुप्रयोग सॉफ़्टवेयर के बीच एक कड़ी के रूप में कार्य करता है: यदि किसी डायग्नोस्टिक रिपोर्ट के दौरान कोई त्रुटि होती है, तो DiagReportingException इस स्थिति को एनकैप्सुलेट करता है और इसे कॉल स्टैक के माध्यम से कॉलर तक सिंक्रोनस रूप से पहुँचाता है। प्राथमिक इंटरैक्शन भागीदारों में मॉड्यूल diag के डायग्नोस्टिक्स-संबंधित API वर्ग शामिल हैं, जो त्रुटि की स्थिति में अपवाद को इंस्टैंसिएट और ट्रिगर करते हैं, साथ ही अनुप्रयोग के उच्च-स्तरीय त्रुटि प्रबंधन रूटीन भी शामिल हैं, जो डायग्नोस्टिक्स त्रुटि को पकड़ते हैं और संसाधित करते हैं।

जीवनचक्र

ara::diag::DiagReportingException का इंस्टैंसिएशन स्पष्ट रूप से कंस्ट्रक्टर [SWS_DM_00988] को ara::core::ErrorCode प्रकार का त्रुटि कोड पास करके किया जाता है। कंस्ट्रक्टर की घोषणा explicit के रूप में त्रुटि कोड के अपवाद ऑब्जेक्ट में अंतर्निहित रूपांतरणों को रोकती है और यह सुनिश्चित करती है कि अपवाद इंस्टेंस हमेशा जानबूझकर बनाए जाएँ [SWS_DM_00988]।

चूँकि कंस्ट्रक्टर विनिर्देश noexcept के साथ प्रदान किया गया है, यह गारंटी दी जाती है कि ऑब्जेक्ट निर्माण के दौरान स्वयं कोई अन्य अपवाद नहीं हो सकता है [SWS_DM_00988]। त्रुटि प्रबंधन के दौरान अपवादों के कैस्केडिंग को रोकने के लिए यह त्रुटि पथों के लिए आवश्यक है। इसके अतिरिक्त, निर्माण प्रक्रिया को स्पष्ट रूप से अपवाद-सुरक्षित (exception safe) और थ्रेड-सुरक्षित (thread-safe) के रूप में वर्गीकृत किया गया है [SWS_DM_00988]। इस प्रकार कई थ्रेड समानांतर में और पारस्परिक अवरोधों के बिना अलग-अलग अपवाद ऑब्जेक्ट बना सकते हैं।

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

उपयोग पथ

नियमित उपयोग पथ तब शुरू होता है जब Adaptive प्लेटफॉर्म के भीतर कोई डायग्नोस्टिक रिपोर्ट या ऑपरेशन विफल हो जाता है। विशिष्ट प्रवाह में, निष्पादित करने वाला डायग्नोस्टिक वर्ग एक अमान्य स्थिति का पता लगाता है और उपयुक्त ara::core::ErrorCode उत्पन्न करता है। केवल एक रिटर्न मान के रूप में त्रुटि प्रसारित करने के बजाय, सिंक्रोनस अपवाद पथ में ara::diag::DiagReportingException प्रकार का एक ऑब्जेक्ट निर्मित किया जाता है और फेंका जाता है [SWS_DM_00987]।

अनुक्रम आरेख: DiagReportingException के साथ अपवाद निर्माण और त्रुटि प्रबंधन का विशिष्ट प्रवाह। स्रोत: [SWS_DM_00987], [SWS_DM_00988], AUTOSAR_AP_SWS_Diagnostics §8.11.8 “Class: DiagReportingException”।

प्राप्तकर्ता पक्ष पर, अनुप्रयोग तर्क अपवाद को पकड़ता है। यह अधिमानतः स्थिर ऑब्जेक्ट (const ara::diag::DiagReportingException& या const ara::core::Exception& के माध्यम से बहुरूपी) के संदर्भ द्वारा किया जाता है। इसके बाद, सटीक त्रुटि कारण निर्धारित करने और स्थिति-उपयुक्त पुनर्प्राप्ति उपायों को शुरू करने के लिए हैंडलर एम्बेडेड ara::core::ErrorCode को निकालता है।

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

ara::diag::DiagReportingException से संबंधित त्रुटि परिदृश्य मुख्य रूप से पास किए गए त्रुटि डेटा की व्याख्या और उचित अपवाद प्रबंधन के अभाव से संबंधित हैं।

कंस्ट्रक्टर अनिवार्य रूप से एक मान्य ara::core::ErrorCode [SWS_DM_00988] की मांग करता है। हेडर फ़ाइल ara/diag/diag_error_domain.h [SWS_DM_00988] को शामिल करने से, पास किया गया त्रुटि कोड मुख्य रूप से विशिष्ट डायग्नोस्टिक्स त्रुटि डोमेन से उत्पन्न होना चाहिए। प्रश्न Q-cb8a197542857807 (खुला) अनुप्रयोग आर्किटेक्चर में एक प्राथमिक त्रुटि परिदृश्य अपवाद को अपूर्ण रूप से पकड़ना है: यदि कॉल स्टैक के साथ फेंके गए DiagReportingException को एक उपयुक्त catch ब्लॉक द्वारा नहीं संभाला जाता है, तो यह अनिवार्य रूप से std::terminate के कॉल की ओर ले जाता है और इस प्रकार संबंधित प्लेटफ़ॉर्म प्रक्रिया के क्रैश का कारण बनता है। चूँकि कंस्ट्रक्टर स्वयं noexcept घोषित किया गया है [SWS_DM_00988], अपवाद का इंस्टैंसिएशन आंतरिक संसाधनों की कमी के कारण विफल नहीं हो सकता है। इसलिए डेवलपर्स को यह सुनिश्चित करना चाहिए कि कॉलिंग घटक DiagReportingException की घटना के लिए तैयार हैं, विशेष रूप से तब जब ऐसे API का उपयोग किया जाता है जो ara::core::Result के बजाय अपवादों के माध्यम से त्रुटियों का संकेत देते हैं।