namespace ara::fw

El espacio de nombres ara::fw proporciona tipos e interfaces para el control de firewall, así como su gestión estandarizada de errores en AUTOSAR Adaptive Platform. Mediante FirewallStateSwitchInterface, el módulo define una interfaz para estados de firewall y genera objetos de error tipificados basados en el dominio de error FwErrorDomain [AP_SWS_Fw_83003] a través de la función segura para hilos MakeErrorCode. Los problemas que surgen se representan mediante la enumeración FwErrc, que indica, entre otros, servicios no disponibles o configuraciones dependientes del estado no válidas [AP_SWS_Fw_83001]. Todas las funciones centrales para la generación de errores son seguras para hilos y están declaradas como noexcept.

más ›

Contexto

El espacio de nombres ara::fw agrupa las interfaces de programación y los tipos para la funcionalidad de firewall de AUTOSAR Adaptive Platform en la versión R25-11. La función principal del módulo consiste en proporcionar mecanismos para el filtrado y aseguramiento de la comunicación de red interna del vehículo. Entre los componentes centrales del espacio de nombres se encuentran la interfaz FirewallStateSwitchInterface, así como los componentes para la gestión de errores estandarizada, formados por FwErrorDomain, FwException y los códigos de error asociados. La arquitectura se integra perfectamente en el concepto de error de plataforma de ara::core. Interlocutores externos, tales como servicios de plataforma de gestión de estados o aplicaciones, utilizan el espacio de nombres para controlar estados de firewall relevantes para la seguridad o resolver errores de ejecución surgidos. Interpretación: la clase FirewallStateSwitchInterface sirve presumiblemente como interfaz principal para activar y conmutar conjuntos de reglas en función del estado del sistema de nivel superior. Pregunta Q-d4ba0994e0147cf1 (abierta)

Diagrama de contexto: interacción entre la aplicación, FirewallStateSwitchInterface y FwErrorDomain en la resolución de errores. Fuentes: [AP_SWS_Fw_83001], [AP_SWS_Fw_83002], [AP_SWS_Fw_83003].

Ruta de uso

La ruta de uso típica en el espacio de nombres ara::fw abarca la iniciación de cambios de estado, así como la generación, transmisión y evaluación de estados de error durante la ejecución de funciones de firewall. Si una operación en el contexto de FirewallStateSwitchInterface falla o no se puede satisfacer una solicitud de estado, el módulo accede al dominio de error específico para proporcionar al llamante un resultado de diagnóstico preciso. Para instanciar dicho error, se invoca la función MakeErrorCode [AP_SWS_Fw_83003]. Esta función genera un ara::core::ErrorCode aceptando un valor de error de FwErrc [AP_SWS_Fw_83001] y datos adicionales específicos del fabricante opcionales de tipo ara::core::ErrorDomain::SupportDataType [AP_SWS_Fw_83003]. Dado que MakeErrorCode está declarada como constexpr y noexcept, la creación del código de error puede realizarse de manera determinista y eficiente en recursos.

En el lado del llamante, el error devuelto se suele recibir en un objeto de resultado (como ara::core::Result). Para la verificación programática del origen del error se utiliza la función libre GetFwErrorDomain [AP_SWS_Fw_83002], que devuelve una referencia constante al singleton del dominio de error FwErrorDomain. Con ella, los llamantes pueden cotejar si un error ocurrido procede realmente del módulo de firewall y determinar su descripción textual. Interpretación: en arquitecturas de sistema que emplean excepciones de C++, la clase FwException presumiblemente tiene como finalidad encapsular el ara::core::ErrorCode de forma capturable y reenviarlo de forma síncrona a las rutinas de gestión de errores de nivel superior. Pregunta (abierta)

Escenarios de error

Para situaciones de error, la enumeración FwErrc en el espacio de nombres ara::fw define causas de error específicas para el dominio de errores FwErrorDomain [AP_SWS_Fw_83001]. El archivo de cabecera ara/fw/fw_error_domain.h declara para ello los siguientes estados de error estandarizados:

• kServiceNotAvailable (valor 1): indica que el servicio de Firewall direccionado no está accesible en tiempo de ejecución o no está operativo en ese momento [AP_SWS_Fw_83001]. Las causas posibles residen en componentes en segundo plano aún no inicializados o en interrupciones temporales de la conexión. Las condiciones previas para llamadas posteriores no se cumplen, por lo que los emisores de las llamadas deben consultar el estado del servicio o repetir la solicitud en un momento posterior.
• kInvalidStateDependentFirewall (valor 2): se produce cuando una configuración de Firewall dependiente del estado solicitada no es válida o se ha solicitado una transición de estado no válida [AP_SWS_Fw_83001]. La condición previa para operaciones de conmutación correctas es que el Firewall de destino admita los estados deseados y que el sistema se encuentre en un estado básico admisible. Tras producirse este error, el Firewall permanece sin cambios en el modo de protección anterior.

Ambos valores de error se basan en el tipo base ara::core::ErrorDomain::CodeType [AP_SWS_Fw_83001]. Las funciones GetFwErrorDomain [AP_SWS_Fw_83002] y MakeErrorCode [AP_SWS_Fw_83003] están declaradas expresamente como seguras para subprocesos (thread-safe, thread-safe) y noexcept, con lo que se garantiza un tratamiento de errores seguro incluso en contextos con un alto grado de concurrencia o de tiempo crítico.