classe ara::diag::DiagOfferException

A classe ara::diag::DiagOfferException serve como um tipo de exceção C++ específico lançado por classes de diagnóstico da AUTOSAR Adaptive Platform para sinalização de erros ([SWS_DM_00985]). Ela deriva de ara::core::Exception e é instanciada de forma thread-safe por meio de um construtor noexcept, especificando um ara::core::ErrorCode ([SWS_DM_00986]). A exceção presumivelmente deve ocorrer primariamente em falhas na disponibilização de serviços de diagnóstico e deve ser interceptada pela aplicação chamadora para evitar o encerramento descontrolado do processo. Pergunta (aberta)

mais ›

Contexto

A classe ara::diag::DiagOfferException é um tipo central de exceção do módulo de diagnóstico dentro da AUTOSAR Adaptive Platform ([SWS_DM_00985], SWS Diagnostics §8.11.6 «Class: DiagOfferException»). De acordo com sua especificação, trata-se de uma exceção lançada por classes de diagnóstico ("Exception type thrown by Diag classes"). A classe deriva publicamente da classe base ara::core::Exception e deve ser incluída em aplicações por meio do cabeçalho ara/diag/diag_error_domain.h ([SWS_DM_00986]).

Entre os principais parceiros de interação estão as classes funcionais do gerenciamento de diagnóstico, a arquitetura de erros subjacente da AUTOSAR Adaptive (representada por ara::core::ErrorCode) e o software de aplicação que oferece serviços de diagnóstico. O nome da classe sugere que esta exceção presumivelmente é empregada quando o oferecimento ou o registro de serviços de diagnóstico por classes Diag correspondentes falha (interpretação). Pergunta Q-47046201c9fd38c3 (aberta)

Ciclo de vida

A instanciação de ara::diag::DiagOfferException ocorre por meio de seu único construtor especificado explicit DiagOfferException(ara::core::ErrorCode err) noexcept ([SWS_DM_00986], SWS Diagnostics §8.11.6.1.1.1 «DiagOfferException»). Com isso, a exceção é vinculada diretamente a um código de erro concreto. Como o construtor é declarado como noexcept, é garantido que nenhum erro adicional ou exceção recursiva ocorra durante a própria criação do objeto de exceção ([SWS_DM_00986]).

Quanto ao ciclo de vida, a classe está sujeita aos mecanismos usuais de tratamento de exceções de C++: ela é alocada na memória de exceções do ambiente de execução, transportada pela pilha de chamadas e liberada automaticamente após a conclusão do bloco catch de tratamento. De acordo com a especificação, a construção é thread-safe e exception-safe ([SWS_DM_00986]). O objeto de exceção não possui transições internas complexas de estado após sua criação; presume-se que atue como um invólucro de transporte imutável para o código de erro fornecido (interpretação). Pergunta Q-09c6e0ad610717e9 (aberta)

Caminho de utilização

O fluxo típico durante o uso de ara::diag::DiagOfferException divide-se nas seguintes fases:

• Uma aplicação chama um método de uma classe de diagnóstico para disponibilizar um serviço ou porta de diagnóstico (operação offer).
• A classe de diagnóstico identifica uma condição de erro durante a inicialização ou registro e instancia um ara::core::ErrorCode adequado.
• A classe de diagnóstico constrói uma instância de ara::diag::DiagOfferException passando esse código de erro ([SWS_DM_00986]) e lança essa exceção.
• O software de aplicação chamador intercepta a exceção no âmbito de um bloco try-catch.
• O chamador extrai o código de erro da exceção e aciona estratégias adequadas de contingência ou repetição.

Diagrama de sequência: fluxo típico na sinalização e no tratamento de um erro por meio de DiagOfferException. Fontes: [SWS_DM_00985], [SWS_DM_00986].

Cenários de erro

ara::diag::DiagOfferException serve, por si só, como mecanismo de sinalização para situações de erro. Como pré-requisito para a instanciação, a instância chamadora deve dispor de um ara::core::ErrorCode válido ([SWS_DM_00986]). Como o construtor é definido como noexcept, a instanciação não causa exceções secundárias em hipótese alguma ([SWS_DM_00986]).

Se uma DiagOfferException lançada não for interceptada pelo software de aplicação, isso causará por padrão a chamada de std::terminate e, com isso, a queda descontrolada do processo. Devido à herança de ara::core::Exception, presume-se que esteja previsto que, além da interceptação específica de ara::diag::DiagOfferException, um manipulador genérico para ara::core::Exception também possa atuar (interpretação), visando garantir uma tolerância a falhas robusta no nível do processo. Pergunta Q-d0cf602a077c4dae (aberta)