clase ara::crypto::CryptoErrorDomain

Uso y contexto de llamada

El constructor predeterminado CryptoErrorDomain() inicializa una instancia del dominio de errores para operaciones criptográficas [SWS_CRYPT_19902]. Está especificado como constexpr y noexcept, no toma argumentos y no tiene valor de retorno. La ejecución se realiza de forma síncrona y puede tener lugar en tiempo de compilación. En programas de aplicación, es probable que rara vez sea necesaria una instanciación manual, ya que el acceso al dominio se realiza de forma habitual mediante la función global GetCryptoErrorDomain() [SWS_CRYPT_19952]. Pregunta Q-1e029d80fb7bf7d1 (abierta)

Tratamiento de errores y concurrencia

La creación del objeto está definida como exception safe así como thread-safe [SWS_CRYPT_19902]. Puesto que el constructor está declarado con noexcept, no se producen errores ni excepciones durante la llamada; no existen mensajes de error a DET o DEM para este constructor.

Interacción en el módulo

El dominio creado forma el contexto para las descripciones de errores criptográficos:

• Encapsula los códigos de error de la enumeración CryptoErrc [SWS_CRYPT_10099] mediante el alias de tipo Errc [SWS_CRYPT_19903].
• A través de la función libre MakeErrorCode() se crean instancias de ara::core::ErrorCode que hacen referencia de forma fija a este dominio [SWS_CRYPT_19951].
• Las funciones miembro del dominio permiten consultar el identificador mediante Name() [SWS_CRYPT_19950], resolver el texto a través de Message() [SWS_CRYPT_19953] y lanzar errores específicos del sistema mediante ThrowAsException() [SWS_CRYPT_19954] con el tipo base Exception [SWS_CRYPT_19904].

El método Message de la clase ara::crypto::CryptoErrorDomain traduce un valor de código de error en un mensaje de error legible en texto plano [SWS_CRYPT_19953]. Sobrescribe el método base para la resolución del texto de error y se incluye mediante el archivo de encabezado ara/crypto/common/crypto_error_domain.h [SWS_CRYPT_19953]. Además, la interfaz está vinculada funcionalmente con el requisito RS_CRYPTO_02310 [SWS_CRYPT_19953].

Uso y contexto de llamada

La llamada se realiza de forma síncrona como función miembro constante (const), por lo que el método opera sin estado y el objeto de dominio de error permanece inalterado [SWS_CRYPT_19953]. La función espera el siguiente parámetro de entrada [SWS_CRYPT_19953]:

• errorCode: Un identificador numérico de código de error de la enumeración CryptoErrc, que se pasa como tipo ara::core::ErrorDomain::CodeType [SWS_CRYPT_19953].

Como valor de retorno, la función proporciona un puntero a una cadena de caracteres constante (const char *), que contiene el texto de mensaje descriptivo correspondiente al código de error respectivo [SWS_CRYPT_19953].

Concurrencia y seguridad frente a excepciones

Con respecto a la seguridad de ejecución y la concurrencia se aplican las siguientes condiciones de contorno [SWS_CRYPT_19953]:

• Seguridad para hilos: La función está especificada explícitamente como segura para hilos (thread-safe), por lo que se permiten llamadas concurrentes desde distintos hilos sin sincronización externa [SWS_CRYPT_19953].
• Seguridad frente a excepciones: El método está clasificado como seguro frente a excepciones (exception safe) y dotado del especificador noexcept, por lo que se garantiza que no se lanzarán excepciones de C++ [SWS_CRYPT_19953].

La función miembro Name de la clase ara::crypto::CryptoErrorDomain proporciona el identificador unívoco del dominio de error para operaciones criptográficas [SWS_CRYPT_19950]. La función se proporciona a través del archivo de encabezado ara/crypto/common/crypto_error_domain.h y sobrescribe la interfaz base correspondiente para dominios de error [SWS_CRYPT_19950].

Uso y semántica

La llamada se realiza de forma síncrona, sin parámetros y sin efectos secundarios modificadores sobre la instancia. Como valor de retorno se devuelve un const char *, que representa el nombre unívoco del dominio [SWS_CRYPT_19950]. Interpretación: Es de esperar que el puntero devuelto apunte a una cadena de caracteres persistida estáticamente, ya que la interfaz no prevé un ciclo de vida dinámico ni una transferencia de la propiedad de la memoria. Pregunta Q-b7f2dab65f25b7e6 (abierta)

Tratamiento de errores y concurrencia

• Seguridad frente a excepciones: El método está declarado con noexcept y definido como seguro frente a excepciones (exception safe), de modo que los llamantes no tienen que capturar excepciones de C++ [SWS_CRYPT_19950].
• Señalización de errores: No se especifican códigos de error específicos para la función; la recuperación del nombre no falla en funcionamiento regular [SWS_CRYPT_19950].
• Seguridad para hilos: La operación está especificada como thread-safe y puede ejecutarse concurrentemente desde varios hilos sin mecanismos de bloqueo externos [SWS_CRYPT_19950].

Interacción

Dentro del modelo de tratamiento de errores de AUTOSAR Adaptive, la función sirve para identificar el dominio de error durante la evaluación y el registro de causas de error criptográficas [SWS_CRYPT_19950].

El método ThrowAsException de la clase ara::crypto::CryptoErrorDomain sirve para lanzar una excepción de C++ sobre la base de un código de error proporcionado [SWS_CRYPT_19954]. Sobrescribe el método base correspondiente y está declarado con el atributo [[noreturn]], por lo que las llamadas no poseen valor de retorno y, en caso de ejecución correcta, no retornan de forma regular [SWS_CRYPT_19954].

Con respecto al uso y la parametrización se aplican los siguientes detalles de especificación:

• Parámetros: Como parámetro de entrada se pasa errorCode del tipo const ara::core::ErrorCode&, que encapsula un identificador de error de la enumeración CryptoErrc [SWS_CRYPT_19954].
• Inclusión de encabezado: La función se proporciona a través del archivo de encabezado #include "ara/crypto/common/crypto_error_domain.h" [SWS_CRYPT_19954].
• Concurrencia: La ejecución está especificada como segura para hilos y, por tanto, puede llamarse de forma segura desde contextos concurrentes [SWS_CRYPT_19954].

En lo relativo al tratamiento de errores y a la seguridad frente a excepciones, el método está clasificado como not exception safe [SWS_CRYPT_19954]. Una restricción esencial del compilador y de la cadena de herramientas se deriva de [SWS_CORE_10304]: si las excepciones de C++ están deshabilitadas en la cadena de herramientas del compilador, ThrowAsException no participa en la resolución de sobrecargas y, por tanto, no está disponible para el llamante [SWS_CRYPT_19954].