класс ara::core::CoreErrorDomain

Класс ara::core::CoreErrorDomain представляет домен ошибок для ошибок из функционального кластера ara::core и сопоставляет числовым кодам ошибок описательные текстовые сообщения [SWS_CORE_05243]. Кроме того, с помощью ThrowAsException() он позволяет преобразовывать коды ошибок в типизированные исключения CoreException [SWS_CORE_05244]. Поскольку все методы запроса потокобезопасны и могут конструироваться как constexpr, данный домен подходит для эффективного использования в масштабах всего кластера. Если исключения C++ отключены в тулчейне, метод генерации исключений не участвует в разрешении перегрузки.

больше ›

Контекст

Класс ara::core::CoreErrorDomain представляет собой специализированный домен ошибок для всех состояний ошибок, возникающих в функциональном кластере ara::core. Он определен как финальная специализация ErrorDomain, что предотвращает дальнейшее наследование. Класс предоставляет уникальное короткое имя домена с помощью метода Name() [SWS_CORE_05242]. Для согласованной интеграции в модель обработки ошибок AUTOSAR CoreErrorDomain определяет ключевые псевдонимы типов: Errc напрямую указывает на перечисление CoreErrc [SWS_CORE_05231], тогда как Exception служит псевдонимом для соответствующего базового класса исключений CoreException [SWS_CORE_05232]. К числу основных взаимодействующих компонентов относятся универсальные оболочки ошибок типа ErrorCode, хранящие ссылку на соответствующий домен ошибок, а также исполняемые компоненты, выполняющие диагностику или обработку ошибочных состояний.

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

Создание CoreErrorDomain выполняется через конструктор по умолчанию без параметров constexpr CoreErrorDomain() noexcept [SWS_CORE_05241]. Поскольку конструктор объявлен как constexpr и noexcept, экземпляр может быть создан уже на этапе компиляции без затрат на выделение памяти и без риска возникновения исключений.

Интерпретация: поскольку домены ошибок в стандарте AUTOSAR Adaptive спроектированы без сохранения состояния и предоставляют исключительно неизменяемые метаданные и логику преобразования, в системе обычно существует глобальный или статический экземпляр-одиночка (singleton), к которому осуществляется доступ на уровне всего кластера. Вопрос Q-7b4761bf124c5755 (открытый) Экземпляр сохраняет валидность на протяжении всего времени работы процесса. С точки зрения конкурентности операции класса специфицированы как потокобезопасные [SWS_CORE_05241], [SWS_CORE_05242], [SWS_CORE_05243], что допускает одновременные запросы из нескольких параллельных потоков без дополнительных мер синхронизации.

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

Во время штатной работы среда выполнения или код приложения обращаются к CoreErrorDomain главным образом в двух типичных сценариях: для текстовой инспекции ошибок и для обработки исключений.

При возникновении ошибки связанное текстовое сообщение можно запросить через функцию-член Message(), передав числовой код ошибки [SWS_CORE_05243]. Спецификация строго гарантирует, что эта функция никогда не возвращает нулевой указатель (nullptr), поэтому возвращаемый const char* можно безопасно использовать для диагностического вывода или журналирования. Если ошибку требуется передать не как возвращаемое значение, а в виде C++-исключения, для этого служит метод ThrowAsException() [SWS_CORE_05244]. Он принимает экземпляр ErrorCode, инстанцирует соответствующее CoreException и выбрасывает его в текущий стек вызовов.

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

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

Функции Name() и Message(), а также конструктор объявлены как noexcept и классифицированы как безопасные относительно исключений [SWS_CORE_05241], [SWS_CORE_05242], [SWS_CORE_05243]. Они не генерируют исключений даже в условиях ошибок и не создают собственных кодов ошибок.

В противоположность этому метод ThrowAsException() явно помечен спецификатором noexcept(false) и обозначен как небезопасный относительно исключений, поскольку детерминированный выброс исключения (типа CoreException) является основной задачей данного интерфейса [SWS_CORE_05244]. Ключевым архитектурным предусловием является следующее: если в используемом тулчейне или настройках компилятора отключены C++-исключения, эта функция не должна участвовать в разрешении перегрузки [SWS_CORE_05244]. Это предотвращает ошибки компиляции в системных окружениях, придерживающихся отказоустойчивого встроенного подхода без обработки исключений C++.