klasse ara::diag::DiagErrorDomain

De standaardconstructor DiagErrorDomain() initialiseert een instantie van het diagnostische foutdomein ara::diag::DiagErrorDomain ([SWS_DM_00520], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.1.1 “Default Constructor”). Hij is gedeclareerd als constexpr en noexcept, accepteert geen parameters en levert geen retourwaarde op ([SWS_DM_00520]). De aanroep vindt synchroon plaats en kan zowel tijdens compileertijd als tijdens runtime worden uitgevoerd.

Met betrekking tot uitvoeringsveiligheid en concurrency gelden de volgende eigenschappen:

• Fout- en uitzonderingsveiligheid: De functie is gespecificeerd als exception safe en kan vanwege noexcept geen excepties genereren ([SWS_DM_00520]). Specifieke foutcodes of meldingen aan DET of DEM zijn niet gedefinieerd voor de constructie.
• Thread-safety: De instantiëring is geclassificeerd als thread-safe ([SWS_DM_00520]) en is niet onderhevig aan beperkingen met betrekking tot de aanroepcontext.

In samenspel met de module Diagnostics representeert de klasse DiagErrorDomain ([SWS_DM_00517], AUTOSAR_AP_SWS_Diagnostics §8.11.3 “Class: DiagErrorDomain”) het domein van diagnostische fouten. Deze stelt centrale type-aliassen zoals Errc ([SWS_DM_00518]) en Exception ([SWS_DM_00519]) beschikbaar. Instanties van het domein bieden bovendien methoden voor het opvragen van namen ([SWS_DM_00521]), voor het vertalen van foutcodes naar berichtteksten via Message() ([SWS_DM_00522]) en voor het genereren van domeinspecifieke uitzonderingen via ThrowAsException() ([SWS_DM_00523]).

In de praktische toepassing zal een directe handmatige instantiëring via deze constructor zelden vereist zijn (interpretatie), aangezien met de functie ara::diag::GetDiagDomain() ([SWS_DM_00524]) al een globale instantieverwijzing beschikbaar is, die onder meer door ara::diag::MakeErrorCode() ([SWS_DM_00525]) wordt gebruikt voor het genereren van foutcodes. Vraag Q-95d533b0920260e0 (open)

De methode Message van de klasse ara::diag::DiagErrorDomain dient voor de synchrone vertaling van een numerieke foutcode naar een leesbaar tekstbericht ([SWS_DM_00522]). Deze overschrijft de basisfunctie van het foutdomeinconcept en wordt beschikbaar gesteld via de header ara/diag/diag_error_domain.h ([SWS_DM_00522]).

Aanroepcontext en semantiek

Als invoerparameter verwacht de functie errorCode van het type ara::core::ErrorDomain::CodeType ([SWS_DM_00522]). De retourwaarde is een pointer van het type const char * naar de desbetreffende foutmelding ([SWS_DM_00522]). De specificatie garandeert bindend dat deze retourwaarde nooit nullptr is ([SWS_DM_00522]). Interpretatie: de geleverde tekenreeks verwijst vermoedelijk naar statische tekenreeksliterals, aangezien de interface niet voorziet in dynamische geheugenvrijgave en niet mag mislukken. Vraag Q-a54b3a5f746357a8 (open)

Foutafhandeling en gelijktijdigheid

Voor de uitvoering gelden strikte toezeggingen ten aanzien van robuustheid en gelijktijdigheid:

• Uitzonderingsveiligheid: de operatie is gedeclareerd als noexcept en gespecificeerd als volledig uitzonderingsveilig (exception safe) ([SWS_DM_00522]). Deze genereert bij een fout geen C++-exceptions.
• Thread-safety: de functie is expliciet geclassificeerd als thread-safe ([SWS_DM_00522]). Deze kan daarom zonder externe synchronisatiemechanismen veilig parallel door meerdere threads worden aangeroepen.

Samenspel in de diagnosemodule

