klasse ara::exec::ExecErrorDomain

De standaardconstructor ExecErrorDomain() initialiseert een nieuwe instantie van het foutdomein ara::exec::ExecErrorDomain conform [SWS_EM_02286]. De aanroep verloopt synchroon, accepteert geen parameters en heeft geen retourwaarde. De declaratie is ingevoegd via de header ara/exec/exec_error_domain.h.

Wat betreft robuustheid en gelijktijdigheid is de constructor gedeclareerd als noexcept, geldt deze als uitzonderingsveilig (exception safe) en is deze gespecificeerd als onbeperkt thread-veilig (thread-safe) [SWS_EM_02286]. Foutafhandeling bij het aanmaken van het object is niet vereist, aangezien de bewerking foutloos verloopt en geen foutcodes of excepties genereert.

In het totale systeem dient het aangemaakte object voor de representatie en beschrijving van modulespecifieke fouten van Execution Management. Via de instantie kan de domeinnaam worden opgevraagd [SWS_EM_02287], kunnen tekstuele meldingen bij foutcodes worden achterhaald [SWS_EM_02288] of kunnen fouten als C++-exceptie worden geworpen [SWS_EM_02289]. Een expliciete instantiëring via deze constructor zal in applicatiemodules zelden nodig zijn, aangezien via de vrije functie GetExecErrorDomain() al een globale referentie naar de instantie beschikbaar wordt gesteld [SWS_EM_02290]. Vraag Q-df8efc87e6547216 (open)

De methode Message is een virtuele lidfunctie van de klasse ara::exec::ExecErrorDomain binnen het functionele cluster Execution Management [SWS_EM_02288]. Ze wordt via het headerbestand ara/exec/exec_error_domain.h ingesloten en overschrijft de corresponderende interface voor het bepalen van tekstuele foutmeldingen [SWS_EM_02288].

Het gebruik ziet er als volgt uit:

• Aanroep en semantiek: De aanroep geschiedt synchroon en is ontworpen als leesoperatie (const) [SWS_EM_02288].
• Parameters: Als invoerparameter wordt errorCode van het type CodeType doorgegeven, die de numerieke identificator van de fout vertegenwoordigt [SWS_EM_02288].
• Retourwaarde: De functie retourneert een pointer van het type const char * naar de aan de foutcode gekoppelde foutmelding [SWS_EM_02288]. Interpretatie: Er mag van worden uitgegaan dat deze pointer verwijst naar een statische tekenreeks, zodat er voor de aanroeper geen geheugenvrijgave vereist is. Vraag Q-3e254e008a07294e (open)

Wat de foutafhandeling betreft, is de functie gedeclareerd als noexcept en gespecificeerd als exception safe [SWS_EM_02288]. De functie werpt zelf geen C++-uitzonderingen op. Eigen foutcodes of terugmeldingskanalen voor foutieve aanroepen zijn in de specificatie niet voorzien [SWS_EM_02288].

Met betrekking tot gelijktijdigheid is de methode geclassificeerd als thread-safe [SWS_EM_02288]. Omdat ze de toestand van het foutdomein niet wijzigt, kan ze zonder externe synchronisatiemechanismen veilig parallel worden aangeroepen vanuit meerdere threads [SWS_EM_02288].

Gebruik

De lidfunctie Name van de klasse ara::exec::ExecErrorDomain levert synchroon een pointer naar een op tekens gebaseerde constante (const char *) op, die het foutdomein aanduidt [SWS_EM_02287]. De geretourneerde waarde richt zich naar de definitie voor ara::exec::ExecErrorDomain uit [SWS_CORE_90023]. De methode wordt via de header ara/exec/exec_error_domain.h ingesloten, verwacht geen overdrachtsparameters en opereert als constante lidfunctie op instanties van het foutdomein [SWS_EM_02287].

Foutafhandeling en gelijktijdigheid

De interface is gedeclareerd als noexcept en daarmee geclassificeerd als volledig uitzonderingsveilig (exception safe) [SWS_EM_02287]. Er worden noch foutcodes geretourneerd, noch uitzonderingen geworpen. Met betrekking tot gelijktijdige toegang is de functie gespecificeerd als thread-safe (thread-safe) [SWS_EM_02287]. Aanroepen kunnen bijgevolg zonder extra synchronisatiemaatregelen parallel vanuit verschillende threads worden uitgevoerd.

Samenspel

Door de declaratie als override implementeert de functie de algemene interface voor het opvragen van de domeinnaam in het kader van [SWS_CORE_90023]. De geretourneerde tekenreeks dient er vermoedelijk toe het foutdomein in log- of diagnose-uitvoer eenduidig leesbaar te identificeren [SWS_EM_02287]. Vraag Q-ae1f9de8510d7ff9 (open)

De methode ThrowAsException van het foutdomein ara::exec::ExecErrorDomain dient voor het synchroon opwerpen van een C++-uitzondering op basis van een opgetreden foutcode [SWS_EM_02289]. Ze accepteert als invoerparameter een referentie naar errorCode (type const ara::core::ErrorCode &), instantieert op basis daarvan een uitzonderingsobject van het type ExecException en werpt dit direct als C++-exception op [SWS_EM_02289]. De functie retourneert geen waarde.

Wat het fout- en runtimegedrag betreft, moeten de volgende aspecten in acht worden genomen:

• Uitzonderingsveiligheid: Omdat het beoogde gedrag van de functie bestaat uit het opwerpen van een uitzondering, is ze geannoteerd met noexcept(false) en formeel ingeschaald als niet uitzonderingsveilig (not exception safe) [SWS_EM_02289]. Aanroepers moeten daarom voorbereid zijn op het vangen resp. afhandelen van ExecException.
• Gelijktijdigheid: De specificatie merkt de lidfunctie aan als thread-safe (thread-safe) [SWS_EM_02289]. Ze kan zodoende veilig worden aangeroepen vanuit gelijktijdige threads.
• Toolchain-beperkingen: Volgens [SWS_CORE_10304] neemt ThrowAsException niet deel aan overbelastingsresolutie (overload resolution) indien C++-exceptions in de compiler-toolchain zijn uitgeschakeld [SWS_EM_02289]. In omgevingen zonder exception-ondersteuning is deze aanroep bijgevolg niet beschikbaar.