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

यह वर्ग एक अद्वितीय कुंजी पहचानकर्ता [SWS_DM_02375] के साथ एक SOVD नैदानिक सामग्री तत्व को इनकैप्सुलेट करने का कार्य करता है। इसे ASAM SOVD के अनुसार लेखन एक्सेस के दौरान Diagnostic Management द्वारा भरा जाता है और GenericDiagnosticSovdContent::Write को अग्रेषित किया जाता है [SWS_DM_02166]। सभी सदस्य फलन थ्रेड-सुरक्षित और अपवाद-सुरक्षित निर्दिष्ट हैं, जहाँ त्रुटिपूर्ण असाइनमेंट की रिपोर्ट DiagErrc::kInvalidArgument के साथ ara::core::Result के माध्यम से की जाती है [SWS_DM_02381]।

अधिक ›

संदर्भ

वर्ग ara::diag::DiagnosticSovdContentElementDataWithKey Adaptive Platform के भीतर ASAM SOVD (Service-Oriented Vehicle Diagnostics) के संदर्भ में एकल डायग्नोस्टिक्स सामग्री तत्व के लिए डेटा कैप्सूल के रूप में कार्य करता है और पेलोड ऑब्जेक्ट को एक अद्वितीय कुंजी पहचानकर्ता निर्दिष्ट करता है [SWS_DM_02375]। SOVD डेटा को मॉडल तत्व DiagnosticSovdContent के माध्यम से संरचित किया जाता है, जो कम से कम एक DiagnosticSovdContentElement से बना होता है AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion”। जबकि पठन क्वेरीज़ को GenericDiagnosticSovdContent::Read के माध्यम से प्रबंधित किया जाता है [SWS_DM_01432], यह वर्ग डेटा संसाधनों पर संरचित लेखन एक्सेस निष्पादित करने के लिए मुख्य रूप से Diagnostic Management (DM) और सेवा इंटरफ़ेस GenericDiagnosticSovdContent::Write के साथ इंटरैक्ट करता है [SWS_DM_01431], [SWS_DM_02166]।

जीवनचक्र

ara::diag::DiagnosticSovdContentElementDataWithKey का इंस्टेंसिएशन और विनाश RAII सिद्धांत के अनुपालन में होता है। डिस्ट्रक्टर और संबंधित कॉपी और मूव ऑपरेशन (Move/Copy कंस्ट्रक्टर और असाइनमेंट ऑपरेटर) स्पष्ट रूप से noexcept के रूप में घोषित किए गए हैं [SWS_DM_02376]। स्वामित्व संबंधों के संबंध में, वर्ग SetContent में मान द्वारा पास करके पेलोड सामग्री को संभालता है [SWS_DM_02381], जबकि कुंजी नाम को ara::core::StringView के रूप में पास किया जाता है [SWS_DM_02378]। Diagnostic Management संभवतः आंतरिक रूप से यह सुनिश्चित करेगा कि एक्सेस के दौरान अंतर्निहित स्ट्रिंग मान्य रहे या आंतरिक मेमोरी में कॉपी हो जाए। प्रश्न Q-f00f62f43629a773 (खुला) विनिर्देश के अनुसार वर्ग के सभी सदस्य फलन थ्रेड-सुरक्षित और अपवाद-सुरक्षित डिज़ाइन किए गए हैं [SWS_DM_02376], [SWS_DM_02377], [SWS_DM_02378], [SWS_DM_02379], [SWS_DM_02380], [SWS_DM_02381]।

उपयोग पथ

विशिष्ट उपयोग पथ किसी निकाय डेटा संसाधन के लिए SOVD लेखन अनुरोध प्राप्त होने पर होता है [SWS_DM_01431]। Diagnostic Management एक इंस्टेंस बनाता है या उसका उपयोग करता है और पहले संबंधित DiagnosticSovdContentElement के shortName को SetName के साथ सेट करता है [SWS_DM_02166], [SWS_DM_02378]। फिर आने वाले मान को रूपांतरण नियमों के आधार पर रूपांतरित किया जाता है AUTOSAR_AP_SWS_Diagnostics §7.3.3.3.2 “SOVD Data – Conversion” और SetContent के माध्यम से असाइन किया जाता है [SWS_DM_02166], [SWS_DM_02381]। इस प्रकार एकत्रित डेटा को फिर GenericDiagnosticSovdContent::Write पर अग्रेषित किया जाता है [SWS_DM_02166]। उपभोक्ता GetName के माध्यम से कुंजी नाम की जाँच कर सकते हैं [SWS_DM_02377] और GetContent के स्थिर या गैर-स्थिर ओवरलोड के माध्यम से डेटा सामग्री का निरीक्षण या हेरफेर कर सकते हैं [SWS_DM_02379], [SWS_DM_02380]।

अनुक्रम आरेख: DiagnosticSovdContentElementDataWithKey का उपयोग करके SOVD लेखन अनुरोध को संसाधित करते समय कॉल और डेटा प्रवाह। स्रोत: [SWS_DM_01431], [SWS_DM_02166], [SWS_DM_02378], [SWS_DM_02381]।

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

त्रुटि के मामले में, वर्ग C++ अपवादों से बचता है और इसके बजाय SetContent के रिटर्न प्रकार ara::core::Result<void> के माध्यम से विफलताओं की रिपोर्ट करता है [SWS_DM_02381]। यदि सामग्री सेट करना विफल रहता है - उदाहरण के लिए यदि पास किया गया सामग्री प्रकार लक्ष्य संरचना से मेल नहीं खाता है या अमान्य है -, तो त्रुटि कोड DiagErrc::kInvalidArgument लौटाया जाता है [SWS_DM_02381]। ऑब्जेक्ट को GenericDiagnosticSovdContent::Write में पास करने से पहले कॉलर को लौटाए गए परिणाम की जाँच करनी चाहिए [SWS_DM_02166]।