klasse ara::com::ComErrorDomain

De klasse ara::com::ComErrorDomain vertegenwoordigt het communicatiefoutdomein voor het identificeren van algemene, niet-interfacespecifieke fouten in de ara::com-API ([SWS_CM_11265]). Deze stelt foutbeschrijvingen beschikbaar voor foutcodes zoals ComErrc::kCommunicationFailure en maakt het opvragen daarvan mogelijk via Message() of het omzetten in een exceptie door middel van ThrowAsException() ([SWS_CM_11332]). Aangezien de standaardconstructor ervan is verwijderd, fungeert deze als stateless, thread-safe domeininstantie voor de foutdragende ara::core::Result.

meer ›

Context

De klasse ara::com::ComErrorDomain vertegenwoordigt het gestandaardiseerde communicatiefoutdomein van het Adaptive Platform voor het functionele cluster Communication Management (SWS CommunicationManagement p. 439). Deze is afgeleid van de basisklasse ara::core::ErrorDomain en definieert de semantische context voor algemene fouten die kunnen optreden tijdens methode-aanroepen of gegevensoverdrachten, maar niet specifiek zijn voor een afzonderlijke ServiceInterface ([SWS_CM_11265]). In de foutarchitectuur van ara::com bakent deze algemene communicatiestoringen systematisch af van E2E-bewakingsfouten en applicatiespecifieke servicefouten (SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”).

Tot de centrale interactiepartners behoren de Adaptive Application, de service- en proxy-implementaties van de middleware evenals de datatypen ara::core::ErrorCode en ara::core::Result van het basissysteem (EXP ARAComAPI §4.7 “Error Handling”). Voor de semantische typebinding stelt de klasse de type-aliassen Errc voor de foutcode-enumeratie ComErrc ([SWS_CM_11336]) en Exception voor de bijbehorende exceptieklasse ComException beschikbaar ([SWS_CM_11337]).

Contextdiagram: inpassing van de ComErrorDomain in de foutarchitectuur van ara::com. Bronnen: [SWS_CM_11265], EXP ARAComAPI §4.7 “Error Handling”, SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”

Levenscyclus

Als specificatieklasse voor een foutdomein is het aanmaken van ara::com::ComErrorDomain verhinderd door de verwijdering van de standaardconstructor ComErrorDomain() = delete; ([SWS_CM_11330]). Interpretatie: het beschikbaar stellen van de domeininstantie vindt vermoedelijk plaats als statische singleton via het platform, zodat applicatiecomponenten het domein niet dynamisch hoeven te instantiëren of beheren. Vraag Q-bf957a108c0a5378 (open)

De instantie fungeert als een stateless descriptor zonder veranderlijke attributen. Alle beschikbaar gestelde methoden zoals Name() ([SWS_CM_11331]) en Message() ([SWS_CM_11332]) zijn gedeclareerd als const noexcept. Dit waarborgt onbeperkte thread-safety bij gelijktijdige foutopvragingen door parallelle applicatie- en middleware-threads.

Gebruikspad

Het typische gebruikstraject omvat het detecteren, overdragen en evalueren van een fout via de interfaces van ara::com:

1. De applicatie initieert een service-interactie, bijvoorbeeld via de aanroepoperator van de methodeklasse operator() ([SWS_CM_00196]).
2. Detecteert de middleware tijdens de verwerking een foutsituatie, zoals een communicatiestoring of een niet-geconfigureerde applicatiefout ([SWS_CM_00048]), dan wordt de operatie SetError op de corresponderende Promise aangeroepen (SWS CommunicationManagement p. 300).
3. Daarbij wordt een ara::core::ErrorCode geconstrueerd waarvan het domein is ingesteld op ara::com::ComErrorDomain ([SWS_CM_11329]) en de numerieke code op een specifieke enum-waarde zoals ComErrc::kCommunicationFailure ([SWS_CM_10432]).
4. De aan de applicatie geretourneerde ara::core::Future resp. ara::core::Result transporteert de foutcode in fouttoestand naar de aanroeper (EXP ARAComAPI §4.7 “Error Handling”).
5. De applicatie controleert de Result en gebruikt de domeinfuncties Name() ([SWS_CM_11331]) en Message() ([SWS_CM_11332]) om foutmeldingen op te lossen voor logging of diagnose.
6. Indien de applicatielogica een exceptie verwacht en C++-exceptions zijn ingeschakeld, kan de overgang naar een ComException door middel van ThrowAsException() worden geactiveerd ([SWS_CM_11333]).

Sequentiediagram: signalering en bevraging van een communicatiefout via ComErrorDomain. Bronnen: [SWS_CM_00196], [SWS_CM_10432], [SWS_CM_11329], [SWS_CM_11332], SWS CommunicationManagement p. 300

Foutscenario's

Het foutconcept van ara::com maakt een strikt onderscheid tussen herstelbare fouten (Recoverable Errors) en ernstige programmeschendingen (Violations of Corruptions) (EXP ARAComAPI §4.7 “Error Handling”). Herstelbare fouten worden afgehandeld via ara::core::Result en ara::core::ErrorCode, waarbij foutcodes van het domein ComErrorDomain worden geadresseerd via de identifier-alias Errc ([SWS_CM_11336]).

Treedt er bijvoorbeeld tijdens een aanroep op afstand een overdrachtsonderbreking op, dan meldt het systeem ComErrc::kCommunicationFailure ([SWS_CM_10432]). Bij een niet-geconfigureerde applicatiefout breekt de middleware de aanroep af en stelt eveneens een overeenkomstige foutcode van het domein in ([SWS_CM_00048], SWS CommunicationManagement p. 300).

Moet een foutcode als exceptie worden geworpen, dan instantieert ThrowAsException() een exceptie van het type ComException ([SWS_CM_11337]) en werpt deze ([SWS_CM_11333]). Deze methode is niet uitzonderingsveilig (not exception safe) en neemt volgens de specificatie bij uitgeschakelde C++-exceptions niet deel aan overload resolution ([SWS_CM_11333]). Niet-herstelbare systeemschendingen leiden daarentegen direct tot het afbreken van het platform en worden niet via ComErrorDomain behandeld (EXP ARAComAPI §4.7 “Error Handling”).