classe ara::shwa::ShwaErrorDomain

A classe ara::shwa::ShwaErrorDomain disponibiliza o domínio de erros específico do módulo para o módulo shwa e associa códigos de erro a descrições, bem como a tipos de exceção associados [AP_SWS_SHWA_01305]. Além da consulta textual de nomes de domínios e mensagens de erro, ela oferece, através de ThrowAsException(), a possibilidade de lançar erros de forma direcionada como exceção [AP_SWS_SHWA_01310]. Os métodos de inspeção estão declarados como seguros para threads e seguros contra exceções.

mais ›

Contexto

A classe ara::shwa::ShwaErrorDomain representa o domínio de erros específico para o módulo shwa na Adaptive Platform e deriva da classe base ara::core::ErrorDomain. Ela funciona como elemento de ligação central para a identificação unívoca, nomeação e descrição textual de causas de erro específicas do módulo. Tipicamente, o domínio de erros interage estreitamente com instâncias de ara::core::ErrorCode, bem como com o respetivo tratamento de exceções via ShwaException. Através de aliases de tipo, a classe disponibiliza uma associação direta aos tipos de erro específicos do módulo: Errc remete para ShwaErrorCode [AP_SWS_SHWA_01305] e Exception para ShwaException [AP_SWS_SHWA_01306].

Diagrama de contexto: incorporação de ShwaErrorDomain na interação com códigos de erro, exceções e a lógica da aplicação. Fontes: [AP_SWS_SHWA_01305], [AP_SWS_SHWA_01306], [AP_SWS_SHWA_01310]

Ciclo de vida

A instanciação de ShwaErrorDomain é realizada através do construtor padrão ShwaErrorDomain(), o qual está declarado como noexcept e assegura tanto Thread Safety como Exception Safety [AP_SWS_SHWA_01307]. Como representante de um domínio de erros no modelo de tratamento de erros da AUTOSAR Adaptive, tal instância é habitualmente mantida com vida longa (interpretação: presumivelmente como objeto singleton estático ou global) para comparar contextos de erro de forma recorrente. Pergunta Q-82cb2e14793eeaef (aberta) À exceção do lançamento de exceções, todos os métodos de leitura da instância são seguros para threads e não lançam exceções.

Caminho de utilização

No fluxo de processamento regular, aquando da ocorrência de um erro específico do módulo, um componente gera um ara::core::ErrorCode sob referência ao domínio de erros. Para saída de texto ou registo em log, o utilizador chama o método Name() para determinar o identificador do domínio de erros [AP_SWS_SHWA_01308], ou faz com que lhe seja fornecida, por meio de Message(errorCode), a descrição de erro pertencente ao código numérico [AP_SWS_SHWA_01309]. Caso um código de erro deva ser transferido para o caminho de exceção C++, a lógica chamadora aciona ThrowAsException() [AP_SWS_SHWA_01310].

Diagrama de sequência: fluxo típico na consulta de erros e conversão numa exceção. Fontes: [AP_SWS_SHWA_01308], [AP_SWS_SHWA_01309], [AP_SWS_SHWA_01310]

Cenários de erro

Os próprios domínios de erro servem para a classificação de erros e estão concebidos de forma amplamente tolerante a falhas nas suas funções de inspeção. Tanto Name() [AP_SWS_SHWA_01308] como Message() [AP_SWS_SHWA_01309] estão especificados como noexcept e exception-safe, de modo que, mesmo no caso de códigos de erro desconhecidos, é fornecido um ponteiro definido para uma cadeia de caracteres (interpretação: presumivelmente um texto estático de aviso ou de placeholder). O único cenário de erro com lançamento explícito é constituído pelo método ThrowAsException(errorCode) [AP_SWS_SHWA_01310]: ele está declarado com noexcept(false) como «not exception safe», uma vez que a sua finalidade primária consiste no lançamento direcionado de uma exceção do tipo Exception (ShwaException) [AP_SWS_SHWA_01306]. Pergunta Q-03a63539b08ddb73 (aberta)