classe ara::fw::FwException

A classe ara::fw::FwException representa o tipo de exceção C++ especializado para a API do Firewall da AUTOSAR Adaptive Platform e deriva de ara::core::Exception. Ela serve para encapsular e transportar um ara::core::ErrorCode a fim de transmitir estados de erro graves a componentes chamadores [AP_SWS_Fw_83005]. A instanciação ocorre por meio do cabeçalho ara/fw/fw_error_domain.h mediante um construtor explícito declarado como noexcept [AP_SWS_Fw_83005]. Como condição de contorno central, a classe garante uma construção thread-safe, permitindo que erros sejam sinalizados de forma confiável também em contextos de execução simultâneos.

mais ›

Contexto

A classe ara::fw::FwException representa o tipo de exceção C++ dedicado para a interface do Firewall (Firewall API) da AUTOSAR Adaptive Platform. Conforme sua definição de interface, ela herda publicamente da classe base ara::core::Exception. Dentro da arquitetura do módulo fw, ela serve para encapsular situações de erro que ocorrem durante a execução sob a forma de uma exceção e propagá-las além dos limites de chamada para camadas funcionais superiores. A classe e seu construtor são declarados por meio do cabeçalho ara/fw/fw_error_domain.h [AP_SWS_Fw_83005]. O tipo ara::core::ErrorCode atua como parceiro central de interação, mapeando o contexto concreto de erro e o domínio de erro do Firewall.

Ciclo de vida

O ciclo de vida de uma instância de ara::fw::FwException começa com a inicialização explícita mediante a passagem de um objeto ara::core::ErrorCode para o construtor [AP_SWS_Fw_83005]. Como o construtor é declarado como explicit, conversões implícitas de tipo a partir de códigos de erro são impedidas [AP_SWS_Fw_83005]. Pela marcação com noexcept, garante-se que a própria criação do objeto de exceção não falhe em momento algum nem dispare exceções secundárias [AP_SWS_Fw_83005]. Além disso, o padrão especifica a construção expressamente como thread-safe (thread-safe) [AP_SWS_Fw_83005], permitindo que instâncias de exceção sejam criadas sem sincronização adicional mesmo em contextos de execução simultâneos da aplicação Adaptive. A destruição do objeto ocorre automaticamente no fim do respectivo bloco de tratamento após a captura da exceção, de acordo com as regras padrão do C++.

Caminho de utilização

Um caminho de uso típico descreve o reconhecimento de um erro interno dentro da API do Firewall, o encapsulamento da causa e o tratamento subsequente no nível do usuário. Como o Adaptive AUTOSAR foca primariamente no tratamento de erros baseado em valores por meio de objetos de resultado, ara::fw::FwException deve ser lançada presumivelmente sobretudo quando há um caso de exceção grave ou quando APIs baseadas em exceções são acionadas. Pergunta Q-4a8d1c1d5359c469 (aberta)

Diagrama de sequência: fluxo típico de tratamento de erro e de tratamento de exceção com FwException. Fontes: [AP_SWS_Fw_83005] AP_SWS_Fw_83005

O fluxo típico se desenvolve nas seguintes etapas:

• Detecção do erro: um serviço da API do Firewall identifica uma operação inválida e gera um objeto ara::core::ErrorCode correspondente.
• Criação da exceção: por meio do construtor [AP_SWS_Fw_83005], uma nova instância de ara::fw::FwException é instanciada de forma thread-safe com este código de erro.
• Disparo da exceção: a exceção é sinalizada para o contexto de execução mediante throw.
• Captura e avaliação: a aplicação chamadora captura ara::fw::FwException e lê o código de erro contido para análise do erro ou recuperação.

Cenários de erro

Cenários de erro no uso de ara::fw::FwException dizem respeito prioritariamente à validade lógica dos dados de erro fornecidos e à ausência de um tratamento adequado de exceções. Como a construção da classe de exceção é especificada como noexcept, não existem fontes internas de erro durante a própria instanciação [AP_SWS_Fw_83005]. Como pré-condição, o local chamador deve assegurar que seja fornecido um ara::core::ErrorCode semanticamente correto, que descreva adequadamente a causa do erro de Firewall ocorrida [AP_SWS_Fw_83005]. Se uma ara::fw::FwException lançada não for capturada por nenhum manipulador correspondente na pilha de chamadas subsequente, isto leva inevitavelmente, segundo a semântica padrão do C++, à chamada de std::terminate e, consequentemente, ao encerramento do processo.