클래스 ara::rds::RdsException

클래스 ara::rds::RdsException은(는) Raw Data Stream 모듈을 위한 특화된 예외 타입을 나타내며, ara::core::ErrorCode을(를) 기반으로 오류를 전달하는 역할을 합니다 [SWS_RDS_11292]. 인스턴스화는 일반적으로 ThrowAsException에 의한 오류 처리의 일환으로 수행되며, 이를 통해 오류가 발생한 실행 흐름의 구조적 중단이 트리거됩니다 [SWS_RDS_11297]. noexcept(으)로 선언된 생성자를 통해 예외 생성 시 런타임 시스템에서 후속 오류가 발생하지 않도록 보장됩니다. 호출하는 애플리케이션 코드는 프로그램 중단을 방지하기 위해 이 예외를 catch해야 합니다.

자세히 ›

컨텍스트

클래스 ara::rds::RdsException은(는) SWS RawDataStream §1 “Raw Data Stream”에 명시된 바와 같이 AUTOSAR Adaptive 컨텍스트에서 Raw Data Stream(rds)을 위한 전용 예외 타입으로 기능합니다. 이 클래스는 범용 기본 클래스 ara::core::Exception에서 직접 파생되며 모듈의 오류 모델을 플랫폼의 예외 처리에 매끄럽게 통합합니다. RDS 네임스페이스 내에서 이 타입은 타입 별칭 Exception을(를) 통해 제공되며 [SWS_RDS_11327], 이를 통해 사용자와 모듈 구성요소는 통일되고 단순화된 명명 체계를 사용할 수 있습니다. 주요 상호작용 대상으로는 ara/rds/rds_error_domain.h에 선언된 도메인과 같은 오류 도메인 및 예외를 통해 오류를 처리하는 애플리케이션 코드가 있습니다 [SWS_RDS_11292].

수명 주기

ara::rds::RdsException의 인스턴스는 발생한 오류 이벤트로 인해 정규 제어 흐름의 중단이 불가피할 때 필요에 따라 생성됩니다. 인스턴스화는 ara::core::ErrorCode 객체를 전달받는 명시적 생성자를 통해 수행됩니다 [SWS_RDS_11292]. 이 생성자는 noexcept(으)로 선언되어 있어, 어떠한 상황에서도 객체 생성 자체가 실패하거나 또 다른 예외를 발생시키지 않도록 보장합니다. 이 예외 객체는 일반적인 C++ 값 시맨틱을 따르며, throw될 때 런타임 환경의 예외 메모리로 전달됩니다. ara::core의 예외 타입에서 일반적이듯, 소멸 시점은 예외 객체에 대한 참조가 만료되어 해당 catch 블록을 벗어나는 시점과 연결되어 있을 것으로 보입니다. 질문 Q-5673ede6a9688b85 (열림) 동시 실행 환경에서는 각 예외 상황이 스레드-로컬 수준에서 격리되어 인스턴스화되고 전파되므로 이 클래스는 스레드 안전하게 동작합니다.

사용 경로

일반적인 사용 경로는 스트림 동작 중 오류 상태 감지, 오류 코드를 예외로 변환, 그리고 애플리케이션 코드에서의 후속 catch를 포함합니다. 작업 중 오류가 발생하면 이는 기본적으로 ara::core::ErrorCode(으)로 표현됩니다. 수동 질의 대신 변환 및 발생 과정을 캡슐화하는 ThrowAsException 메서드를 통해 예외 발생을 개시할 수 있습니다 [SWS_RDS_11297]. 해석: ThrowAsException 호출은 내부적으로 RdsException의 생성자에 직접 위임한 후 throw을(를) 사용하여 새로 생성된 인스턴스를 throw할 것으로 추정됩니다 [SWS_RDS_11292]. 질문 Q-d8734426a5c71e07 (열림) 호출 코드는 구체적 타입 ara::rds::RdsException, 별칭 ara::rds::Exception [SWS_RDS_11327]을(를) 통해, 또는 ara::core::Exception을(를) 통해 다형적으로 예외를 catch합니다.

시퀀스 다이어그램: ErrorCode를 통한 RDS 예외 발생 및 catch 시의 상호작용. 출처: [SWS_RDS_11292], [SWS_RDS_11297].

오류 시나리오

ara::rds::RdsException과(와) 관련된 오류 시나리오는 주로 오류 전파의 일관성 및 처리되지 않은 프로그램 중단의 방지와 관련이 있습니다. 예외를 throw하는 것이 오류 발생 시 의도된 동작이므로, 트리거 작업 ThrowAsException은(는) 명시적으로 noexcept(false)(으)로 정의됩니다 [SWS_RDS_11297]. 호출 코드가 잠재적인 제어 흐름 중단을 무시하고 적절한 예외 핸들러를 제공하지 않을 때 치명적인 오류 시나리오가 발생하며, 불완전한 처리는 std::terminate을(를) 통한 즉각적인 프로세스 중단으로 이어집니다. 그러나 생성자 [SWS_RDS_11292]의 noexcept 보장을 통해 예외 자체를 제공할 때 중첩된 초기화 오류가 발생할 수 없음이 보장됩니다.