namespace ara::nm

O namespace ara::nm fornece, com NetworkHandle, interfaces para o acesso controlado ao status de rede solicitado e efetivo da AUTOSAR Adaptive Platform. Possíveis situações de erro no fluxo operacional são mapeadas por meio dos códigos de erro padronizados da enumeração NmErrc, como kServiceNotAvailable ou kInvalidHandler [SWS_ANM_01111]. Para o tratamento estruturado de erros, MakeErrorCode gera códigos de erro de forma segura para threads para o domínio de erro NmErrorDomain, que é referenciado via GetNmDomain [SWS_ANM_01109]. As aplicações devem considerar a acessibilidade do serviço de Network Management antes de chamadas, para evitar falhas em consultas de status.

mais ›

Contexto

O namespace ara::nm fornece na AUTOSAR Adaptive Platform as interfaces centrais para o Network Management funcional. A interface funcional primária é formada pela classe NetworkHandle, que encapsula o acesso controlado tanto ao status de rede solicitado quanto ao efetivo. Por meio desse mecanismo de abstração, aplicações funcionais e serviços de plataforma podem monitorar o estado operacional atual da rede de comunicação subjacente e iniciar alterações de status.

Para um tratamento de erros consistente e robusto, ara::nm fornece tipos padronizados e funções auxiliares integrados à arquitetura de erros da AUTOSAR Adaptive. Fazem parte disso o domínio de erro NmErrorDomain, a classe de exceção NmException e a enumeração específica de domínio NmErrc [SWS_ANM_01111]. Adicionalmente, estão disponíveis as funções seguras para threads GetNmDomain [SWS_ANM_01109] e MakeErrorCode [SWS_ANM_01110], que garantem a manipulação de estados de erro em conformidade com a instanciação e os tipos.

Diagrama de contexto: interação entre a aplicação, o NetworkHandle e a arquitetura de erros em ara::nm. Fontes: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Caminho de utilização

Num cenário de utilização típico, uma Adaptive Application interage com o namespace ara::nm para controlar o estado da rede e reagir a eventos de tempo de execução. A sequência de interação divide-se nos seguintes passos:

• Iniciar o acesso ao estado: a aplicação utiliza um NetworkHandle para consultar o estado de rede solicitado ou o atualmente efetivo.
• Deteção de erros: se o pedido de rede não puder ser atendido corretamente, a interface sinaliza um evento de erro correspondente. Interpretação: no caso de falhas dos serviços de rede subjacentes, o NetworkHandle deverá gerar internamente códigos de erro com base em NmErrc. Pergunta Q-97b1567be5e28121 (aberta)
• Gerar código de erro: a função auxiliar MakeErrorCode [SWS_ANM_01110] recebe um valor de NmErrc [SWS_ANM_01111], bem como dados adicionais específicos da aplicação (ara::core::ErrorDomain::SupportDataType), e gera a partir deles um ara::core::ErrorCode completo. A função está especificada como constexpr e noexcept e garante total segurança de threads [SWS_ANM_01110].
• Verificar o domínio de erro: o componente chamador pode obter, através de GetNmDomain [SWS_ANM_01109], uma referência segura para threads para a NmErrorDomain global, a fim de verificar o domínio de erro do código retornado e resolver descrições de erro específicas do domínio.

Diagrama de sequência: fluxo da consulta do estado da rede e resolução de erros através de ara::nm. Fontes: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Cenários de erro

Os códigos de erro normalizados do módulo estão reunidos na enumeração NmErrc, que se baseia em ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. O módulo distingue os seguintes casos de erro:

• NmErrc::kServiceNotAvailable (código 1): este erro indica que o serviço necessário para a gestão de rede não está acessível ou operacional em tempo de execução [SWS_ANM_01111]. Neste caso, os chamadores têm de reagir com novas tentativas ou estratégias de contingência.
• NmErrc::kInvalidHandler (código 2): ocorre quando, numa operação, foi passado ou referenciado um manipulador inválido ou não registado [SWS_ANM_01111]. Isto aponta geralmente para um erro de configuração ou de inicialização no chamador.

As pré-condições para chamadas robustas são uma infraestrutura de serviços inicializada, bem como parâmetros válidos no acesso a NetworkHandle, para evitar NmErrc::kServiceNotAvailable ou NmErrc::kInvalidHandler [SWS_ANM_01111]. Nenhuma das funções centrais de tratamento de erros, tais como MakeErrorCode [SWS_ANM_01110] e GetNmDomain [SWS_ANM_01109], lança exceções por si própria (noexcept). Interpretação: para aplicações que preferem uma estrutura de controlo baseada em exceções, a classe de exceção NmException deverá atuar como portadora para propagar estados de erro de forma estruturada através da pilha de chamadas. Pergunta Q-67a17c37021e8beb (aberta)