classe ara::crypto::CryptoErrorDomain

Utilização e contexto de chamada

O construtor padrão CryptoErrorDomain() inicializa uma instância do domínio de erro para operações criptográficas [SWS_CRYPT_19902]. Ele é especificado como constexpr e noexcept, não recebe argumentos e não possui valor de retorno. A execução ocorre de forma síncrona e pode ocorrer em tempo de compilação. Em programas de aplicação, uma instanciação manual dificilmente deve ser necessária, visto que o acesso ao domínio ocorre regularmente através da função global GetCryptoErrorDomain() [SWS_CRYPT_19952]. Pergunta Q-1e029d80fb7bf7d1 (aberta)

Tratamento de erros e simultaneidade

A criação do objeto é definida como exception safe bem como thread-safe [SWS_CRYPT_19902]. Como o construtor é declarado com noexcept, não ocorrem erros ou exceções durante a chamada; mensagens de erro para DET ou DEM não existem para este construtor.

Interação no módulo

O domínio gerado constitui o contexto para descrições de erros criptográficos:

• Ele encapsula os códigos de erro da enumeração CryptoErrc [SWS_CRYPT_10099] por meio do alias de tipo Errc [SWS_CRYPT_19903].
• Por meio da função livre MakeErrorCode(), são criadas instâncias de ara::core::ErrorCode que referenciam firmemente este domínio [SWS_CRYPT_19951].
• As funções-membro do domínio permitem a consulta do identificador via Name() [SWS_CRYPT_19950], a resolução de texto via Message() [SWS_CRYPT_19953] bem como o lançamento de erros específicos do sistema via ThrowAsException() [SWS_CRYPT_19954] com o tipo base Exception [SWS_CRYPT_19904].

O método Message da classe ara::crypto::CryptoErrorDomain traduz um valor de código de erro em uma mensagem de erro em texto simples legível [SWS_CRYPT_19953]. Ele substitui o método base para resolução de texto de erro e é incluído por meio do arquivo de cabeçalho ara/crypto/common/crypto_error_domain.h [SWS_CRYPT_19953]. Além disso, a interface está vinculada tecnicamente ao requisito RS_CRYPTO_02310 [SWS_CRYPT_19953].

Utilização e contexto de chamada

A chamada ocorre sincronicamente como uma função-membro constante (const), fazendo com que o método opere sem estado e o objeto do domínio de erro permaneça inalterado [SWS_CRYPT_19953]. A função espera o seguinte parâmetro de entrada [SWS_CRYPT_19953]:

• errorCode: Um identificador numérico de código de erro da enumeração CryptoErrc, que é passado como tipo ara::core::ErrorDomain::CodeType [SWS_CRYPT_19953].

Como valor de retorno, a função fornece um ponteiro para uma cadeia de caracteres constante (const char *), que contém o texto descritivo da mensagem para o respectivo código de erro [SWS_CRYPT_19953].

Simultaneidade e segurança contra exceções

Em relação à segurança de execução e à simultaneidade, aplicam-se as seguintes condições de contorno [SWS_CRYPT_19953]:

• Segurança de threads: A função é explicitamente especificada como segura para threads (thread-safe), sendo admissíveis chamadas concorrentes a partir de diferentes threads sem sincronização externa [SWS_CRYPT_19953].
• Segurança contra exceções: O método é classificado como seguro contra exceções (exception safe) e fornecido com o especificador noexcept, razão pela qual é garantido que nenhuma exceção de C++ será lançada [SWS_CRYPT_19953].

A função-membro Name da classe ara::crypto::CryptoErrorDomain retorna o identificador exclusivo do domínio de erros para operações criptográficas [SWS_CRYPT_19950]. A função é disponibilizada por meio do arquivo de cabeçalho ara/crypto/common/crypto_error_domain.h e substitui a interface base correspondente para domínios de erro [SWS_CRYPT_19950].

Utilização e semântica

A chamada ocorre de forma síncrona, sem parâmetros e sem efeitos colaterais modificadores sobre a instância. Como valor de retorno, é fornecido um const char *, que representa o nome exclusivo do domínio [SWS_CRYPT_19950]. Interpretação: o ponteiro retornado deve apontar para uma cadeia de caracteres persistida estaticamente, uma vez que a interface não prevê ciclo de vida dinâmico ou transferência de propriedade de memória. Pergunta Q-b7f2dab65f25b7e6 (aberta)

Tratamento de erros e simultaneidade

• Segurança contra exceções: O método é declarado com noexcept e definido como seguro contra exceções (exception safe), de modo que os chamadores não precisam capturar exceções de C++ [SWS_CRYPT_19950].
• Sinalização de erros: Não há códigos de erro específicos especificados para a função; a recuperação do nome não falha em operação regular [SWS_CRYPT_19950].
• Segurança de threads: A operação é especificada como thread-safe e pode ser executada concorrentemente a partir de múltiplas threads sem mecanismos de bloqueio externos [SWS_CRYPT_19950].

Interação

Dentro do modelo de tratamento de erros do AUTOSAR Adaptive, a função serve para identificar o domínio de erro durante a avaliação e o registro em log das causas de erros criptográficos [SWS_CRYPT_19950].

O método ThrowAsException da classe ara::crypto::CryptoErrorDomain serve para lançar uma exceção C++ com base em um código de erro fornecido [SWS_CRYPT_19954]. Ele substitui o método base correspondente e é declarado com o atributo [[noreturn]], razão pela qual as chamadas não possuem valor de retorno e não retornam regularmente em caso de execução bem-sucedida [SWS_CRYPT_19954].

Em relação ao uso e à parametrização, aplicam-se os seguintes detalhes de especificação:

• Parâmetro: Como parâmetro de entrada, é passado errorCode do tipo const ara::core::ErrorCode&, que encapsula um identificador de erro da enumeração CryptoErrc [SWS_CRYPT_19954].
• Inclusão de cabeçalho: A função é disponibilizada por meio do arquivo de cabeçalho #include "ara/crypto/common/crypto_error_domain.h" [SWS_CRYPT_19954].
• Simultaneidade: A execução é especificada como thread-safe e, portanto, pode ser chamada com segurança a partir de contextos concorrentes [SWS_CRYPT_19954].

Em relação ao tratamento de erros e à segurança contra exceções, o método é classificado como not exception safe [SWS_CRYPT_19954]. Uma restrição importante de compilador e toolchain decorre de [SWS_CORE_10304]: se as exceções C++ estiverem desativadas na toolchain do compilador, ThrowAsException não participará da resolução de sobrecarga e, portanto, não estará disponível para o chamador [SWS_CRYPT_19954].