estrutura ara::diag::SovdConfiguration::SovdConfigurationMetaInfo

A estrutura ara::diag::SovdConfiguration::SovdConfigurationMetaInfo serve como objeto de transferência de dados para metainformações na transferência de dados de configuração SOVD no AUTOSAR Adaptive [SWS_DM_01861]. Ela reúne o tipo MIME em mimetype bem como, opcionalmente, o comprimento total dos dados de configuração em size, que são preenchidos pela aplicação antes da entrega aos métodos de transferência [SWS_DM_01863]. Como estrutura de dados C++ passiva sem métodos próprios, ela não possui segurança de threads nem lógica de validação, de modo que as verificações de consistência ocorrem apenas por meio dos serviços de processamento da plataforma.

mais ›

Contexto

A estrutura ara::diag::SovdConfiguration::SovdConfigurationMetaInfo atua como contêiner de metadados padronizado para a transferência de dados de configuração SOVD (Service-Oriented Vehicle Diagnostics) na AUTOSAR Adaptive Platform [SWS_DM_01861]. Ela é declarada no cabeçalho ara/diag/sovd_configuration.h e atribuída organizacionalmente de forma direta à classe de interface ara::diag::SovdConfiguration AUTOSAR_AP_SWS_Diagnostics §8.54.2 «Struct: SovdConfigurationMetaInfo». A sua responsabilidade central consiste em disponibilizar as metainformações necessárias para a transferência de configuração diagnóstica, como o tipo de conteúdo e a dimensão dos dados [SWS_DM_01862], [SWS_DM_01863].

Entre os parceiros primários de interação estão, por um lado, a aplicação de diagnóstico utilizadora, que gera, modifica ou processa dados de configuração, e, por outro lado, o sistema de gerenciamento de diagnóstico do AUTOSAR Adaptive. A estrutura atua como objeto de transferência de dados (Data Transfer Object, DTO), mediando entre a lógica específica da aplicação e os serviços de transferência padronizados da plataforma de diagnóstico. Por meio dos campos disponibilizados, o emissor e o receptor podem acordar em qual formato os dados de configuração se encontram e quantos bytes são esperados no canal de transmissão.

Ciclo de vida

Como tipo de dados C++ puramente passivo (struct), SovdConfigurationMetaInfo não está sujeito a fases complexas de ciclo de vida controladas pela plataforma [SWS_DM_01861]. A criação ocorre normalmente de forma direta pela Adaptive Application na pilha (stack) ou na heap, imediatamente antes de uma transferência de configuração ser iniciada ou de um conjunto de metadados recebido ser avaliado. A estrutura segue a semântica de valor regular do C++; o componente detentor assume a responsabilidade pela instanciação e pelo tempo de vida.

Em relação ao estado interno, a estrutura não possui máquina de estados nem modos de operação discretos. Após a inicialização das variáveis públicas, os dados permanecem inalterados na memória até a destruição da instância, a menos que sejam explicitamente sobrescritos pela aplicação detentora. A liberação da instância ocorre automaticamente de acordo com o padrão RAII ao sair do escopo, sendo liberada a memória alocada dinamicamente da string contida [SWS_DM_01863].

Em relação à concorrência, SovdConfigurationMetaInfo não oferece segurança de threads integrada. Múltiplos threads podem processar simultaneamente uma instância em modo de leitura, por exemplo para inspeção dos parâmetros de configuração. Contudo, acessos simultâneos de escrita à mesma instância exigem medidas de sincronização externa, uma vez que modificações concorrentes nas variáveis de membro levam a inconsistências de dados.

Caminho de utilização

Um caso de uso típico consiste na preparação e disponibilização de metadados antes da transferência de configuração propriamente dita. A aplicação instancia inicialmente a estrutura e atribui ao campo mimetype uma cadeia de caracteres que descreve o tipo de mídia do arquivo de configuração [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.1 «mimetype». Isso permite ao receptor a associação a um analisador (parser) ou esquema, por exemplo para configurações baseadas em JSON ou XML.

Na etapa seguinte, verifica-se se o tamanho exato dos dados úteis pode ser determinado previamente. Se for esse o caso, o atributo size é preenchido com o respectivo valor inteiro em bytes [SWS_DM_01862], AUTOSAR_AP_SWS_Diagnostics §8.54.2.1.2 «size». Se o tamanho for desconhecido antes do início da transmissão, a variável permanecerá indefinida. Em seguida, o objeto preparado é passado como argumento para a função de transferência da classe ara::diag::SovdConfiguration.

Diagrama de sequência: fluxo típico de inicialização e passagem de SovdConfigurationMetaInfo no âmbito da transferência de configuração. Fontes: [SWS_DM_01861], [SWS_DM_01862], [SWS_DM_01863], AUTOSAR_AP_SWS_Diagnostics §8.54.2 «Struct: SovdConfigurationMetaInfo».

Cenários de erro

Como SovdConfigurationMetaInfo é projetada como uma estrutura de dados pura sem funções-membro, ela não define valores de retorno, códigos de erro ou exceções próprios [SWS_DM_01861]. Possíveis condições de erro decorrem primariamente de atribuições de dados incompletas ou inconsistentes, que são detectadas pelos serviços da plataforma responsáveis pelo processamento em ara::diag::SovdConfiguration.

Interpretação: um primeiro cenário de erro diz respeito a tipos MIME inadmissíveis. Se for definida em mimetype uma cadeia de caracteres vazia ou um identificador de formato não suportado, o serviço de transferência chamado deverá recusar o processamento e retornar um código de erro correspondente à aplicação. Um segundo cenário de erro reside em uma discrepância do tamanho dos dados: se a quantidade de dados efetivamente transmitida divergir do valor em bytes declarado em size, a infraestrutura de diagnóstico cancelará a transferência, presumivelmente por inconsistência. Além disso, um campo size indefinido provavelmente provocará erros de transmissão, caso o canal de transporte escolhido exija obrigatoriamente um comprimento total conhecido previamente. Pergunta (aberta)