класс ara::shwa::ShwaErrorDomain

Класс ara::shwa::ShwaErrorDomain предоставляет специфический для модуля домен ошибок для модуля shwa и связывает коды ошибок с описаниями, а также соответствующими типами исключений [AP_SWS_SHWA_01305]. Наряду с текстовым запросом имён доменов и сообщений об ошибках он через ThrowAsException() предоставляет возможность целенаправленно генерировать ошибку в виде исключения [AP_SWS_SHWA_01310]. Методы инспекции объявлены как потокобезопасные и безопасные относительно исключений.

больше ›

Контекст

Класс ara::shwa::ShwaErrorDomain представляет специфический домен ошибок для модуля shwa на платформе Adaptive Platform и является производным от базового класса ara::core::ErrorDomain. Он выступает в качестве центрального связующего звена для однозначной идентификации, именования и текстового описания причин ошибок, специфичных для модуля. Как правило, домен ошибок тесно взаимодействует с экземплярами ara::core::ErrorCode, а также с соответствующей обработкой исключений через ShwaException. Через псевдонимы типов класс предоставляет прямое сопоставление со специфичными для модуля типами ошибок: Errc указывает на ShwaErrorCode [AP_SWS_SHWA_01305], а Exception — на ShwaException [AP_SWS_SHWA_01306].

Контекстная диаграмма: встраивание ShwaErrorDomain во взаимодействие с кодами ошибок, исключениями и логикой приложения. Источники: [AP_SWS_SHWA_01305], [AP_SWS_SHWA_01306], [AP_SWS_SHWA_01310]

Жизненный цикл

Создание экземпляра ShwaErrorDomain выполняется через стандартный конструктор ShwaErrorDomain(), который объявлен как noexcept и гарантирует как безопасность потоков (Thread Safety), так и безопасность относительно исключений (Exception Safety) [AP_SWS_SHWA_01307]. Являясь представителем домена ошибок в модели обработки ошибок AUTOSAR Adaptive, такой экземпляр обычно содержится как долгоживущий (интерпретация: вероятно, как статический или глобальный объект-синглтон) для повторяющегося сопоставления контекстов ошибок. Вопрос Q-82cb2e14793eeaef (открытый) За исключением генерации исключений, все методы чтения экземпляра являются потокобезопасными и не генерируют исключений.

Путь использования

При штатном процессе обработки компонент при возникновении ошибки, специфичной для модуля, создаёт ara::core::ErrorCode со ссылкой на домен ошибок. Для текстового вывода или протоколирования пользователь вызывает метод Name() для определения идентификатора домена ошибок [AP_SWS_SHWA_01308] или получает с помощью Message(errorCode) описание ошибки, соответствующее числовому коду [AP_SWS_SHWA_01309]. Если требуется передать код ошибки в ветвь исключений C++, вызывающая логика инициирует ThrowAsException() [AP_SWS_SHWA_01310].

Диаграмма последовательности: типичный процесс при запросе ошибок и преобразовании в исключение. Источники: [AP_SWS_SHWA_01308], [AP_SWS_SHWA_01309], [AP_SWS_SHWA_01310]

Сценарии ошибок

Домены ошибок сами служат для классификации ошибок и в своих функциях инспекции спроектированы в значительной степени отказоустойчивыми. Как Name() [AP_SWS_SHWA_01308], так и Message() [AP_SWS_SHWA_01309] специфицированы как noexcept и exception-safe, поэтому даже при неизвестных кодах ошибок возвращается определённый указатель на строку символов (интерпретация: вероятно, статический текст указания или заполнителя). Вопрос Q-03a63539b08ddb73 (открытый) Единственным сценарием с явной генерацией ошибки является метод ThrowAsException(errorCode) [AP_SWS_SHWA_01310]: он объявлен с noexcept(false) как «not exception safe», так как его основная цель заключается в целенаправленном выбрасывании исключения типа Exception (ShwaException) [AP_SWS_SHWA_01306].