class ara::tsync::TsyncErrorDomain

Verwendung

Die Methode Message der Klasse ara::tsync::TsyncErrorDomain dient dem synchronen Abrufen einer textuellen Fehlerbeschreibung zu einem übergebenen Fehlercode [SWS_TS_00907]. Sie wird über den Header #include "ara/tsync/tsync_error_domain.h" bereitgestellt. Als Eingabeparameter nimmt die Funktion errorCode vom Typ CodeType entgegen und liefert einen konstanten Zeichenkettenzeiger (const char *) auf die entsprechende Meldung zurück [SWS_TS_00907].

Fehlerbehandlung und Nebenläufigkeit

Die Schnittstelle garantiert vollständige Ausnahmesicherheit (exception safe) und ist als noexcept deklariert, weshalb der Aufruf garantiert ohne C++-Exceptions abläuft [SWS_TS_00907]. Zudem ist die Funktion als thread-safe spezifiziert und kann bedenkenlos nebenläufig aus mehreren Threads aufgerufen werden [SWS_TS_00907]. Interpretation: Der zurückgegebene const char * dürfte auf unveränderlichen, statischen Speicher zeigen, wodurch für den Aufrufer keine manuelle Speicherfreigabe anfällt. Frage Q-933f88e4fde03016 (offen)

Zusammenspiel

Als überschriebene Methode (override) fügt sich die Funktion in das einheitliche Fehlermodell von AUTOSAR Adaptive ein [SWS_TS_00907]. In ähnlicher Weise implementiert auch apext::tsync::TsyncFvmErrorDomain aus dem Header #include "apext/tsync/fvm_error_domain.h" eine gleichnamige Message-Funktion zur Auflösung domänenspezifischer Fehlertexte unter denselben Garantien bezüglich Thread- und Ausnahmesicherheit [SWS_TS_14210].

Verwendung und Aufrufkontext

Die Elementfunktion Name() der Klasse ara::tsync::TsyncErrorDomain liefert einen Zeiger auf eine konstante Zeichenkette zurück, die die Fehlerdomäne identifiziert [SWS_TS_00906]. Die Funktion erfordert die Header-Datei ara/tsync/tsync_error_domain.h, wird synchron aufgerufen und nimmt keine Parameter entgegen [SWS_TS_00906]. Als Rückgabewert wird der Typ const char * übergeben [SWS_TS_00906]. Interpretation: Da der Rückgabewert als Zeichenkettenkonstante definiert ist, dürfte der Speicherbereich statische Lebensdauer besitzen und darf vom Aufrufer weder modifiziert noch freigegeben werden. Frage Q-f9cb9d4986d49755 (offen)

Fehlerbehandlung und Nebenläufigkeit

Die Methode ist als noexcept deklariert und als ausnahmesicher („exception safe“) spezifiziert, womit garantiert ist, dass keine Ausnahmen geworfen werden [SWS_TS_00906]. Spezifische Fehlercodes, DET- oder DEM-Meldungen existieren für diesen Aufruf nicht. Hinsichtlich des Nebenläufigkeitsverhaltens ist die Funktion als threadsicher („thread-safe“) klassifiziert [SWS_TS_00906]. Der Aufruf kann folglich ohne externe Synchronisation parallel aus mehreren Ausführungskontexten erfolgen.

Zusammenspiel und verwandte Anforderungen

Mit der Kennzeichnung override überschreibt die Funktion die standardisierte Schnittstelle zur Domänenbezeichnung im Modul ts [SWS_TS_00906]. Dasselbe Entwurfsmuster implementiert die verwandte Fehlerdomäne apext::tsync::TsyncFvmErrorDomain, deren Funktion Name() aus apext/tsync/fvm_error_domain.h ebenfalls synchron, threadsicher und ausnahmesicher den zugehörigen Bezeichner liefert [SWS_TS_14209].

Verwendung

Die Elementfunktion ThrowAsException der Klasse ara::tsync::TsyncErrorDomain erzeugt aus dem übergebenen Parameter errorCode synchron eine neue Instanz von TsyncException und wirft diese als C++-Exception ([SWS_TS_00908]). Die Funktion besitzt keinen Rückgabewert (void) und wird über den Header ara/tsync/tsync_error_domain.h bereitgestellt.

Fehlerbehandlung und Exception-Sicherheit

Die Methode ist mit noexcept(false) deklariert und als not exception safe spezifiziert ([SWS_TS_00908]). Interpretation: Diese Einstufung dürfte sich daraus begründen, dass die Funktion bestimmungsgemäß eine Exception auslöst und somit den regulären Kontrollfluss verlässt. Frage Q-cde17219378516c1 (offen) Spezifische Fehlercodes werden nicht zurückgegeben, sondern über das geworfene Ausnahmeobjekt transportiert.

Nebenläufigkeit und Einschränkungen

Die Funktion ist als thread-safe eingestuft ([SWS_TS_00908]) und kann somit sicher aus nebenläufigen Threads aufgerufen werden. Eine wesentliche Restriktion betrifft die Toolchain: Gemäß [SWS_CORE_10304] nimmt ThrowAsException nicht an der Überladungsauflösung (overload resolution) teil, sofern C++-Exceptions in der Compiler-Toolchain deaktiviert sind.

Zusammenspiel

Das Verhalten entspricht dem einheitlichen Muster für Fehlerdomänen in AUTOSAR Adaptive. Ein direktes Pendant findet sich in apext::tsync::TsyncFvmErrorDomain ([SWS_TS_14211]), wo ThrowAsException eine apext::tsync::TsyncFvmException wirft und ebenfalls den Vorgaben aus [SWS_CORE_10304] unterliegt.

Verwendung

Der parameterlose Standardkonstruktor erzeugt eine neue Instanz der Fehlerdomäne ara::tsync::TsyncErrorDomain [SWS_TS_00905]. Die Deklaration wird über den Header #include "ara/tsync/tsync_error_domain.h" bereitgestellt [SWS_TS_00905]. Die Ausführung erfolgt synchron, nimmt keine Übergabeparameter entgegen und wirft keine C++-Ausnahmen (noexcept) [SWS_TS_00905].

Zusammenspiel und Fehlerbehandlung

Die erzeugte Fehlerdomäne dient der Kapselung und Interpretation synchronisationsspezifischer Fehlerzustände im Modul Time Synchronization. Innerhalb der Domäne stehen die Typ-Aliase Errc für die Fehlercode-Enumeration TsyncErrc [SWS_TS_01266] sowie Exception für die Ausnahmebasisklasse TsyncException [SWS_TS_01267] bereit. Instanzen der Klasse liefern über die Methode Name eine konstante Namenszeichenkette der Domäne [SWS_TS_00906] und über Message die textuelle Fehlerbeschreibung zu einem angegebenen Fehlercode [SWS_TS_00907]. Zudem erlaubt ThrowAsException das Erzeugen und Werfen einer TsyncException auf Basis eines ara::core::ErrorCode, sofern C++-Ausnahmen im Compiler aktiviert sind [SWS_TS_00908]. In typischen Anwendungsszenarien dürfte eine eigene Instanziierung über den Konstruktor selten erforderlich sein, da über GetTsyncErrorDomain bereits eine Referenz auf das globale Instanzobjekt bereitsteht [SWS_TS_00909]. Frage Q-8ebaff4e52125b78 (offen)

Nebenläufigkeit und Einschränkungen

Der Aufruf ist als ausnahmesicher (exception safe) und threadsicher (thread-safe) spezifiziert [SWS_TS_00905]. Die Instanziierung kann somit thread-übergreifend ohne zusätzliche Synchronisationsmaßnahmen erfolgen.