clase ara::com::ComErrorDomain

La clase ara::com::ComErrorDomain representa el dominio de errores de comunicación para la identificación de errores generales no específicos de la interfaz en la API ara::com ([SWS_CM_11265]). Proporciona descripciones de error para códigos de error tales como ComErrc::kCommunicationFailure y permite su consulta a través de Message() o su conversión en una excepción mediante ThrowAsException() ([SWS_CM_11332]). Dado que su constructor por defecto está eliminado, actúa como una instancia de dominio sin estado y segura para subprocesos (thread-safe) para el ara::core::Result portador del error.

más ›

Contexto

La clase ara::com::ComErrorDomain representa el dominio estandarizado de errores de comunicación de la Adaptive Platform para el clúster funcional Communication Management (SWS CommunicationManagement p. 439). Deriva de la clase base ara::core::ErrorDomain y define el contexto semántico para errores generales que pueden producirse durante llamadas a métodos o transmisiones de datos, pero que no son específicos de una ServiceInterface individual ([SWS_CM_11265]). En la arquitectura de errores de ara::com, delimita sistemáticamente los fallos generales de comunicación respecto de los errores de supervisión de E2E y de los errores de servicio específicos de la aplicación (SWS CommunicationManagement §7.5.22.6 «Error Related Data Types»).

Entre sus interlocutores centrales figuran la Adaptive Application, las implementaciones de servicio y proxy del middleware, así como los tipos de datos ara::core::ErrorCode y ara::core::Result del sistema base (EXP ARAComAPI §4.7 «Error Handling»). Para la vinculación semántica de tipos, la clase proporciona los alias de tipo Errc para la enumeración de códigos de error ComErrc ([SWS_CM_11336]), así como Exception para la clase de excepción asociada ComException ([SWS_CM_11337]).

Diagrama de contexto: Integración de ComErrorDomain en la arquitectura de errores de ara::com. Fuentes: [SWS_CM_11265], EXP ARAComAPI §4.7 «Error Handling», SWS CommunicationManagement §7.5.22.6 «Error Related Data Types»

Ciclo de vida

Como clase de especificación para un dominio de error, la creación de ara::com::ComErrorDomain queda impedida mediante la eliminación del constructor por defecto ComErrorDomain() = delete; ([SWS_CM_11330]). Interpretación: La provisión de la instancia de dominio debería realizarse como singleton estático a través de la plataforma, de modo que los componentes de la aplicación no tengan que instanciar ni gestionar el dominio dinámicamente. Pregunta Q-bf957a108c0a5378 (abierta)

La instancia actúa como descriptor sin estado y sin atributos modificables. Todos los métodos proporcionados, como Name() ([SWS_CM_11331]) y Message() ([SWS_CM_11332]), están declarados como const noexcept. Esto garantiza una seguridad de subprocesos sin restricciones durante las consultas de error concurrentes procedentes de subprocesos paralelos de la aplicación y del middleware.

Ruta de uso

La ruta de uso típica comprende la detección, transmisión y evaluación de un error a través de las interfaces de ara::com:

1. La aplicación inicia una interacción de servicio, por ejemplo mediante el operador de llamada de la clase de método operator() ([SWS_CM_00196]).
2. Si el middleware detecta un caso de error durante el procesamiento, como por ejemplo un fallo de comunicación o un error de aplicación no configurado ([SWS_CM_00048]), se invoca la operación SetError en el Promise correspondiente (SWS CommunicationManagement p. 300).
3. En este proceso se construye un ara::core::ErrorCode cuyo dominio se establece en ara::com::ComErrorDomain ([SWS_CM_11329]) y cuyo código numérico se fija en un valor de enumeración específico como ComErrc::kCommunicationFailure ([SWS_CM_10432]).
4. El ara::core::Future o ara::core::Result devuelto a la aplicación transporta el código de error en estado de error al invocador (EXP ARAComAPI §4.7 «Error Handling»).
5. La aplicación comprueba el Result y utiliza las funciones de dominio Name() ([SWS_CM_11331]) y Message() ([SWS_CM_11332]) para resolver los mensajes de error destinados al registro o al diagnóstico.
6. En caso de que la lógica de la aplicación espere una excepción y las excepciones de C++ estén habilitadas, puede desencadenarse la conversión en una ComException mediante ThrowAsException() ([SWS_CM_11333]).

Diagrama de secuencia: Señalización y consulta de un error de comunicación mediante ComErrorDomain. Fuentes: [SWS_CM_00196], [SWS_CM_10432], [SWS_CM_11329], [SWS_CM_11332], SWS CommunicationManagement p. 300

Escenarios de error

El concepto de error de ara::com distingue estrictamente entre errores recuperables (Recoverable Errors) e infracciones graves de programación (Violations o Corruptions) (EXP ARAComAPI §4.7 «Error Handling»). Los errores recuperables se gestionan a través de ara::core::Result y ara::core::ErrorCode, donde los códigos de error del dominio ComErrorDomain se direccionan mediante el alias de identificador Errc ([SWS_CM_11336]).

Si, por ejemplo, se produce una interrupción de la transmisión durante una llamada remota, el sistema notifica ComErrc::kCommunicationFailure ([SWS_CM_10432]). En caso de un error de aplicación no configurado, el middleware cancela la llamada y establece asimismo el código de error correspondiente del dominio ([SWS_CM_00048], SWS CommunicationManagement p. 300).

Si debe lanzarse un código de error como excepción, ThrowAsException() instancia una excepción del tipo ComException ([SWS_CM_11337]) y la lanza ([SWS_CM_11333]). Este método no es seguro frente a excepciones (not exception safe) y, según la especificación, no participa en la resolución de sobrecargas cuando las excepciones de C++ están deshabilitadas ([SWS_CM_11333]). Por el contrario, las violaciones no recuperables del sistema provocan directamente la interrupción de la plataforma y no se tratan mediante ComErrorDomain (EXP ARAComAPI §4.7 «Error Handling»).