clase ara::diag::DiagErrorDomain

El constructor por defecto DiagErrorDomain() inicializa una instancia del dominio de errores de diagnóstico ara::diag::DiagErrorDomain ([SWS_DM_00520], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.1.1 «Default Constructor»). Está declarado como constexpr y noexcept, no recibe parámetros y no devuelve ningún valor ([SWS_DM_00520]). La llamada se realiza de forma síncrona y puede ejecutarse tanto en tiempo de compilación como en tiempo de ejecución.

En cuanto a la seguridad de ejecución y la concurrencia, se aplican las siguientes propiedades:

• Seguridad frente a fallos y excepciones: la función está especificada como exception safe y no puede lanzar ninguna excepción debido a noexcept ([SWS_DM_00520]). No se definen códigos de error específicos ni notificaciones a DET o DEM para la construcción.
• Seguridad para subprocesos: la instanciación está clasificada como thread-safe ([SWS_DM_00520]) y no está sujeta a ninguna restricción respecto al contexto de llamada.

En interacción con el módulo Diagnostics, la clase DiagErrorDomain ([SWS_DM_00517], AUTOSAR_AP_SWS_Diagnostics §8.11.3 «Class: DiagErrorDomain») representa el dominio de errores de diagnóstico. Proporciona alias de tipos centrales como Errc ([SWS_DM_00518]) y Exception ([SWS_DM_00519]). Las instancias del dominio también ofrecen métodos para consultar el nombre ([SWS_DM_00521]), para traducir códigos de error a textos de mensaje mediante Message() ([SWS_DM_00522]), así como para lanzar excepciones específicas del dominio a través de ThrowAsException() ([SWS_DM_00523]).

En el uso práctico, es de prever que rara vez sea necesaria una instanciación manual directa mediante este constructor (interpretación), ya que con la función ara::diag::GetDiagDomain() ([SWS_DM_00524]) ya se dispone de una referencia global de instancia, que ara::diag::MakeErrorCode() ([SWS_DM_00525]), entre otros, utiliza para generar códigos de error. Pregunta Q-95d533b0920260e0 (abierta)

El método Message de la clase ara::diag::DiagErrorDomain sirve para la traducción sincrónica de un código de error numérico a un mensaje de texto legible ([SWS_DM_00522]). Sobrescribe la función base del concepto de dominio de errores y se proporciona a través del encabezado ara/diag/diag_error_domain.h ([SWS_DM_00522]).

Contexto de llamada y semántica

Como parámetro de entrada, la función espera errorCode de tipo ara::core::ErrorDomain::CodeType ([SWS_DM_00522]). El valor de retorno es un puntero de tipo const char * al mensaje de error correspondiente ([SWS_DM_00522]). La especificación garantiza de forma vinculante que este valor de retorno nunca es nullptr ([SWS_DM_00522]). Interpretación: La cadena de caracteres devuelta probablemente apunte a literales de cadena estáticos, ya que la interfaz no prevé liberación dinámica de memoria y no debe fallar. Pregunta Q-a54b3a5f746357a8 (abierta)

Tratamiento de errores y concurrencia

Para la ejecución se aplican garantías estrictas en cuanto a robustez y concurrencia:

• Seguridad frente a excepciones: La operación está declarada como noexcept y especificada como totalmente segura frente a excepciones (exception safe) ([SWS_DM_00522]). No lanza excepciones C++ en caso de error.
• Seguridad de hilos: La función está catalogada explícitamente como thread-safe ([SWS_DM_00522]). Por lo tanto, varios hilos pueden invocarla de forma paralela y segura sin mecanismos de sincronización externos.

Interacción en el módulo de diagnóstico

La función forma parte de la notificación de errores unificada en AUTOSAR Adaptive Diagnostic Management. Existen funciones de traducción idénticas para otros dominios específicos del módulo:

• ara::diag::DiagUdsNrcErrorDomain::Message para la resolución textual de NRC de UDS ([SWS_DM_00534]),
• ara::diag::DiagOfferErrorDomain::Message para la descripción de errores en ofertas de diagnóstico ([SWS_DM_00994]),
• ara::diag::DiagReportingErrorDomain::Message para la resolución de códigos de error de notificación ([SWS_DM_01001]),
• ara::diag::DiagSovdErrorDomain::Message para códigos de error específicos de SOVD ([SWS_DM_01814]).

El método ara::diag::DiagErrorDomain::Name sirve para la consulta estandarizada del identificador del dominio de errores de diagnóstico ([SWS_DM_00521]). Se proporciona a través del encabezado ara/diag/diag_error_domain.h y devuelve de forma sincrónica el nombre corto ApApplicationErrorDomain.SN como cadena C terminada en nulo de tipo const char * ([SWS_DM_00521]). La llamada se realiza sin parámetros de entrada. Interpretación: El puntero devuelto probablemente apunte a un literal de cadena persistido estáticamente, ya que la especificación no prevé mecanismos de liberación. Pregunta Q-1ca098627210deb0 (abierta)

En lo relativo al tratamiento de errores, la función está declarada como noexcept así como especificada como segura frente a excepciones (exception safe) ([SWS_DM_00521]). No se notifican ni códigos de error ni excepciones; una llamada produce siempre un resultado válido.

En lo referente a la concurrencia y a las condiciones de contorno, el método está definido como thread-safe ([SWS_DM_00521]). Al carecer de estado y estar calificado como const, opera de forma reentrante y puede ejecutarse de manera concurrente desde hilos arbitrarios sin sincronización externa.

En la interacción arquitectónica, la función se integra en el Diagnostic Management (AUTOSAR_AP_SWS_Diagnostics p. 68). Existen métodos Name similares para la identificación de dominios en las clases afines ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) y ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

La función miembro ThrowAsException de la clase ara::diag::DiagErrorDomain sirve para el lanzamiento sincrónico de una excepción C++ a partir de un código de error transferido ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 «ThrowAsException»). El método espera como parámetro de entrada una referencia constante a una instancia de ara::core::ErrorCode y no tiene valor de retorno ([SWS_DM_00523]). Dado que su propósito principal consiste en lanzar una excepción, la operación está declarada con noexcept(false) y como no segura frente a excepciones (not exception safe) ([SWS_DM_00523]).

En lo respectivo a la concurrencia, el método está especificado como seguro para hilos (thread-safe) y, por consiguiente, puede invocarse desde múltiples contextos de ejecución sin sincronización adicional ([SWS_DM_00523]). Una condición de contorno esencial concierne a los entornos sin soporte de excepciones: conforme a [SWS_CORE_10304], la función no participa en la resolución de sobrecargas si las excepciones C++ están desactivadas en la cadena de herramientas del compilador empleada ([SWS_DM_00523]).

Este esquema funcional se aplica de manera consistente en diversos dominios de errores del módulo de diagnóstico. Se encuentran implementaciones análogas de ThrowAsException, entre otras, en ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException»), ara::diag::DiagOfferErrorDomain ([SWS_DM_00995]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01002]) así como en ara::diag::DiagSovdErrorDomain ([SWS_DM_01815]). Interpretación: Mediante la especificación con override, el método presumiblemente representa una operación de interfaz común para el tratamiento polimórfico de excepciones. Pregunta Q-9c1e35e079af639d (abierta)