classe ara::diag::DiagnosticSovdRecordContentElementDataConstView

La classe offre une vue immuable sur des éléments de contenu d'enregistrement SOVD structurés pour une évaluation efficace et en lecture seule dans les applications de diagnostic ([SWS_DM_02295]). Les utilisateurs peuvent vérifier l'état d'erreur via des objets de résultat, adresser de manière ciblée des éléments d'enregistrement par clé ou parcourir séquentiellement l'ensemble du contenu au moyen d'itérateurs constants ([SWS_DM_02300]). Toutes les interfaces sont entièrement thread-safe et déclarées sûres vis-à-vis des exceptions, mais supposent que l'élément de contenu référencé correspond au type Record attendu.

plus ›

Contexte

La classe ara::diag::DiagnosticSovdRecordContentElementDataConstView définit une vue immuable (Const View) sur des éléments de contenu SOVD de diagnostic du type d'enregistrement Record ([SWS_DM_02295], AUTOSAR_AP_SWS_Diagnostics §8.60.9 « Class: DiagnosticSovdRecordContentElementDataConstView »). L'interface est fournie via l'en-tête #include "ara/diag/diagnostic_sovd_content_element_data.h" ([SWS_DM_02298]). Elle permet aux applications de diagnostic de lire de manière ciblée et structurée des champs de données hiérarchiquement organisés d'un élément de contenu SOVD, sans devoir créer de copies des données utiles ni effectuer d'opérations modificatrices.

Les partenaires d'interaction principaux comprennent le composant de diagnostic appelant, l'objet sous-jacent de type DiagnosticSovdContentElementData ainsi que les éléments individuels adressés par son intermédiaire, lesquels sont mis à disposition sous forme d'encapsulation de référence constante std::reference_wrapper<DiagnosticSovdContentElementData const> ou via des itérateurs constants ([SWS_DM_02300], [SWS_DM_02301]).

Cycle de vie

En tant que type de vue, ara::diag::DiagnosticSovdRecordContentElementDataConstView ne possède vraisemblablement pas la propriété propre (ownership) des données utiles sous-jacentes ; la validité de la vue devrait être liée à la durée de vie de l'objet DiagnosticSovdContentElementData référencé. Question Q-4aca4f6f723cd3f5 (ouverte) La destruction de l'instance de vue ne libère que le descripteur de vue, mais laisse la structure de données sous-jacente intacte.

En matière de concurrence, toutes les fonctions membres de la classe sont explicitement spécifiées comme thread-safe et sûres vis-à-vis des exceptions (noexcept) ([SWS_DM_02296], [SWS_DM_02298]). Plusieurs threads peuvent ainsi accéder en lecture à l'interface en parallèle et sans synchronisation, tant que la structure de données référencée n'est pas modifiée de manière concurrente pendant l'accès.

Parcours d'utilisation

Un déroulement typique pour l'évaluation d'un élément d'enregistrement se divise en vérification d'erreur, contrôle de dimension et accès aux éléments :

1. Vérifier l'état d'erreur : avant le traitement, il est validé via HasError() si le contenu est exempt d'erreur ([SWS_DM_02296]).
2. Interroger l'occupation : via Empty(), il peut être vérifié si l'enregistrement est vide ([SWS_DM_02299], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.5 « Empty »). Les méthodes Size() et Capacity() fournissent le nombre d'éléments ainsi que la capacité de l'enregistrement ([SWS_DM_02297], [SWS_DM_02298], AUTOSAR_AP_SWS_Diagnostics §8.60.9.1.1.4 « Capacity »).
3. Accès ciblé aux éléments : avant d'accéder à un champ nommé, la présence d'une clé peut être vérifiée au moyen de HasContentElement() ([SWS_DM_02305]). L'accès direct s'effectue ensuite via operator[] avec transmission d'un ara::core::StringView, qui renvoie une référence à l'élément secondaire ([SWS_DM_02300]). Alternativement, Find() fournit un itérateur sur l'élément trouvé ([SWS_DM_02306]).
4. Itération séquentielle : pour le parcours complet de tous les éléments secondaires, les méthodes d'itérateur Begin() / End() ainsi que CBegin() / CEnd() sont disponibles et renvoient des instances 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 »).

Diagramme de séquence : ordre d'appel pour la vérification d'erreur et l'interrogation d'éléments basée sur des clés. Sources : [SWS_DM_02296], [SWS_DM_02300], [SWS_DM_02305].

Scénarios d'erreur

Pour la gestion des erreurs, la classe utilise le type de retour ara::core::Result au lieu des exceptions C++ :

• État d'erreur interne : si l'élément de contenu SOVD sous-jacent présente une erreur, HasError() retourne un ara::core::Result<void> contenant le code d'erreur ara::diag::DiagSovdErrc ([SWS_DM_02296]).
• Clé manquante ou conflit de type : lors de l'accès via operator[] ou de la vérification avec HasContentElement(), la valeur de retour fournit un Result d'erreur si le DiagnosticSovdContentElementData n'est pas du type RecordContentElementData ou ContentData ou si la clé spécifiée n'existe pas ([SWS_DM_02300], [SWS_DM_02305]).
• Violation de préconditions : pour les méthodes Begin(), End(), CBegin(), CEnd(), Size(), Capacity(), Empty() et Find(), la précondition exige que l'élément de contenu référencé soit du type 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]).