klasse ara::diag::DiagUdsNrcErrorDomain

De parameterloze standaardconstructor initialiseert een instantie van het foutdomein ara::diag::DiagUdsNrcErrorDomain synchroon en zonder overdrachtsparameters [SWS_DM_00532]. Door de kwalificatie als constexpr kan de instantiëring al tijdens compileertijd plaatsvinden AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 “Default Constructor”. In de praktische implementatie zal een directe handmatige instantiëring van de domeinklasse [SWS_DM_00529] door applicatiecode echter zelden vereist zijn, aangezien standaard de globale referentie via de functie GetDiagUdsNrcDomain() [SWS_DM_00536] wordt verkregen. Vraag Q-22c33afd620b536e (open)

Met betrekking tot concurrency en exception-safety is de constructor gespecificeerd als thread-safe en exception safe [SWS_DM_00532]. Hij is gedeclareerd als noexcept en werpt zelf geen enkele exceptie. Het domein beheert foutcodes van het enumeratietype DiagUdsNrcErrc via de alias Errc [SWS_DM_00530], die met MakeErrorCode() [SWS_DM_00537] worden aangemaakt. Bovendien stelt de klasse methoden zoals Name() [SWS_DM_00533], Message() [SWS_DM_00534] en ThrowAsException() [SWS_DM_00535] beschikbaar in het kader van DiagUdsNrcException [SWS_DM_00531].

In samenspel met Diagnostic Management sturen fouten van dit domein de negatieve responsafhandeling aan. Geeft een ara::diag-interface een fout van DiagUdsNrcErrorDomain terug, dan leidt de Diagnostic Server daar een negatief UDS-antwoord (NRC) uit af met de waarde van de foutcode in het geldige bereik van 0x01 tot 0xFE [SWS_DM_02059], [SWS_DM_02060]. Treedt een dergelijke fout op bij het ophalen van een omgevingselement, dan beoordeelt de server de betreffende voorwaarde als niet voldaan en verzendt een log-and-trace-bericht [SWS_DM_00970].

Gebruik

De synchrone lidfunctie Message van de klasse ara::diag::DiagUdsNrcErrorDomain zet een numerieke foutcode om in een leesbare tekenreeks [SWS_DM_00534]. Als parameter wordt de foutwaarde errorCode van het type ara::core::ErrorDomain::CodeType doorgegeven. De aanroep retourneert een constante pointer (const char *) naar het desbetreffende bericht, waarbij gegarandeerd is dat de retourwaarde nooit nullptr is [SWS_DM_00534].

Foutafhandeling en gelijktijdigheid

De methode is gedeclareerd als noexcept en waarborgt volledige uitzonderingsveiligheid (exception safe) [SWS_DM_00534]. Er worden geen excepties gegenereerd. Zelfs bij onbekende of ongeldige waarden voor errorCode levert de implementatie vermoedelijk een statisch fallback-bericht op, aangezien een null-pointer expliciet is uitgesloten [SWS_DM_00534]. Vraag Q-e9724baf4aedc3ff (open) Bovendien is de functie gespecificeerd als thread-safe (thread-safe) en kan deze zonder externe synchronisatie parallel vanuit meerdere threads worden aangeroepen [SWS_DM_00534].

Interactie binnen Diagnostic Management

Binnen Diagnostic Management implementeert Message het gestandaardiseerde overschrijven van de foutberichtresolutie, specifiek voor UDS Negative Response Codes (NRC) [SWS_DM_00534]. Deze correspondeert met soortgelijke functies van andere diagnose-foutdomeinen zoals DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001] en DiagSovdErrorDomain [SWS_DM_01814].

Gebruik

De lidfunctie Name van de klasse ara::diag::DiagUdsNrcErrorDomain retourneert de korte naam (ApApplicationErrorDomain.SN) van dit specifieke diagnose-foutdomein [SWS_DM_00533]. De aanroep vindt synchroon plaats en is via de header ara/diag/diag_uds_nrc_error_domain.h gedeclareerd. De methode accepteert geen overdrachtsparameters en retourneert een pointer van het type const char * naar een nul-getermineerde tekenreeks [SWS_DM_00533].

Foutafhandeling

De functie is gedeclareerd als noexcept en heeft de eigenschap exception safe [SWS_DM_00533]. Deze werpt geen uitzonderingen op en retourneert geen foutcodes. Het mislukken van de bevraging is in het interfaceontwerp niet voorzien, waardoor er geen afzonderlijke foutmeldingen bestaan.

Gelijktijdigheid en beperkingen

Volgens de specificatie is Name geclassificeerd als thread-safe [SWS_DM_00533]. Deze kan re-entrant en zonder externe synchronisatiemechanismen parallel vanuit meerdere threads worden aangeroepen. De gereferentieerde tekenreeks betreft vermoedelijk statisch gealloceerde gegevens, zodat de pointer naar verwachting gedurende de gehele levensduur van de applicatie ongewijzigd geldig blijft. Vraag Q-d4a4d28af7a9c2df (open) Er gelden geen bijzondere volgordevoorwaarden voor de aanroep.

Samenspel

De operatie implementeert het uniforme opvragen van de naam voor AUTOSAR Adaptive-foutdomeinen in de diagnosecontext. Deze komt structureel overeen met de gelijknamige interfaces van verwante foutdomeinen zoals ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000] en ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. Deze dient er vooral toe fouten uit de UDS-NRC-omgeving leesbaar te identificeren voor diagnoseclients of logging-componenten.

De lidfunctie ara::diag::DiagUdsNrcErrorDomain::ThrowAsException dient ertoe een fout uit het UDS-NRC-foutdomein synchroon om te zetten in een C++-exceptie [SWS_DM_00535]. Als parameter wordt de instantie errorCode van het type const ara::core::ErrorCode& doorgegeven. De functie heeft geen retourwaarde, maar werpt direct het aan de foutcode gekoppelde exceptietype op AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 “ThrowAsException”.

Wat betreft het fout- en runtimegedrag is de methode gedeclareerd met noexcept(false) en geclassificeerd als niet-uitzonderingsveilig (not exception safe), aangezien het opwerpen van de exceptie de primaire semantiek ervan vormt [SWS_DM_00535]. Voor de context van gelijktijdige aanroepen is de functie gespecificeerd als thread-safe (thread-safe) [SWS_DM_00535].

Bij de integratie en systeemconfiguratie gelden de volgende voorwaarden en ontwerpreferenties:

• Compilerbeperking: Als C++-excepties in de compiler-toolchain zijn gedeactiveerd, neemt deze functie conform [SWS_CORE_10304] niet deel aan overload resolution (overload resolution) [SWS_DM_00535].
• Interactie met foutdomeinen: Het identieke schema voor het opwerpen van excepties wordt uniform toegepast in overige diagnostische domeinen, zoals in DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002] en DiagSovdErrorDomain [SWS_DM_01815].