classe ara::diag::DoIPGroupIdentification

A classe ara::diag::DoIPGroupIdentification serve como interface abstrata para aplicações Adaptive, de modo a disponibilizar ao Diagnostic Management o estado atual da identificação de grupo DoIP [SWS_DM_00724]. Após a instanciação específica da porta, a aplicação ativa o reencaminhamento de pedidos através de Offer() e termina-o antes da destruição do objeto através de StopOffer() [SWS_DM_00725]. A instância do gestor é única, não é copiável nem movível e responde a consultas assincronamente através de um ara::core::Future.

mais ›

Contexto

A classe ara::diag::DoIPGroupIdentification disponibiliza a interface funcional do Diagnostic Management (AUTOSAR AP SWS Diagnostics p. 73), através da qual uma aplicação Adaptive fornece o estado atual de identificação de grupo (estado de GID) para o protocolo DoIP [SWS_DM_00724]. Na arquitetura da plataforma, a classe atua como intermediária entre dois parceiros de interação primários: o daemon interno do Diagnostic Management (DM), que processa mensagens estandardizadas de identificação de veículos e de DoIP através da rede, e a implementação específica da aplicação, que concretiza o método puramente virtual GetGidStatus(). A disponibilização e a receção de pedidos são controladas através de ofertas explícitas de serviços [SWS_DM_00725].

Ciclo de vida

Uma instância de DoIPGroupIdentification representa uma porta de diagnóstico única. Por esta razão, a classe foi concebida como um objeto de gestão única: tanto o construtor de cópia [SWS_DM_01641] e o construtor de movimentação [SWS_DM_01642] como os respetivos operadores de atribuição [SWS_DM_01639], [SWS_DM_01640] foram explicitamente eliminados (=delete).

A criação ocorre obrigatoriamente através do construtor parametrizado mediante a especificação de um ara::core::InstanceSpecifier bem como do modo de concorrência ConcurrencyType [SWS_DM_00722]. O ciclo de vida divide-se nas seguintes fases:

• Não oferecido (Not Offered): Após a construção, o objeto existe no espaço de endereçamento do processo, mas ainda não recebe solicitações do DM.
• Oferecido (Offered): Por meio da chamada síncrona de Offer() [SWS_DM_00725], o manipulador é ativado no DM, de modo que as solicitações de status DoIP recebidas sejam encaminhadas.
• Parado (Stopped): A chamada de StopOffer() [SWS_DM_00726] retira a autorização de encaminhamento do DM e faz a transição do objeto de volta para o estado inativo.

A destruição ocorre por meio do destruidor virtual ~DoIPGroupIdentification() [SWS_DM_00723]. Em relação à concorrência, o construtor é thread-safe, enquanto Offer(), StopOffer(), bem como o destruidor, não são thread-safe [SWS_DM_00722], [SWS_DM_00723], [SWS_DM_00725], [SWS_DM_00726]. A segurança de thread da função de consulta GetGidStatus() é definida condicionalmente pelo ConcurrencyType selecionado no construtor [SWS_DM_00724]. Interpretação: O destruidor deve encerrar implicitamente os encaminhamentos em andamento, caso StopOffer() não tenha sido chamado anteriormente. Pergunta Q-50d70fb679462321 (aberta)

Caminho de utilização

O uso típico compreende inicialização, ativação, processamento assíncrono e desativação:

1. Uma classe de diagnóstico concreta herda de ara::diag::DoIPGroupIdentification e implementa o método GetGidStatus() [SWS_DM_00724].
2. A aplicação cria o objeto com o InstanceSpecifier do PortPrototype configurado e define se GetGidStatus() pode ser chamado concorrentemente (kConcurrent) ou não (kNotConcurrent) [SWS_DM_00722].
3. Por meio de Offer(), a aplicação arma o manipulador para o Diagnostic Management [SWS_DM_00725].
4. Assim que chegam solicitações DoIP, o DM chama GetGidStatus(); a aplicação retorna o estado do GID de forma assíncrona via ara::core::Future<GidStatus> [SWS_DM_00724].
5. Antes de encerrar o serviço ou desligar o componente, a aplicação chama StopOffer() [SWS_DM_00726], seguido pela destruição do objeto [SWS_DM_00723].

Diagrama de sequência: Fluxo típico de instanciação, ativação, consulta de status e desativação. Fontes: [SWS_DM_00722], [SWS_DM_00724], [SWS_DM_00725], [SWS_DM_00726].

Cenários de erro

Ao utilizar DoIPGroupIdentification, condições de erro estão definidas nas fases de construção e disponibilização:

• Erros de modelo e de mapeamento (construtor): Se a instanciação falhar, são reportadas violações padronizadas [SWS_DM_00722]:
  • InstanceSpecifierMappingIntegrityViolation: O identificador não pode ser resolvido ou não faz referência a um protótipo de porta.
  • PortInterfaceMappingViolation: A porta referenciada não está tipada como DiagnosticDoIPGroupIdentificationInterface.
  • ProcessMappingViolation: Nenhum processo correspondente está associado ao contexto de execução no modelo.
  • InstanceSpecifierAlreadyInUseViolation: O identificador de porta especificado já está sendo utilizado por outra instância no processo em execução.
• Erros de disponibilização de serviço (Offer()): O método retorna um ara::core::Result<void>. Se o serviço já tiver sido oferecido com sucesso para este manipulador, a nova chamada falha com o código de erro DiagOfferErrc::kAlreadyOffered [SWS_DM_00725].
• Erro na consulta de status: A interface GetGidStatus() não especifica códigos de erro padronizados [SWS_DM_00724]; erros internos da aplicação devem ser mapeados por meio do objeto de resultado da future retornada.