namespace ara::com::runtime

O namespace ara::com::runtime fornece serviços centrais de tempo de execução para a resolução de endpoints de comunicação no gerenciamento de comunicação AUTOSAR_AP_SWS_CommunicationManagement p. 39. Sua função principal ResolveInstanceIDs traduz identificadores abstratos de modelo do tipo ara::core::InstanceSpecifier em ara::com::InstanceIdentifierContainer concretos, utilizáveis por proxies e skeletons [SWS_CM_00118]. Se o mapeamento de um identificador formalmente válido falhar no deployment, a função segura contra exceções retorna o código de erro ComErrc::kInstanceIDNotResolvable dentro de um ara::core::Result. Os chamadores devem, portanto, avaliar o objeto Result antes da instanciação do serviço.

mais ›

Contexto

O namespace ara::com::runtime disponibiliza funcionalidades centrais de tempo de execução para o gerenciamento de comunicação (ara::com) da AUTOSAR Adaptive Platform AUTOSAR_AP_SWS_CommunicationManagement p. 39. Sua principal responsabilidade funcional reside no desacoplamento da arquitetura abstrata de software da infraestrutura concreta de comunicação em tempo de execução. Enquanto aplicações e componentes de software são vinculados a portas em suas interfaces por meio de identificadores abstratos de modelo (ara::core::InstanceSpecifier), o middleware de comunicação necessita de dados concretos de endereçamento e instanciação na forma de objetos ara::com::InstanceIdentifier para o estabelecimento de conexões [SWS_CM_00118].

A função ResolveInstanceIDs, declarada no cabeçalho ara/com/runtime.h, forma a ponte entre esses dois níveis de abstração [SWS_CM_00118]. Ela recebe um ara::core::InstanceSpecifier e o transforma em um ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement p. 40. Interpretação: O mapeamento concreto baseia-se internamente, provavelmente, nas configurações de manifesto e de deployment armazenadas no contexto de execução, mantendo o código da aplicação portátil e livre de endereços de rede ou de protocolo codificados diretamente no código. Pergunta Q-8fab6de1c39a065a (aberta)

Diagrama de contexto: Enquadramento de ara::com::runtime entre a arquitetura da aplicação e o deployment de comunicação. Fontes: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 39.

Caminho de utilização

O uso típico do namespace ara::com::runtime ocorre durante a fase de inicialização e inicialização de uma aplicação adaptativa, antes que relações de comunicação sejam estabelecidas por meio de service proxies ou service skeletons AUTOSAR_AP_SWS_CommunicationManagement p. 41. Um service consumer ou provider percorre, com isso, um caminho determinístico de resolução:

• Determinar o especificador: a aplicação instancia ou referencia o identificador do tipo ara::core::InstanceSpecifier definido para a respectiva porta de comunicação.
• Resolver instâncias: o identificador é passado para a função ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
• Verificar o resultado: a chamada retorna um objeto do tipo ara::core::Result<ara::com::InstanceIdentifierContainer>, que é verificado quanto a uma execução bem-sucedida ou estados de erro [SWS_CM_00118].
• Processar o contentor: em caso de sucesso, o ara::com::InstanceIdentifierContainer contém um número de identificadores de instância que é proporcional ao número de ocorrências encontradas no deployment [SWS_CM_00118]. A aplicação pode selecionar especificamente uma instância ou iterar sobre todas as instâncias disponíveis.
• Instanciar proxy ou skeleton: os objetos ara::com::InstanceIdentifier resolvidos são subsequentemente utilizados para criar instâncias concretas de proxy ou skeleton AUTOSAR_AP_SWS_CommunicationManagement p. 42.

Diagrama de sequência: fluxo de chamada e processamento da resolução de instâncias via ResolveInstanceIDs. Fontes: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 41.

Cenários de erro

As interfaces no namespace ara::com::runtime seguem o paradigma de tratamento de erros robusto e livre de exceções de toda a plataforma. De acordo com a especificação, ResolveInstanceIDs está declarado como noexcept e possui o nível de segurança contra exceções exception safe [SWS_CM_00118]. Por conseguinte, os erros nunca são sinalizados através de exceções C++, sendo integralmente transportados através da mónada de erro ara::core::Result AUTOSAR_AP_SWS_CommunicationManagement p. 47.

O cenário de erro central especificado diz respeito ao código de erro ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Este erro ocorre quando o ara::core::InstanceSpecifier transmitido é formalmente válido, mas não pode ser associado a nenhum ara::com::InstanceIdentifier existente na configuração atual do sistema ou no manifesto [SWS_CM_00118]. Na prática, isto aponta para discrepâncias entre a modelação e o deployment, por exemplo, se um fornecedor de serviços não tiver sido implementado noutra máquina ou se a vinculação (binding) estiver em falta no manifesto. Para este erro aplica-se a semântica de reversão (rollback_semantics): não são criados estados parciais nem vinculados recursos, de modo que o chamador pode verificar a configuração ou transitar para um estado de erro definido [SWS_CM_00118].