classe ara::diag::SovdBulkData

Utilisation

La fonction virtuelle DeleteAllBulkData de la classe ara::diag::SovdBulkData est appelée pour exécuter la méthode SOVD « Delete All Bulk Data Defined by Category » [SWS_DM_01855]. La définition d'interface est déposée dans l'en-tête ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.1 « DeleteAllBulkData ».

La méthode reçoit les paramètres de transmission suivants :

• bulkDataCategory (ara::core::String) : identifie la catégorie de données de masse dont toutes les instances doivent être supprimées [SWS_DM_01855].
• metaInfo (MetaInfo const &) : transmet les métadonnées contextuelles de la requête en cours [SWS_DM_01855].
• cancellationHandler (CancellationHandler) : informe de l'interruption prématurée de la conversation en cours [SWS_DM_01855].

Le résultat est mis à disposition de manière asynchrone via un ara::core::Future<DeleteByCategoryResult> [SWS_DM_01855]. Interprétation : le nettoyage de catégories entières de données de masse pouvant être long, l'application devrait vérifier périodiquement le cancellationHandler transmis afin de réagir immédiatement à d'éventuelles interruptions. Question Q-59d2847dbe42f240 (ouverte)

Gestion des erreurs et sécurité vis-à-vis des exceptions

La méthode est déclarée comme noexcept et sûre face aux exceptions (exception safe) [SWS_DM_01855]. Si la suppression échoue, un code d'erreur SOVD approprié selon ISO 17978-3 ou ASAM SOVD 1.1 doit être transmis dans le ara::core::Future [SWS_DM_01855].

concurrence

La sécurité vis-à-vis des threads est conditionnelle (conditional) : le fait que l'implémentation doive être conçue pour être thread-safe ou non thread-safe est défini via le ConcurrencyType transmis au constructeur [SWS_DM_01855].

La méthode DeleteSpecificBulkData de l'interface ara::diag::SovdBulkData est appelée pour supprimer une ressource de données de masse spécifique dans le cadre de la méthode SOVD « Delete Specific Bulk Data Resource » ([SWS_DM_01856], AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.2 « DeleteSpecificBulkData »). La déclaration s'effectue via le fichier d'en-tête #include "ara/diag/sovd_bulk_data.h".

Lors de l'appel, les paramètres suivants sont transmis à l'implémentation du service :

• bulkDataCategory : identifie la catégorie de l'instance de données de masse à supprimer.
• bulkDataId : identifiant unique de la ressource de données de masse spécifique qui doit être supprimée.
• metaInfo : transmet des métadonnées supplémentaires de la requête SOVD entrante.
• cancellationHandler : surveille l'état de l'opération et informe si la conversation en cours est interrompue.

L'opération fonctionne de manière asynchrone et renvoie un ara::core::Future<void> ([SWS_DM_01856]). En cas de suppression réussie, le future est résolu sans valeur. Si une erreur survient pendant le traitement, le future doit être complété avec un code d'erreur SOVD pertinent selon ISO 17978-3 ou ASAM SOVD 1.1 ([SWS_DM_01856]).

Concernant la concurrence, la méthode est déclarée comme noexcept et doit être implémentée exception safe. La sécurité vis-à-vis des threads requise est conditionnelle : le fait que la fonction doive être exécutée de manière thread-safe est déterminé par le ConcurrencyType transmis dans le constructeur ([SWS_DM_01856]). L'implémentation devrait devoir s'assurer que les éventuels travaux de nettoyage s'effectuent de manière fiable, même en cas de notification précoce par le cancellationHandler. Question Q-2336b99585d8bf3c (ouverte)

La méthode ara::diag::SovdBulkData::Offer sert à activer le transfert des requêtes de diagnostic : par cet appel, le Diagnostic Management (DM) est autorisé et rendu capable de transmettre les messages de requête entrants pour les bulk data au gestionnaire correspondant ([SWS_DM_01857]).

Utilisation et sémantique : la fonction possède la signature ara::core::Result<void> Offer() noexcept, est sans paramètre et garantit, en tant que sûre face aux exceptions (exception safe), qu'aucune exception C++ n'est levée ([SWS_DM_01857]). Interprétation : étant donné que le résultat est renvoyé directement sous la forme d'un ara::core::Result<void> et non via un objet future asynchrone, le processus d'enregistrement devrait être exécuté de manière synchrone. Question Q-9933248363829009 (ouverte)

Gestion des erreurs : en cas d'échec de l'enregistrement, la fonction renvoie un ara::core::Result avec un code d'erreur approprié issu du domaine d'erreur ([SWS_DM_01857]) :

• DiagOfferErrc::kAlreadyOffered : le service a déjà été proposé auparavant pour ce gestionnaire ([SWS_DM_01857] ; voir aussi [SWS_DM_00514] ainsi que [SWS_DM_00560]).
• DiagOfferErrc::kConfigurationMismatch : la configuration ne correspond pas aux données de spécification de diagnostic (DEXT) ([SWS_DM_01857]).

Les deux erreurs disposent d'une sémantique de rollback, de sorte qu'aucun enregistrement incomplet ne subsiste en cas d'erreur ([SWS_DM_01857]).

Concurrence et interaction : la méthode est explicitement spécifiée comme non thread-safe (not thread-safe) ([SWS_DM_01857]). Les appels parallèles sur la même instance doivent donc être évités du côté de l'application. Le modèle d'activation est partagé par SovdBulkData avec d'autres services DM tels que GenericRoutine ([SWS_DM_00557]), GenericUDSService ([SWS_DM_00619]) ou CommunicationControl ([SWS_DM_00809]), qui ne sont également débloqués pour le traitement des requêtes qu'au moyen de Offer.

