classe ara::fw::FirewallStateSwitchInterface

A classe template ara::fw::FirewallStateSwitchInterface serve no AUTOSAR Adaptive para a comutação entre diferentes estados de Firewall e os conjuntos de regras de filtragem associados. Após a criação thread-safe por meio de um ara::core::InstanceSpecifier [AP_SWS_Fw_82002], a transição de estado é iniciada assincronamente via SwitchFirewallState e monitorada por meio de um ara::core::Future<void> [AP_SWS_Fw_82008]. A classe impõe semântica pura de movimentação (move semantics) sem possibilidade de cópia, sendo que o destrutor e as operações de movimentação não são thread-safe e os erros são sinalizados assincronamente por meio da future.

mais ›

Contexto

A classe template ara::fw::FirewallStateSwitchInterface serve, dentro do cluster funcional fw (Firewall) da AUTOSAR Adaptive Platform, como a interface primária para alternar entre diferentes estados de Firewall. Por estado de Firewall, entende-se uma configuração definida de conjuntos de regras de filtragem que protegem o tráfego de rede. O parâmetro de template EnumT representa uma enumeração específica da aplicação de todos os estados de Firewall permitidos. Como parceiros de interação típicos, devem atuar instâncias de nível superior da plataforma, como um gerenciamento de modo (Mode Management), que adaptam as regras de filtragem a modos operacionais ou do veículo alterados. Pergunta Q-5424cd3802d53915 (aberta)

Ciclo de vida

A criação de uma instância ocorre explicitamente por meio do construtor, especificando-se um ara::core::InstanceSpecifier [AP_SWS_Fw_82002]. Esta etapa de construção é especificada como thread-safe. Por meio do InstanceSpecifier, resolve-se presumivelmente a associação concreta a uma instância de Firewall modelada no manifesto da plataforma. Pergunta Q-97db4416453c9885 (aberta)

A classe é declarada como final e implementa uma semântica pura de movimentação: o construtor de cópia [AP_SWS_Fw_82004] e o operador de atribuição por cópia [AP_SWS_Fw_82005] são excluídos (=delete), impedindo a duplicação. Em vez disso, são disponibilizados o construtor de movimentação [AP_SWS_Fw_82006] e o operador de atribuição por movimentação [AP_SWS_Fw_82007], ambos definidos como noexcept. Importante para a simultaneidade é que tanto o destrutor [AP_SWS_Fw_82003] quanto as operações de movimentação não são thread-safe. A aplicação chamadora deve, portanto, assegurar que operações de ciclo de vida e transferências de posse ocorram de forma local à thread ou sincronizada.

Caminho de utilização

O fluxo regular para comutação de conjuntos de regras divide-se nas seguintes etapas:

1. Inicialização: o objeto de interface é criado especificando-se o InstanceSpecifier de destino [AP_SWS_Fw_82002].
2. Solicitar comutação de estado: por meio do método SwitchFirewallState, passa-se o estado de destino desejado do tipo EnumT [AP_SWS_Fw_82008].
3. Aguardar confirmação assíncrona: o método retorna um ara::core::Future<void> [AP_SWS_Fw_82008]. Os chamadores podem resolver a future de forma bloqueante ou monitorá-la assincronamente até que a troca subjacente do conjunto de regras seja concluída.

Diagrama de sequência: fluxo típico da comutação assíncrona de estado. Fontes: [AP_SWS_Fw_82002], [AP_SWS_Fw_82008].

Cenários de erro

O método SwitchFirewallState é declarado com noexcept e não lança exceções C++ [AP_SWS_Fw_82008]. Erros na comutação são encapsulados no ara::core::Future<void> retornado. Os seguintes códigos de erro são especificados para a chamada [AP_SWS_Fw_82008]:

• FwErrc::kServiceNotAvailable: o serviço de Firewall responsável não está disponível ou não responde [AP_SWS_Fw_82008].
• FwErrc::kInvalidStateDependentFirewall: o estado solicitado é inválido para o Firewall referenciado ou não está previsto na configuração [AP_SWS_Fw_82008].

Como pré-condição para a comutação, aplica-se que o objeto de interface esteja validamente instanciado e exista uma conexão com o serviço de Firewall. Como pós-condição, em caso de sucesso, o novo conjunto de regras de filtragem está ativo, enquanto em caso de erro, o estado anterior permanece inalterado.