structure ara::diag::SovdBulkData::DeleteByCategoryResult

La structure ara::diag::SovdBulkData::DeleteByCategoryResult fournit le résultat agrégé lors de la suppression de toutes les données de masse d'une catégorie dans le module de diagnostic SOVD ([SWS_DM_01926]). Elle sépare les résultats en entrées supprimées avec succès (deleted_items) et en instances en échec accompagnées de la cause de l'erreur (failed_items) ([SWS_DM_01842], [SWS_DM_01843]). Les appelants doivent évaluer les deux listes afin de traiter les succès partiels de manière déterministe.

plus ›

Contexte

La structure ara::diag::SovdBulkData::DeleteByCategoryResult sert de type de résultat standardisé pour la méthode « Delete All Bulk Data Defined by Category » dans le cadre de la gestion des données volumineuses de Service-Oriented Vehicle Diagnostics (SOVD) ([SWS_DM_01926], AUTOSAR_AP_SWS_Diagnostics §8.53.3 « Struct: DeleteByCategoryResult »). Dans le module de diagnostic AUTOSAR Adaptive (diag), les données volumineuses telles que les fichiers journaux, les enregistrements de trace ou les séries de mesures peuvent être affectées à des catégories sémantiques. Si un client de diagnostic demande la suppression de toutes les instances d’une catégorie via l’interface ara::diag::SovdBulkData, cette structure de données résume l’état global de l’opération (AUTOSAR_AP_SWS_Diagnostics §8.53.3 « Definition of API class ara::diag::SovdBulkData::DeleteByCategoryResult »).

Les partenaires d'interaction typiques sont un client SOVD externe ou une application de diagnostic, l'interface de diagnostic fonctionnelle ara::diag::SovdBulkData et le sous-système de persistance interne pour les données de masse. L'objet résultat fait le pont entre l'unité d'exécution synchrone ou asynchrone et le client effectuant l'évaluation en agrégeant l'état de tous les objets de données concernés.

Cycle de vie

Conformément à la définition de classe dans l'en-tête #include "ara/diag/sovd_bulk_data.h", il s'agit d'une structure de données passive (struct) sans logique d'état complexe propre ([SWS_DM_01842], [SWS_DM_01843]). Sa création s'effectue côté serveur par l'environnement d'exécution de diagnostic immédiatement après l'achèvement de la suppression des données de masse relative à la catégorie. À cette occasion, les variables membres deleted_items et failed_items sont renseignées avec les descripteurs et les objets d'erreur respectifs.

Puisqu'il s'agit d'une pure structure de transfert de données, la transmission à l'entité appelante dans le contexte de la plateforme Adaptive devrait s'effectuer par valeur (Value) ou par sémantique de déplacement — par exemple encapsulée dans un conteneur de résultat asynchrone. Question Q-bafa9fbd3ae683c1 (ouverte) La propriété est alors intégralement transférée à l'appelant. La destruction de l'objet et la libération de la mémoire des instances ara::core::Vector contenues s'effectuent de façon déterministe lors de la sortie de la portée (scope) de l'appelant. Au niveau de l'instance, il n'existe aucune concurrence partagée ; des requêtes de suppression parallèles pour des catégories distinctes génèrent des instances indépendantes les unes des autres.

Parcours d'utilisation

Le déroulement typique de l'utilisation comprend l'initiation de la suppression, l'exécution par le service de diagnostic et l'évaluation séparée de l'objet résultant par l'appelant :

1. Un client de diagnostic demande la suppression de toutes les données de masse associées via la méthode de suppression par catégorie.
2. Le serveur itère sur les instances de la catégorie spécifiée et procède aux opérations de suppression.
3. Les entrées supprimées avec succès sont consignées dans la liste deleted_items ([SWS_DM_01842]).
4. Les instances ayant échoué sont collectées dans failed_items avec leur motif d'erreur respectif ([SWS_DM_01843]).
5. L'élément agrégé DeleteByCategoryResult est renvoyé à l'appelant ([SWS_DM_01926]), qui acquitte les suppressions réussies et évalue les éventuelles erreurs.

Diagramme de séquence : déroulement de la suppression de données de masse par catégorie, de la requête à l'évaluation en passant par l'agrégation. Sources : [SWS_DM_01926], [SWS_DM_01842], [SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3 « Struct: DeleteByCategoryResult ».

Scénarios d'erreur

Une caractéristique centrale de la suppression de données de masse réside dans la possibilité d'un succès partiel. Comme une catégorie peut regrouper une multitude d'enregistrements de données indépendants, l'opération globale n'échoue pas nécessairement en présence d'erreurs individuelles. Pour l'appelant, la division en deux vecteurs distincts signifie vraisemblablement qu'un traitement partiel a lieu sans rollback atomique. Question Q-35307a7eccf0afa9 (ouverte)

Les suppressions défaillantes d'enregistrements individuels sont transmises via l'élément failed_items, qui est typé comme ara::core::Vector<DeletionError> ([SWS_DM_01843], AUTOSAR_AP_SWS_Diagnostics §8.53.3.1.2 « failed_items »). Les appelants doivent vérifier comme précondition pour un message de succès complet si failed_items.empty() s'applique. Si la liste contient des éléments, l'erreur de suppression spécifique (par exemple un verrouillage par un accès en lecture actif ou des autorisations insuffisantes) peut être analysée pour chaque instance de données de masse concernée. En même temps, deleted_items documente de manière fiable tous les enregistrements qui ont pu être supprimés malgré la présence d'erreurs individuelles ([SWS_DM_01842]).