classe ara::diag::DiagnosticSovdRecordContentElementDataConstView

A classe oferece uma visualização imutável de elementos de conteúdo de registro SOVD estruturados para avaliação eficiente e somente para leitura em aplicações de diagnóstico ([SWS_DM_02295]). Os usuários podem verificar o status de erro por meio de objetos de resultado, endereçar elementos de registro de dados especificamente por chave ou percorrer todo o conteúdo sequencialmente usando iteradores constantes ([SWS_DM_02300]). Todas as interfaces são totalmente thread-safe e declaradas como seguras contra exceções, mas pressupõem que o elemento de conteúdo referenciado corresponda ao tipo de registro esperado.

mais ›

Contexto

A classe ara::diag::DiagnosticSovdRecordContentElementDataConstView define uma visualização imutável (Const View) de elementos de conteúdo SOVD diagnósticos do tipo de conjunto de dados Record ([SWS_DM_02295], AUTOSAR_AP_SWS_Diagnostics §8.60.9 «Class: DiagnosticSovdRecordContentElementDataConstView»). A interface é disponibilizada por meio do cabeçalho #include "ara/diag/diagnostic_sovd_content_element_data.h" ([SWS_DM_02298]). Ela permite que aplicações de diagnóstico leiam de maneira direcionada e estruturada campos de dados organizados hierarquicamente de um elemento de conteúdo SOVD, sem a necessidade de criar cópias dos dados úteis ou executar operações modificadoras.

Entre os principais parceiros de interação estão o componente de diagnóstico chamador, o objeto subjacente do tipo DiagnosticSovdContentElementData, bem como os elementos individuais endereçados por meio dele, os quais são disponibilizados como empacotamento de referência constante std::reference_wrapper<DiagnosticSovdContentElementData const> ou por meio de iteradores constantes ([SWS_DM_02300], [SWS_DM_02301]).

Ciclo de vida

Como tipo de visualização, presume-se que ara::diag::DiagnosticSovdRecordContentElementDataConstView não possua propriedade própria (ownership) dos dados úteis subjacentes; a validade da visualização deve estar vinculada ao tempo de vida do objeto DiagnosticSovdContentElementData referenciado. Pergunta Q-4aca4f6f723cd3f5 (aberta) A destruição da instância de visualização libera apenas o descritor de visualização, deixando a estrutura de dados subjacente intacta.

Em relação à concorrência, todas as funções-membro da classe são explicitamente especificadas como thread-safe e seguras contra exceções (noexcept) ([SWS_DM_02296], [SWS_DM_02298]). Várias threads podem, portanto, acessar a interface para leitura de forma paralela e livre de sincronização, desde que a estrutura de dados referenciada não seja modificada concorrentemente durante o acesso.

Caminho de utilização

Um fluxo típico para a avaliação de um elemento Record é dividido em verificação de erros, verificação de dimensões e acesso aos elementos:

1. Verificar estado de erro: antes do processamento, valida-se por meio de HasError() se o conteúdo está livre de erros ([SWS_DM_02296]).
2. Consultar ocupação: por meio de Empty(), é possível verificar se o conjunto de dados está vazio ([SWS_DM_02299], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.5 «Empty»). Os métodos Size() e Capacity() fornecem a quantidade de elementos e a capacidade do conjunto de dados ([SWS_DM_02297], [SWS_DM_02298], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.4 «Capacity»).
3. Acesso direcionado a elementos: antes de acessar um campo nomeado, a presença de uma chave pode ser verificada usando HasContentElement() ([SWS_DM_02305]). O acesso aleatório ocorre em seguida por meio de operator[] com a passagem de um ara::core::StringView, o qual retorna uma referência ao subelemento ([SWS_DM_02300]). Como alternativa, Find() fornece um iterador para o elemento encontrado ([SWS_DM_02306]).
4. Iteração sequencial: para a travessia completa de todos os subelementos, estão disponíveis os métodos de iterador Begin() / End() e CBegin() / CEnd(), que retornam instâncias de DiagnosticSovdRecordContentElementDataConstIterator ([SWS_DM_02301], [SWS_DM_02302], [SWS_DM_02303], [SWS_DM_02304], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.1 «Begin», AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.2 «CBegin», AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.3 «CEnd»).

Diagrama de sequência: ordem de chamadas para verificação de erros e consulta de elementos baseada em chave. Fontes: [SWS_DM_02296], [SWS_DM_02300], [SWS_DM_02305].

Cenários de erro

A classe utiliza o tipo de retorno ara::core::Result para tratamento de erros em vez de exceções C++:

• Estado de erro interno: se o elemento de conteúdo SOVD subjacente apresentar um erro, HasError() retorna um ara::core::Result<void> que contém o código de erro ara::diag::DiagSovdErrc ([SWS_DM_02296]).
• Chave ausente ou conflito de tipo: no acesso via operator[] ou na verificação com HasContentElement(), o valor de retorno fornece um resultado de erro caso o DiagnosticSovdContentElementData não seja do tipo RecordContentElementData ou ContentData ou se a chave especificada não existir ([SWS_DM_02300], [SWS_DM_02305]).
• Violação de pré-condições: para os métodos Begin(), End(), CBegin(), CEnd(), Size(), Capacity(), Empty() e Find(), aplica-se como pré-condição que o elemento de conteúdo referenciado deve ser do tipo RecordContentElementData ou ContentData ([SWS_DM_02297], [SWS_DM_02298], [SWS_DM_02299], [SWS_DM_02301], [SWS_DM_02302], [SWS_DM_02303], [SWS_DM_02304], [SWS_DM_02306]).