Definieert het foutdomein voor de identificatie, tekstvertaling en uitzonderingsafhandeling van fouten uit SOVD.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: c5b4c66a9279HerkomstOpen vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Definieert het foutdomein voor de identificatie, tekstvertaling en uitzonderingsafhandeling van fouten uit SOVD.
De klasse ara::diag::DiagSovdErrorDomain omkapselt het gestandaardiseerde foutdomein voor SOVD-specifieke diagnosefouten binnen het AUTOSAR Adaptive Platform ([SWS_DM_01809]). Via haar thread-safe lidfuncties maakt zij de betrouwbare vertaling van numerieke foutcodes naar tekstberichten mogelijk, evenals het gecontroleerd genereren van passende C++-uitzonderingstypes ([SWS_DM_01814]). Indien C++-uitzonderingen in de compiler-toolchain zijn uitgeschakeld, neemt de methode voor het genereren van uitzonderingen conform de regels niet deel aan de overbelastingsresolutie.
Context
De klasse ara::diag::DiagSovdErrorDomain beeldt het specifieke foutdomein af voor fouttoestanden die voortvloeien uit het SOVD-subsysteem (Service-Oriented Vehicle Diagnostics) ([SWS_DM_01809], AUTOSAR_AP_SWS_Diagnostics §8.51.3 “Class: DiagSovdErrorDomain”). Als finale specialisatie van de basisinfrastructuurklasse ara::core::ErrorDomain integreert zij foutcodes en bijbehorende uitzonderingsafhandelingen van de SOVD-context naadloos in het uniforme foutmodel van het AUTOSAR Adaptive Platform ([SWS_DM_01809]).
De instantiëring van ara::diag::DiagSovdErrorDomain geschiedt via de parameterloze standaardconstructor constexpr DiagSovdErrorDomain() noexcept ([SWS_DM_01812], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.1.1 “Default Constructor”). Dankzij de specificatie als constexpr en noexcept is het aanmaken gegarandeerd uitzonderingsveilig en kan dit reeds tijdens compilatietijd respectievelijk tijdens de statische initialisatie plaatsvinden. Interpretatie: De beschikbaarstelling van de constexpr-constructor stelt het platform vermoedelijk in staat een langlevende singleton-instantie aan te houden waarnaar via GetDiagSovdErrorDomain wordt gerefereerd ([SWS_DM_01816]). Vraag Q-777076a993f1202d (open)
Met betrekking tot gelijktijdigheid zijn alle lidfuncties van de klasse expliciet als thread-safe („thread-safe”) gedeclareerd. Dit geldt voor de constructor ([SWS_DM_01812]) evenals voor de leesoperaties Name() ([SWS_DM_01813]) en Message() ([SWS_DM_01814]) en voor het genereren van uitzonderingen via ThrowAsException() ([SWS_DM_01815]). Meerdere threads kunnen zodoende parallel en zonder externe synchronisatiemechanismen op dezelfde domeininstantie opereren.
Gebruikspad
Het reguliere verloop voor het gebruik van ara::diag::DiagSovdErrorDomain is onderverdeeld in de volgende stappen:
Opvragen van foutmeldingen: Voor het vertalen van een numerieke foutcode van het type ara::core::ErrorDomain::CodeType (overeenkomend met Errc conform [SWS_DM_01810]) naar leesbare tekst wordt Message(errorCode) aangeroepen ([SWS_DM_01814], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.1 “Message”). De functie retourneert een constante pointer naar een tekenreeks (const char*), die gegarandeerd nooit nullptr is ([SWS_DM_01814]). Interpretatie: De resulterende tekenreeksen zijn vermoedelijk statische literals, aangezien de functie geclassificeerd is als noexcept. Vraag Q-9af1f4094bda4bde (open)
Uitzonderingsafhandeling: Indien een fouttoestand als alternatief via C++-uitzonderingen moet worden gepropageerd, geeft de applicatie de instantie van ara::core::ErrorCode door aan ThrowAsException(errorCode) ([SWS_DM_01815]), waardoor een qua type overeenkomstige uitzondering van het type Exception (DiagSovdException) wordt gegenereerd ([SWS_DM_01811]).
Sequentiediagram: Typische interactievolgorde voor het oplossen van foutbeschrijvingen en optioneel genereren van uitzonderingen via het foutdomein. Bronnen: [SWS_DM_01814], [SWS_DM_01815], [SWS_DM_01816].
Foutscenario's
In het kader van foutafhandeling vertoont de interface van ara::diag::DiagSovdErrorDomain specifieke gedragskenmerken:
Gegarandeerde tekstretournering: De methode Message is gedeclareerd als noexcept en volledig uitzonderingsveilig („exception safe”) ([SWS_DM_01814]). Zij faalt nooit en levert altijd een geldige, niet-lege tekenreeks op ([SWS_DM_01814]).
Gericht genereren van uitzonderingen: De methode ThrowAsException is bedoeld om uitzonderingen op te werpen en daarom voorzien van noexcept(false) evenals de classificatie „not exception safe” ([SWS_DM_01815]). Zij werpt afhankelijk van het meegegeven ara::core::ErrorCode de bijbehorende uitzondering van het type Exception (DiagSovdException) op ([SWS_DM_01811], [SWS_DM_01815]).
Uitgeschakelde C++-uitzonderingen: Conform [SWS_CORE_10304] neemt ThrowAsException niet deel aan de overbelastingsresolutie wanneer in de compiler-toolchain C++-uitzonderingen zijn uitgeschakeld ([SWS_DM_01815]). In dergelijke omgevingen is de functie niet beschikbaar en moeten fouten verplicht via foutcodes worden geëvalueerd.
Deze handleiding is uitsluitend gebaseerd op de specificatievoorschriften van de AUTOSAR-module diag (Release R25-11).
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: e054a1afabf9HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
In typische toepassingsscenario's zal een directe handmatige instantiëring via deze constructor zelden vereist zijn, aangezien de functionele interface ara::diag::GetDiagSovdErrorDomain() reeds een referentie naar de globale instantie van het foutdomein beschikbaar stelt [SWS_DM_01816]. Vraag Q-8c4b22173b01dce7 (open)
De klasse DiagSovdErrorDomain definieert het foutbereik voor SOVD en stelt essentiële typen evenals functies beschikbaar:
Als parameterloze noexcept-functie genereert de constructor geen excepties. Volgens de specificatie is de aanroep uitzonderingsveilig (“exception safe”) en concurrent thread-safe (“thread-safe”) [SWS_DM_01812]. Er zijn geen specifieke randvoorwaarden of foutcodes voor de constructor gedefinieerd.
Deze tekst is gegenereerd door een AI en dient ter aanvulling van de documentatie.
Translate an error code value into a text message.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 83c49eafd3e0HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
De lidfunctie Message van de klasse ara::diag::DiagSovdErrorDomain dient voor de synchrone vertaling van een numerieke foutcode naar een leesbaar tekstbericht [SWS_DM_01814] (aangetoond in AUTOSAR_AP_SWS_Diagnostics p. 69). Deze wordt beschikbaar gesteld via het headerbestand ara/diag/diag_sovd_error_domain.h in de namespace ara::diag.
Voor de aanroep en het runtimegedrag gelden de volgende specificatiekenmerken:
Gebruik en semantiek: Als invoerparameter wordt errorCode van het type ara::core::ErrorDomain::CodeType doorgegeven. De functie levert synchroon een pointer naar een constante tekenreeks (const char *) op, die de tekstuele foutbeschrijving bevat. De specificatie garandeert bindend dat deze retourwaarde nooit nullptr is [SWS_DM_01814].
Foutafhandeling en robuustheid: De interface is gekwalificeerd met noexcept en gedefinieerd als uitzonderingsveilig (exception safe) [SWS_DM_01814]. Er worden geen C++-excepties gegenereerd. Interpretatie: Bij doorgifte van een niet-gedefinieerde of onbekende foutcode levert de implementatie vermoedelijk een gestandaardiseerde instructietekst op om de garantie tegen null-pointers na te leven. Vraag Q-c115f3da24bde8bd (open)
Gelijktijdigheid: De methode is gedeclareerd als const-operatie en expliciet gespecificeerd als thread-safe (thread-safe) [SWS_DM_01814]. Deze wijzigt geen interne toestanden, is niet onderhevig aan volgordevoorwaarden en kan zonder externe locks of synchronisatiemechanismen parallel vanuit meerdere threads worden aangeroepen.
Interactie binnen Diagnostic Management: De methode levert de gestandaardiseerde tekstvertaling voor het SOVD-foutdomein. Deze volgt het uniforme architectuurpatroon van het Adaptive Platform en komt qua signatuur en gedrag overeen met de Message-implementaties van verwante diagnose-foutdomeinen zoals DiagErrorDomain[SWS_DM_00522], DiagUdsNrcErrorDomain[SWS_DM_00534], DiagOfferErrorDomain[SWS_DM_00994] en DiagReportingErrorDomain[SWS_DM_01001].
Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de specificatie.
Return the "shortname" ApApplicationErrorDomain.SN of this error domain.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: f69f6a515368HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Gebruik
De methode Name van de klasse ara::diag::DiagSovdErrorDomain retourneert de korte naam (ApApplicationErrorDomain.SN) van het SOVD-foutdomein synchroon als C-string (const char*) ([SWS_DM_01813]; AUTOSAR_AP_SWS_Diagnostics §7 “Diagnostics”). De functie verwacht geen overdrachtsparameters en wordt beschikbaar gesteld via de header ara/diag/diag_sovd_error_domain.h ([SWS_DM_01813]). Interpretatie: De geretourneerde pointer verwijst vermoedelijk naar een onveranderlijke, statisch bewaarde tekenreeks die gedurende de gehele runtime geldig blijft. Vraag Q-b7b74a09ea645e46 (open)
Foutafhandeling en gelijktijdigheid
De functie is gedeclareerd als noexcept en geldt als uitzonderingsveilig (exception safe) ([SWS_DM_01813]). Deze meldt geen foutcodes en genereert noch DET- noch DEM-items. Voor de gelijktijdigheid is de methode gespecificeerd als thread-safe (thread-safe) ([SWS_DM_01813]). Deze bezit zodoende re-entrante eigenschappen en kan zonder externe synchronisatiemechanismen vanuit willekeurige threads worden aangeroepen.
Samenspel
De interface volgt het uniforme naambevragingspatroon voor foutdomeinen in de adaptieve diagnose. Overeenkomstige implementaties zijn te vinden bij ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]) en ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]). Deze dient typisch voor de logging en identificatie van foutdomeinen in de SOVD-context.
Deze gebruiksinstructie is geautomatiseerd opgesteld en is gebaseerd op de specificatie AUTOSAR Adaptive Platform R25-11.
Throw the exception type corresponding to the given ErrorCode. As per [SWS_CORE_10304], this function does not participate in overload resolution when C++ exceptions are disabled in the compiler toolchain.
DOOR AI GEGENEREERDongecontroleerdModel: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: e5c7c7c60bd3HerkomstOpen vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel
Gebruik
De methode ThrowAsException van de klasse ara::diag::DiagSovdErrorDomain ([SWS_DM_01815], gedeclareerd in header ara/diag/diag_sovd_error_domain.h; zie AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 “ThrowAsException”) dient ertoe een foutcode synchroon om te zetten in het bijbehorende C++-uitzonderingstype. Deze accepteert de invoerparameter errorCode van het type const ara::core::ErrorCode & en heeft geen retourwaarde (void). Bij aanroep werpt deze de met de foutcode corresponderende exceptie op conform de signatuur met noexcept(false).
Foutafhandeling en randvoorwaarden
De specificatie classificeert de methode als “not exception safe” ([SWS_DM_01815]). Interpretation: Deze classificatie is waarschijnlijk gebaseerd op het feit dat door het opzettelijk werpen van een exceptie de reguliere controlestroom wordt verlaten. Vraag Q-23924e13760f4186 (open) Een centrale randvoorwaarde betreft de compiler-toolchain: volgens [SWS_CORE_10304] neemt ThrowAsException niet deel aan de overbelastingsresolutie zolang C++-exceptions in de compiler zijn gedeactiveerd.
gemini-3.8-flash-low· 2026-10-13 · Duits origineel