clase ara::rds::RdsException

La clase ara::rds::RdsException representa el tipo de excepción especializado para el módulo Raw Data Stream y sirve para la propagación de errores basados en ara::core::ErrorCode [SWS_RDS_11292]. La instanciación se produce típicamente en el marco de la gestión de errores por medio de ThrowAsException, lo que desencadena una interrupción estructurada del flujo erróneo [SWS_RDS_11297]. Gracias al constructor declarado como noexcept, se garantiza que no se produzcan errores derivados en el sistema de tiempo de ejecución durante la generación de la excepción. El código de aplicación que realiza la llamada debe capturar la excepción para evitar la terminación anómala del programa.

más ›

Contexto

La clase ara::rds::RdsException actúa, en el contexto de AUTOSAR Adaptive, como tipo de excepción dedicado para el Raw Data Stream (rds), tal como se especifica en SWS RawDataStream §1 «Raw Data Stream». Se deriva directamente de la clase base general ara::core::Exception e integra de forma fluida el modelo de errores del módulo en la gestión de excepciones de la plataforma. Dentro del espacio de nombres de RDS, el tipo se proporciona a través del alias de tipo Exception [SWS_RDS_11327], lo que permite a los usuarios y componentes de módulo una nomenclatura uniforme y simplificada. Como interlocutores primarios figuran dominios de error como el dominio declarado en ara/rds/rds_error_domain.h, así como código de aplicación que gestiona errores mediante excepciones [SWS_RDS_11292].

Ciclo de vida

Las instancias de ara::rds::RdsException se crean según la demanda en cuanto un evento de error producido fuerza la interrupción del flujo de control regular. La instanciación se realiza a través de un constructor explícito que recibe un objeto ara::core::ErrorCode [SWS_RDS_11292]. Este constructor está declarado como noexcept, lo que garantiza que la propia creación del objeto no falle ni lance una excepción adicional bajo ninguna circunstancia. El objeto de excepción sigue la semántica de valor regular de C++: al lanzarse, se transfiere a la memoria de excepciones del entorno de ejecución. Como es habitual en los tipos de excepción en ara::core, es de suponer que el momento de la destrucción esté ligado a la salida del bloque catch correspondiente, tan pronto como expire la referencia al objeto de excepción. Pregunta Q-5673ede6a9688b85 (abierta) En entornos de ejecución concurrentes, la clase se comporta de forma segura frente a hilos, ya que cada situación de excepción se instancia y propaga de forma aislada a nivel local de hilo.

Ruta de uso

La ruta de uso típica incluye la detección de un estado de error en el funcionamiento del flujo (stream), la conversión del código de error en una excepción y su posterior captura en el código de la aplicación. Si se produce un error durante una operación, este se representa primariamente como ara::core::ErrorCode. En lugar de una consulta manual, el lanzamiento de la excepción puede iniciarse a través del método ThrowAsException, el cual encapsula la conversión y el proceso de lanzamiento [SWS_RDS_11297]. Interpretación: La invocación de ThrowAsException probablemente delega internamente de forma directa en el constructor de RdsException y lanza la instancia recién creada mediante throw [SWS_RDS_11292]. Pregunta Q-d8734426a5c71e07 (abierta) El código que realiza la llamada captura la excepción a través del tipo concreto ara::rds::RdsException, del alias ara::rds::Exception [SWS_RDS_11327] o polimórficamente a través de ara::core::Exception.

Diagrama de secuencia: interacción al desencadenar y capturar una excepción de RDS mediante un ErrorCode. Fuentes: [SWS_RDS_11292], [SWS_RDS_11297].

Escenarios de error

Los escenarios de error en torno a ara::rds::RdsException conciernen principalmente a la coherencia de la propagación de fallos y a la prevención de cancelaciones no controladas del programa. La operación de activación ThrowAsException está definida explícitamente como noexcept(false) [SWS_RDS_11297], ya que el lanzamiento de la excepción constituye el comportamiento previsto en caso de error. Se produce un escenario de error crítico si el código llamador ignora la posible interrupción del flujo de control y no proporciona ningún manejador de excepciones adecuado; un tratamiento incompleto provoca la terminación inmediata del proceso a través de std::terminate. Sin embargo, la garantía noexcept del constructor [SWS_RDS_11292] asegura que no se produzca ningún error de inicialización anidado al proporcionar la excepción propiamente dicha.