clase ara::exec::ExecErrorDomain

El constructor por defecto ExecErrorDomain() inicializa una nueva instancia del dominio de errores ara::exec::ExecErrorDomain según [SWS_EM_02286]. La llamada se realiza de forma síncrona, no recibe parámetros y no tiene valor de retorno. La declaración se incluye a través de la cabecera ara/exec/exec_error_domain.h.

En lo que respecta a la robustez y concurrencia, el constructor está declarado como noexcept, se considera seguro frente a excepciones (exception safe) y está especificado como plenamente seguro para subprocesos (thread-safe) [SWS_EM_02286]. No se requiere ningún tratamiento de errores durante la creación del objeto, ya que la operación se ejecuta sin errores y no desencadena códigos de error ni excepciones.

En el sistema global, el objeto creado sirve para representar y describir errores específicos de módulo de Execution Management. A través de la instancia se puede consultar el nombre del dominio [SWS_EM_02287], determinar mensajes textuales para códigos de error [SWS_EM_02288] o lanzar errores como excepciones de C++ [SWS_EM_02289]. Rara vez debería ser necesaria una instanciación explícita mediante este constructor en módulos de aplicación, ya que a través de la función libre GetExecErrorDomain() ya se proporciona una referencia global a la instancia [SWS_EM_02290]. Pregunta Q-df8efc87e6547216 (abierta)

El método Message es una función miembro virtual de la clase ara::exec::ExecErrorDomain dentro del clúster funcional Execution Management [SWS_EM_02288]. Se incluye a través del archivo de encabezado ara/exec/exec_error_domain.h y sobrescribe la interfaz correspondiente para la obtención de mensajes de error textuales [SWS_EM_02288].

El uso se articula de la siguiente manera:

• Llamada y semántica: La llamada se realiza de forma síncrona y está concebida como una operación de lectura (const) [SWS_EM_02288].
• Parámetros: Como parámetro de entrada se pasa errorCode del tipo CodeType, el cual representa el identificador numérico del error [SWS_EM_02288].
• Valor de retorno: La función devuelve un puntero de tipo const char * al mensaje de error asociado al código de error [SWS_EM_02288]. Interpretación: Es de suponer que este puntero apunta a una cadena de caracteres estática, de modo que no se requiere liberación de memoria por parte del emisor de la llamada. Pregunta Q-3e254e008a07294e (abierta)

Con respecto al tratamiento de errores, la función está declarada como noexcept y especificada como exception safe [SWS_EM_02288]. La propia función no lanza excepciones de C++. En la especificación no se contemplan códigos de error propios ni canales de notificación para llamadas erróneas [SWS_EM_02288].

En lo referente a la concurrencia, el método está clasificado como thread-safe [SWS_EM_02288]. Puesto que no modifica el estado del dominio de errores, puede llamarse de forma segura en paralelo desde múltiples subprocesos sin mecanismos de sincronización externa [SWS_EM_02288].

usar

La función miembro Name de la clase ara::exec::ExecErrorDomain devuelve de forma síncrona un puntero a una constante basada en caracteres (const char *), la cual designa el dominio de errores [SWS_EM_02287]. El retorno se rige por la definición para ara::exec::ExecErrorDomain de [SWS_CORE_90023]. El método se incluye a través del encabezado ara/exec/exec_error_domain.h, no espera parámetros de transferencia y opera como función miembro constante sobre instancias del dominio de errores [SWS_EM_02287].

Tratamiento de errores y concurrencia

La interfaz está declarada como noexcept y, por lo tanto, clasificada como completamente segura ante excepciones (exception safe) [SWS_EM_02287]. No se devuelven códigos de error ni se lanzan excepciones. En cuanto al acceso concurrente, la función está especificada como segura para subprocesos (thread-safe) [SWS_EM_02287]. En consecuencia, las llamadas se pueden ejecutar en paralelo desde diferentes subprocesos sin medidas de sincronización adicionales.

Interacción

Mediante la declaración como override, la función implementa la interfaz general para la consulta del nombre del dominio en el marco de [SWS_CORE_90023]. La cadena de caracteres devuelta sirve probablemente para identificar el dominio de errores de forma legible e inequívoca en salidas de registro o diagnóstico [SWS_EM_02287]. Pregunta Q-ae1f9de8510d7ff9 (abierta)

El método ThrowAsException del dominio de errores ara::exec::ExecErrorDomain sirve para lanzar de forma síncrona una excepción de C++ sobre la base de un código de error ocurrido [SWS_EM_02289]. Recibe como parámetro de entrada una referencia a errorCode (tipo const ara::core::ErrorCode &), instancia a partir de ella un objeto de excepción del tipo ExecException y lo lanza inmediatamente como una excepción de C++ [SWS_EM_02289]. La función no devuelve ningún valor de retorno.

En cuanto al comportamiento de errores y en tiempo de ejecución, deben tenerse en cuenta los siguientes aspectos:

• Seguridad ante excepciones: Dado que el comportamiento previsto de la función consiste en lanzar una excepción, está anotada con noexcept(false) y clasificada formalmente como no segura ante excepciones (not exception safe) [SWS_EM_02289]. Por tanto, los emisores de la llamada deben estar preparados para capturar o tratar ExecException.
• Concurrencia: La especificación identifica a la función miembro como segura para subprocesos (thread-safe) [SWS_EM_02289]. Por lo tanto, se puede llamar de forma segura desde subprocesos concurrentes.
• Limitaciones de la toolchain: Según [SWS_CORE_10304], ThrowAsException no participa en la resolución de sobrecargas si las excepciones de C++ están desactivadas en la toolchain del compilador [SWS_EM_02289]. En consecuencia, esta llamada no está disponible en entornos sin soporte para excepciones.