클래스 ara::idsm::IdsmException

클래스 ara::idsm::IdsmException은 IdsM 프로그래밍 인터페이스의 오류를 나타내기 위한 표준화된 C++ 예외 클래스 역할을 합니다 [SWS_AIDSM_10704]. ara::core::Exception에서 파생되며 원인 분석을 위해 특정 오류 코드를 캡슐화합니다. 인스턴스화는 스레드 안전하며 noexcept로 보장되는 ara::core::ErrorCode을 사용하는 명시적 생성자를 통해 수행됩니다 [SWS_AIDSM_10705]. 이를 통해 클래스는 실패한 IdsM 흐름에서 결정론적이고 안전한 예외 처리를 가능하게 합니다.

자세히 ›

컨텍스트

클래스 ara::idsm::IdsmException은 침입 탐지 시스템 관리자(IdsM)의 프로그래밍 인터페이스 오류를 알리고 처리하기 위한 전용 예외 클래스 역할을 합니다 [SWS_AIDSM_10704]. 헤더 ara/idsm/idsm_error_domain.h에 정의되어 있으며 기본 클래스 ara::core::Exception에서 공개적으로 파생됩니다 [SWS_AIDSM_10704]. AUTOSAR Adaptive Platform 내에서 이 클래스는 주로 적용 기능 클러스터 및 IdsM 모듈의 인터페이스와 상호작용합니다. 개발자에게 오류 메시지를 반환값을 통해서만 전파하는 대신 오류 상태를 구조화된 방식으로 포착할 수 있는 표준화된 C++ 예외 메커니즘을 제공합니다.

수명 주기

ara::idsm::IdsmException의 인스턴스화는 ara::core::ErrorCode 전달을 요구하는 명시적 생성자를 통해 수행됩니다 [SWS_AIDSM_10705]. 이 생성자는 noexcept 지정자로 선언되어 예외 객체를 생성하는 동안 추가 예외가 발생하지 않도록 보장합니다 [SWS_AIDSM_10705]. 동시성과 관련하여 생성은 스레드 안전(thread-safe)으로 명시적으로 지정되어 [SWS_AIDSM_10705], 다중 스레드 실행 컨텍스트에서도 추가 동기화 없이 예외 객체를 안전하게 인스턴스화할 수 있습니다.

예외 객체로서 IdsmException은 일반적인 C++ 값 시맨틱을 따릅니다. 생성은 오류 조건을 감지하거나 실패한 작업 결과를 언패킹할 때 즉시 발생합니다. 수명은 관련 catch 블록의 평가에 연결되어 있으며, 이 블록이 종료된 후 런타임 시스템에 의해 예외 객체가 자동으로 소멸됩니다.

사용 경로

이 클래스의 전형적인 사용은 동기 IdsM 서비스 호출 프레임워크 내에서 이루어집니다. 애플리케이션이 모듈 idsm의 함수를 호출합니다. IdsM 런타임 환경에서 유효하지 않은 작업이나 내부 오류를 감지하면 해당 ara::core::ErrorCode을(를) 생성하고 이를 통해 ara::idsm::IdsmException [SWS_AIDSM_10705]을(를) 인스턴스화합니다. 이 예외가 발생하여 일반적인 제어 흐름 [SWS_AIDSM_10704]을(를) 중단합니다.

호출 애플리케이션은 해당 객체를 구체적으로 ara::idsm::IdsmException(으)로 캐치하거나 일반적으로 ara::core::Exception(으)로 캐치합니다. 예외 핸들러 내에서 캡슐화된 오류 코드를 추출하여 진단 로깅, 폴백 전략 또는 결정론적 재시작을 위해 평가할 수 있습니다.

시퀀스 다이어그램: API 호출 시 IdsmException을 사용한 오류 처리의 전형적인 흐름. 출처: [SWS_AIDSM_10704], [SWS_AIDSM_10705]

오류 시나리오

클래스 ara::idsm::IdsmException은(는) IdsM API 오류를 표현하는 역할을 하며, 함수 호출이 실패하고 이 상태가 예외 경로를 통해 보고될 때 사용됩니다 [SWS_AIDSM_10704]. 생성의 핵심적인 사전 조건은 오류 원인을 정밀하게 설명하는 유효한 ara::core::ErrorCode 객체의 존재입니다 [SWS_AIDSM_10705].

객체 생성 중의 2차 오류 상태는 생성자의 noexcept 보증을 통해 배제됩니다 [SWS_AIDSM_10705]. 이를 통해 이미 치명적인 오류 처리 경로에서 std::terminate을(를) 통한 예기치 않은 프로그램 중단이 유발되는 것을 방지합니다. 생성자 호출의 사후 조건은 추가 진단을 위해 오류 코드를 변경 없이 유지하는 초기화된 예외 객체입니다.