klasse ara::tsync::TsyncErrorDomain

Gebruik

De methode Message van de klasse ara::tsync::TsyncErrorDomain dient voor het synchroon opvragen van een tekstuele foutbeschrijving bij een meegegeven foutcode [SWS_TS_00907]. Deze wordt beschikbaar gesteld via de header #include "ara/tsync/tsync_error_domain.h". Als invoerparameter accepteert de functie errorCode van het type CodeType en levert een constante tekenreekspointer (const char *) naar de desbetreffende melding op [SWS_TS_00907].

Foutafhandeling en gelijktijdigheid

De interface garandeert volledige uitzonderingsveiligheid (exception safe) en is gedeclareerd als noexcept, waardoor de aanroep gegarandeerd zonder C++-exceptions verloopt [SWS_TS_00907]. Bovendien is de functie gespecificeerd als thread-safe en kan deze zonder bezwaar gelijktijdig vanuit meerdere threads worden aangeroepen [SWS_TS_00907]. Interpretatie: De geretourneerde const char * wijst vermoedelijk naar onveranderlijk, statisch geheugen, waardoor voor de oproeper geen handmatige geheugenvrijgave nodig is. Vraag Q-933f88e4fde03016 (open)

Samenspel

Als overschreven methode (override) past de functie in het uniforme foutmodel van AUTOSAR Adaptive [SWS_TS_00907]. Op vergelijkbare wijze implementeert ook apext::tsync::TsyncFvmErrorDomain uit de header #include "apext/tsync/fvm_error_domain.h" een gelijknamige Message-functie voor het resolven van domeinspecifieke foutteksten onder dezelfde garanties met betrekking tot thread- en uitzonderingsveiligheid [SWS_TS_14210].

Gebruik en aanroepcontext

De lidfunctie Name() van de klasse ara::tsync::TsyncErrorDomain levert een pointer naar een constante tekenreeks op die het foutdomein identificeert [SWS_TS_00906]. De functie vereist het headerbestand ara/tsync/tsync_error_domain.h, wordt synchroon aangeroepen en accepteert geen parameters [SWS_TS_00906]. Als retourwaarde wordt het type const char * overgedragen [SWS_TS_00906]. Interpretatie: Aangezien de retourwaarde is gedefinieerd als tekenreeksconstante, heeft het geheugengebied vermoedelijk een statische levensduur en mag het door de oproeper noch gewijzigd noch vrijgegeven worden. Vraag Q-f9cb9d4986d49755 (open)

Foutafhandeling en gelijktijdigheid

De methode is gedeclareerd als noexcept en gespecificeerd als uitzonderingsveilig (“exception safe”), waarmee gegarandeerd is dat er geen uitzonderingen worden geworpen [SWS_TS_00906]. Specifieke foutcodes, DET- of DEM-meldingen bestaan er voor deze aanroep niet. Wat betreft het concurrency-gedrag is de functie geclassificeerd als thread-safe (“thread-safe”) [SWS_TS_00906]. De aanroep kan bijgevolg zonder externe synchronisatie parallel vanuit meerdere uitvoeringscontexten plaatsvinden.

Samenspel en verwante eisen

Met de aanduiding override overschrijft de functie de gestandaardiseerde interface voor domeinaanduiding in de module ts [SWS_TS_00906]. Hetzelfde ontwerppatroon implementeert het verwante foutdomein apext::tsync::TsyncFvmErrorDomain, waarvan de functie Name() uit apext/tsync/fvm_error_domain.h eveneens synchroon, thread-safe en uitzonderingsveilig de bijbehorende identifier levert [SWS_TS_14209].

Gebruik

De lidfunctie ThrowAsException van de klasse ara::tsync::TsyncErrorDomain genereert uit de meegegeven parameter errorCode synchroon een nieuwe instantie van TsyncException en werpt deze als C++-exception ([SWS_TS_00908]). De functie heeft geen retourwaarde (void) en wordt via de header ara/tsync/tsync_error_domain.h beschikbaar gesteld.

Foutafhandeling en exception-veiligheid

De methode is gedeclareerd met noexcept(false) en gespecificeerd als not exception safe ([SWS_TS_00908]). Interpretatie: Deze classificatie is vermoedelijk gebaseerd op het feit dat de functie zoals bedoeld een exception triggert en zo de reguliere control flow verlaat. Vraag Q-cde17219378516c1 (open) Specifieke foutcodes worden niet geretourneerd, maar via het geworpen uitzonderingsobject getransporteerd.

Gelijktijdigheid en beperkingen

De functie is geclassificeerd als thread-safe ([SWS_TS_00908]) en kan zodoende veilig vanuit gelijktijdige threads worden aangeroepen. Een wezenlijke restrictie betreft de toolchain: conform [SWS_CORE_10304] neemt ThrowAsException niet deel aan overload resolution indien C++-exceptions in de compiler-toolchain zijn gedeactiveerd.

Samenspel

Het gedrag komt overeen met het uniforme patroon voor foutdomeinen in AUTOSAR Adaptive. Een directe tegenhanger bevindt zich in apext::tsync::TsyncFvmErrorDomain ([SWS_TS_14211]), waar ThrowAsException een apext::tsync::TsyncFvmException werpt en eveneens onderworpen is aan de voorschriften uit [SWS_CORE_10304].

Gebruik

De parameterloze standaardconstructor genereert een nieuwe instantie van het foutdomein ara::tsync::TsyncErrorDomain [SWS_TS_00905]. De declaratie wordt via de header #include "ara/tsync/tsync_error_domain.h" beschikbaar gesteld [SWS_TS_00905]. De uitvoering vindt synchroon plaats, accepteert geen overdrachtsparameters en werpt geen C++-excepties (noexcept) [SWS_TS_00905].

Samenspel en foutafhandeling

Het aangemaakte foutdomein dient voor het inkapselen en interpreteren van synchronisatiespecifieke fouttoestanden in de module Time Synchronization. Binnen het domein zijn de type-aliassen Errc voor de foutcode-enumeratie TsyncErrc [SWS_TS_01266] en Exception voor de exceptie-basisklasse TsyncException [SWS_TS_01267] beschikbaar. Instanties van de klasse leveren via de methode Name een constante naamstekenreeks van het domein op [SWS_TS_00906] en via Message de tekstuele foutbeschrijving bij een opgegeven foutcode [SWS_TS_00907]. Bovendien maakt ThrowAsException het aanmaken en opwerpen van een TsyncException op basis van een ara::core::ErrorCode mogelijk, mits C++-excepties in de compiler zijn ingeschakeld [SWS_TS_00908]. In typische toepassingsscenario's zal een eigen instantiëring via de constructor zelden vereist zijn, aangezien via GetTsyncErrorDomain reeds een referentie naar het globale instantie-object beschikbaar is [SWS_TS_00909]. Vraag Q-8ebaff4e52125b78 (open)

Gelijktijdigheid en beperkingen

De aanroep is gespecificeerd als uitzonderingsveilig (exception safe) en thread-safe (thread-safe) [SWS_TS_00905]. De instantiëring kan zodoende thread-overschrijdend zonder aanvullende synchronisatiemaatregelen plaatsvinden.