clase ara::fw::FwErrorDomain

El alias de tipo Errc está definido, conforme a [AP_SWS_Fw_83007], como un alias para la enumeración de códigos de error FwErrc (using Errc = FwErrc;). El elemento está declarado en el ámbito de la clase ara::fw::FwErrorDomain y debe incluirse mediante el archivo de cabecera ara/fw/fw_error_domain.h [AP_SWS_Fw_83007].

En lo relativo a su uso, Errc no representa una invocación de función ejecutable y, por lo tanto, no dispone de parámetros, valores de retorno ni de semántica síncrona o asíncrona [AP_SWS_Fw_83007]. Más bien proporciona un identificador uniforme para la enumeración de las causas de error específicas del dominio. Interpretación: Es de prever que el alias ofrezca a los desarrolladores un acceso simplificado y coherente a los valores de la enumeración de FwErrc dentro de ara::fw::FwErrorDomain para tipificar y consultar estados de error [AP_SWS_Fw_83007]. Pregunta Q-bd8949830961e459 (abierta)

Dado que se trata de un constructo exclusivo de tiempo de compilación, no existen restricciones en tiempo de ejecución relativas a reentrancia, seguridad para subprocesos u órdenes de invocación [AP_SWS_Fw_83007]. Los valores de error específicos o las vinculaciones con notificaciones de DET o DEM no están predeterminados en el elemento de especificación y se rigen por los valores de la enumeración subyacente [AP_SWS_Fw_83007].

El constructor por defecto FwErrorDomain() está declarado como eliminado ([AP_SWS_Fw_83009]). Por lo tanto, en el código de aplicación queda excluida la instanciación directa de objetos de la clase ara::fw::FwErrorDomain mediante este constructor. Interpretación: la eliminación probablemente garantice que el dominio de errores se gestione exclusivamente como un singleton. Pregunta Q-54f7bc341f074e2c (abierta)

Para el uso del dominio de errores está disponible la función libre GetFwErrorDomain() ([AP_SWS_Fw_83002]). Esta devuelve de forma segura para hilos (thread-safe) una referencia al objeto de dominio existente de tipo ara::core::ErrorDomain. A través de esta referencia se pueden utilizar las interfaces del dominio:

• Consulta del nombre del dominio de errores mediante Name() ([AP_SWS_Fw_83010]).
• Determinación de textos descriptivos para códigos de error mediante Message() ([AP_SWS_Fw_83011]).
• Disparo de excepciones mediante ThrowAsException() ([AP_SWS_Fw_83012]), donde el alias Exception remite a FwException ([AP_SWS_Fw_83008]).

Los códigos de error correspondientes se definen mediante la enumeración FwErrc ([AP_SWS_Fw_83001]), la cual también está disponible dentro de la clase a través del alias Errc ([AP_SWS_Fw_83007]). Los valores válidos son kServiceNotAvailable, así como kInvalidStateDependentFirewall. Por lo tanto, los desarrolladores no deben crear instancias propias, sino utilizar siempre la referencia global.

Uso y semántica

La función miembro Name de la clase ara::fw::FwErrorDomain sirve para obtener el identificador del dominio de error [AP_SWS_Fw_83010]. La invocación se realiza de forma síncrona y requiere la inclusión del archivo de cabecera ara/fw/fw_error_domain.h [AP_SWS_Fw_83010]. La función no toma parámetros de entrada y devuelve un puntero de tipo const char * que representa el nombre del dominio [AP_SWS_Fw_83010]. Es de prever que el retorno consista en una cadena terminada en nulo cuya validez está ligada a la vida útil del dominio de error. Pregunta Q-6bd465d82e79a682 (abierta)

Manejo de errores

El método está declarado con el identificador noexcept [AP_SWS_Fw_83010]. En consecuencia, no lanza excepciones y no prevé códigos de error específicos ni retornos de error [AP_SWS_Fw_83010].

Concurrencia y restricciones

Según la especificación, la función está clasificada como segura para subprocesos (thread-safe) [AP_SWS_Fw_83010]. Dado que se trata de una función miembro constante (const), el acceso no modifica el estado de la instancia y puede invocarse de forma segura y concurrente desde diferentes contextos de ejecución [AP_SWS_Fw_83010]. Según la especificación, no existen condiciones previas ni requisitos de orden especiales [AP_SWS_Fw_83010].

usar

La función miembro Message de la clase ara::fw::FwErrorDomain se declara a través del archivo de cabecera ara/fw/fw_error_domain.h y sirve para la recuperación síncrona de un mensaje de error [AP_SWS_Fw_83011]. Al invocarla, el llamante transfiere un código de error errorCode de tipo CodeType. Como valor de retorno, la función devuelve un puntero de tipo const char * a la cadena de caracteres asignada al código de error [AP_SWS_Fw_83011]. La función sobrescribe como override la interfaz correspondiente de la clase base [AP_SWS_Fw_83011].

Concurrencia y seguridad para subprocesos

La especificación define Message expresamente como thread-safe [AP_SWS_Fw_83011]. Por lo tanto, los llamantes pueden invocar el método en paralelo para la misma instancia desde diferentes subprocesos sin medidas de sincronización adicionales. Debido a la calificación como método const, el estado del dominio de error no se modifica con la invocación [AP_SWS_Fw_83011].

Tratamiento de errores y condiciones límite

Debido a su declaración como noexcept, el método garantiza que no se lanzarán excepciones de C++ [AP_SWS_Fw_83011]. En el elemento no se definen códigos de error específicos ni valores de error para códigos que no se puedan resolver [AP_SWS_Fw_83011]. Presumiblemente, el puntero devuelto apunta a una cadena de caracteres inmutable y asignada estáticamente, por lo que no existe ninguna obligación de gestión de memoria para el llamante. Pregunta Q-2e98884ffd517367 (abierta)

La función miembro ThrowAsException de la clase ara::fw::FwErrorDomain sirve para instanciar y desencadenar una FwException a partir de un código de error errorCode transferido [AP_SWS_Fw_83012]. La función se incluye a través del archivo de cabecera ara/fw/fw_error_domain.h y toma una referencia constante a ara::core::ErrorCode como único parámetro [AP_SWS_Fw_83012]. No tiene valor de retorno (void) y está declarada con const así como con override [AP_SWS_Fw_83012].

Mediante la cláusula de especificación noexcept(false) se define explícitamente que se permite lanzar excepciones al invocar el método; la función genera y lanza de manera determinista una FwException para el caso de error correspondiente [AP_SWS_Fw_83012]. En cuanto a la seguridad frente a excepciones, el método está clasificado como not exception safe [AP_SWS_Fw_83012]. Por lo tanto, el código llamante debe estar preparado para que la excepción resultante interrumpa el flujo de control regular y requiere las disposiciones correspondientes para el manejo de excepciones.

En cuanto a la concurrencia, el método está especificado como thread-safe, con lo que se permite una invocación simultánea desde varios subprocesos [AP_SWS_Fw_83012]. Mediante la palabra clave override, el método presumiblemente sobrescribe la función de interfaz homónima de un dominio de error de nivel superior [AP_SWS_Fw_83012]. Pregunta Q-aae02c046243335c (abierta)