class ara::com::ComErrorDomain

Die Klasse ara::com::ComErrorDomain repräsentiert die Kommunikationsfehlerdomäne zur Identifikation allgemeiner, nicht schnittstellenspezifischer Fehler in der ara::com-API ([SWS_CM_11265]). Sie stellt Fehlerbeschreibungen für Fehlercodes wie ComErrc::kCommunicationFailure bereit und ermöglicht deren Abfrage über Message() oder die Wandlung in eine Ausnahme mittels ThrowAsException() ([SWS_CM_11332]). Da ihr Standardkonstruktor gelöscht ist, agiert sie als zustandslose, threadsichere Domäneninstanz für das fehlertragende ara::core::Result.

mehr ›

Kontext

Die Klasse ara::com::ComErrorDomain repräsentiert die standardisierte Kommunikationsfehlerdomäne der Adaptive Platform für das Funktionscluster Communication Management (SWS CommunicationManagement S. 439). Sie leitet von der Basisklasse ara::core::ErrorDomain ab und definiert den semantischen Kontext für allgemeine Fehler, die während Methodenaufrufen oder Datenübertragungen auftreten können, jedoch nicht spezifisch für ein einzelnes ServiceInterface sind ([SWS_CM_11265]). In der Fehlerarchitektur von ara::com grenzt sie allgemeine Kommunikationsstörungen systematisch von E2E-Überwachungsfehlern sowie anwendungsspezifischen Dienstfehlern ab (SWS CommunicationManagement §7.5.22.6 „Error Related Data Types“).

Zu ihren zentralen Interaktionspartnern gehören die Adaptive Application, die Dienst- und Proxy-Implementierungen der Middleware sowie die Datentypen ara::core::ErrorCode und ara::core::Result des Basissystems (EXP ARAComAPI §4.7 „Error Handling“). Für die semantische Typbindung stellt die Klasse die Typ-Aliase Errc für die Fehlercode-Enumeration ComErrc ([SWS_CM_11336]) sowie Exception für die zugehörige Ausnahmeklasse ComException bereit ([SWS_CM_11337]).

Kontextdiagramm: Einordnung der ComErrorDomain in die Fehlerarchitektur von ara::com. Quellen: [SWS_CM_11265], EXP ARAComAPI §4.7 „Error Handling“, SWS CommunicationManagement §7.5.22.6 „Error Related Data Types“

Lebenszyklus

Als Spezifikationsklasse für eine Fehlerdomäne ist die Erzeugung von ara::com::ComErrorDomain durch die Löschung des Standardkonstruktors ComErrorDomain() = delete; unterbunden ([SWS_CM_11330]). Interpretation: Die Bereitstellung der Domäneninstanz dürfte als statisches Singleton über die Plattform erfolgen, sodass Anwendungskomponenten die Domäne nicht dynamisch instanziieren oder verwalten müssen. Frage Q-bf957a108c0a5378 (offen)

Die Instanz agiert als zustandsloser Deskriptor ohne veränderliche Attribute. Sämtliche bereitgestellten Methoden wie Name() ([SWS_CM_11331]) und Message() ([SWS_CM_11332]) sind als const noexcept deklariert. Dies gewährleistet eine uneingeschränkte Threadsicherheit bei nebenläufigen Fehlerabfragen durch parallele Anwendungs- und Middleware-Threads.

Nutzungspfad

Der typische Nutzungspfad umfasst die Erkennung, Übermittlung und Auswertung eines Fehlers über die Schnittstellen von ara::com:

1. Die Anwendung initiiert eine Service-Interaktion, beispielsweise über den Aufrufoperator der Methodenklasse operator() ([SWS_CM_00196]).
2. Erkennt die Middleware während der Verarbeitung einen Fehlerfall, wie etwa eine Kommunikationsstörung oder einen unkonfigurierten Anwendungsfehler ([SWS_CM_00048]), wird die Operation SetError am korrespondierenden Promise aufgerufen (SWS CommunicationManagement S. 300).
3. Dabei wird ein ara::core::ErrorCode konstruiert, dessen Domäne auf ara::com::ComErrorDomain ([SWS_CM_11329]) und dessen numerischer Code auf einen spezifischen Enum-Wert wie ComErrc::kCommunicationFailure gesetzt ist ([SWS_CM_10432]).
4. Das an die Anwendung zurückgegebene ara::core::Future bzw. ara::core::Result transportiert den Fehlercode im Fehlerzustand an den Aufrufer (EXP ARAComAPI §4.7 „Error Handling“).
5. Die Anwendung prüft das Result und nutzt die Domänenfunktionen Name() ([SWS_CM_11331]) und Message() ([SWS_CM_11332]), um Fehlermeldungen für Protokollierung oder Diagnose aufzulösen.
6. Falls die Anwendungslogik eine Ausnahme erwartet und C++-Exceptions aktiviert sind, kann die Überführung in eine ComException mittels ThrowAsException() ausgelöst werden ([SWS_CM_11333]).

Sequenzdiagramm: Signalisierung und Abfrage eines Kommunikationsfehlers über ComErrorDomain. Quellen: [SWS_CM_00196], [SWS_CM_10432], [SWS_CM_11329], [SWS_CM_11332], SWS CommunicationManagement S. 300

Fehlerszenarien

Das Fehlerkonzept von ara::com unterscheidet strikt zwischen behebbaren Fehlern (Recoverable Errors) und schwerwiegenden Programmierverletzungen (Violations oder Corruptions) (EXP ARAComAPI §4.7 „Error Handling“). Behebbare Fehler werden über ara::core::Result und ara::core::ErrorCode abgewickelt, wobei Fehlercodes der Domäne ComErrorDomain über den Bezeichner-Alias Errc adressiert werden ([SWS_CM_11336]).

Tritt beispielsweise während eines Fernaufrufs eine Übertragungsunterbrechung auf, meldet das System ComErrc::kCommunicationFailure ([SWS_CM_10432]). Bei einem unkonfigurierten Anwendungsfehler bricht die Middleware den Aufruf ab und setzt ebenfalls einen entsprechenden Fehlercode der Domäne ([SWS_CM_00048], SWS CommunicationManagement S. 300).

Soll ein Fehlercode als Ausnahme geworfen werden, instanziiert ThrowAsException() eine Ausnahme des Typs ComException ([SWS_CM_11337]) und wirft diese ([SWS_CM_11333]). Diese Methode ist nicht ausnahmesicher (not exception safe) und nimmt laut Spezifikation bei deaktivierten C++-Exceptions nicht an der Überladungsauflösung teil ([SWS_CM_11333]). Nicht behebbare Systemverletzungen führen dagegen direkt zum Plattformabbruch und werden nicht über ComErrorDomain behandelt (EXP ARAComAPI §4.7 „Error Handling“).