클래스 ara::com::ComErrorDomain

클래스 ara::com::ComErrorDomain은(는) ara::com API에서 인터페이스에 국한되지 않는 일반적인 오류를 식별하기 위한 통신 오류 도메인을 나타냅니다([SWS_CM_11265]). 이 클래스는 ComErrc::kCommunicationFailure과(와) 같은 오류 코드에 대한 오류 설명을 제공하며, Message()을(를) 통한 조회 또는 ThrowAsException()을(를) 사용한 예외로의 변환을 가능하게 합니다([SWS_CM_11332]). 기본 생성자가 삭제되었으므로, 오류를 포함하는 ara::core::Result을(를) 위한 상태 비보존형(stateless) 스레드 안전 도메인 인스턴스로 작동합니다.

자세히 ›

컨텍스트

클래스 ara::com::ComErrorDomain은(는) Communication Management 기능 클러스터를 위한 Adaptive Platform의 표준화된 통신 오류 도메인을 나타냅니다(SWS CommunicationManagement 439쪽). 이 클래스는 기본 클래스 ara::core::ErrorDomain에서 파생되며, 메서드 호출 또는 데이터 전송 중에 발생할 수 있지만 단일 ServiceInterface에 국한되지 않는 일반 오류의 시맨틱 컨텍스트를 정의합니다([SWS_CM_11265]). ara::com의 오류 아키텍처에서 이 클래스는 일반 통신 장애를 E2E 모니터링 오류 및 애플리케이션별 서비스 오류와 체계적으로 구분합니다(SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”).

주요 상호작용 파트너로는 Adaptive Application, 미들웨어의 서비스 및 프록시 구현, 그리고 기본 시스템의 데이터 유형 ara::core::ErrorCode 및 ara::core::Result이(가) 있습니다(EXP ARAComAPI §4.7 “Error Handling”). 시맨틱 타입 바인딩을 위해 클래스는 오류 코드 열거형 ComErrc을(를) 위한 타입 별칭 Errc([SWS_CM_11336])과 해당 예외 클래스 ComException을(를) 위한 Exception을(를) 제공합니다([SWS_CM_11337]).

컨텍스트 다이어그램: ara::com의 오류 아키텍처 내 ComErrorDomain의 분류. 출처: [SWS_CM_11265], EXP ARAComAPI §4.7 “Error Handling”, SWS CommunicationManagement §7.5.22.6 “Error Related Data Types”

수명 주기

오류 도메인을 위한 명세 클래스로서, ara::com::ComErrorDomain의 생성은 기본 생성자 ComErrorDomain() = delete;의 삭제를 통해 금지됩니다([SWS_CM_11330]). 해석: 애플리케이션 컴포넌트가 도메인을 동적으로 인스턴스화하거나 관리할 필요가 없도록, 도메인 인스턴스의 제공은 플랫폼을 통한 정적 싱글톤으로 이루어질 것으로 추정됩니다. 질문 Q-bf957a108c0a5378 (열림)

인스턴스는 가변 속성이 없는 상태 비보존형(stateless) 디스크립터로 작동합니다. Name()([SWS_CM_11331]) 및 Message()([SWS_CM_11332])와(과) 같이 제공되는 모든 메서드는 const noexcept(으)로 선언되어 있습니다. 이는 병렬 애플리케이션 및 미들웨어 스레드에 의한 동시 오류 쿼리 시 완벽한 스레드 안전성을 보장합니다.

사용 경로

일반적인 사용 경로는 ara::com의 인터페이스를 통한 오류의 감지, 전달 및 평가를 포함합니다:

1. 애플리케이션은 예를 들어 메서드 클래스 operator()의 호출 연산자를 통해 서비스 상호작용을 시작합니다([SWS_CM_00196]).
2. 처리 중 미들웨어가 통신 장애 또는 구성되지 않은 애플리케이션 오류([SWS_CM_00048])와 같은 오류 사례를 감지하면, 해당하는 Promise에서 연산 SetError이(가) 호출됩니다(SWS CommunicationManagement 300쪽).
3. 이때 도메인이 ara::com::ComErrorDomain(으)로 설정되고([SWS_CM_11329]) 숫자 코드가 ComErrc::kCommunicationFailure과(와) 같은 특정 열거형 값으로 설정된 ara::core::ErrorCode이(가) 생성됩니다([SWS_CM_10432]).
4. 애플리케이션에 반환된 ara::core::Future 또는 ara::core::Result은(는) 오류 상태의 오류 코드를 호출자에게 전달합니다(EXP ARAComAPI §4.7 “Error Handling”).
5. 애플리케이션은 Result을(를) 확인하고 도메인 함수 Name()([SWS_CM_11331]) 및 Message()([SWS_CM_11332])을(를) 사용하여 로깅 또는 진단을 위한 오류 메시지를 확인합니다.
6. 애플리케이션 로직이 예외를 예상하고 C++ 예외가 활성화된 경우, ThrowAsException()을(를) 사용하여 ComException(으)로의 변환을 트리거할 수 있습니다([SWS_CM_11333]).

시퀀스 다이어그램: ComErrorDomain을 통한 통신 오류의 신호 및 조회. 출처: [SWS_CM_00196], [SWS_CM_10432], [SWS_CM_11329], [SWS_CM_11332], SWS CommunicationManagement 300쪽

오류 시나리오

ara::com의 오류 개념은 복구 가능한 오류(Recoverable Errors)와 심각한 프로그래밍 위반(Violations 또는 Corruptions)을 엄격히 구분합니다(EXP ARAComAPI §4.7 “Error Handling”). 복구 가능한 오류는 ara::core::Result 및 ara::core::ErrorCode을(를) 통해 처리되며, 도메인 ComErrorDomain의 오류 코드는 식별자 별칭 Errc을(를) 통해 지정됩니다([SWS_CM_11336]).

예를 들어 원격 호출 중에 전송 중단이 발생하면 시스템은 ComErrc::kCommunicationFailure을(를) 보고합니다([SWS_CM_10432]). 구성되지 않은 애플리케이션 오류가 발생하면 미들웨어는 호출을 중단하고 마찬가지로 도메인의 해당 오류 코드를 설정합니다([SWS_CM_00048], SWS CommunicationManagement 300쪽).

오류 코드를 예외로 발생시켜야 하는 경우, ThrowAsException()은(는) ComException 유형의 예외를 인스턴스화하고([SWS_CM_11337]) 이를 발생시킵니다([SWS_CM_11333]). 이 메서드는 예외 안전하지 않으며(not exception safe), 명세에 따르면 C++ 예외가 비활성화된 경우 오버로드 확인에 참여하지 않습니다([SWS_CM_11333]). 반면, 복구할 수 없는 시스템 위반은 플랫폼 중단으로 직접 이어지며 ComErrorDomain을(를) 통해 처리되지 않습니다(EXP ARAComAPI §4.7 “Error Handling”).