클래스 ara::rds::RdsErrorDomain

오류 도메인 ara::rds::RdsErrorDomain은 AUTOSAR_AP_SWS_RawDataStream §1 “Raw Data Stream”에 따라 Raw Data Stream 모듈의 특정 오류 상태를 식별하고 분류합니다. 관련된 오류 메시지 텍스트를 제공하며 오류를 예외로 발생시키는 것을 지원합니다 [SWS_RDS_11296]. 기본 생성자가 삭제되었으므로 [SWS_RDS_11294], 애플리케이션은 자유 함수 GetRdsErrorDomain()을(를) 통해 중앙 인스턴스에 접근합니다 [SWS_RDS_11298].

자세히 ›

컨텍스트

클래스 ara::rds::RdsErrorDomain은 Adaptive Platform의 Raw Data Stream(RDS) 기능 클러스터를 위한 특정 오류 도메인을 나타냅니다 AUTOSAR_AP_SWS_RawDataStream §1 “Raw Data Stream”. 기본 클래스 ara::core::ErrorDomain의 특수화로서 스트림 관련 오류 상태를 AUTOSAR의 플랫폼 전반 오류 처리 모델에 통합합니다. 이 클래스의 주요 역할 중에는 메서드 Name()을 통한 고유 도메인 이름 제공 [SWS_RDS_11295] 및 Message()을 통한 오류 코드와 명확한 진단 메시지의 매핑 [SWS_RDS_11296]이 포함됩니다.

클라이언트 코드에서 일관된 처리를 위해 도메인은 표준화된 타입 별칭을 정의합니다. 별칭 Errc은 열거형 RdsErrc을(를) 참조하고 [SWS_RDS_11326], 타입 별칭 Exception은 예외 타입 RdsException에 바인딩됩니다 [SWS_RDS_11327]. 상호작용 주체는 주로 발생한 오류의 식별을 위해 오류 도메인을 사용하는 애플리케이션 컴포넌트, 스트리밍 엔드포인트 및 인프라 타입 ara::core::ErrorCode, ara::core::Result입니다.

수명 주기

ara::rds::RdsErrorDomain의 인스턴스는 엄격하게 제어된 수명 주기를 따릅니다. 기본 생성자가 삭제되었으므로(=delete) 클라이언트 코드에 의한 직접 인스턴스화는 명시적으로 차단됩니다 [SWS_RDS_11294]. 대신 도메인에 대한 상수 참조를 반환하는 전역 헬퍼 함수 GetRdsErrorDomain()을 통해 접근이 이루어집니다 [SWS_RDS_11298].

해석: 오류 도메인은 프로세스의 전체 실행 기간 동안 존재하는 장기 지속 싱글톤으로 구현되었을 것으로 추정됩니다. 질문 (열림) Name() [SWS_RDS_11295] 및 Message() [SWS_RDS_11296]과 같은 모든 쿼리 인터페이스가 const 및 noexcept(으)로 선언되어 있으므로, 동기화 오버헤드 없이 여러 스레드에 의한 스레드 안전한 동시 읽기 접근이 가능합니다.

사용 경로

일반적인 사용 경로는 Raw Data Stream의 작업이 실패하고 해당 오류 객체를 분석하거나 전파해야 할 때 발생합니다. 애플리케이션 또는 미들웨어 계층은 일반적으로 도메인에 바인딩된 오류 객체를 수신하거나 GetRdsErrorDomain()을(를) 통해 도메인을 직접 참조합니다 [SWS_RDS_11298]. 메서드 Message()을(를) 통해 런타임에 오류 코드의 관련 텍스트를 조회하고 로그 출력에 기록할 수 있습니다 [SWS_RDS_11296].

애플리케이션의 오류 처리 전략이 C++ 예외를 기반으로 하는 경우, 메서드 ThrowAsException()이(가) 호출됩니다 [SWS_RDS_11297]. 이는 전달된 ara::core::ErrorCode을(를) 타입 별칭 Exception을(를) 통해 지정된 RdsException 타입의 예외로 변환합니다 [SWS_RDS_11327].

시퀀스 다이어그램: Raw Data Stream 오류 도메인을 통한 오류 처리 및 예외 발생의 일반적인 흐름. 출처: [SWS_RDS_11296], [SWS_RDS_11297], [SWS_RDS_11298]

오류 시나리오

오류 도메인 자체의 컨텍스트에서는 일반적인 조회 중 예외가 발생하지 않습니다. 식별 및 현지화 메서드 Name() [SWS_RDS_11295] 및 Message() [SWS_RDS_11296]은 noexcept 지정을 통해 오류 없음을 보장합니다. 접근 함수 GetRdsErrorDomain() 역시 결코 실패하지 않습니다 [SWS_RDS_11298].

주요 오류 시나리오는 예외 처리와 관련됩니다. 호출자가 유효한 ara::core::ErrorCode과(와) 함께 ThrowAsException()을(를) 호출하면 메서드는 정상적으로 종료되지 않고 반드시 RdsException 타입의 예외(noexcept(false))를 발생시킵니다 [SWS_RDS_11297]. 이 호출을 위한 사전 조건은 도메인에서 일관된 오류 코드를 전달하는 것이며, 사후 조건은 해당 catch 블록에서 추가 처리를 위해 호출자 컨텍스트에서 예외가 발생하는 것입니다.