estrutura ara::diag::SovdBulkData::DeletionError

A estrutura [SWS_DM_01844] representa o resultado de erro em um procedimento de exclusão com falha de um único objeto de dados em massa no módulo de diagnóstico SOVD (AUTOSAR_AP_SWS_Diagnostics §8.53.4 «Struct: DeletionError»). Ela vincula os metadados do elemento de dados não excluído item ao código de erro ocorrido error [SWS_DM_01845], [SWS_DM_01846]. Como objeto puramente de valor, ela serve ao chamador para a identificação direcionada e a análise de causas de limpezas com falha.

mais ›

Contexto

A estrutura de dados [SWS_DM_01844] descreve um erro individual que ocorre durante a operação de exclusão de dados em massa (bulk data) dentro do framework SOVD (Service-Oriented Vehicle Diagnostics) do AUTOSAR Adaptive (AUTOSAR_AP_SWS_Diagnostics §8.53.4 «Struct: DeletionError»). Como parte integrante da interface ara::diag::SovdBulkData, a estrutura serve para estabelecer uma atribuição precisa entre o elemento de dados afetado e a causa do erro em caso de ações de limpeza ou exclusão com falha. Com isso, ela conecta o descritor de metadados do arquivo não passível de exclusão a um código de erro padronizado do AUTOSAR.

A interação ocorre primariamente entre o servidor de diagnóstico ou o componente ara::diag::SovdBulkData, que executa a exclusão, e a lógica de diagnóstico ou de aplicação chamadora. Esta última solicita a limpeza de dados em massa e, em caso de erro, recebe retornos para determinar quais conjuntos de dados específicos não puderam ser removidos e por quê. A interação dos componentes envolvidos e o retorno do objeto de erro em uma tentativa de exclusão são apresentados no diagrama de sequência a seguir.

Diagrama de sequência: fluxo típico de uma exclusão de dados em massa com falha com retorno de DeletionError. Fontes: [SWS_DM_01844], [SWS_DM_01845], [SWS_DM_01846], AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 «Public Member Variables»

Ciclo de vida

A estrutura [SWS_DM_01844] é concebida como um objeto puramente de valor (plain old data / tipo de valor). A sua instanciação ocorre no lado da infraestrutura de diagnóstico exatamente quando for detectado um erro durante o processamento de uma solicitação de exclusão para um determinado elemento de dados em massa. Nesse processo, o campo item é inicializado com o respectivo BulkDataMetaDataDescriptor [SWS_DM_01845] e o campo error com o código de erro específico ara::core::ErrorCode [SWS_DM_01846].

No que diz respeito às relações de posse, a instância (ou uma coleção de tais instâncias) é tipicamente transferida para a posse do chamador como valor de retorno ou dentro de um contêiner de erro. Interpretação: a estrutura não possui recursos de longa duração próprios nem threads ativos; o seu ciclo de vida está diretamente vinculado ao escopo (scope) do bloco chamador de tratamento de erros ou do contêiner de resultado. Pergunta Q-60f135b9e36d7083 (aberta) Após a avaliação pela aplicação, a estrutura é destruída por padrão na pilha (stack) ou na heap juntamente com as suas variáveis de membro. Como se trata de um pacote de dados passivo, não ocorrem transições de estado internas nem requisitos de sincronização concorrente dentro da estrutura.

Caminho de utilização

No caso de utilização normal, um componente de diagnóstico ou um cliente SOVD inicia a eliminação de um ou mais objetos de dados em massa através da interface SovdBulkData. Se a eliminação de pelo menos um elemento falhar, a plataforma cria uma instância de DeletionError [SWS_DM_01844].

O chamador recebe o objeto de erro e avalia as duas variáveis públicas (AUTOSAR_AP_SWS_Diagnostics §8.53.4.1 «Public Member Variables»):

• item: por meio do BulkDataMetaDataDescriptor, a aplicação identifica o elemento de dados concreto cuja exclusão falhou [SWS_DM_01845].
• error: com base no ara::core::ErrorCode, a aplicação determina a causa exata para a falha do procedimento de exclusão [SWS_DM_01846].

Com base nessas informações, a lógica chamadora pode reagir de forma diferenciada, por exemplo, registrando o erro em log, escolhendo uma estratégia de limpeza alternativa ou reportando a causa detalhada do erro a um cliente SOVD de nível superior.

Cenários de erro

A estrutura DeletionError em si não lança exceções nem reporta códigos de erro próprios, servindo exclusivamente como portadora de informações para o encapsulamento de falhas de operações de exclusão anteriores. A semântica de erro central é disponibilizada pela variável error do tipo ara::core::ErrorCode [SWS_DM_01846]. Esse código especifica detalhadamente por qual motivo o objeto de dados em massa [SWS_DM_01845] referenciado por item não pôde ser excluído (por exemplo, negação de acesso, recursos bloqueados ou erros de sistema de arquivos).

Aplica-se como pré-condição para uma avaliação significativa que as variáveis item e error tenham sido preenchidas com dados de contexto válidos pelo ambiente de tempo de execução SovdBulkData gerador. Após a conclusão da inspeção, a estrutura não exige ações de limpeza por parte do desenvolvedor.