클래스 ara::fw::FwErrorDomain

타입 별칭 Errc은(는) [AP_SWS_Fw_83007]에 따라 오류 코드 열거형 FwErrc의 별칭으로 정의됩니다(using Errc = FwErrc;). 이 요소는 클래스 ara::fw::FwErrorDomain의 범위에서 선언되며 헤더 파일 ara/fw/fw_error_domain.h을(를) 통해 포함되어야 합니다 [AP_SWS_Fw_83007].

사용과 관련하여 Errc은(는) 실행 가능한 함수 호출을 나타내지 않으므로 매개변수, 반환값, 동기 또는 비동기 시맨틱을 갖지 않습니다 [AP_SWS_Fw_83007]. 오히려 도메인별 오류 원인의 열거를 위한 통일된 식별자를 제공합니다. 해석: 이 별칭은 개발자에게 오류 상태를 유형화하고 질의할 수 있도록 ara::fw::FwErrorDomain 내에서 FwErrc의 열거형 값에 대한 단순화되고 일관된 접근을 제공할 것으로 보입니다 [AP_SWS_Fw_83007]. 질문 Q-bd8949830961e459 (열림)

순수한 컴파일 타임 구문이므로 재진입성, 스레드 안전성 또는 호출 순서와 관련된 런타임 제약 조건은 존재하지 않습니다 [AP_SWS_Fw_83007]. 특정 오류 값이나 DET 또는 DEM 메시지와의 연결은 명세 요소에 지정되어 있지 않으며 기반 열거형의 값에 따릅니다 [AP_SWS_Fw_83007].

기본 생성자 FwErrorDomain()은(는) 삭제된 것으로 선언되어 있습니다 ([AP_SWS_Fw_83009]). 따라서 애플리케이션 코드에서 이 생성자를 통한 ara::fw::FwErrorDomain 클래스 객체의 직접 인스턴스화는 제외됩니다. Interpretation: 삭제 선언을 통해 오류 도메인이 싱글톤으로만 관리되도록 보장하는 것으로 추정됩니다. 질문 Q-54f7bc341f074e2c (열림)

오류 도메인을 사용하기 위해 자유 함수 GetFwErrorDomain()을(를) 사용할 수 있습니다 ([AP_SWS_Fw_83002]). 이는 ara::core::ErrorDomain 유형의 기존 도메인 객체에 대한 참조를 스레드 안전(thread-safe)하게 반환합니다. 이 참조를 통해 도메인의 인터페이스를 사용할 수 있습니다:

• Name()을(를) 통한 오류 도메인 이름 조회 ([AP_SWS_Fw_83010]).
• Message()을(를) 사용한 오류 코드 설명 텍스트 확인 ([AP_SWS_Fw_83011]).
• ThrowAsException()을(를) 통한 예외 트리거 ([AP_SWS_Fw_83012]), 여기서 별칭 Exception은(는) FwException을(를) 가리킵니다 ([AP_SWS_Fw_83008]).

관련 오류 코드는 열거형 FwErrc에 의해 정의되며 ([AP_SWS_Fw_83001]), 이는 클래스 내에서 별칭 Errc을(를) 통해서도 제공됩니다 ([AP_SWS_Fw_83007]). 유효한 값은 kServiceNotAvailable 및 kInvalidStateDependentFirewall입니다. 따라서 개발자는 자체 인스턴스를 생성하지 말고 항상 글로벌 참조를 사용해야 합니다.

사용법 및 의미론

클래스 ara::fw::FwErrorDomain의 멤버 함수 Name은(는) 오류 도메인의 식별자를 조회하는 데 사용됩니다 [AP_SWS_Fw_83010]. 호출은 동기식으로 수행되며 헤더 파일 ara/fw/fw_error_domain.h의 포함이 필요합니다 [AP_SWS_Fw_83010]. 이 함수는 전달 매개변수를 받지 않으며 도메인의 이름을 나타내는 const char * 타입의 포인터를 반환합니다 [AP_SWS_Fw_83010]. 반환값은 널로 끝나는 문자열이며, 그 유효성은 오류 도메인의 수명에 묶여 있을 것으로 보입니다. 질문 Q-6bd465d82e79a682 (열림)

오류 처리