La méthode virtuelle RequestBulkDataDownload de la classe ara::diag::SovdBulkData est appelée pour l’opération SOVD « Download Bulk Data » afin de demander le téléchargement de données de masse [SWS_DM_01873]. La déclaration s’effectue via le fichier d’en-tête ara/diag/sovd_bulk_data.h AUTOSAR_AP_SWS_Diagnostics §8.53.1.1.3.5 « RequestBulkDataDownload ».

Comme paramètres d’entrée, la méthode accepte la catégorie des données de masse (bulkDataCategory), leur identifiant (bulkDataId), une liste d’en-têtes HTTP acceptés (acceptHeader), des métadonnées de requête (metaInfo) ainsi qu’un cancellationHandler qui informe d’une interruption de la conversation courante [SWS_DM_01873]. Le traitement s’effectue de manière asynchrone via un ara::core::Future. Celui-ci renvoie un ara::core::Variant, lequel encapsule soit une session de lecture sous forme d’un tuple composé de DataTransferReadSession et BulkDataMetaDataDescriptor, soit une redirection HTTP (HttpRedirect) [SWS_DM_01873].

En cas d’erreur, un code d’erreur SOVD approprié selon ISO 17978-3 ou ASAM SOVD 1.1 est transmis via le future au moyen de DiagSovdErrc [SWS_DM_01873]. La fonction est déclarée comme noexcept et considérée comme sans émission d’exception (exception safe) [SWS_DM_01873].

En matière de concurrence, la sécurité des threads est conditionnelle (« conditional ») : le fait que la méthode doive être implémentée de manière thread-safe est déterminé par le ConcurrencyType transmis dans le constructeur [SWS_DM_01873]. Interprétation : si une interruption est signalée via le cancellationHandler, l’implémentation devrait mettre fin prématurément aux préparatifs en cours du transfert de données. Question Q-1c74be85e810ac8e (ouverte)

Utilisation et contexte d'appel

La méthode purement virtuelle RequestBulkDataUpload de la classe ara::diag::SovdBulkData est appelée par l'instance de serveur Diagnostic dès qu'un client demande la méthode SOVD « Upload Bulk Data » [SWS_DM_01793]. Elle sert à préparer un téléversement de données de masse pour une catégorie de données déterminée AUTOSAR AP SWS Diagnostics §8.53.1.1.3.6 « RequestBulkDataUpload ».

Lors de l'appel, les paramètres suivants sont transmis à la fonction [SWS_DM_01854] :

• bulkDataCategory : désigne la catégorie de données de masse pour laquelle une nouvelle instance doit être téléversée.
• bulkDataMetaData : descripteur de type BulkDataMetaDataDescriptor, prérempli avec les informations disponibles des en-têtes HTTP de la requête POST SOVD.
• metaInfo : méta-informations supplémentaires de la requête.
• cancellationHandler : signale si la conversation actuelle est interrompue.

Le retour s'effectue de manière asynchrone via un ara::core::Future qui, en cas d'exécution réussie, fournit un tuple composé d'une session d'écriture DataTransferWriteSession et du BulkDataMetaDataDescriptor associé [SWS_DM_01854].

Gestion des erreurs et concurrence

Si une erreur survient lors de la préparation ou de l'exécution, un code d'erreur SOVD pertinent est renvoyé via le Future conformément à l'ISO 17978-3 ou à l'ASAM SOVD 1.1 [SWS_DM_01854]. La fonction est déclarée avec noexcept et doit être sûre du point de vue des exceptions (exception safe) [SWS_DM_01854].

La sécurité des threads est conditionnelle : la nécessité d'implémenter la méthode de manière thread-safe dépend du ConcurrencyType transmis au constructeur de l'instance [SWS_DM_01854]. Interprétation : il devrait incomber à l'implémentation applicative de surveiller le cancellationHandler transmis pendant le processus d'écriture afin de libérer rapidement les ressources allouées à la session d'écriture en cas d'interruption de connexion. Question Q-cc88a00d48a35d61 (ouverte)

La méthode ara::diag::SovdBulkData::StopOffer issue de l'en-tête ara/diag/sovd_bulk_data.h désactive le transfert des messages de requête entrants depuis le Diagnostic Management (DM) vers l'objet respectif [SWS_DM_01858]. Elle ne prend aucun paramètre et ne possède aucune valeur de retour [SWS_DM_01858].

Concernant l'exécution et la sécurité, les conditions suivantes s'appliquent :

• Gestion des erreurs : la fonction est déclarée comme noexcept et classée comme sûre face aux exceptions (exception safe) [SWS_DM_01858]. Aucune exception n'est levée et aucun code d'erreur n'est renvoyé [SWS_DM_01858].
• Concurrence : l'opération est spécifiée comme non thread-safe (not thread-safe) [SWS_DM_01858]. Les appels ne doivent pas être exécutés sans protection en cas d'utilisation parallèle de la même instance.
• Interaction et cycle de vie : l'appel sert au désenregistrement ou à la fin de la disponibilité du service. Après l'appel, les requêtes entrantes ne devraient plus être transmises à l'application par le DM. Ce principe correspond au modèle de mise à disposition standardisé pour les gestionnaires de diagnostic dans Adaptive AUTOSAR, tel qu'il est défini de manière analogue pour des classes de fonctions telles que [SWS_DM_00558] (GenericRoutine), [SWS_DM_00793] (DownloadService) ou [SWS_DM_01017] (EcuResetRequest) (cf. aussi AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 « Monitors »). Question Q-23639406c07ca7c1 (ouverte)