클래스 ara::com::e2e::ComE2EException

클래스 ara::com::e2e::ComE2EException은 통신 관리의 E2E API([SWS_CM_12501])에서 발생하는 오류를 보고하기 위한 표준화된 C++ 예외 역할을 합니다. 이는 ara::core::Exception로부터 상속받으며, 예외 안전한 noexcept 생성자를 통해 인스턴스화 시 전달되는 특정 ara::core::ErrorCode을 캡슐화합니다([SWS_CM_12502]). 컴파일러 툴체인에서 C++ 예외가 비활성화된 경우, 사양에 따라 예외를 발생시키는 함수는 오버로드 확인에 참여하지 않으므로, 이 오류 경로는 활성화된 예외 지원을 전제 조건으로 합니다.

자세히 ›

컨텍스트

클래스 ara::com::e2e::ComE2EException은 발생한 오류 조건을 알리기 위해 통신 관리의 End-to-End API(E2E)에 의해 트리거되는 표준화된 C++ 예외 클래스 역할을 합니다([SWS_CM_12501], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). 이 클래스는 final으로 선언되어 있으며 기본 클래스 ara::core::Exception로부터 공개 상속받습니다(AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). 헤더 파일 ara/com/e2e/e2e_error_domain.h을 통해 제공됩니다([SWS_CM_12502]).

AUTOSAR Adaptive의 기능 아키텍처 내에서 ComE2EException은 플랫폼의 E2E 모니터링 루틴과 호출 애플리케이션 소프트웨어 간의 통신 브리지 역할을 합니다. 데이터 검증 또는 처리 중에 E2E 함수가 오류 상태를 감지하면, 이 예외를 던져 상위 제어 흐름에 이 오류를 전달합니다(AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”).

수명 주기

ComE2EException 객체의 인스턴스화는 생성자 explicit ComE2EException(ara::core::ErrorCode errorCode) noexcept에 오류 코드를 전달함으로써 명시적으로 수행됩니다([SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4.1.1.1 “ComE2EException”). 생성자는 noexcept 및 예외 안전(exception safe)으로 명시되어 있습니다([SWS_CM_12502]). 이를 통해 예외 자체를 생성하는 동안 추가 예외가 발생할 수 없음이 보장되어 오류 경로의 견고성이 확보됩니다.

소유권 관계 측면에서 예외는 이를 트리거하는 E2E 인터페이스에 의해 생성되며 값으로 던져집니다(AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”). 애플리케이션 측면에서는 일반적으로 이 객체를 상수 참조로 포착합니다. 해당 처리 블록을 벗어나는 즉시 일반적인 C++ 스택 해제 과정에서 자동으로 소멸됩니다. 이 클래스는 final(으)로 정의되어 있으므로 서브클래스는 제공되지 않습니다.

사용 경로

예외 사용 시 일반적인 흐름은 다음 단계로 구성됩니다:

• 애플리케이션 소프트웨어가 통신 관리의 E2E 보호 기능을 호출합니다.
• E2E 로직이 데이터 처리 또는 검사 중에 오류를 감지하고, 특정 errorCode을(를) 사용하여 ara::com::e2e::ComE2EException의 인스턴스를 생성한 후 이를 던집니다(AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”).
• 애플리케이션이 try-catch 블록에서 예외를 포착합니다. 이때 호출자는 오류 진단을 위해 포함된 ara::core::ErrorCode을(를) 평가하고자 ara::core::Exception의 상속된 기본 메서드에 접근할 것으로 보입니다(해석). 질문 Q-8dfac2428f223afe (열림)

시퀀스 다이어그램: ComE2EException을 통한 E2E 오류 발생 시 오류 처리 흐름. 출처: [SWS_CM_12501], [SWS_CM_12502], AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”.

오류 시나리오

ComE2EException의 사용에는 툴체인과 관련하여 중요한 전제 조건이 적용됩니다. [SWS_CORE_10304]에 따르면, 컴파일러에서 C++ 예외가 비활성화된 경우(AUTOSAR_AP_SWS_CommunicationManagement §8.15.4 “Class: ComE2EException”) 인스턴스를 생성하고 던지는 함수는 오버로드 확인(overload resolution)에 참여하지 않습니다. 따라서 C++ 예외 지원이 없는 런타임 환경에서는 이 신호 전달 경로가 존재하지 않으며, 이 경우 오류는 플랫폼의 대체 비예외 기반 오류 메커니즘을 통해 전달될 것으로 보입니다(해석). 질문 Q-e1b3f4f1dfc191ef (열림)

예외가 활성화되어 있는 경우, 모든 ComE2EException은(는) 의무적으로 오류 코드를 전달합니다([SWS_CM_12502]). 인스턴스화의 사전 조건으로 유효한 ara::core::ErrorCode이(가) 준비되어 있어야 합니다([SWS_CM_12502]). 생성자가 예외 안전(exception-safe)으로 선언되어 있으므로([SWS_CM_12502]), 오류 상황에서도 객체 생성 자체가 실패할 수는 없습니다.