class ara::idsm::IdsmErrorDomain

The class binds the Intrusion Detection System Manager module to the error handling system of the AUTOSAR Adaptive Platform and defines domain-specific error codes as well as exceptions [SWS_AIDSM_10706]. Its main tasks include identifying the domain, providing readable error messages for error codes, and converting errors into typed exceptions via ThrowAsException [SWS_AIDSM_10712]. Because the default constructor is deleted, access presumably occurs via a global instance whose method calls are specified as completely thread-safe. Question (open)

more ›

Context

The class ara::idsm::IdsmErrorDomain functions within the AUTOSAR Adaptive Platform in module idsm as the central error domain for identifying and classifying system-specific error states of the Intrusion Detection System Manager [SWS_AIDSM_10706]. As a final specialization of base class ara::core::ErrorDomain, it seamlessly integrates the IdsM subsystem into the unified error handling model of the Adaptive Platform [SWS_AIDSM_10706]. The class is defined in header ara/idsm/idsm_error_domain.h.

Within the error architecture, the class links relevant type definitions for IdsM error handling: Via type alias Errc, it references the domain-specific error code enumeration IdsmErrc [SWS_AIDSM_10707], while type alias Exception is bound to the module-specific exception class IdsmException [SWS_AIDSM_10708]. In addition, it provides a unique identifier of the domain for diagnostic and logging purposes via the overridden method Name() [SWS_AIDSM_10710].

Context diagram: Placement of IdsmErrorDomain between base class, error codes, and exceptions. Sources: [SWS_AIDSM_10706], [SWS_AIDSM_10707], [SWS_AIDSM_10708], [SWS_AIDSM_10712]

Lifecycle

The creation of instances of IdsmErrorDomain is subject to strict constraints. The default constructor is explicitly deleted (IdsmErrorDomain() = delete;) [SWS_AIDSM_10709]. Calling components and applications therefore cannot instantiate the class via normal object creation. In practice, the provision of the domain instance is presumably carried out via a static access function of the module as a long-lived singleton, as is customary for error domains in the AUTOSAR Adaptive Platform. Question Q-f791746dd8b5c3d5 (open)

As a purely functional error domain, the class has no mutable internal state and does not undergo complex lifecycle phases or state transitions. Regarding concurrency, all provided method calls (Name(), Message(), and ThrowAsException()) are explicitly specified as thread-safe [SWS_AIDSM_10710], [SWS_AIDSM_10711], [SWS_AIDSM_10712]. Instances of the error domain can thus be used safely in parallel by multiple threads of the system without additional external synchronization mechanisms.

Usage Path

In practical use, the class serves to translate and mediate IdsM errors within the software system via the following typical steps:

• Identification and diagnosis: Via method Name(), the identifier of the error domain can be queried to determine whether a given error originates from the IdsM module [SWS_AIDSM_10710].
• Textual error message: In the presence of a specific error code from IdsmErrc (alias Errc), invoking Message(errorCode) returns a readable description of the error cause as a character string [SWS_AIDSM_10707], [SWS_AIDSM_10711].
• Exception throwing: If a call hierarchy requires an exception instead of value-based error handling, method ThrowAsException(errorCode) directly converts an error code into the corresponding exception [SWS_AIDSM_10712].

Through this usage path, the domain supports both value-based error checks via ara::core::ErrorCode and classic exception-based control flows in the event of an error.

Error Scenarios

Error conditions within the IdsM module are represented via values of enumeration IdsmErrc, which are accessed in a typed manner via alias Errc [SWS_AIDSM_10707]. The error domain controls how these error codes are transformed into exceptional situations.

Method ThrowAsException(const ara::core::ErrorCode& errorCode) is annotated with noexcept(false) and throws the exception corresponding to the passed error code [SWS_AIDSM_10712]. This type is IdsmException, which is connected via alias Exception [SWS_AIDSM_10708]. Interpretation: In the event of an error, the call does not return normally, but forces exit from the current execution context by throwing the exception. Question Q-52ca402c6c38a110 (open) In contrast, Name() and Message() guarantee through their noexcept declaration that unintended exceptions can never be thrown during pure name or message queries [SWS_AIDSM_10710], [SWS_AIDSM_10711].