classe ara::rds::IEEE1722DatagramNTSCF

La classe ara::rds::IEEE1722DatagramNTSCF représente la structure de données pour les datagrammes de contrôle IEEE 1722 NTSCF au sein du module Raw Data Stream SWS RawDataStream « Specification of Raw Data Stream ». Elle encapsule des champs spécifiques au protocole, tels que le numéro de séquence, les indications d'adresse et les identifiants uniques, dans des attributs protégés qui sont à la disposition des classes de datagrammes spécialisées. Un cycle de vie sûr dans le cadre d'une utilisation polymorphe est garanti par le destructeur virtuel [SWS_RDS_90310]. La contrainte principale réside dans le fait que la destruction doit impérativement s'effectuer sans exception et que la présence des champs optionnels doit être vérifiée avant tout accès.

plus ›

Contexte

La classe ara::rds::IEEE1722DatagramNTSCF représente, au sein du module AUTOSAR Adaptive rds (Raw Data Stream) conformément à SWS RawDataStream « Specification of Raw Data Stream », la structure d'un datagramme IEEE 1722 au format NTSCF (Non-Time-Synchronous Control Format). La classe regroupe les champs de protocole spécifiés pour l'échange de flux de données de contrôle et de données utiles non critiques en matière de temps. Le fichier d'en-tête #include "ara/rds/raw_data_stream_IEEE1722.h" déclare la classe dans l'espace de noms ara::rds. Les composants spécifiés comprennent l'identifiant de flux unique unique_id [SWS_RDS_90309], le numéro de séquence sequenceNum [SWS_RDS_90307] ainsi que les informations de longueur et d'adresse ntscf_data_length et mac_address [SWS_RDS_90306], [SWS_RDS_90308].

Il est remarquable que tous les éléments de données présentent la protection d'accès protected. En guise d'interprétation, on peut en déduire que la classe sert de classe de base fondamentale pour des structures de datagrammes dérivées et spécifiques à un protocole, et qu'elle n'est vraisemblablement pas destinée à une instanciation directe par la logique d'application standard. Question Q-10e9faa973973eda (ouverte)

Cycle de vie

Le cycle de vie de ara::rds::IEEE1722DatagramNTSCF est conçu pour un fonctionnement sûr dans les hiérarchies d'héritage orientées objet. L'élément central est le destructeur virtuel ~IEEE1722DatagramNTSCF() noexcept conformément à [SWS_RDS_90310]. La virtualité garantit que, lors de la destruction d'une instance dérivée via un pointeur vers la classe de base, la chaîne de destructeurs est exécutée intégralement et correctement.

La déclaration avec noexcept [SWS_RDS_90310] garantit que la destruction de l'objet ne lève d'exception sous aucun prétexte. Cela correspond aux exigences fondamentales de la gestion moderne des ressources en C++ et assure la sécurité face aux exceptions en cas d'erreur.

Aucun constructeur public ne figure dans le périmètre de la spécification. La création de l'objet devrait donc s'effectuer soit par des classes dérivées dans le cadre de leur initialisation, soit via des mécanismes de création internes au module Raw Data Stream. Question Q-4a0e75e3e565d2d5 (ouverte) La classe ne possède ni états fixes ni machine à états interne ; l'objet reste, de sa création à sa destruction, dans un état cohérent en tant que vecteur d'informations.

Parcours d'utilisation

L'utilisation de la classe s'effectue typiquement au cours du traitement de flux de données de contrôle selon IEEE 1722. Les classes dérivées ou les composants du framework de flux de données brutes utilisent les attributs protégés pour la sérialisation ou la désérialisation des paquets transmis. Les attributs sont définis comme des types entiers élémentaires ou comme ara::core::Optional. La chaîne de traitement typique se divise selon les étapes suivantes :

• Identification du flux de données : à l'aide de unique_id [SWS_RDS_90309], il est vérifié à quel flux de données logique le datagramme appartient.
• Vérification de l'ordre : le numéro de séquence sequenceNum [SWS_RDS_90307] permet de déterminer si les paquets sont arrivés dans l'ordre attendu ou s'il y a des pertes.
• Évaluation de la longueur et de l'adresse : la taille des données utiles est déterminée et l'adresse cible ou source est évaluée via les champs ntscf_data_length et mac_address [SWS_RDS_90306], [SWS_RDS_90308].

Après l'évaluation des données utiles, le chemin d'utilisation s'achève par la libération de l'instance via le destructeur virtuel [SWS_RDS_90310].

Scénarios d'erreur

En raison de la nature de ara::rds::IEEE1722DatagramNTSCF en tant que structure de données et classe de base, les erreurs ne se manifestent pas sous forme de codes de retour de méthodes, mais concernent les préconditions lors de l'accès aux données et de la destruction :

• Accès non vérifié à des champs optionnels : des attributs tels que sequenceNum [SWS_RDS_90307] et unique_id [SWS_RDS_90309] sont déclarés comme ara::core::Optional. Un accès sans vérification préalable au moyen de has_value() conduit, en présence de paquets incomplets, à des erreurs d'exécution ou à un comportement indéfini.
• Violation de la garantie noexcept dans le destructeur : le destructeur étant spécifié avec noexcept [SWS_RDS_90310], toute exception levée pendant le nettoyage dans les classes dérivées et non traitée localement entraîne l'arrêt immédiat du programme via std::terminate.
• Indications de longueur incohérentes : si la valeur de ntscf_data_length [SWS_RDS_90306], [SWS_RDS_90308] ne concorde pas avec la taille réelle du tampon du pilote réseau, des dépassements de tampon ou une lecture incomplète peuvent survenir lors du traitement des données.