класс ara::nm::NmException

Класс исключений служит стандартизированным типом ошибок для синхронных ошибок времени выполнения и API внутри функционального кластера Network Management согласно [SWS_ANM_01100]. Экземпляры инкапсулируют первопричину ошибки и создаются путём передачи конкретного кода ошибки [SWS_ANM_01102]. За счёт специализации общего базового исключения данный тип обеспечивает целенаправленную обработку исключений при сбойных операциях сетевого управления. Важным граничным условием является то, что конструктор гарантирует полную потокобезопасность и соблюдение гарантии отсутствия исключений (not-throw) во время создания объекта.

больше ›

Контекст

Класс ara::nm::NmException выступает внутри функционального кластера Network Management (ara::nm) в качестве центрального типа исключений для сигнализации об ошибках на уровне API [SWS_ANM_01100]. Он объявлен в заголовочном файле ara/nm/nm_error_domain.h и открыто наследует от общего базового класса ara::core::Exception [SWS_ANM_01100]. В архитектуре AUTOSAR Adaptive Platform он тем самым связывает модуле-специфичные состояния ошибок сетевого управления со стандартизированным механизмом обработки исключений C++ базовой инфраструктуры.

В качестве партнеров по взаимодействию выступают API-интерфейсы Network Management, а также прикладные компоненты, использующие сервисы этого кластера. Если при выполнении такого интерфейса возникает критическое или требующее синхронной обработки состояние ошибки, объект исключения инкапсулирует эту ошибку для передачи вышестоящим вызывающим компонентам [SWS_ANM_01100]. Благодаря иерархии наследования NmException органично встраивается в общие подпрограммы обработки исключений и может перехватываться как на уровне конкретного модуля, так и полиморфно через ссылки на ara::core::Exception.

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

Жизненный цикл экземпляра ara::nm::NmException начинается с его явного инстанцирования через конструктор, которому передается код ошибки типа ara::core::ErrorCode [SWS_ANM_01102]. За счет обозначения конструктора ключевым словом explicit спецификация запрещает неявные преобразования типов из кодов ошибок, благодаря чему принудительно обеспечивается осознанное и типобезопасное создание объекта [SWS_ANM_01102].

С точки зрения параллелизма конструирование исключения специфицировано как потокобезопасное (thread-safe) [SWS_ANM_01102]. Таким образом, инстанцирование может безопасно выполняться параллельно в различных потоках без необходимости реализации внешних механизмов синхронизации вызывающими компонентами. Кроме того, конструктор объявлен с noexcept [SWS_ANM_01102], что формально гарантирует невозможность генерации других исключений при самом создании объекта.

После создания экземпляр передается соответствующему обработчику исключений через механизм стека C++. Уничтожение происходит автоматически при выходе из соответствующего блока catch согласно стандартным правилам языка программирования C++ для объектов исключений.

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

Штатный сценарий использования охватывает возникновение ошибки при взаимодействии с API Network Management, создание объекта исключения, а также его последующий разбор приложением. Предположительно, исключение инициируется прежде всего тогда, когда синхронные вызовы завершаются сбоем или ошибки из возвращаемых значений явно преобразуются в исключение. Вопрос Q-636ec24993a10a5b (открытый)

Диаграмма последовательности: типичный ход обработки ошибок через исключение при вызовах API Network Management. Источники: [SWS_ANM_01100], [SWS_ANM_01102]

Типичная последовательность действий подразделяется на следующие шаги:

• Вызов операции API: приложение вызывает функцию Network Management.
• Обнаружение ошибки и конструирование: если реализация API фиксирует условие ошибки, она создает экземпляр NmException с передачей конкретного кода ошибки [SWS_ANM_01102].
• Генерация исключения: генерируется исключение (throw), вследствие чего нормальный поток управления прерывается [SWS_ANM_01100].
• Перехват и обработка ошибки: приложение перехватывает исключение по ссылке как const ara::nm::NmException& и предпринимает соответствующие меры по восстановлению или журналированию.

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

Являясь классом исключения, ara::nm::NmException представляет собой инструмент отображения ошибок и сам по себе не подвержен сложным сценариям сбоев во время работы [SWS_ANM_01100]. Основным предусловием для создания является предоставление инициализированного объекта ara::core::ErrorCode [SWS_ANM_01102]. Данный код ошибки, по всей видимости, отображает домен ошибки и числовой идентификатор конкретной проблемы NM. Вопрос (открытый)

Поскольку конструктор объявлен как noexcept, сбой при создании объекта исключения исключен [SWS_ANM_01102]. Основной сценарий отказа на системном уровне заключается в отсутствии надлежащей обработки исключений: если сгенерированное NmException остается неперехваченным, это приводит к вызову std::terminate и тем самым к неконтролируемому аварийному завершению процесса. Поэтому приложения должны гарантировать, что вызывающие участки кода защищены соответствующими блоками обработки.