classe {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton

A classe serve como classe base do lado do servidor para a implementação de uma Service-Interface em ara::com, da qual a aplicação fornecedora do serviço deriva. Na criação, define-se através do construtor se as chamadas de métodos recebidas são processadas de forma orientada a eventos ou por polling [SWS_CM_00130]. Em métodos declarados como seguros contra exceções, fluxos com erro são sinalizados através do ara::core::Future retornado como código de erro [SWS_CM_00191].

mais ›

Contexto

A classe {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton serve na Adaptive Platform, no módulo com, como classe base abstrata gerada para a disponibilização do lado do servidor de uma Service-Interface. Um componente fornecedor de serviço específico da aplicação deriva desta classe skeleton para implementar a lógica de negócio funcional do serviço. A classe intermedeia entre a aplicação fornecedora de serviço concreta e o middleware de comunicação ou o binding de protocolo subjacente, tal como SOME/IP (SWS CommunicationManagement §8.1 «Method invocation»). Entre os parceiros de interação encontram-se a aplicação fornecedora de serviço, que cria e possui a instância, a própria classe skeleton, bem como a infraestrutura de comunicação, que recebe pedidos de serviço recebidos, os desserializa e os encaminha para o skeleton ([SWS_CM_10306], [SWS_CM_10307]).

Diagrama de contexto: interação entre a aplicação fornecedora de serviço, ServiceSkeleton e o middleware de comunicação. Fontes: [SWS_CM_10306], [SWS_CM_10307], SWS CommunicationManagement §8.1 «Method invocation».

Ciclo de vida

A criação da instância de skeleton é realizada através do construtor, ao qual é passado o modo de processamento pretendido ara::com::MethodCallProcessingMode [SWS_CM_00130]. Este modo define a estratégia de concorrência para chamadas de métodos recebidas: se kEvent ou kEventSingleThread for configurado, as chamadas de métodos recebidas são invocadas diretamente de forma orientada a eventos pelo middleware de comunicação [SWS_CM_10306]. Se, em vez disso, for passado kPoll, o processamento ocorre com base em polling pela aplicação [SWS_CM_10307]. Interpretação: é provável que a instância de skeleton permaneça na posse da aplicação fornecedora de serviço durante toda a disponibilização ativa do serviço e só seja destruída aquando da desativação do serviço. Pergunta Q-ce25321f79393024 (aberta)

Caminho de utilização

O fluxo típico compreende a implementação dos métodos puramente virtuais pela classe fornecedora derivada e a execução posterior aquando da chegada de pedidos. Para chamadas de métodos regulares (request-response), o skeleton define uma interface que retorna um ara::core::Future com o respetivo objeto de saída [SWS_CM_00191], [SWS_CM_99556]. Para métodos fire-and-forget sem resposta de retorno, o skeleton disponibiliza operações puramente virtuais com o tipo de retorno void [SWS_CM_90434]. Em caso de pedidos recebidos, o middleware de comunicação desserializa os dados úteis e encaminha a chamada para a implementação concreta da classe skeleton de acordo com o modo de processamento configurado ([SWS_CM_10306], [SWS_CM_00191]).

Diagrama de sequência: fluxo de uma chamada de método através do skeleton. Fontes: [SWS_CM_00191], [SWS_CM_10306], SWS CommunicationManagement §8.1 «Method invocation».

Cenários de erro

Tanto os métodos request-response como os métodos fire-and-forget estão anotados com noexcept ao nível da interface e declarados como seguros contra exceções ([SWS_CM_00191], [SWS_CM_90434]). Erros no processamento de chamadas de métodos regulares não são transmitidos através de exceções C++; em vez disso, o ara::core::Future retornado transporta, em caso de erro, um código de erro correspondente do tipo ara::com::ComErrc ou um ApApplicationError [SWS_CM_00191]. Para métodos fire-and-forget, não estão previstos, segundo a especificação, valores de retorno nem códigos de erro padronizados [SWS_CM_90434].