클래스 ara::crypto::CryptoException

클래스 ara::crypto::CryptoException은 AUTOSAR Adaptive Platform에서 호출 애플리케이션에 암호화 오류를 알리기 위한 특수 예외로 기능합니다. 이는 ara::core::Exception에서 파생되며, 작업 실패 시 ara::core::ErrorCode를 사용하여 명시적으로 인스턴스화됩니다[SWS_CRYPT_19906]. noexcept 및 스레드 안전으로 지정되어 동시성 환경에서도 후속 오류 없이 신뢰할 수 있는 예외 생성이 보장됩니다[SWS_CRYPT_19906]. 애플리케이션은 처리되지 않은 예외 및 프로그램 중단을 방지하기 위해 암호화 호출을 적절히 보호해야 합니다.

자세히 ›

컨텍스트

클래스 ara::crypto::CryptoException은 AUTOSAR Adaptive Platform의 암호화 모듈 내에서 오류 상태를 위한 핵심 예외 유형을 정의합니다. 표준 예외 클래스 ara::core::Exception의 특수화로서, 플랫폼에서 주로 사용되는 오류 코드 기반 반환과 전통적인 C++ 예외 처리 메커니즘 사이의 가교 역할을 합니다. 이 클래스는 암호화 작업이 실패하고 이 오류 상태를 호출 스택을 통해 예외로 전파해야 하는 시스템 아키텍처에서 사용됩니다. 주요 상호작용 대상에는 예기치 않은 오류나 명시적 검사 시 예외를 발생시키는 암호화 기능 모듈 및 서비스와, 암호화, 서명 검증 또는 키 관리와 같은 암호화 프로세스를 시작하고 잠재적 오류를 가로채는 상위 애플리케이션 컴포넌트가 포함됩니다. 플랫폼의 공통 오류 도메인 개념에 기반을 둠으로써 ara::crypto::CryptoException는 암호화 오류가 애플리케이션 로직에 일관되고 형식화된 방식으로 보고되도록 보장합니다.

수명 주기

ara::crypto::CryptoException의 객체 생성은 생성자 [SWS_CRYPT_19906]에 ara::core::ErrorCode 유형의 오류 코드를 전달하여 결정론적으로 수행됩니다. 이 생성자는 오류 코드로부터의 암시적 유형 변환을 차단하기 위해 explicit으로 선언되어 있으며, noexcept 규격을 갖습니다[SWS_CRYPT_19906]. 후자는 예외 자체의 생성 중에 추가 예외가 발생할 수 없음을 보장하여 암호화 하위 시스템의 예외 및 작동 안전성을 크게 향상시킵니다. 규격에 따라 구현은 스레드 안전(thread-safe)으로 분류되므로[SWS_CRYPT_19906], 인스턴스는 동시 실행 환경에서도 안정적으로 인스턴스화되고 처리될 수 있습니다. 소유권 관계와 관련하여 예외는 일반적으로 값(by-value)으로 throw되고 포착 블록에서 상수 참조로 바인딩됩니다. 클래스는 오류 코드 외에 동적 리소스를 관리하지 않으므로 해당 수명주기는 처리하는 catch 블록을 벗어남으로써 정상적으로 종료됩니다(해석). 질문 (열림)

사용 경로

정규 사용 경로는 로컬에서 해결할 수 없는 오류 조건이 발생할 때 암호화 작업 내에서 시작됩니다. 모듈은 헤더 파일 ara/crypto/common/crypto_error_domain.h의 암호화 오류 도메인을 기반으로 오류 원인을 식별하고 해당 ara::core::ErrorCode을 생성합니다[SWS_CRYPT_19906]. 이어서 이 오류 코드를 사용하여 ara::crypto::CryptoException의 인스턴스가 인스턴스화되고[SWS_CRYPT_19906] throw 문을 통해 신호가 전달됩니다. 애플리케이션 측에서는 호출 컴포넌트가 catch (const ara::crypto::CryptoException& e)을 통해 예외를 타겟팅하여 포착합니다. 대안으로 상속 계층 구조를 통해 제네릭 ara::core::Exception로 다형적으로 포착할 수도 있습니다. 포함된 ara::core::ErrorCode을 조회하여 애플리케이션은 이후 구체적인 암호화 오류 원인을 분석하고 적절한 대응 조치를 취할 수 있습니다.

시퀀스 다이어그램: 암호화 작업 시 오류 처리 및 예외 발생의 일반적인 흐름. 출처: [SWS_CRYPT_19906]

오류 시나리오

ara::crypto::CryptoException 자체가 오류 신호 전달의 수단이므로 오류 시나리오에서 주요 초점은 예외 생성의 견고성에 있습니다. 예외 및 스레드 안전성에 대한 보증과 생성자의 noexcept 보장을 통해 이미 활성화된 오류 처리 중에 2차 예외가 발생하는 것을 방지합니다[SWS_CRYPT_19906]. 애플리케이션 로직에서 발생할 수 있는 오류 시나리오는 전달된 ara::core::ErrorCode이 예기치 않거나 암호화가 아닌 오류 도메인을 캡슐화하는 경우입니다. 아마도 이 Exception은 오류 코드를 중립적으로 처리하고 처리기에 변경 없이 전달할 것으로 보입니다(해석). 시스템 수준에서의 또 다른 위험은 예외 포착의 누락이며, 이는 C++ 런타임 환경에서 std::terminate의 호출로 이어집니다. 따라서 오류 코드 기반 반환이 없는 API를 사용하는 호출 컴포넌트는 해당 catch 블록을 사용하여 암호화 호출을 일관되게 보호해야 합니다. 질문 Q-0bb3376f547ce024 (열림)