clase ara::nm::NmException

La clase de excepción sirve como tipo de error estandarizado para errores síncronos de tiempo de ejecución y de API dentro del clúster funcional de Network Management según [SWS_ANM_01100]. Las instancias encapsulan la causa subyacente del error y se crean mediante el paso de un código de error específico [SWS_ANM_01102]. Mediante la especialización de la excepción base genérica, el tipo permite un tratamiento de excepciones específico ante operaciones fallidas de gestión de red. Como restricción esencial, el constructor garantiza total seguridad para subprocesos y el cumplimiento de la garantía de no lanzamiento (not-throw) durante la creación del objeto.

más ›

Contexto

La clase ara::nm::NmException actúa dentro del clúster funcional Network Management (ara::nm) como tipo de excepción central para señalizar errores a nivel de API [SWS_ANM_01100]. Está declarada en el archivo de cabecera ara/nm/nm_error_domain.h y deriva públicamente de la clase base general ara::core::Exception [SWS_ANM_01100]. En la arquitectura de AUTOSAR Adaptive Platform, tiende así un puente entre los estados de error específicos de módulo de la gestión de red y el mecanismo estandarizado de excepciones de C++ de la infraestructura base.

Como interlocutores intervienen las interfaces de API de Network Management, así como componentes específicos de la aplicación que hacen uso de los servicios de este clúster. Si durante la ejecución de dicha interfaz surge un estado de error grave o que deba tratarse de forma síncrona, el objeto de excepción encapsula este error para transferirlo a los llamadores de nivel superior [SWS_ANM_01100]. Gracias a la jerarquía de herencia, NmException se integra perfectamente en las rutinas generales de tratamiento de excepciones y puede capturarse tanto de forma específica de módulo como polimórficamente mediante referencias a ara::core::Exception.

Ciclo de vida

El ciclo de vida de una instancia de ara::nm::NmException comienza con su instanciación explícita mediante el constructor, al cual se le pasa un código de error de tipo ara::core::ErrorCode [SWS_ANM_01102]. Al marcar el constructor con la palabra clave explicit, la especificación impide conversiones implícitas de tipo a partir de códigos de error, forzando con ello una creación de objetos deliberada y con tipos correctos [SWS_ANM_01102].

En lo relativo a la concurrencia, la construcción de la excepción está especificada como segura para subprocesos (thread-safe) [SWS_ANM_01102]. Por lo tanto, la instanciación puede tener lugar de forma segura en paralelo en diferentes hilos, sin que los componentes llamadores deban establecer mecanismos de sincronización externos. De forma complementaria, el constructor está declarado con noexcept [SWS_ANM_01102], lo que garantiza formalmente que no se puedan lanzar más excepciones durante la propia creación del objeto.

Tras la creación, la instancia se transporta al gestor de excepciones competente a través del mecanismo de pila de C++. La destrucción se produce automáticamente al salir del bloque catch correspondiente, con arreglo a las reglas estándar del lenguaje de programación C++ para objetos de excepción.

Ruta de uso

La ruta de uso regular abarca la aparición de un error en la interacción con la API de Network Management, la creación del objeto de excepción y su posterior evaluación por parte de la aplicación. Es de suponer que la excepción se lance sobre todo cuando las llamadas síncronas fallen o cuando los errores procedentes de valores de retorno se desempaqueten explícitamente como excepción. Pregunta Q-636ec24993a10a5b (abierta)

Diagrama de secuencia: Flujo típico del tratamiento de errores mediante una excepción en llamadas a la API de Network Management. Fuentes: [SWS_ANM_01100], [SWS_ANM_01102]

El flujo típico se divide en los siguientes pasos:

• Llamada a la operación de API: La aplicación llama a una función de Network Management.
• Detección del error y construcción: Si la implementación de la API determina una condición de error, crea una instancia de NmException pasando el código de error específico [SWS_ANM_01102].
• Lanzamiento de la excepción: La excepción se lanza (throw), con lo que se interrumpe el flujo normal de control [SWS_ANM_01100].
• Captura y tratamiento del error: La aplicación captura la excepción por referencia como const ara::nm::NmException& e inicia las medidas pertinentes de recuperación o registro.

Escenarios de error

Como clase de excepción, ara::nm::NmException representa la herramienta para la plasmación de errores y no está sujeta por sí misma a escenarios de error complejos durante el funcionamiento [SWS_ANM_01100]. La precondición fundamental para la creación consiste en la provisión de un objeto ara::core::ErrorCode inicializado [SWS_ANM_01102]. Es de suponer que este código de error refleje el dominio de error y el identificador numérico del problema específico de NM. Pregunta (abierta)

Dado que el constructor está declarado como noexcept, queda descartado un fallo durante la creación del objeto de excepción [SWS_ANM_01102]. El escenario de fallo principal a nivel de sistema radica en la omisión de un tratamiento de excepciones adecuado: Si una NmException lanzada no se captura, esto deriva en la llamada a std::terminate y, con ello, en la terminación descontrolada del proceso. Por consiguiente, las aplicaciones deben asegurarse de que las secciones de código llamadoras estén protegidas con los bloques de tratamiento correspondientes.