clase ara::phm::PhmErrorDomain

La función miembro Message de la clase ara::phm::PhmErrorDomain devuelve, para un número de error errorCode pasado de tipo CodeType, una descripción textual del mensaje de error asociado como const char * [SWS_PHM_01249]. La función se proporciona mediante el archivo de cabecera ara/phm/phm_error_domain.h y, al ser un método virtual (override), sobrescribe el comportamiento de interfaz estándar para la resolución de errores [SWS_PHM_01249].

Para el contexto de invocación y la semántica de ejecución son aplicables las siguientes definiciones:

• Ejecución síncrona y tratamiento de excepciones: La llamada se efectúa de forma síncrona y está declarada como noexcept; además, el método está especificado como exception safe, por lo que no se lanzan excepciones durante la ejecución [SWS_PHM_01249].
• Concurrencia: La función está declarada explícitamente como thread-safe y puede llamarse de manera segura desde subprocesos concurrentes sin sincronización externa adicional [SWS_PHM_01249].
• Gestión de memoria: Interpretación: Es probable que el puntero a caracteres devuelto haga referencia a un literal de caracteres estático, por lo que el invocador no necesita realizar ninguna liberación de memoria. Pregunta Q-dcdc593e3f9ded45 (abierta)

En Platform Health Management (PHM), el método sirve para traducir códigos de error numéricos de PhmErrorDomain a cadenas de caracteres legibles por humanos para fines de registro o diagnóstico [SWS_PHM_01249].

La función miembro Name de la clase ara::phm::PhmErrorDomain devuelve el nombre del dominio de error como cadena de caracteres ([SWS_PHM_01248]). La declaración está integrada en el módulo phm a través del archivo de cabecera #include "ara/phm/phm_error_domain.h" ([SWS_PHM_01248]).

Para el uso práctico y el comportamiento en tiempo de ejecución se aplican las siguientes prescripciones:

• Uso y firma: El método posee la firma const char * Name () const noexcept override; ([SWS_PHM_01248]). Se ejecuta de forma síncrona y no espera parámetros de entrada. El puntero devuelto de tipo const char * se ajusta a las prescripciones para ara::phm::PhmErrorDomain de [SWS_CORE_90023].
• Tratamiento de errores: La función está declarada como noexcept y presenta el nivel de seguridad frente a excepciones exception safe ([SWS_PHM_01248]). No lanza excepciones en tiempo de ejecución ni genera mensajes de error.
• Concurrencia: El método está especificado como seguro para subprocesos (thread-safe) ([SWS_PHM_01248]). Se pueden realizar llamadas paralelas entre la misma instancia o distintas instancias sin mecanismos de sincronización adicionales.

En la interacción arquitectónica, la operación sobrescribe la consulta virtual de nombre de la interfaz superior del dominio de error y proporciona el nombre específico para ara::phm::PhmErrorDomain de acuerdo con [SWS_CORE_90023] ([SWS_PHM_01248]).

El constructor predeterminado PhmErrorDomain() sirve para crear una instancia del dominio de error ara::phm::PhmErrorDomain [SWS_PHM_01247]. La llamada se efectúa de forma síncrona y sin parámetros de entrada a través de la cabecera ara/phm/phm_error_domain.h [SWS_PHM_01247].

En cuanto a la seguridad en la ejecución, la construcción está especificada como exception safe y declarada con noexcept, de modo que no se desencadenan excepciones [SWS_PHM_01247]. Además, la instanciación es segura para subprocesos (thread-safe) [SWS_PHM_01247].

El dominio creado forma el contexto para errores de PHM, proporciona funciones miembro como Name() [SWS_PHM_01248], Message() [SWS_PHM_01249] y ThrowAsException() [SWS_PHM_01250], y define los alias de tipo Errc [SWS_PHM_01245] y Exception [SWS_PHM_01246]. Para el acceso regular al dominio de error se dispone de la función libre GetPhmDomain(), que devuelve una referencia al objeto global [SWS_PHM_01251]. Por consiguiente, es probable que en el código de aplicación no se requiera de forma típica una instanciación manual por separado a través del constructor. Pregunta Q-63be3bb534ef1fa9 (abierta)

usar

La función miembro ThrowAsException es un método de la clase de dominio de error ara::phm::PhmErrorDomain y se proporciona a través del archivo de cabecera ara/phm/phm_error_domain.h ([SWS_PHM_01250]). Su propósito consiste en lanzar de forma síncrona aquella excepción de C++ que esté vinculada con el código de error transmitido ([SWS_PHM_01250]). Para ello, la función toma como parámetro de entrada una referencia al objeto de error errorCode de tipo const ara::core::ErrorCode & ([SWS_PHM_01250]). Dado que el flujo de control continúa a través de la excepción en caso de ejecución errónea, el método no tiene valor de retorno (void) ([SWS_PHM_01250]).

Concurrencia y seguridad de ejecución

En lo que respecta al comportamiento en llamadas paralelas, ThrowAsException está declarada como thread-safe ([SWS_PHM_01250]). Por lo tanto, puede invocarse de forma segura y concurrente desde múltiples subprocesos. Respecto a la seguridad frente a excepciones, en cambio, la interfaz está clasificada expresamente en la especificación como «not exception safe» ([SWS_PHM_01250]).

Restricciones del compilador y resolución de sobrecarga

[SWS_CORE_10304] define una condición de contorno esencial para el uso: Si las excepciones de C++ están desactivadas en la cadena de herramientas del compilador utilizada, ThrowAsException no participa en la resolución de sobrecarga ([SWS_PHM_01250]). Por lo tanto, en compilaciones de software para plataformas o configuraciones sin soporte de excepciones, la función no está disponible para el compilador para la resolución de sobrecarga ([SWS_PHM_01250]).