clase ara::diag::DiagReportingErrorDomain

El constructor por defecto sin parámetros [SWS_DM_00999] inicializa una instancia del dominio de errores ara::diag::DiagReportingErrorDomain ([SWS_DM_00996], AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.1.1 «Default Constructor»). Está declarado como constexpr así como noexcept y crea el dominio de forma síncrona sin valor de retorno. La clase se debe incluir mediante el archivo de cabecera #include "ara/diag/diag_error_domain.h".

La operación está especificada como segura frente a hilos y segura frente a excepciones ([SWS_DM_00999]). Dado que el constructor está definido como noexcept, no se producen excepciones de tiempo de ejecución durante la instanciación. El dominio de errores creado sirve para la clasificación y asignación de errores procedentes de la enumeración DiagReportingErrc ([SWS_DM_00560], alias de tipo Errc en [SWS_DM_00997]), que representa causas de error específicas en la notificación de diagnósticos tales como kAlreadyOffered, kConfigurationMismatch, kDebouncingConfigurationInconsistent o kReportIgnored.

En interacción con el dominio de errores, las funciones miembro Name ([SWS_DM_01000]) y Message ([SWS_DM_01001]) devuelven el nombre de dominio así como los textos de error para los códigos de error pasados. Mediante ThrowAsException ([SWS_DM_01002]) se pueden convertir códigos de error en objetos de excepción del tipo base DiagReportingException ([SWS_DM_00998]), mientras que MakeErrorCode ([SWS_DM_01006]) sirve para crear nuevas instancias de ara::core::ErrorCode. Interpretación: Una instanciación manual mediante este constructor raramente debería ser necesaria en programas de aplicación, ya que el acceso se realiza habitualmente a través de la función singleton global GetDiagReportingDomain ([SWS_DM_01004]). Pregunta Q-772337db203849c6 (abierta)

usar

El método Message de la clase ara::diag::DiagReportingErrorDomain ([SWS_DM_01001]) sirve para traducir de forma síncrona un código de error numérico (ara::core::ErrorDomain::CodeType errorCode) a un mensaje de texto descriptivo. Como valor de retorno, la función proporciona un puntero de tipo const char * que, según la especificación, nunca es nullptr ([SWS_DM_01001]). Debido al tipo de retorno sin mecanismo de liberación, el puntero probablemente apunte a memoria estática (interpretación). Pregunta Q-6c1dffd8e5f8f2c2 (abierta) La interfaz se proporciona a través del archivo de cabecera #include "ara/diag/diag_error_domain.h" ([SWS_DM_01001]).

Tratamiento de errores y concurrencia

La función está definida como noexcept así como exception safe ([SWS_DM_01001]). Dado que se garantiza contractualmente que nunca se devuelve un puntero nulo, la función siempre genera una cadena de caracteres válida incluso para códigos de error desconocidos ([SWS_DM_01001]). En cuanto a la concurrencia, Message está especificado como thread-safe ([SWS_DM_01001]). Por lo tanto, las llamadas pueden realizarse en paralelo desde múltiples subprocesos sin sincronización adicional.

Interacción

El método sobrescribe como override el método base homónimo para la traducción de códigos de error en el contexto de Adaptive AUTOSAR ([SWS_DM_01001]). Este patrón de comportamiento uniforme también lo comparten otros dominios de error del módulo de diagnóstico, por ejemplo ara::diag::DiagErrorDomain ([SWS_DM_00522]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00534]), ara::diag::DiagOfferErrorDomain ([SWS_DM_00994]) y ara::diag::DiagSovdErrorDomain ([SWS_DM_01814]).

La función miembro Name() de la clase ara::diag::DiagReportingErrorDomain del encabezado #include "ara/diag/diag_error_domain.h" devuelve el nombre corto configurado (shortname) del área de error ApApplicationErrorDomain.SN como cadena C terminada en nulo [SWS_DM_01000]. La llamada se realiza de forma síncrona y sin parámetros de transferencia a fin de proporcionar el identificador para fines de diagnóstico y registro en el sistema AUTOSAR_AP_SWS_Diagnostics p. 68.

Para el tratamiento de errores no se han definido códigos de error específicos ni mensajes DET o DEM. Gracias a su especificación como noexcept y segura frente a excepciones (exception safe), se garantiza que la llamada a la función siempre tenga éxito y no lance excepciones [SWS_DM_01000].

Con respecto a la concurrencia y las restricciones, el método está especificado como seguro para subprocesos (thread-safe) y permite el acceso paralelo y reentrante desde distintos subprocesos [SWS_DM_01000]. Interpretación: el puntero suministrado probablemente apunte a una cadena de caracteres inmutable durante toda la vida útil de la instancia del dominio de error. Pregunta Q-d67122aa15cc13f8 (abierta)

En el sistema general, la interfaz sigue el estándar uniforme para dominios de error de Adaptive. Corresponde funcionalmente a los métodos Name() equivalentes de dominios afines como DiagErrorDomain [SWS_DM_00521], DiagUdsNrcErrorDomain [SWS_DM_00533], DiagOfferErrorDomain [SWS_DM_00993] así como DiagSovdErrorDomain [SWS_DM_01813].

La función ThrowAsException del área ara::diag::DiagReportingErrorDomain sirve para lanzar una excepción de C++ que corresponde al código de error pasado ([SWS_DM_01002], AUTOSAR_AP_SWS_Diagnostics §8.11.7.2.2.3 «ThrowAsException»). La interfaz se proporciona a través del archivo de cabecera ara/diag/diag_error_domain.h ([SWS_DM_01002]).

Uso y contexto de llamada

Como parámetro de entrada, el método recibe una instancia de tipo const ara::core::ErrorCode& (errorCode) ([SWS_DM_01002]). No tiene valor de retorno (void) y está especificado con noexcept(false) ([SWS_DM_01002]). Si las excepciones de C++ están desactivadas en la cadena de herramientas del compilador, esta función no participa en la resolución de sobrecargas ([SWS_DM_01002]).

Concurrencia y seguridad frente a errores

La función está definida como segura para subprocesos (thread-safe) ([SWS_DM_01002]). En cuanto a la seguridad frente a excepciones, está clasificada como no segura frente a excepciones (not exception safe), ya que el lanzamiento de la excepción constituye la semántica principal de la operación ([SWS_DM_01002]).

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

El método forma parte del enfoque uniforme de tratamiento de errores en AUTOSAR Adaptive Diagnostics. Se han especificado interfaces similares con firma y semántica idénticas para dominios de error de diagnóstico adicionales:

• ara::diag::DiagErrorDomain ([SWS_DM_00523], AUTOSAR_AP_SWS_Diagnostics §8.11.3.2.2.3 „ThrowAsException“)
• ara::diag::DiagOfferErrorDomain ([SWS_DM_00995], AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 „ThrowAsException“)
• ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00535], AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 „ThrowAsException“)
• ara::diag::DiagSovdErrorDomain ([SWS_DM_01815], AUTOSAR_AP_SWS_Diagnostics §8.51.3.2.2.3 „ThrowAsException“)