namespace ara::nm

El espacio de nombres ara::nm proporciona con NetworkHandle interfaces para el acceso controlado al estado de red solicitado y efectivo de AUTOSAR Adaptive Platform. Las posibles situaciones de error en el funcionamiento operativo se representan mediante los códigos de error estandarizados de la enumeración NmErrc, tales como kServiceNotAvailable o kInvalidHandler [SWS_ANM_01111]. Para un tratamiento de errores estructurado, MakeErrorCode genera de forma segura para subprocesos códigos de error para el dominio de errores NmErrorDomain, el cual se referencia mediante GetNmDomain [SWS_ANM_01109]. Antes de realizar llamadas, las aplicaciones deben tener en cuenta la accesibilidad del servicio de Network Management a fin de evitar fallos en las consultas de estado.

más ›

Contexto

El espacio de nombres ara::nm proporciona en AUTOSAR Adaptive Platform las interfaces principales para el Network Management funcional. La interfaz funcional primaria la constituye la clase NetworkHandle, que encapsula el acceso controlado tanto al estado de red solicitado como al efectivo. A través de este mecanismo de abstracción, las aplicaciones funcionales y los servicios de plataforma pueden monitorizar el estado operativo actual de la red de comunicación subyacente e iniciar cambios de estado.

Para un tratamiento de errores consistente y robusto, ara::nm proporciona tipos estandarizados y funciones auxiliares que están integrados en la arquitectura de errores de AUTOSAR Adaptive. Entre ellos se encuentran el dominio de errores NmErrorDomain, la clase de excepción NmException y la enumeración específica del dominio NmErrc [SWS_ANM_01111]. De forma complementaria, están disponibles las funciones seguras para subprocesos GetNmDomain [SWS_ANM_01109] y MakeErrorCode [SWS_ANM_01110], las cuales garantizan una gestión de los estados de error conforme a la instanciación y al tipo.

Diagrama de contexto: interacción entre la aplicación, NetworkHandle y la arquitectura de errores en ara::nm. Fuentes: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Ruta de uso

En un escenario de uso típico, una Adaptive Application interactúa con el espacio de nombres ara::nm para controlar el estado de la red y reaccionar a eventos en tiempo de ejecución. La secuencia de interacción se divide en los siguientes pasos:

• Iniciar el acceso al estado: la aplicación utiliza un NetworkHandle para consultar el estado de red solicitado o el actualmente efectivo.
• Detección de errores: si la solicitud de red no puede atenderse correctamente, la interfaz señaliza el evento de error correspondiente. Interpretación: en caso de fallos de los servicios de red subyacentes, es probable que NetworkHandle genere internamente códigos de error basados en NmErrc. Pregunta Q-97b1567be5e28121 (abierta)
• Generar el código de error: la función auxiliar MakeErrorCode [SWS_ANM_01110] recibe un valor de NmErrc [SWS_ANM_01111], así como datos adicionales específicos de la aplicación (ara::core::ErrorDomain::SupportDataType), y genera a partir de ellos un ara::core::ErrorCode completo. La función está especificada como constexpr y noexcept, y garantiza una total seguridad para subprocesos [SWS_ANM_01110].
• Verificar el dominio de errores: el componente que realiza la llamada puede obtener, mediante GetNmDomain [SWS_ANM_01109], una referencia segura para subprocesos al NmErrorDomain global a fin de comprobar el dominio de errores del código devuelto y resolver descripciones de error específicas del dominio.

Diagrama de secuencia: desarrollo de la consulta del estado de red y resolución de errores a través de ara::nm. Fuentes: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Escenarios de error

Los códigos de error estandarizados del módulo se agrupan en la enumeración NmErrc, que se basa en ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. El módulo distingue los siguientes casos de error:

• NmErrc::kServiceNotAvailable (código 1): este error indica que el servicio requerido para la gestión de red no está accesible u operativo en tiempo de ejecución [SWS_ANM_01111]. En este caso, los emisores de las llamadas deben reaccionar con reintentos o estrategias de repliegue.
• NmErrc::kInvalidHandler (código 2): se produce cuando en una operación se ha transmitido o referenciado un manejador no válido o no registrado [SWS_ANM_01111]. Esto suele apuntar a un error de configuración o de inicialización en el emisor de la llamada.

Las condiciones previas para llamadas robustas son una infraestructura de servicios inicializada, así como parámetros válidos al acceder a NetworkHandle, con el fin de evitar NmErrc::kServiceNotAvailable o NmErrc::kInvalidHandler [SWS_ANM_01111]. Ninguna de las funciones centrales del tratamiento de errores, tales como MakeErrorCode [SWS_ANM_01110] y GetNmDomain [SWS_ANM_01109], lanza excepciones (noexcept). Interpretación: para aquellas aplicaciones que prefieren una estructura de control basada en excepciones, es probable que la clase de excepción NmException actúe como portadora para propagar estados de error de forma estructurada a través de la pila de llamadas (callstack). Pregunta Q-67a17c37021e8beb (abierta)