estrutura ara::diag::SovdBulkData::DeleteByCategoryResult

A estrutura ara::diag::SovdBulkData::DeleteByCategoryResult fornece o resultado agregado na exclusão de todos os dados em massa de uma categoria no módulo de diagnóstico SOVD ([SWS_DM_01926]). Ela separa os resultados em entradas excluídas com sucesso (deleted_items) e instâncias com falha, incluindo a causa do erro (failed_items) ([SWS_DM_01842], [SWS_DM_01843]). Os chamadores devem avaliar ambas as listas para tratar sucessos parciais de forma determinística.

mais ›

Contexto

A estrutura ara::diag::SovdBulkData::DeleteByCategoryResult atua como tipo de resultado padronizado para o método “Delete All Bulk Data Defined by Category” no âmbito do gerenciamento de dados em massa do Service-Oriented Vehicle Diagnostics (SOVD) ([SWS_DM_01926], AUTOSAR_AP_SWS_Diagnostics §8.53.3 «Struct: DeleteByCategoryResult»). No módulo de diagnóstico AUTOSAR Adaptive (diag), dados em massa como arquivos de log, gravações de trace ou séries de medição podem ser atribuídos a categorias semânticas. Se um cliente de diagnóstico solicitar a exclusão de todas as instâncias de uma categoria por meio da interface ara::diag::SovdBulkData, essa estrutura de dados resume o estado geral da operação (AUTOSAR_AP_SWS_Diagnostics §8.53.3 «Definition of API class ara::diag::SovdBulkData::DeleteByCategoryResult»).

Atuam tipicamente como parceiros de interação um cliente SOVD externo ou uma aplicação de diagnóstico, a interface de diagnóstico funcional ara::diag::SovdBulkData e o subsistema interno de persistência para dados em massa. O objeto de resultado transpõe a fronteira entre a unidade de execução síncrona ou assíncrona e o cliente avaliador, agregando o estado de todos os objetos de dados afetados.

Ciclo de vida

De acordo com a definição de classe no cabeçalho #include "ara/diag/sovd_bulk_data.h", trata-se de uma estrutura de dados passiva (struct) sem lógica de estado complexa própria ([SWS_DM_01842], [SWS_DM_01843]). A sua criação ocorre no lado do servidor pelo ambiente de tempo de execução de diagnóstico imediatamente após a conclusão da exclusão de dados em massa relacionada à categoria. Nesse processo, as variáveis de membro deleted_items e failed_items são preenchidas com os respectivos descritores e objetos de erro.

Como se trata de uma estrutura puramente de transferência de dados, a entrega ao ponto chamador no contexto da Adaptive Platform deve ocorrer provavelmente por valor (value) ou semântica de movimento (move) — por exemplo, encapsulada em um contêiner de resultado assíncrono. Pergunta Q-bafa9fbd3ae683c1 (aberta) Com isso, as relações de posse são transferidas integralmente para o chamador. A destruição do objeto e a liberação da memória das instâncias de ara::core::Vector contidas ocorrem de forma determinística ao sair do escopo (scope) do chamador. Não existe concorrência compartilhada no nível de instância; solicitações de exclusão paralelas para categorias distintas geram instâncias independentes entre si.

Caminho de utilização

O fluxo de utilização típico engloba o início da exclusão, a execução pelo serviço de diagnóstico e a avaliação separada do objeto resultante pelo chamador:

1. Um cliente de diagnóstico solicita, por meio do método para exclusão por categoria, a remoção de todos os dados em massa associados.
2. O servidor itera sobre as instâncias da categoria especificada e executa os procedimentos de exclusão.
3. Entradas removidas com sucesso são registradas na lista deleted_items ([SWS_DM_01842]).
4. Instâncias com falha são reunidas em failed_items com o seu respectivo motivo de erro ([SWS_DM_01843]).
5. O DeleteByCategoryResult agregado é retornado ao chamador ([SWS_DM_01926]), que confirma as exclusões bem-sucedidas e avalia eventuais erros.

Diagrama de sequência: fluxo da exclusão de dados em massa por categoria, desde a solicitação e agregação até a avaliação. Fontes: [SWS_DM_01926], [SWS_DM_01842], [SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3 «Struct: DeleteByCategoryResult».

Cenários de erro

Uma característica central da exclusão de dados em massa é a possibilidade de sucesso parcial. Uma vez que uma categoria pode agrupar uma variedade de conjuntos de dados independentes, a operação como um todo não falha necessariamente no caso de erros individuais. Para o chamador, a divisão em dois vetores separados significa presumivelmente que ocorre um processamento parcial sem rollback atômico. Pergunta Q-35307a7eccf0afa9 (aberta)

Exclusões com falha de conjuntos de dados individuais são transportadas pelo elemento failed_items, que é tipificado como ara::core::Vector<DeletionError> ([SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3.1.2 «failed_items»). Como pré-condição para uma notificação de sucesso completa, os chamadores devem verificar se failed_items.empty() se aplica. Se a lista contiver elementos, o erro de exclusão específico (por exemplo, bloqueio por um acesso de leitura ativo ou permissões insuficientes) poderá ser analisado para cada instância de dados em massa afetada. Ao mesmo tempo, deleted_items documenta de forma confiável todos os conjuntos de dados que puderam ser excluídos apesar da presença de erros individuais ([SWS_DM_01842]).