이 메서드는 식별자 noexcept(으)로 선언되어 있습니다 [AP_SWS_Fw_83010]. 따라서 예외를 발생시키지 않으며 특정 오류 코드나 오류 반환값을 제공하지 않습니다 [AP_SWS_Fw_83010].

동시성 및 제약사항

명세에 따르면 이 함수는 스레드 안전(thread-safe)으로 분류됩니다 [AP_SWS_Fw_83010]. 상수 멤버 함수(const)이므로 접근 시 인스턴스의 상태를 변경하지 않으며, 서로 다른 실행 컨텍스트로부터 안전하게 병행 호출될 수 있습니다 [AP_SWS_Fw_83010]. 명세에 따른 특별한 사전 조건이나 순서 요구 사항은 없습니다 [AP_SWS_Fw_83010].

사용

클래스 ara::fw::FwErrorDomain의 멤버 함수 Message은(는) 헤더 파일 ara/fw/fw_error_domain.h을(를) 통해 선언되며 오류 메시지를 동기식으로 검색하는 데 사용됩니다 [AP_SWS_Fw_83011]. 호출 시 호출자는 CodeType 타입의 오류 코드 errorCode을(를) 전달합니다. 반환값으로 이 함수는 오류 코드에 할당된 문자열에 대한 const char * 타입의 포인터를 반환합니다 [AP_SWS_Fw_83011]. 이 함수는 override로서 기본 클래스 [AP_SWS_Fw_83011]의 해당 인터페이스를 오버라이드합니다.

동시성 및 스레드 안전성

명세는 Message을(를) 명시적으로 thread-safe로 정의합니다 [AP_SWS_Fw_83011]. 따라서 호출자는 추가적인 동기화 조치 없이 동일한 인스턴스에 대해 서로 다른 스레드에서 병렬로 이 메서드를 호출할 수 있습니다. const 메서드로 한정됨에 따라 호출 시 오류 도메인의 상태가 변경되지 않습니다 [AP_SWS_Fw_83011].

오류 처리 및 제약 조건

noexcept(으)로의 선언으로 인해 이 메서드는 C++ 예외가 발생하지 않음을 보장합니다 [AP_SWS_Fw_83011]. 확인할 수 없는 코드에 대한 특정 오류 코드나 오류 값은 요소에 정의되어 있지 않습니다 [AP_SWS_Fw_83011]. 반환된 포인터는 아마도 변경 불가능하고 정적으로 할당된 문자열을 가리킬 것으로 보이며, 이에 따라 호출자에게 메모리 관리 의무는 없습니다. 질문 Q-2e98884ffd517367 (열림)

클래스 ara::fw::FwErrorDomain의 멤버 함수 ThrowAsException은(는) 전달된 오류 코드 errorCode로부터 FwException을(를) 인스턴스화하고 발생시키는 데 사용됩니다 [AP_SWS_Fw_83012]. 이 함수는 헤더 파일 ara/fw/fw_error_domain.h을(를) 통해 포함되며 유일한 매개변수로 ara::core::ErrorCode에 대한 상수 참조를 받습니다 [AP_SWS_Fw_83012]. 반환값이 없으며(void), const 및 override(으)로 선언되어 있습니다 [AP_SWS_Fw_83012].

명세 조항 noexcept(false)에 의해 메서드 호출 시 예외가 발생할 수 있음이 명시적으로 정의되어 있습니다. 이 함수는 해당 오류 사례에 대해 FwException을(를) 결정론적으로 생성하고 던집니다 [AP_SWS_Fw_83012]. 예외 안전성과 관련하여 이 메서드는 not exception safe로 분류됩니다 [AP_SWS_Fw_83012]. 따라서 호출하는 코드는 결과적인 예외가 정규 제어 흐름을 중단한다는 점에 대비해야 하며 예외 처리를 위한 적절한 조치를 필요로 합니다.

동시성과 관련하여 이 메서드는 thread-safe로 명시되어 있어 여러 스레드에서의 동시 호출이 허용됩니다 [AP_SWS_Fw_83012]. 키워드 override을(를) 통해 이 메서드는 아마도 상위 오류 도메인의 동일한 이름의 인터페이스 함수를 오버라이드할 것으로 보입니다 [AP_SWS_Fw_83012]. 질문 Q-aae02c046243335c (열림)