klasse ara::diag::DiagOfferErrorDomain

De parameterloze standaardconstructor [SWS_DM_00992] dient voor het aanmaken van een instantie van de klasse ara::diag::DiagOfferErrorDomain (SWS Diagnostics §8.11.5 “Class: DiagOfferErrorDomain”). Hij is gedeclareerd via het headerbestand ara/diag/diag_error_domain.h en heeft de signatuur constexpr DiagOfferErrorDomain() noexcept; (SWS Diagnostics §8.11.5.2.1.1 “Default Constructor”). De aanroep geschiedt synchroon, verwerkt geen invoerparameters en levert constructortyperend geen retourwaarde op [SWS_DM_00992].

Wat betreft gelijktijdigheid en foutveiligheid is de functie gespecificeerd als thread-safe evenals exception safe [SWS_DM_00992]. Door de noexcept-specificatie is gegarandeerd dat er tijdens de uitvoering geen excepties worden geworpen [SWS_DM_00992]. Specifieke foutcodes of meldingen via DET of DEM zijn voor deze constructor niet voorzien.

In de modulecontext representeert het domein fouttoestanden rond diagnosediensten waarvan de foutcodes zijn gedefinieerd in de enumeratie DiagOfferErrc [SWS_DM_00559] en kunnen worden gerefereerd via de type-alias Errc [SWS_DM_00990]. De klasse stelt standaardmethoden zoals Name() [SWS_DM_00993], Message() [SWS_DM_00994] en ThrowAsException() [SWS_DM_00995] beschikbaar. In toepassingsgevallen is een directe aanroep van de constructor vermoedelijk zelden vereist (interpretatie), aangezien met de functie ara::diag::GetDiagOfferDomain() reeds een globale referentie naar de instantie ter beschikking staat [SWS_DM_01003], die onder andere door ara::diag::MakeErrorCode() wordt gebruikt [SWS_DM_01005]. Vraag Q-a98886da9b649096 (open)

De synchrone lidfunctie Message van de klasse ara::diag::DiagOfferErrorDomain dient voor het vertalen van een numerieke foutcode naar een beschrijvend tekstbericht [SWS_DM_00994]. Ontwikkelaars binden de interface in via het headerbestand ara/diag/diag_error_domain.h [SWS_DM_00994].

Voor het gebruik en de aanroepcontext gelden de volgende richtlijnen:

• Parameters en retourwaarde: Aan de functie wordt de op te vragen foutwaarde doorgegeven als ara::core::ErrorDomain::CodeType errorCode. Deze retourneert een pointer naar een constante tekenreeks (const char*), die volgens de specificatie nooit nullptr is [SWS_DM_00994].
• Fout- en uitzonderingsveiligheid: De functie is gedeclareerd als noexcept en gespecificeerd als exception safe, zodat deze geen C++-excepties werpt [SWS_DM_00994]. Onbekende of ongeldige foutcodes worden vermoedelijk gemapt op vooraf gedefinieerde standaardberichten om de null-pointergarantie te handhaven. Vraag Q-73eb1822df6a995d (open)
• Gelijktijdigheid: De operatie is gedeclareerd als const-methode en expliciet geclassificeerd als thread-safe, waardoor gelijktijdige aanroepen vanuit meerdere threads zonder externe synchronisatie zijn toegestaan [SWS_DM_00994].

De methode overschrijft een basisinterface en volgt het uniforme foutberichtpatroon van de diagnosemodule, dat analoog ook in andere foutdomeinen zoals ara::diag::DiagErrorDomain [SWS_DM_00522], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00534], ara::diag::DiagReportingErrorDomain [SWS_DM_01001] en ara::diag::DiagSovdErrorDomain [SWS_DM_01814] wordt gebruikt.

De methode Name() van de klasse ara::diag::DiagOfferErrorDomain dient voor het synchroon bepalen van de unieke korte naam van het foutdomein ([SWS_DM_00993]). Deze is beschikbaar via het headerbestand ara/diag/diag_error_domain.h en overschrijft de basismethode voor domeinidentificatie in het Adaptive-framework ([SWS_DM_00993]).

Gebruik en semantiek:

• Aanroepcontext en parameters: De aanroep vindt synchroon, parameterloos en zonder randvoorwaarden direct op de instantie van ara::diag::DiagOfferErrorDomain plaats ([SWS_DM_00993]).
• Retourwaarde: De functie levert een const char* op, die de identifier ApApplicationErrorDomain.SN van het foutdomein representeert ([SWS_DM_00993]). Interpretatie: De geretourneerde pointer verwijst vermoedelijk naar een onveranderlijke, statische tekenreeks die gedurende de gehele programmaduur geldig blijft. Vraag Q-86836b3715182080 (open)
• Foutafhandeling: De methode is gedeclareerd als noexcept en gespecificeerd als exception safe ([SWS_DM_00993]). Deze meldt geen foutcodes en werpt geen excepties op.
• Gelijktijdigheid: De uitvoering is geclassificeerd als thread-safe ([SWS_DM_00993]), zodat parallelle aanroepen vanuit meerdere threads zonder externe synchronisatie zijn toegestaan.

Interactie: Het gedrag komt overeen met het algemene architectuurpatroon voor foutdomeinen in Diagnostic Management. Identiek gespecificeerde Name()-methoden bestaan voor verwante domeinen zoals ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) en ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

De lidfunctie ThrowAsException van het foutdomein ara::diag::DiagOfferErrorDomain dient conform [SWS_DM_00995] om een doorgegeven foutcode van het type ara::core::ErrorCode om te zetten in een overeenkomstige C++-exceptie en deze op te werpen (AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 “ThrowAsException”).

Wat betreft semantiek en interfaceontwerp gelden de volgende eigenschappen:

• Aanroep en parameters: De methode accepteert een constante referentie naar een instantie van ara::core::ErrorCode, heeft geen retourwaarde (void) en is gedeclareerd met noexcept(false), aangezien deze per definitie een exceptie opwerpt [SWS_DM_00995].
• Compilatierestrictie: Conform [SWS_CORE_10304] neemt de functie niet deel aan overload resolution (Overload Resolution) wanneer C++-excepties in de toolchain van de compiler zijn gedeactiveerd [SWS_DM_00995].
• Veiligheid en gelijktijdigheid: De functie is gespecificeerd als thread-safe, waardoor parallelle aanroepen over threadgrenzen heen zijn toegestaan; deze is echter expliciet aangeduid als not exception safe [SWS_DM_00995].
• Interactie: Het concept komt overeen met het gestandaardiseerde foutmodel voor diagnosefoutdomeinen, zoals dat analoog ook in ara::diag::DiagErrorDomain [SWS_DM_00523], ara::diag::DiagReportingErrorDomain [SWS_DM_01002], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00535] en ara::diag::DiagSovdErrorDomain [SWS_DM_01815] is geïmplementeerd. De definitie wordt geïntegreerd via het headerbestand #include "ara/diag/diag_error_domain.h" [SWS_DM_00995].

Vanwege de classificatie als not exception safe grijpt er bij het opwerpproces in de systeemcontext vermoedelijk geen aanvullende interne foutbeveiliging binnen de methode in (interpretatie: ontwikkelaars moeten excepties opvangen in de aanroepende applicatiecontext). Vraag Q-72152cb488c24026 (open)