클래스 ara::com::e2e::ComE2EErrorDomain

클래스 ara::com::e2e::ComE2EErrorDomain은(는) AUTOSAR Adaptive의 통신 관리에서 E2E 보호 오류에 대한 오류 도메인을 정의하고 오류 코드를 열거형 ComE2EErrc에 매핑합니다([SWS_CM_12504]). 서버 측 E2E 검증이 실패하면 이 도메인의 ara::core::ErrorCode이(가) 오류 응답에 실려 전송되고 클라이언트 측에서 ara::core::Result을(를) 통해 제공됩니다([SWS_CM_00033]). 상태 비보존형의 예외 안전 클래스는 값 기반 또는 ThrowAsException()을(를) 통한 오류 처리를 선택적으로 허용하지만, 이 예외 메서드는 C++ 컴파일러 예외가 비활성화된 경우 사용할 수 없습니다([SWS_CM_12509]).

자세히 ›

컨텍스트

클래스 ara::com::e2e::ComE2EErrorDomain은(는) AUTOSAR Adaptive Platform의 통신 관리(ara::com) 내에서 E2E 보호를 위한 오류 도메인을 정의합니다. 이 클래스는 기본 클래스 ara::core::ErrorDomain에서 final로 파생되며 메시지의 E2E 유효성 검사 중에 발생하는 도메인별 오류를 캡슐화합니다.

통신 모델에서 ComE2EErrorDomain은(는) E2E 보호 상호작용 시 오류 상태에 대한 중앙 식별자 및 변환기 역할을 합니다. 타입 별칭 Errc([SWS_CM_12504]) 및 Exception([SWS_CM_12505])을(를) 통해 오류 도메인은 타입별 열거형 ComE2EErrc 및 파생된 예외 유형 ComE2EException을(를) ara::core의 오류 관련 생태계에 바인딩합니다. 서버 런타임 환경이 E2E_check([SWS_CM_90421])을(를) 사용하여 메서드 요청을 검사할 때 보호 오류를 감지하면, E2E 오류 응답이 전송됩니다. [SWS_CM_00033]에 따르면 이 응답 메시지의 페이로드는 ara::com::e2e::ComE2EErrorDomain 도메인의 ara::core::ErrorCode을(를) 전달하며, 해당 오류 값은 E2E_check의 결과에 해당합니다(AUTOSAR_AP_SWS_CommunicationManagement §7.4.1.2.4 “Payload of the E2E Error Response”). 클라이언트 측에서는 E2E 헤더를 제거한 후([SWS_CM_90475]) 이 오류가 역직렬화되어([SWS_CM_90476], [SWS_CM_10473]) ara::core::Result 내의 오류 상태로서 애플리케이션에 전달됩니다(AUTOSAR_AP_SWS_CommunicationManagement §7.4.1.2.5 “Deserializing the payload”).

컨텍스트 다이어그램: ara::core 및 ara::com의 타입 시스템에 ComE2EErrorDomain 포함. 출처: [SWS_CM_12504], [SWS_CM_12505], [SWS_CM_12506], [SWS_CM_00033].

수명 주기

인스턴스 객체의 생성은 기본 생성자 constexpr ComE2EErrorDomain() noexcept([SWS_CM_12506])을 통해 이루어집니다. constexpr로 지정되어 있으므로 오류 도메인은 이미 컴파일 타임에 생성될 수 있습니다. 이는 일반적으로 변경 불가능한 프로세스 전역 싱글톤으로 제공될 수 있으므로, 도메인에 대한 참조는 전체 프로그램 실행 시간 동안 유효하게 유지됩니다. 질문 Q-bd1ba0230650e246 (열림) 클래스가 final로 선언되어 있으므로 추가적인 파생은 허용되지 않습니다.

이 클래스는 가변 상태를 관리하지 않으며 완전한 예외 안전성([SWS_CM_12506])을 제공합니다. 검사 메서드 Name()([SWS_CM_12507]) 및 Message()([SWS_CM_12508])은 const 및 noexcept로 선언되어 있습니다. 이로써 여러 실행 스레드에 걸친 동시 읽기 접근이 스레드 안전하며 동기화 오버헤드 없이 보장됩니다.

사용 경로

전형적인 사용 경로는 실패한 E2E 검사의 전송 및 클라이언트 측 평가 프레임워크 내에서 이루어집니다:

1. 검사 및 오류 생성: E2E 보호된 요청을 수신하면 서버는 E2E_check을 사용하여 유효성 검사를 수행합니다([SWS_CM_90421]). 이 검사가 실패하면 미들웨어는 페이로드에 ara::com::e2e::ComE2EErrorDomain이 포함된 ara::core::ErrorCode를 담은 오류 응답을 직렬화합니다([SWS_CM_00033]).
2. 전송 및 역직렬화: 클라이언트 측에서는 프로토콜 처리 및 보호 헤더 제거([SWS_CM_90475]) 후 페이로드가 역직렬화됩니다([SWS_CM_90476]). 통신 프레임워크는 전송된 오류 코드를 캡슐화하는 ara::core::Result로 결과를 제공합니다([SWS_CM_10473], AUTOSAR_AP_SWS_CommunicationManagement §7.4.1.2.5 “Deserializing the payload”).
3. 오류 진단: Adaptive Application은 ara::core::Result을 검사합니다. 오류 로깅을 위해 Name()은 도메인의 식별자를 반환하고([SWS_CM_12507]), Message()은 구체적인 숫자 코드에 대한 사람이 읽을 수 있는 텍스트를 반환합니다([SWS_CM_12508]).
4. 오류 처리: 애플리케이션은 오류를 값 기반으로 평가하거나 예외 처리가 활성화된 경우 ThrowAsException()을 통해 타입별 예외를 발생시킬 수 있습니다([SWS_CM_12509]).

시퀀스 다이어그램: 메서드 호출 시 E2E 오류의 전송 및 처리. 출처: [SWS_CM_00033], [SWS_CM_90421], [SWS_CM_90475], [SWS_CM_90476], [SWS_CM_10473], [SWS_CM_12509].

오류 시나리오

유효성 검사 중 E2E 오류가 발생하면, 클래스의 타입 별칭 Errc을 통해 사용할 수 있는 열거형 ComE2EErrc을 통해 식별됩니다([SWS_CM_12504]). 이때 ComE2EErrc의 오류 코드는 E2E_check의 정의된 결과 값에 직접 대응할 것으로 보입니다. 질문 Q-07fc2c01567ac537 (열림)

C++ 예외를 통해 오류를 전달하기 위해 메서드 ThrowAsException()은 ara::com::e2e::ComE2EException 타입(별칭 Exception, [SWS_CM_12505])의 예외를 인스턴스화하고 이를 던집니다([SWS_CM_12509]). 이 메서드는 noexcept(false)로 선언되어 있습니다. 컴파일러 툴체인에서 C++ 예외가 비활성화된 경우, ThrowAsException()은 [SWS_CM_12509]에 따라 오버로드 확인에 참여하지 않습니다. 따라서 예외 지원이 없는 시스템에서는 오류 처리가 반드시 ara::core::Result 및 ara::core::ErrorCode의 값 기반 검사를 통해 이루어져야 합니다.