De functie maakt deel uit van de uniforme foutrapportage in AUTOSAR Adaptive Diagnostic Management. Identieke vertaalfuncties bestaan voor andere domeinspecifieke foutdomeinen van de module:

• ara::diag::DiagUdsNrcErrorDomain::Message voor de tekstresolutie van UDS-NRC's ([SWS_DM_00534]),
• ara::diag::DiagOfferErrorDomain::Message voor de beschrijving van fouten bij diagnoseaanbiedingen ([SWS_DM_00994]),
• ara::diag::DiagReportingErrorDomain::Message voor de resolutie van rapportage-foutcodes ([SWS_DM_01001]),
• ara::diag::DiagSovdErrorDomain::Message voor SOVD-specifieke foutcodes ([SWS_DM_01814]).

De methode ara::diag::DiagErrorDomain::Name dient voor het gestandaardiseerd opvragen van de identifier van het diagnose-foutdomein ([SWS_DM_00521]). Deze wordt via de header ara/diag/diag_error_domain.h geleverd en retourneert synchroon de korte naam ApApplicationErrorDomain.SN als nul-getermineerde C-string van het type const char * ([SWS_DM_00521]). De aanroep vindt plaats zonder overdrachtsparameters. Interpretatie: de geretourneerde pointer verwijst vermoedelijk naar een statisch gepersisteerde tekenreeksliteral, aangezien de specificatie niet voorziet in vrijgavemechanismen. Vraag Q-1ca098627210deb0 (open)

Met betrekking tot foutafhandeling is de functie gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (exception safe) ([SWS_DM_00521]). Er worden noch foutcodes noch uitzonderingen gerapporteerd; een aanroep leidt altijd tot een geldig resultaat.

Wat betreft gelijktijdigheid en randvoorwaarden is de methode gedefinieerd als thread-safe ([SWS_DM_00521]). Omdat zij toestandloos is en gekwalificeerd is als const, werkt zij re-entrant en kan zij zonder externe synchronisatie gelijktijdig vanuit willekeurige threads worden uitgevoerd.

In het architecturale samenspel sluit de functie aan bij Diagnostic Management (AUTOSAR_AP_SWS_Diagnostics p. 68). Gelijkaardige Name-methoden voor domeinidentificatie bestaan voor de verwante klassen ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) en ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

De lidfunctie ThrowAsException van de klasse ara::diag::DiagErrorDomain dient voor het synchroon genereren van een C++-exception op basis van een doorgegeven foutcode ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 “ThrowAsException”). De methode verwacht als invoerparameter een constante referentie naar een instantie van ara::core::ErrorCode en heeft geen retourwaarde ([SWS_DM_00523]). Omdat het primaire doel bestaat uit het opwerpen van een uitzondering, is de operatie met noexcept(false) en als niet uitzonderingsveilig (not exception safe) gedeclareerd ([SWS_DM_00523]).

Wat betreft gelijktijdigheid is de methode gespecificeerd als thread-safe (thread-safe) en kan deze zodoende zonder aanvullende synchronisatie vanuit meerdere uitvoeringscontexten worden aangeroepen ([SWS_DM_00523]). Een belangrijke randvoorwaarde betreft omgevingen zonder ondersteuning voor uitzonderingen: conform [SWS_CORE_10304] neemt de functie niet deel aan overbelastingsresolutie wanneer C++-exceptions in de gebruikte compiler-toolchain zijn uitgeschakeld ([SWS_DM_00523]).

Dit functionele schema wordt consistent over verschillende foutdomeinen van de diagnosemodule heen toegepast. Analoge implementaties van ThrowAsException zijn onder andere te vinden in ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 “ThrowAsException”), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002]) en ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]). Interpretatie: door de specificatie met override representeert de methode vermoedelijk een gemeenschappelijke interfaceoperatie voor polymorfe uitzonderingsafhandeling. Vraag Q-9c1e35e079af639d (open)