classe ara::com::ServiceVersionType

A classe ara::com::ServiceVersionType serve para a representação e o gerenciamento padronizados de versões de serviço na AUTOSAR Adaptive Platform ([SWS_CM_11515]). As aplicações utilizam as instâncias para verificação de compatibilidade por meio de comparações de igualdade e de ordem, para armazenamento em contêineres, bem como para registro em log por meio de ToString() ([SWS_CM_11519]). O tipo exato pode ser sobrescrito pelo provedor de Communication Management, mas deve atender aos requisitos elementares de comparação e atribuição do C++. Durante o uso, deve-se observar que todas as funções-membro da classe estão classificadas especificativamente como não seguras contra exceções.

mais ›

Contexto

A classe ara::com::ServiceVersionType define no cabeçalho ara/com/service/service_version.h (AUTOSAR_AP_SWS_CommunicationManagement §8.11 «Header: ara/com/service/service_version.h») a versão de um serviço de comunicação ([SWS_CM_11515]). Sua responsabilidade primária consiste em tornar as versões de serviço manipuláveis para o software de aplicação, permitindo que este armazene, gerencie, compare e registre em log essas informações de versão ([SWS_CM_11515]).

Uma particularidade arquitetural reside na flexibilidade da plataforma: de acordo com [SWS_CM_11515], o tipo de dados concreto pode ser sobrescrito ou estendido pelo provedor de software do Communication Management. Para garantir, ainda assim, uma manipulação consistente em aplicações portáveis, a especificação exige que o tipo atenda pelo menos aos conceitos padrão do C++ [equalitycomparable] ([SWS_CM_11516]), [lessthancomparable] ([SWS_CM_11517]) e [copyassignable] ([SWS_CM_11518]) conforme a ISO/IEC 14882:2014.

Entre os parceiros de interação estão, além do Communication Management Software Provider, também interfaces de serviço que disponibilizam versões como constante estática serviceVersion (AUTOSAR_AP_SWS_CommunicationManagement p. 320), bem como o software aplicativo que realiza comparações de versão.

Diagrama de contexto: integração de ara::com::ServiceVersionType entre Software Provider, interface de serviço e aplicação. Fontes: [SWS_CM_11515], AUTOSAR_AP_SWS_CommunicationManagement p. 320, AUTOSAR_AP_SWS_CommunicationManagement §8.11.1 «Class: ServiceVersionType».

Ciclo de vida

Instâncias de ara::com::ServiceVersionType são projetadas como tipos de valor regulares (Value Types). A criação e a absorção de valor ocorrem por meio de cópia e atribuição: por meio do operador de atribuição operator=, o requisito [copyassignable] é atendido ([SWS_CM_11518]), permitindo que as instâncias assumam novos valores.

Quanto às relações de posse, ara::com::ServiceVersionType está sujeito ao escopo do respectivo chamador ou é mantido como constante de uma definição de serviço (AUTOSAR_AP_SWS_CommunicationManagement p. 320). O tipo não possui máquina de estados interna complexa, mas encapsula um valor de versão discreto. Sua destruição ocorre automaticamente ao sair do escopo.

Em relação à concorrência, as operações de leitura operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) e ToString ([SWS_CM_11519]) estão declaradas como const. Interpretação: acessos de leitura simultâneos à mesma instância a partir de múltiplas threads provavelmente são seguros sem sincronização, enquanto processos paralelos de escrita e atribuição devem ser protegidos externamente. Pergunta Q-9582ce9a82b9b833 (aberta)

Caminho de utilização

O fluxo típico para o uso de ara::com::ServiceVersionType em uma aplicação divide-se nas seguintes etapas:

1. Consulta de versão: a aplicação acessa a informação de versão de um serviço, por exemplo, através da constante estática serviceVersion de uma interface (AUTOSAR_AP_SWS_CommunicationManagement p. 320).
2. Verificação de compatibilidade: a aplicação compara a versão com uma versão esperada por meio de operator== ([SWS_CM_11516]). Para verificações de ordem ou para armazenamento em contêineres padrão ordenados, utiliza-se operator< ([SWS_CM_11517]).
3. Gerenciamento e armazenamento: para o repasse ou armazenamento local de estados de versão, a aplicação utiliza o operador de atribuição operator= ([SWS_CM_11518]).
4. Registro em log: para mensagens de diagnóstico ou saídas de log, a aplicação gera uma representação textual como ara::core::StringView por meio do método ToString() ([SWS_CM_11519], AUTOSAR_AP_SWS_CommunicationManagement §8.11.1.1.2.1 «ToString»).

Cenários de erro

Ao utilizar a interface, devem ser observadas condições de contorno específicas:

• Segurança contra exceções: todas as funções especificadas – operator= ([SWS_CM_11518]), operator== ([SWS_CM_11516]), operator< ([SWS_CM_11517]) e ToString ([SWS_CM_11519]) – estão explicitamente declaradas na especificação como not exception safe. Em caso de falha (como em alocações de memória em implementações específicas do provedor), as aplicações não devem confiar em garantias automáticas de recuperação.
• Validade da view de string: o método ToString() fornece um ara::core::StringView ([SWS_CM_11519]). Interpretação: como uma StringView não gerencia memória própria, o tempo de vida da cadeia de caracteres referenciada provavelmente está vinculado à instância subjacente ou à memória estática; um uso além da validade da fonte de dados resulta em comportamento indefinido. Pergunta Q-fdb6e821db46af00 (aberta)