estrutura ara::com::FindServiceHandle

A estrutura ara::com::FindServiceHandle serve como um token de controlo exclusivo para comandar uma monitorização de serviços em execução em segundo plano (AUTOSAR_AP_EXP_ARAComAPI p. 34). Uma vez que o construtor predefinido foi eliminado ([SWS_CM_00353]), o handle é gerado exclusivamente por StartFindService e permite, após a receção de callbacks assíncronos de estado, o cancelamento direcionado da pesquisa através de StopFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30). Os operadores de comparação suportados garantem, além disso, a gestão armazenável de múltiplos pedidos de pesquisa em contentores padrão ([SWS_CM_11526], [SWS_CM_11527]).

mais ›

Contexto

A estrutura ara::com::FindServiceHandle atua no módulo com da Adaptive Platform como identificador exclusivo e token de controlo para uma pesquisa de serviços assíncrona e contínua. Enquanto uma consulta síncrona via FindService determina instâncias de serviço correspondentes de forma pontual e devolve diretamente contentores de handles, StartFindService inicia uma monitorização permanente da disponibilidade do serviço em segundo plano (AUTOSAR_AP_EXP_ARAComAPI p. 34). Neste processo participam tipicamente a instância da aplicação, a classe proxy específica do tipo (por exemplo, RadarServiceProxy) e uma função de callback definida pelo utilizador do tipo FindServiceHandler (AUTOSAR_AP_EXP_ARAComAPI p. 30). A representação interna concreta de ara::com::FindServiceHandle é desenhada de forma específica da implementação para o respetivo Communication Management, mas disponibiliza interfaces C++ normalizadas para a manipulação.

Ciclo de vida

O ciclo de vida de um ara::com::FindServiceHandle está estritamente associado ao processo de pesquisa ativo no Communication Management:

• Criação: o construtor predefinido está explicitamente eliminado ([SWS_CM_00353]). Deste modo, uma aplicação não pode criar instâncias de handle não inicializadas ou arbitrariamente. Em vez disso, um handle válido é gerado exclusivamente como payload de um ara::core::Result através do método estático StartFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30).
• Gestão e posse: um handle suporta a atribuição através do operador de atribuição por cópia [SWS_CM_11528]. Para permitir à aplicação o armazenamento e a organização de múltiplos pedidos de pesquisa em contentores padrão (tais como conjuntos ordenados ou contentores associativos), o tipo cumpre os conceitos de C++ [equalitycomparable] e [lessthancomparable] através dos operadores operator== ([SWS_CM_11526]) e operator< ([SWS_CM_11527]).
• Terminação e destruição: o handle mantém a sua validade enquanto a monitorização em segundo plano estiver ativa. A conclusão da pesquisa efetua-se mediante a transmissão do handle para StopFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34). Após esta chamada, o handle já não representa nenhum processo de pesquisa em execução.

Caminho de utilização

O fluxo regular abrange o registo do pedido de pesquisa, a receção contínua de atualizações de disponibilidade e a paragem ordenada do processo de monitorização:

1. Início da pesquisa: a aplicação regista um FindServiceHandler através de StartFindService para ser informada sobre instâncias de serviço recentemente disponíveis ou descontinuadas (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34).
2. Obtenção do handle: em caso de arranque bem-sucedido, a chamada devolve um ara::core::Result com o FindServiceHandle (AUTOSAR_AP_EXP_ARAComAPI p. 30), que a aplicação guarda para chamadas de controlo posteriores.
3. Notificação assíncrona: o Communication Management executa a pesquisa em segundo plano e, no caso de alterações de estado, invoca o manipulador disponibilizado (AUTOSAR_AP_EXP_ARAComAPI p. 34).
4. Paragem da pesquisa: assim que as instâncias forem encontradas ou a monitorização já não for necessária, a aplicação passa o handle para StopFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34).

Diagrama de sequência: sequência típica da pesquisa assíncrona de serviços desde o registo, passando pelas notificações, até ao cancelamento via FindServiceHandle. Fontes: AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34.

Cenários de erro

Na utilização de ara::com::FindServiceHandle, devem ser tidas em conta as seguintes condições de contorno específicas do sistema:

• Início de pesquisa falhado: caso as vinculações técnicas não estejam disponíveis ou a configuração de deployment de serviço esteja incorreta (AUTOSAR_AP_EXP_ARAComAPI p. 34), StartFindService falha. O ara::core::Result devolvido não contém, neste caso, um handle válido, mas sim um código de erro (AUTOSAR_AP_EXP_ARAComAPI p. 30).
• Segurança contra exceções: os operadores de comparação e de atribuição implementados operator== ([SWS_CM_11526]), operator< ([SWS_CM_11527]) e operator= ([SWS_CM_11528]) são explicitamente declarados na especificação como não seguros contra exceções (not exception safe).
• Paragem múltipla: uma chamada repetida de StopFindService com o mesmo handle presumivelmente não terá efeito ou provocará um erro em tempo de execução, dado que a atividade de monitorização subjacente já foi removida. Pergunta Q-f44130c33fa1caea (aberta)