स्ट्रक्चर ara::diag::SovdOperationExecution::GetStatusResponse

डेटा संरचना GetStatusResponse SOVD संचालन ([SWS_DM_02200]) की अतुल्यकालिक स्थिति क्वेरी के लिए रिटर्न कंटेनर के रूप में कार्य करती है। इसे एक SovdOperationExecution इंस्टेंस द्वारा ara::core::Future के माध्यम से Diagnostic Management को पास किया जाता है, जो इससे ASAM SOVD प्रतिक्रिया के लिए विशेषताएँ status और parameters प्राप्त करता है ([SWS_DM_02181])। प्रावधान के लिए पूर्वशर्त एक सफल प्रॉक्सिमिटी सत्यापन और कॉल का त्रुटि-रहित अतुल्यकालिक निष्पादन है।

अधिक ›

संदर्भ

संरचना ara::diag::SovdOperationExecution::GetStatusResponse Adaptive Platform ([SWS_DM_02200]) की एक प्रतिक्रिया डेटा संरचना है, जिसका उपयोग SOVD संचालन (Service-Oriented Vehicle Diagnostics) की स्थिति क्वेरी में एक मानकीकृत रिटर्न कंटेनर के रूप में किया जाता है (AUTOSAR_AP_SWS_Diagnostics §8.62.6 “Struct: GetStatusResponse”)। मॉड्यूल diag के भीतर, यह संरचना डायग्नोस्टिक डेमॉन Diagnostic Management (DM) और एप्लिकेशन-विशिष्ट डायग्नोस्टिक सेवाओं, जो इंटरफ़ेस SovdOperationExecution को लागू करती हैं, के बीच एक इंटरफ़ेस तत्व के रूप में कार्य करती है। यदि Diagnostic Management को संचालन स्थिति क्वेरी के लिए एक बाहरी SOVD कॉल प्राप्त होता है (“Read the Status of an operation”), तो DM इस अनुरोध को संबंधित इंस्टेंस को अग्रेषित करता है ([SWS_DM_02180])। GetStatusResponse निर्धारित स्थिति और परिणाम डेटा को समाहित करता है और DM को ASAM SOVD के अनुसार मानक-अनुरूप प्रतिक्रिया बनाने में सक्षम बनाता है ([SWS_DM_02181])।

जीवनचक्र

एक डेटा संरचना (struct GetStatusResponse) के रूप में, जैसे ही वर्चुअल विधि SovdOperationExecution::GetStatus को प्रसंस्करण के लिए कॉल किया जाता है, सेवा एप्लिकेशन के संदर्भ में आमतौर पर एक इंस्टेंस बनाया जाता है। ऑब्जेक्ट को मान के रूप में एक ara::core::Future<GetStatusResponse> में एम्बेड किया जाता है, जो अतुल्यकालिक विधि हस्ताक्षर के रिटर्न प्रकार के रूप में आवश्यक होता है (AUTOSAR_AP_SWS_Diagnostics §8.62 “GetStatus”)। व्याख्या: GetStatusResponse को एक शुद्ध मान स्थानांतरण ऑब्जेक्ट के रूप में डिज़ाइन किए जाने की संभावना है, जिसका जीवनचक्र संबंधित Future और Promise जोड़ी से निकटता से जुड़ा हुआ है। प्रश्न Q-e5e2b31a97df0af4 (खुला) जैसे ही एप्लिकेशन-विशिष्ट निर्धारण पूरा हो जाता है और Future पूरा हो जाता है, डेटा एक्सेस कॉलिंग Diagnostic Management को स्थानांतरित हो जाता है। SOVD प्रतिक्रिया ([SWS_DM_02181]) तैयार करने के लिए विशेषताओं को पढ़ने के बाद, संरचना का जीवनकाल समाप्त हो जाता है, और इसे नियमित रूप से नष्ट कर दिया जाता है।

उपयोग पथ

संचालन स्थिति की क्वेरी के नियमित प्रवाह में कई घटकों की परस्पर क्रिया शामिल होती है:

1. एक बाहरी SOVD क्लाइंट एक विशिष्ट execution-id के साथ विधि “Read the Status of an operation” को DM को भेजता है ([SWS_DM_02180])।
2. DM अनुरोध की जाँच करता है और यदि आवश्यक हो, तो प्रॉक्सिमिटी चैलेंज का सत्यापन करता है ([SWS_DM_02173])।
3. सफल सत्यापन के बाद, DM execution-id के आधार पर संबंधित SovdOperationExecution इंस्टेंस को संबोधित करता है ([SWS_DM_02177]) और उसकी विधि GetStatus(meta_info, cancellation_handler) को कॉल करता है ([SWS_DM_02180], AUTOSAR_AP_SWS_Diagnostics §8.62 “GetStatus”)।
4. एप्लिकेशन निष्पादन स्थिति निर्धारित करता है, GetStatusResponse को स्थिति मान (status) और आउटपुट पैरामीटर (DiagnosticSovdContentData से Parameters) से भरता है और ara::core::Future के माध्यम से ऑब्जेक्ट प्रदान करता है ([SWS_DM_02181])।
5. DM प्रदान की गई GetStatusResponse से डेटा निकालता है, फ़ील्ड capability को execute पर सेट करता है और ASAM SOVD के अनुसार क्लाइंट को रिस्पॉन्स बॉडी वापस भेजता है ([SWS_DM_02181])।

अनुक्रम आरेख: GetStatusResponse के माध्यम से संचालन स्थिति की क्वेरी में परस्पर क्रिया। स्रोत: [SWS_DM_02180], [SWS_DM_02181], AUTOSAR_AP_SWS_Diagnostics §8.62 “GetStatus”, [SWS_DM_02173]

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

GetStatusResponse का प्रसंस्करण और सफल आदान-प्रदान कई पूर्वशर्तों और त्रुटि पथों पर निर्भर करता है:

• यदि आवश्यक प्रॉक्सिमिटी चैलेंज विफल हो जाता है ([SWS_DM_02173]), तो DM विधि GetStatus को कॉल ही नहीं करता है ([SWS_DM_02180]); इस स्थिति में GetStatusResponse का इंस्टेंसिएशन या मूल्यांकन पूरी तरह से समाप्त हो जाता है।
• विधि SovdOperationExecution::GetStatus को noexcept के रूप में घोषित किया गया है (AUTOSAR_AP_SWS_Diagnostics §8.62 “GetStatus”)। इसलिए, स्थिति निर्धारण में त्रुटियों को C++ अपवादों के माध्यम से प्रसारित नहीं किया जाना चाहिए, बल्कि ara::core::Future के त्रुटि पथ के माध्यम से अतुल्यकालिक रूप से संकेत दिया जाना चाहिए।
• यदि विधि का निष्पादन सफल नहीं होता है (“succeeded” शर्त पूरी नहीं होती है), तो SOVD सफलता प्रतिक्रिया ([SWS_DM_02181]) की नियमित रचना नहीं होती है।
• पास किए गए ऑब्जेक्ट ara::diag::CancellationHandler के माध्यम से, चल रहे संचालन को निरस्तीकरण अनुरोध के बारे में सूचित किया जा सकता है (AUTOSAR_AP_SWS_Diagnostics §8.62 “GetStatus”)।