пространство имён ara::fw

Пространство имен ara::fw предоставляет типы и интерфейсы для управления межсетевым экраном, а также для его стандартизированной обработки ошибок в AUTOSAR Adaptive Platform. Модуль определяет с помощью FirewallStateSwitchInterface интерфейс для состояний межсетевого экрана и генерирует через потокобезопасную функцию MakeErrorCode типизированные объекты ошибок на основе домена ошибок FwErrorDomain [AP_SWS_Fw_83003]. Возникающие неполадки отображаются перечислением FwErrc, которое среди прочего указывает на недоступные службы или недействительные зависимые от состояния конфигурации [AP_SWS_Fw_83001]. Все ключевые функции генерации ошибок являются потокобезопасными и объявлены как noexcept.

больше ›

Контекст

Пространство имен ara::fw объединяет программные интерфейсы и типы для функциональности межсетевого экрана платформы AUTOSAR Adaptive Platform в релизе R25-11. Основная роль модуля заключается в предоставлении механизмов фильтрации и защиты внутриавтомобильной сетевой коммуникации. К ключевым составляющим пространства имен относятся интерфейс FirewallStateSwitchInterface, а также компоненты стандартизированной обработки ошибок, состоящие из FwErrorDomain, FwException и соответствующих кодов ошибок. Архитектура бесшовно вписывается в концепцию ошибок платформы ara::core. Внешние партнеры по взаимодействию, такие как управляющие состоянием службы платформы или приложения, используют пространство имен для управления связанными с безопасностью состояниями межсетевого экрана или для разрешения возникших ошибок выполнения. Интерпретация: класс FirewallStateSwitchInterface, предположительно, служит основным интерфейсом для активации и переключения наборов правил в зависимости от вышестоящего состояния системы. Вопрос Q-d4ba0994e0147cf1 (открытый)

Контекстная диаграмма: взаимодействие приложения, FirewallStateSwitchInterface и FwErrorDomain при разрешении ошибок. Источники: [AP_SWS_Fw_83001], [AP_SWS_Fw_83002], [AP_SWS_Fw_83003].

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

Типичный путь использования в пространстве имен ara::fw включает инициацию изменений состояния, а также создание, передачу и анализ ошибочных состояний при выполнении функций межсетевого экрана. Если операция в контексте FirewallStateSwitchInterface завершается сбоем или требование к состоянию не может быть выполнено, модуль обращается к специфическому домену ошибок, чтобы предоставить вызывающей стороне точный результат диагностики. Для инстанцирования такой ошибки вызывается функция MakeErrorCode [AP_SWS_Fw_83003]. Эта функция создает ara::core::ErrorCode, принимая значение ошибки из FwErrc [AP_SWS_Fw_83001] и необязательные специфические для производителя дополнительные данные типа ara::core::ErrorDomain::SupportDataType [AP_SWS_Fw_83003]. Поскольку MakeErrorCode объявлена как constexpr и noexcept, создание кода ошибки может осуществляться детерминированно и с экономным расходованием ресурсов.

На стороне вызывающего объекта возвращенная ошибка чаще всего принимается в объекте результата (таком как ara::core::Result). Для программной верификации источника ошибки служит свободная функция GetFwErrorDomain [AP_SWS_Fw_83002], возвращающая константную ссылку на синглтон домена ошибок FwErrorDomain. Вызывающие стороны могут с ее помощью сопоставить, действительно ли возникшая ошибка произошла из модуля межсетевого экрана, и определить ее текстовое описание. Интерпретация: в системных архитектурах, использующих исключения C++, класс FwException, вероятно, служит цели перехватываемой инкапсуляции ara::core::ErrorCode и синхронной передачи в вышестоящие подпрограммы обработки ошибок. Вопрос (открытый)

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

Для ошибочных ситуаций перечисление FwErrc в пространстве имен ara::fw определяет специфические причины ошибок для домена ошибок FwErrorDomain [AP_SWS_Fw_83001]. При этом заголовочный файл ara/fw/fw_error_domain.h объявляет следующие стандартизированные состояния ошибок:

• kServiceNotAvailable (значение 1): указывает на то, что адресуемая служба Firewall во время выполнения недоступна или в данный момент не готова к работе [AP_SWS_Fw_83001]. Возможные причины заключаются в еще не инициализированных фоновых компонентах или временных обрывах соединения. Предусловия для последующих вызовов не выполнены, поэтому вызывающие компоненты должны запросить статус службы или повторить запрос позднее.
• kInvalidStateDependentFirewall (значение 2): возникает, если запрошенная зависимая от состояния конфигурация Firewall недействительна или был запрошен недопустимый переход между состояниями [AP_SWS_Fw_83001]. Предусловием для успешных операций переключения является поддержка целевым Firewall желаемых состояний и нахождение системы в допустимом базовом состоянии. После возникновения этой ошибки Firewall остается без изменений в прежнем режиме защиты.

Оба значения ошибок основаны на базовом типе ara::core::ErrorDomain::CodeType [AP_SWS_Fw_83001]. Функции GetFwErrorDomain [AP_SWS_Fw_83002] и MakeErrorCode [AP_SWS_Fw_83003] явно объявлены как потокобезопасные (thread-safe) и noexcept, благодаря чему надежная обработка ошибок гарантируется даже в высокопараллельных или критичных ко времени контекстах.