classe <SI-Namespace>::common::<SI>

A classe agrega, como namespace comum, metadados estáticos e identificadores para uma interface no Communication Management da AUTOSAR Adaptive SWS CommunicationManagement §8.2.2.1 «Public Member Variables». Disponibiliza, através de serviceIdentifier e serviceVersion, informações fundamentais para a identificação inequívoca e o versionamento do serviço [SWS_CM_11506]. Adicionalmente, serviceContractVersionMajor bem como serviceContractVersionMinor definem a versão exata do contrato de serviço para assegurar a compatibilidade da interface. Interpretação: como todos os elementos declarados são estáticos, a classe presumivelmente não requer instanciação em tempo de execução e é incluída de forma imutável a nível de todo o processo. Pergunta Q-bdf8084e3c4a2dec (aberta)

mais ›

Contexto

Na AUTOSAR Adaptive Platform, a classe C++ <SI-Namespace>::common::<SI> no módulo com (Communication Management) desempenha o papel central de um contentor comum de metadados e namespace para uma Service Interface SWS CommunicationManagement §8.2.2.1 «Public Member Variables» definida. A classe agrupa propriedades estáticas e identificadores de interface que se aplicam uniformemente tanto a consumidores como a fornecedores de serviços, sendo disponibilizados através do ficheiro de cabeçalho #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h" [SWS_CM_11506].

Entre os principais intervenientes de interação conta-se o Communication Management funcional ara::com, cujos tipos de dados fundamentais são incluídos. A classe expõe o identificador de serviço serviceIdentifier do tipo const ara::com::ServiceIdentifierType [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 «serviceIdentifier»), bem como a versão de serviço serviceVersion do tipo const ara::com::ServiceVersionType [SWS_CM_11507] (SWS CommunicationManagement §8.2.2.1.4 «serviceVersion»). Interpretação: componentes de aplicação e de plataforma utilizam esta definição de classe partilhada como referência vinculativa para estabelecer instâncias de serviço através de identificadores e contratos de interface uniformizados. Pergunta (aberta)

Diagrama de contexto: enquadramento da classe de interface partilhada na interação com aplicações de serviço e tipos básicos do Communication Management. Fontes: [SWS_CM_11506], [SWS_CM_11507], SWS CommunicationManagement §8.2.2.1 «Public Member Variables».

Ciclo de vida

No que diz respeito ao ciclo de vida, <SI-Namespace>::common::<SI> difere fundamentalmente de classes de instâncias dinâmicas: não requer qualquer instanciação explícita e não possui estado gerido dinamicamente. Todas as variáveis de interface definidas na especificação estão declaradas como membros estáticos da classe SWS CommunicationManagement §8.2.2.1 «Public Member Variables».

O identificador serviceIdentifier [SWS_CM_11506] e o versionamento serviceVersion [SWS_CM_11507] estão declarados como static const. Complementarmente, serviceContractVersionMajor [SWS_CM_11508] (SWS CommunicationManagement §8.2.2.1.1 «serviceContractVersionMajor») e serviceContractVersionMinor [SWS_CM_11509] (SWS CommunicationManagement §8.2.2.1.2 «serviceContractVersionMinor») definem os números de versão do contrato como valores std::uint32_t estáticos. Interpretação: o tempo de vida estático destes símbolos corresponde a toda a duração do processo; a sua inicialização deverá ocorrer aquando do carregamento do respetivo módulo ou da shared library. Pergunta (aberta) Não existe destruição dinâmica ou libertação de recursos de memória.

No que concerne à concorrência, as variáveis serviceIdentifier e serviceVersion qualificadas com const oferecem segurança de threads irrestrita em acessos de leitura simultâneos. Interpretação: dado que as variáveis de versão serviceContractVersionMajor e serviceContractVersionMinor representam estados de especificação contratuais, elas permanecem presumivelmente inalteradas em tempo de execução, permitindo assim acessos de leitura simultâneos a partir de múltiplas threads de execução sem esforço de sincronização. Pergunta Q-2335ea4535e239d6 (aberta)

Caminho de utilização

O caminho de utilização típico compreende o acesso estático a metadados e informações de versão para garantir a compatibilidade de interfaces:

• Inclusão do cabeçalho: a aplicação ou a camada de comunicação gerada inclui o ficheiro <SiNamespaceDerivedDirectoryPath>/<SiShortname>_common.h para obter acesso ao namespace <SI-Namespace>::common::<SI> [SWS_CM_11506].
• Identificação do serviço: os componentes acedem diretamente via <SI-Namespace>::common::<SI>::serviceIdentifier ao identificador unívoco do serviço, por exemplo, para a inicialização de instâncias ou para o registo na infraestrutura de comunicação [SWS_CM_11506] (SWS CommunicationManagement §8.2.2.1.3 «serviceIdentifier»).
• Verificação de versões: para a verificação da compatibilidade de interface entre parceiros de comunicação, são lidos serviceVersion [SWS_CM_11507] bem como as versões do contrato serviceContractVersionMajor [SWS_CM_11508] e serviceContractVersionMinor [SWS_CM_11509].

Não existem pré-condições para o acesso de leitura, uma vez que todas as constantes já se encontram disponíveis no arranque do programa. Não estão especificados estados de erro ou exceções para o acesso de leitura pura a estas variáveis estáticas.