класс ara::nm::NmErrorDomain

Домен ошибок ara::nm::NmErrorDomain инкапсулирует обработку ошибок Network Management в AUTOSAR Adaptive Platform и подключает коды ошибок NmErrc, а также класс исключений NmException [SWS_ANM_01101]. К его основным задачам относятся предоставление понятных сообщений об ошибках через Message() и контролируемая генерация связанных исключений через ThrowAsException() [SWS_ANM_01108]. В качестве ключевого граничного условия инстанцирование и все функции-члены реализованы потокобезопасными (thread-safe), благодаря чему параллельный опрос ошибок защищен во всей системе.

больше ›

Контекст

Класс ara::nm::NmErrorDomain функционирует в AUTOSAR Adaptive Platform как специфичный для предметной области домен ошибок для подсистемы Network Management [SWS_ANM_01101]. Являясь финальной специализацией базового класса ara::core::ErrorDomain, он предоставляет стандартизированный каркас для идентификации, текстового описания и перенаправления ошибок, которые могут возникать во время работы функций Network Management [SWS_ANM_01101].

В рамках концепции обработки ошибок NM класс связывает конкретные причины ошибок с общими механизмами обработки ошибок среды выполнения. При этом класс определяет через псевдонимы типов прямое сопоставление с соответствующими типами: через псевдоним Errc он подключает базовое перечисление NmErrc, объявляющее специфичные коды ошибок для Network Management [SWS_ANM_01103]. Одновременно через псевдоним Exception он ссылается на специализированный класс исключений NmException, благодаря чему ошибки при необходимости могут передаваться в механизм исключений C++ [SWS_ANM_01104]. За счет такого объединения NmErrorDomain служит центральным связующим звеном между состояниями ошибок модуля и базовой системой обработки ошибок из ara::core.

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

Создание экземпляра ara::nm::NmErrorDomain выполняется через конструктор по умолчанию без параметров [SWS_ANM_01105]. Поскольку класс специфицирован как final, дальнейшее разделение или специализация производными доменами ошибок явно предотвращены [SWS_ANM_01101]. Конструктор объявлен с noexcept, что гарантирует инстанцирование домена ошибок без генерации исключений [SWS_ANM_01105].

Что касается отношений владения, экземпляр этого домена ошибок типично должен существовать в памяти как долгоживущий глобальный объект, чтобы быть постоянно доступным по ссылкам в объектах кодов ошибок. Вопрос Q-27fedf008cefcdc7 (открытый) Существенной особенностью жизненного цикла является поведение при параллелизме: как конструирование экземпляра [SWS_ANM_01105], так и все интерфейсные функции, такие как запрос имени [SWS_ANM_01106], формирование сообщения [SWS_ANM_01107] и генерация исключений [SWS_ANM_01108], спроектированы полностью потокобезопасными (thread-safe). Поскольку экземпляры NmErrorDomain не имеют изменяемого состояния, они могут использоваться параллельно из нескольких потоков без дополнительных мер синхронизации.

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

Штатный путь использования начинается, как только в Network Management требуется проанализировать, залогировать состояние ошибки или преобразовать его в исключение. Для этого домен ошибок предоставляет базовые функции идентификации и анализа.

Для общей идентификации домена может вызываться метод Name(), возвращающий имя домена в виде константного строкового указателя [SWS_ANM_01106]. Если приложению или базовой системе требуется определить текстовое значение возникшего кода ошибки, вызывается метод Message() с передачей кода ошибки [SWS_ANM_01107]. Этот метод возвращает соответствующее сообщение об ошибке как const char* и благодаря объявлению noexcept гарантирует, что сам процесс диагностики остается безопасным с точки зрения исключений [SWS_ANM_01107].

Если поток управления требует генерации системного исключения, используется метод ThrowAsException() [SWS_ANM_01108]. Эта функция принимает объект ошибки типа ara::core::ErrorCode и генерирует соответствующее ему исключение типа NmException [SWS_ANM_01104], [SWS_ANM_01108]. На практике вызов, вероятно, осуществляется преимущественно косвенно через вспомогательные методы объектов ошибок. Вопрос Q-70e50ac95d89f400 (открытый)

Диаграмма последовательности: преобразование кода ошибки Network Management в типоспецифичное NmException через домен ошибок. Источники: [SWS_ANM_01104], [SWS_ANM_01108].

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

В рамках обработки ошибок домен покрывает все ошибочные ситуации модуля, определяемые типом перечисления NmErrc через псевдоним Errc [SWS_ANM_01103]. Сам домен спроектирован так, чтобы детерминированно обеспечивать надежность обработки ошибок.

При получении текстовых сообщений через Message() объявление как noexcept гарантирует, что даже при недопустимых кодах ошибок не возникнет непредвиденных исключений [SWS_ANM_01107]. Единственный предусмотренный сценарий, в котором класс активно генерирует исключение, — это явный вызов ThrowAsException() [SWS_ANM_01108]. С помощью объявления noexcept(false) метод сигнализирует о том, что он обязательно переводит программу на путь обработки исключений, генерируя экземпляр NmException [SWS_ANM_01104], [SWS_ANM_01108]. Вызывающие компоненты должны поэтому гарантировать, что такие вызовы при необходимости перехватываются соответствующими блоками обработки исключений.