clase ara::diag::DiagUdsNrcErrorDomain

El constructor por defecto sin parámetros inicializa una instancia del dominio de errores ara::diag::DiagUdsNrcErrorDomain de forma síncrona y sin parámetros de entrada [SWS_DM_00532]. Gracias a la calificación como constexpr, la instanciación ya puede tener lugar en tiempo de compilación AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.1.1 «Default Constructor». En la implementación práctica, sin embargo, es de prever que rara vez sea necesaria una instanciación manual directa de la clase de dominio [SWS_DM_00529] por parte del código de aplicación, ya que, por defecto, la referencia global se obtiene a través de la función GetDiagUdsNrcDomain() [SWS_DM_00536]. Pregunta Q-22c33afd620b536e (abierta)

En lo relativo a concurrencia y seguridad frente a excepciones, el constructor está especificado como thread-safe y exception safe [SWS_DM_00532]. Está declarado como noexcept y no lanza ninguna excepción por sí mismo. El dominio gestiona códigos de error del tipo de enumeración DiagUdsNrcErrc mediante el alias Errc [SWS_DM_00530], los cuales se generan mediante MakeErrorCode() [SWS_DM_00537]. Asimismo, la clase proporciona métodos como Name() [SWS_DM_00533], Message() [SWS_DM_00534] y ThrowAsException() [SWS_DM_00535] en el marco de DiagUdsNrcException [SWS_DM_00531].

En interacción con el Diagnostic Management, los errores de este dominio controlan el tratamiento de respuestas negativas. Si una interfaz ara::diag devuelve un error de DiagUdsNrcErrorDomain, el Diagnostic Server deriva a partir de ello una respuesta UDS negativa (NRC) con el valor del código de error en el rango válido de 0x01 a 0xFE [SWS_DM_02059], [SWS_DM_02060]. Si se produce un error de este tipo al consultar un elemento del entorno, el servidor evalúa la condición pertinente como no cumplida y emite un mensaje de registro y seguimiento (Log-and-Trace) [SWS_DM_00970].

usar

La función miembro sincrónica Message de la clase ara::diag::DiagUdsNrcErrorDomain convierte un código de error numérico en una cadena de caracteres legible [SWS_DM_00534]. Como parámetro se transfiere el valor de error errorCode de tipo ara::core::ErrorDomain::CodeType. La llamada devuelve un puntero constante (const char *) al mensaje correspondiente, garantizándose que el valor de retorno nunca sea nullptr [SWS_DM_00534].

Tratamiento de errores y concurrencia

El método está declarado como noexcept y garantiza una completa seguridad frente a excepciones (exception safe) [SWS_DM_00534]. No se lanzan excepciones. Incluso ante valores desconocidos o no válidos para errorCode, presumiblemente la implementación suministrará un mensaje alternativo estático, ya que se descarta explícitamente un puntero nulo [SWS_DM_00534]. Pregunta Q-e9724baf4aedc3ff (abierta) Además, la función está especificada como segura para hilos (thread-safe) y puede invocarse en paralelo desde varios hilos sin sincronización externa [SWS_DM_00534].

Interacción en Diagnostic Management

Dentro de Diagnostic Management, Message implementa la sobreescritura estandarizada de la resolución de mensajes de error específicamente para Negative Response Codes (NRC) de UDS [SWS_DM_00534]. Se corresponde con funciones equivalentes de otros dominios de errores de diagnóstico como DiagErrorDomain [SWS_DM_00522], DiagOfferErrorDomain [SWS_DM_00994], DiagReportingErrorDomain [SWS_DM_01001] y DiagSovdErrorDomain [SWS_DM_01814].

usar

La función miembro Name de la clase ara::diag::DiagUdsNrcErrorDomain devuelve el nombre corto (ApApplicationErrorDomain.SN) de este dominio de errores de diagnóstico específico [SWS_DM_00533]. La llamada se realiza de forma sincrónica y está declarada a través del encabezado ara/diag/diag_uds_nrc_error_domain.h. El método no recibe parámetros de entrada y devuelve un puntero de tipo const char * a una cadena de caracteres terminada en nulo [SWS_DM_00533].

Manejo de errores

La función está declarada como noexcept y posee la propiedad exception safe [SWS_DM_00533]. No lanza excepciones ni devuelve códigos de error. El fallo de la consulta no está previsto en el diseño de la interfaz, por lo que no existen mensajes de error diferenciados.

Concurrencia y restricciones

Según la especificación, Name está catalogada como thread-safe [SWS_DM_00533]. Puede invocarse en paralelo desde múltiples hilos de forma reentrante y sin mecanismos de sincronización externos. La cadena de caracteres referenciada probablemente represente datos asignados estáticamente, de modo que el puntero debería permanecer invariablemente válido durante toda la vida útil de la aplicación. Pregunta Q-d4a4d28af7a9c2df (abierta) No existen condiciones de orden especiales para la llamada.

Interacción

La operación implementa la consulta uniforme de nombres para dominios de errores de AUTOSAR Adaptive en el contexto de diagnóstico. Corresponde estructuralmente a las interfaces homónimas de dominios de errores afines como ara::diag::DiagErrorDomain::Name [SWS_DM_00521], ara::diag::DiagOfferErrorDomain::Name [SWS_DM_00993], ara::diag::DiagReportingErrorDomain::Name [SWS_DM_01000], así como ara::diag::DiagSovdErrorDomain::Name [SWS_DM_01813]. Sirve ante todo para identificar de forma legible los errores procedentes del entorno de NRC de UDS para clientes de diagnóstico o componentes de registro (logging).

La función miembro ara::diag::DiagUdsNrcErrorDomain::ThrowAsException sirve para transformar de forma sincrónica un error del dominio de errores de NRC de UDS en una excepción C++ [SWS_DM_00535]. Como parámetro se pasa la instancia errorCode de tipo const ara::core::ErrorCode&. La función carece de valor de retorno y lanza directamente el tipo de excepción asociado al código de error AUTOSAR_AP_SWS_Diagnostics §8.12.3.2.2.3 «ThrowAsException».

En lo concerniente al comportamiento de error y en tiempo de ejecución, el método está declarado con noexcept(false) y clasificado como no seguro frente a excepciones (not exception safe), ya que el lanzamiento de la excepción constituye su semántica primaria [SWS_DM_00535]. Para el contexto de llamada concurrente, la función está especificada como segura para hilos (thread-safe) [SWS_DM_00535].

En la integración y configuración del sistema rigen las siguientes condiciones y referencias de diseño:

• Restricción del compilador: Si las excepciones C++ están deshabilitadas en la cadena de herramientas del compilador, esta función no participa en la resolución de sobrecargas (overload resolution) según [SWS_CORE_10304] [SWS_DM_00535].
• Interacción con dominios de errores: El esquema idéntico para el lanzamiento de excepciones se implementa de manera uniforme en otros dominios de diagnóstico, como por ejemplo en DiagErrorDomain [SWS_DM_00523], DiagOfferErrorDomain [SWS_DM_00995], DiagReportingErrorDomain [SWS_DM_01002] y DiagSovdErrorDomain [SWS_DM_01815].