klasse ara::crypto::CryptoErrorDomain

Gebruik en aanroepcontext

De standaardconstructor CryptoErrorDomain() initialiseert een instantie van het foutdomein voor cryptografische bewerkingen [SWS_CRYPT_19902]. Deze is gespecificeerd als constexpr en noexcept, accepteert geen argumenten en heeft geen retourwaarde. De uitvoering geschiedt synchroon en kan tijdens compilatietijd plaatsvinden. In toepassingsprogramma's zou een handmatige instantiëring zelden nodig zijn, aangezien de toegang tot het domein regulier via de globale functie GetCryptoErrorDomain() verloopt [SWS_CRYPT_19952]. Vraag Q-1e029d80fb7bf7d1 (open)

Foutafhandeling en gelijktijdigheid

Het creëren van het object is gedefinieerd als exception safe en thread-safe [SWS_CRYPT_19902]. Omdat de constructor met noexcept is gedeclareerd, treden er bij de aanroep geen fouten of excepties op; foutmeldingen aan DET of DEM bestaan voor deze constructor niet.

Interactie in de module

Het gecreëerde domein vormt de context voor cryptografische foutbeschrijvingen:

• Het omhult de foutcodes van de enumeratie CryptoErrc [SWS_CRYPT_10099] via de typealias Errc [SWS_CRYPT_19903].
• Via de vrije functie MakeErrorCode() worden instanties van ara::core::ErrorCode aangemaakt, die vast refereren aan dit domein [SWS_CRYPT_19951].
• De lidfuncties van het domein maken het opvragen van de identifier via Name() [SWS_CRYPT_19950] mogelijk, het achterhalen van tekst via Message() [SWS_CRYPT_19953], evenals het opwerpen van systeemspecifieke fouten via ThrowAsException() [SWS_CRYPT_19954] met het basistype Exception [SWS_CRYPT_19904].

De methode Message van de klasse ara::crypto::CryptoErrorDomain vertaalt een foutcodewaarde naar een leesbare storingsmelding in platte tekst [SWS_CRYPT_19953]. Zij overschrijft de basismethode voor het oplossen van foutteksten en wordt ingesloten via het headerbestand ara/crypto/common/crypto_error_domain.h [SWS_CRYPT_19953]. Daarnaast is de interface inhoudelijk gekoppeld aan de eis RS_CRYPTO_02310 [SWS_CRYPT_19953].

Gebruik en aanroepcontext

De aanroep vindt synchroon plaats als constante memberfunctie (const), waardoor de methode staatloos werkt en het foutdomeinobject ongewijzigd blijft [SWS_CRYPT_19953]. De functie verwacht de volgende invoerparameter [SWS_CRYPT_19953]:

• errorCode: Een numerieke foutcode-identificator uit de enumeratie CryptoErrc, die wordt doorgegeven als type ara::core::ErrorDomain::CodeType [SWS_CRYPT_19953].

Als retourwaarde levert de functie een pointer naar een constante tekenreeks (const char *) op, die de beschrijvende berichttekst bij de betreffende foutcode bevat [SWS_CRYPT_19953].

Concurrentie en exceptieveiligheid

Met betrekking tot uitvoeringsveiligheid en concurrentie gelden de volgende randvoorwaarden [SWS_CRYPT_19953]:

• Thread-safety: De functie is expliciet gespecificeerd als thread-safe (thread-safe), waardoor gelijktijdige aanroepen vanuit verschillende threads zonder externe synchronisatie zijn toegestaan [SWS_CRYPT_19953].
• Exceptieveiligheid: De methode is geclassificeerd als exceptieveilig (exception safe) en voorzien van de specificator noexcept, waardoor gegarandeerd geen C++-excepties worden gegenereerd [SWS_CRYPT_19953].

De memberfunctie Name van de klasse ara::crypto::CryptoErrorDomain levert de unieke identifier van het foutdomein voor cryptografische bewerkingen op [SWS_CRYPT_19950]. De functie wordt beschikbaar gesteld via het headerbestand ara/crypto/common/crypto_error_domain.h en overschrijft de overeenkomstige basisinterface voor foutdomeinen [SWS_CRYPT_19950].

Gebruik en semantiek

De aanroep vindt synchroon, parameterloos en zonder modificerende neveneffecten op de instantie plaats. Als retourwaarde wordt een const char * teruggegeven, die de unieke naam van het domein representeert [SWS_CRYPT_19950]. Interpretatie: De geretourneerde pointer verwijst vermoedelijk naar een statisch gepersisteerde tekenreeks, aangezien de interface niet voorziet in een dynamische levenscyclus of overdracht van geheugeneigendom. Vraag Q-b7f2dab65f25b7e6 (open)

Foutafhandeling en gelijktijdigheid

• Exceptieveiligheid: De methode is gedeclareerd met noexcept en gedefinieerd als exceptieveilig (exception safe), zodat aanroepers geen C++-exceptions hoeven op te vangen [SWS_CRYPT_19950].
• Foutsignalering: Voor de functie zijn geen specifieke foutcodes gespecificeerd; het opvragen van de naam mislukt bij normaal gebruik niet [SWS_CRYPT_19950].
• Thread-safety: De bewerking is gespecificeerd als thread-safe en kan zonder externe vergrendelingsmechanismen gelijktijdig vanuit meerdere threads worden uitgevoerd [SWS_CRYPT_19950].

Samenspel

De functie dient binnen het AUTOSAR Adaptive-foutafhandelingsmodel voor de identificatie van het foutdomein bij het evalueren en loggen van cryptografische foutoorzaken [SWS_CRYPT_19950].

De methode ThrowAsException van de klasse ara::crypto::CryptoErrorDomain dient om een C++-exception te triggeren op basis van een meegegeven foutcode [SWS_CRYPT_19954]. Zij overschrijft de overeenkomstige basismethode en is gedeclareerd met het attribuut [[noreturn]], waardoor aanroepen geen retourwaarde hebben en bij een succesvolle uitvoering niet regulair terugkeren [SWS_CRYPT_19954].

Met betrekking tot gebruik en parametrering gelden de volgende specificatiedetails:

• Parameter: Als invoerparameter wordt errorCode van het type const ara::core::ErrorCode& meegegeven, die een foutidentificatie uit de enumeratie CryptoErrc inkapselt [SWS_CRYPT_19954].
• Header-insluiting: De functie wordt beschikbaar gesteld via het headerbestand #include "ara/crypto/common/crypto_error_domain.h" [SWS_CRYPT_19954].
• Concurrentie: De uitvoering is gespecificeerd als thread-safe en kan zodoende veilig worden aangeroepen vanuit concurrente contexten [SWS_CRYPT_19954].

Met betrekking tot de foutafhandeling en exceptieveiligheid is de methode geclassificeerd als not exception safe [SWS_CRYPT_19954]. Een wezenlijke compiler- en toolchainbeperking vloeit voort uit [SWS_CORE_10304]: indien C++-exceptions in de compiler-toolchain zijn uitgeschakeld, neemt ThrowAsException niet deel aan de overload-resolutie en staat deze zodoende niet ter beschikking van de aanroeper [SWS_CRYPT_19954].