clase ara::diag::DiagOfferErrorDomain

El constructor por defecto sin parámetros [SWS_DM_00992] sirve para crear una instancia de la clase ara::diag::DiagOfferErrorDomain (SWS Diagnostics §8.11.5 «Class: DiagOfferErrorDomain»). Está declarado mediante el archivo de cabecera ara/diag/diag_error_domain.h y posee la signatura constexpr DiagOfferErrorDomain() noexcept; (SWS Diagnostics §8.11.5.2.1.1 «Default Constructor»). La llamada se efectúa de forma síncrona, no procesa parámetros de entrada y, característicamente para un constructor, no devuelve ningún valor de retorno [SWS_DM_00992].

En relación con la concurrencia y la seguridad frente a fallos, la función está especificada como thread-safe así como exception safe [SWS_DM_00992]. Mediante la especificación noexcept se garantiza que durante la ejecución no se lancen excepciones [SWS_DM_00992]. No están previstos códigos de error específicos ni notificaciones a través de DET o DEM para este constructor.

En el contexto del módulo, el dominio representa estados de error relativos a servicios de diagnóstico cuyos códigos de error están definidos en la enumeración DiagOfferErrc [SWS_DM_00559] y pueden referenciarse a través del alias de tipo Errc [SWS_DM_00990]. La clase proporciona métodos estándar como Name() [SWS_DM_00993], Message() [SWS_DM_00994] y ThrowAsException() [SWS_DM_00995]. En casos de aplicación, una llamada directa al constructor raramente debería ser necesaria (interpretación), ya que con la función ara::diag::GetDiagOfferDomain() ya se encuentra disponible una referencia global a la instancia [SWS_DM_01003], la cual es utilizada, entre otros, por ara::diag::MakeErrorCode() [SWS_DM_01005]. Pregunta Q-a98886da9b649096 (abierta)

La función miembro síncrona Message de la clase ara::diag::DiagOfferErrorDomain sirve para traducir un código de error numérico a un mensaje de texto descriptivo [SWS_DM_00994]. Los desarrolladores integran la interfaz a través del archivo de cabecera ara/diag/diag_error_domain.h [SWS_DM_00994].

Para el uso y el contexto de llamada se aplican las siguientes directrices:

• Parámetros y valor de retorno: A la función se le pasa el valor de error que se va a consultar como ara::core::ErrorDomain::CodeType errorCode. Devuelve un puntero a una cadena de caracteres constante (const char*) que, según la especificación, nunca es nullptr [SWS_DM_00994].
• Seguridad frente a errores y excepciones: La función está declarada como noexcept y especificada como exception safe, de modo que no lanza excepciones de C++ [SWS_DM_00994]. Los códigos de error desconocidos o no válidos probablemente se asignen a mensajes estándar predefinidos para cumplir con la garantía de puntero no nulo. Pregunta Q-73eb1822df6a995d (abierta)
• Concurrencia: La operación está declarada como método const y clasificada explícitamente como thread-safe, por lo que se permiten llamadas concurrentes desde múltiples subprocesos sin sincronización externa [SWS_DM_00994].

El método sobrescribe una interfaz base y sigue el patrón uniforme de mensajes de error del módulo de diagnóstico, que de manera análoga también se utiliza en otros dominios de error como ara::diag::DiagErrorDomain [SWS_DM_00522], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00534], ara::diag::DiagReportingErrorDomain [SWS_DM_01001] y ara::diag::DiagSovdErrorDomain [SWS_DM_01814].

El método Name() de la clase ara::diag::DiagOfferErrorDomain sirve para determinar de forma síncrona el nombre corto unívoco del dominio de error ([SWS_DM_00993]). Está disponible a través del archivo de cabecera ara/diag/diag_error_domain.h y sobrescribe el método base para la identificación de dominios en el framework Adaptive ([SWS_DM_00993]).

Uso y semántica:

• Contexto de llamada y parámetros: La llamada se realiza de forma síncrona, sin parámetros y sin condiciones previas directamente en la instancia de ara::diag::DiagOfferErrorDomain ([SWS_DM_00993]).
• Valor de retorno: La función devuelve un const char* que representa el identificador ApApplicationErrorDomain.SN del dominio de error ([SWS_DM_00993]). Interpretación: el puntero devuelto probablemente apunte a una cadena de caracteres estática e inmutable que permanece válida durante todo el tiempo de ejecución del programa. Pregunta Q-86836b3715182080 (abierta)
• Tratamiento de errores: El método está declarado como noexcept y especificado como exception safe ([SWS_DM_00993]). No notifica códigos de error ni lanza excepciones.
• Concurrencia: La ejecución está clasificada como thread-safe ([SWS_DM_00993]), de modo que se permiten llamadas paralelas desde múltiples subprocesos sin sincronización externa.

Interacción: El comportamiento corresponde al patrón arquitectónico general para dominios de error en Diagnostic Management. Existen métodos Name() especificados de forma idéntica para dominios afines como ara::diag::DiagErrorDomain ([SWS_DM_00521]), ara::diag::DiagUdsNrcErrorDomain ([SWS_DM_00533]), ara::diag::DiagReportingErrorDomain ([SWS_DM_01000]) así como ara::diag::DiagSovdErrorDomain ([SWS_DM_01813]).

La función miembro ThrowAsException del dominio de error ara::diag::DiagOfferErrorDomain sirve, según [SWS_DM_00995], para convertir un código de error pasado de tipo ara::core::ErrorCode en una excepción de C++ correspondiente y lanzarla (AUTOSAR_AP_SWS_Diagnostics §8.11.5.2.2.3 «ThrowAsException»).

En cuanto a la semántica y el diseño de la interfaz, se aplican las siguientes propiedades:

• Llamada y parámetros: El método recibe una referencia constante a una instancia de ara::core::ErrorCode, no tiene valor de retorno (void) y está declarado con noexcept(false), ya que por definición lanza una excepción [SWS_DM_00995].
• Restricción de compilación: Según [SWS_CORE_10304], la función no participa en la resolución de sobrecargas (overload resolution) si las excepciones de C++ están desactivadas en la cadena de herramientas del compilador [SWS_DM_00995].
• Seguridad y concurrencia: La función está especificada como thread-safe, por lo que se permiten llamadas paralelas a través de los límites de los subprocesos; sin embargo, está designada explícitamente como not exception safe [SWS_DM_00995].
• Interacción: El concepto corresponde al modelo de error estandarizado para dominios de error de diagnóstico, tal como también está implementado de forma análoga en ara::diag::DiagErrorDomain [SWS_DM_00523], ara::diag::DiagReportingErrorDomain [SWS_DM_01002], ara::diag::DiagUdsNrcErrorDomain [SWS_DM_00535] así como ara::diag::DiagSovdErrorDomain [SWS_DM_01815]. La definición se incluye a través del archivo de cabecera #include "ara/diag/diag_error_domain.h" [SWS_DM_00995].

Debido a la clasificación como not exception safe, es probable que no intervenga ninguna protección interna adicional contra errores dentro del método durante el proceso de lanzamiento en el contexto del sistema (interpretación: los desarrolladores deben capturar las excepciones en el contexto de la aplicación llamadora). Pregunta Q-72152cb488c24026 (abierta)