classe ara::diag::DynamicAccessListDiagServiceBuilder

Utilisation

La méthode synchrone Add de la classe ara::diag::DynamicAccessListDiagServiceBuilder sert à ajouter un octet individuel (Byte value) à un DynamicAccessListPattern [SWS_DM_01175]. La valeur d'octet transmise est vérifiée pour une correspondance exacte lors de l'évaluation des droits d'accès pour les services de diagnostic [SWS_DM_01175]. En renvoyant une référence à l'instance du même objet (DynamicAccessListDiagServiceBuilder&), la fonction prend en charge l'appel sous forme d'API fluide [SWS_DM_01175].

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

L'opération est déclarée comme noexcept et spécifiée comme sûre vis-à-vis des exceptions (exception safe) [SWS_DM_01175]. Ni codes d'erreur ni valeurs de retour de type ara::core::Result ne sont renvoyés ; aucun message DET ou DEM spécifique n'est désigné dans la charge utile pour cette fonction.

Concurrence et restrictions

La méthode est spécifiée comme non sûre pour les threads (not thread-safe) [SWS_DM_01175]. Interprétation : les appels sur une même instance de constructeur devraient donc typiquement s'effectuer de manière séquentielle au sein d'un thread unique, avant que le modèle d'accès créé ne soit évalué dans le serveur de diagnostic. Question Q-69d895fc6bf90cb4 (ouverte)

Interaction

Au sein de l'interface DynamicAccessListDiagServiceBuilder, cette méthode complète des surcharges apparentées de Add permettant d'ajouter des séquences d'octets via ByteString [SWS_DM_01176] ou des plages de valeurs via ByteRange [SWS_DM_01177] à un DynamicAccessListPattern.

La fonction membre Add de la classe ara::diag::DynamicAccessListDiagServiceBuilder sert à ajouter une séquence d'octets à un DynamicAccessListPattern [SWS_DM_01176]. Le paramètre d'entrée values de type ByteString transmet une séquence d'octets qui sera vérifiée pour une correspondance exacte lors de l'évaluation ultérieure des droits d'accès pour les services de diagnostic [SWS_DM_01176]. En tant que valeur de retour, la méthode fournit une référence à la même instance de monteur (DynamicAccessListDiagServiceBuilder&), ce qui permet une utilisation d'interface fluide (Fluent API) par chaînage de plusieurs appels [SWS_DM_01176].

Concernant la gestion des erreurs, la fonction est déclarée comme noexcept et spécifiée comme sûre vis-à-vis des exceptions (exception safe) [SWS_DM_01176]. Ni codes d'erreur ni exceptions C++ ne sont signalés.

En matière de concurrence, la méthode est définie comme non sûre pour les threads (not thread-safe) [SWS_DM_01176]. Si plusieurs threads accèdent en parallèle à la même instance de monteur, les appels doivent être synchronisés côté application. Interprétation : l'appel devrait s'effectuer de manière synchrone dans le contexte d'exécution du thread applicatif de configuration, étant donné qu'aucun mécanisme asynchrone n'est spécifié. Question Q-d93498e82292a88e (ouverte)

Dans l'interaction de la gestion du diagnostic, cette méthode complète des fonctions de monteur apparentées pour la définition de modèles d'accès dynamiques : alors que des séquences d'octets complètes sont enregistrées avec cette fonction, des fonctions Add surchargées permettent également, de manière alternative, d'ajouter au modèle des octets individuels ([SWS_DM_01175]) ou des plages de valeurs ([SWS_DM_01177]).

La fonction Add de la classe ara::diag::DynamicAccessListDiagServiceBuilder permet aux applications d'ajouter une plage de valeurs d'octets à un DynamicAccessListPattern [SWS_DM_01177]. Le paramètre range transmis, de type ByteRange, définit un intervalle de valeurs dont la concordance est vérifiée lors de l'évaluation des droits d'accès pour les services de diagnostic [SWS_DM_01177].

Pour l'appel et l'intégration dans le Diagnostic Management, les propriétés suivantes s'appliquent :

• Contexte d'appel et sémantique : L'appel s'effectue de manière synchrone. Comme valeur de retour, la fonction fournit une référence d'objet sur la même instance de constructeur (DynamicAccessListDiagServiceBuilder&), afin de favoriser une utilisation fluide de l'interface (Fluent API) par chaînage de méthodes [SWS_DM_01177].
• Gestion des erreurs : L'opération est déclarée comme noexcept et possède la propriété de spécification exception safe [SWS_DM_01177]. Aucun code d'erreur spécifique n'est renvoyé et aucune exception n'est levée.
• Concurrence : La fonction est explicitement spécifiée comme not thread-safe [SWS_DM_01177]. Interprétation : si plusieurs threads d'exécution accèdent à la même instance de constructeur, l'application appelante doit synchroniser l'accès de façon externe. Question Q-c51760a8fe29bd5f (ouverte)
• Interaction : La méthode complète les fonctions associées de la classe de constructeur permettant d'ajouter des valeurs d'octets individuelles via [SWS_DM_01175] ainsi que de définir des séquences d'octets au moyen de [SWS_DM_01176], afin de configurer des modèles d'accès flexibles.

Utilisation

La méthode ara::diag::DynamicAccessListDiagServiceBuilder::Any sert au logiciel d'application à définir des caractères génériques dans un motif d'accès ([SWS_DM_01178]). L'appel synchrone s'effectue sur une instance du builder. Le paramètre numberOfBytesToIgnore permet de déterminer combien d'octets consécutifs sont certes inclus dans le motif d'accès, mais ignorés lors du filtrage ultérieur par motif (pattern matching) par rapport aux requêtes de diagnostic entrantes ([SWS_DM_01220]). Le renvoi d'une référence d'objet vers le même builder permet un style d'appel d'API fluide (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 « Any »).

Traitement des erreurs et comportement face aux exceptions

La fonction est spécifiée comme noexcept et sûre vis-à-vis des exceptions (exception safe) ([SWS_DM_01178]). Ni codes d'erreur ni retours vers DET ou DEM ne sont prévus. Interprétation : lors de la transmission de la valeur 0 pour numberOfBytesToIgnore, l'appel devrait retourner sans erreur et n'enregistrer aucun octet générique dans le motif. Question Q-e372cda9f8840893 (ouverte)

Concurrence et restrictions

L'interface est explicitement désignée comme non sûre vis-à-vis des threads (not thread-safe) ([SWS_DM_01178]). Plusieurs appels du builder sur la même instance de DynamicAccessListDiagServiceBuilder doivent donc obligatoirement se dérouler de manière séquentielle ou être synchronisés par l'appelant.

Interaction

Les définitions de caractères génériques via Any sont typiquement combinées avec des motifs tels que EndsWith ([SWS_DM_01221]). Après l'assemblage de tous les composants de motif, la configuration doit être finalisée avec la méthode Build ([SWS_DM_01222]) avant que la liste d'accès résultante ne soit disponible pour les vérifications (AUTOSAR_AP_SWS_Diagnostics §7.3.2 « Adding wildcards to a DynamicAccessList »).

Utilisation

La méthode synchrone Build de la classe ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) conclut la création d'une liste d'accès dynamique ([SWS_DM_01181]). La fonction ne prend aucun paramètre d'entrée et ne possède aucune valeur de retour ([SWS_DM_01181]). Grâce à cet appel, l'instance de serveur de diagnostic compétente prend en charge les règles d'accès assemblées ([SWS_DM_01222]).

Gestion des erreurs

L'opération est déclarée comme noexcept et spécifiée comme sûre vis-à-vis des exceptions (exception safe) ([SWS_DM_01181]). Aucun code d'erreur n'est renvoyé et aucune exception n'est levée.

Concurrence et restrictions

La méthode est classée comme non sûre vis-à-vis des threads (not thread-safe) ([SWS_DM_01181]). Les accès simultanés au même objet builder depuis plusieurs contextes d'exécution doivent donc être sécurisés en externe. De plus, il existe une condition d'ordre stricte : Build doit impérativement être appelée avant que l'objet service builder ne soit détruit ([SWS_DM_01181]). Interprétation : si cet appel n'a pas lieu avant la fin de vie de l'objet, les motifs précédemment configurés devraient devenir caducs et ne pas prendre effet pour l'autorisation. Question Q-445ea33ece339d42 (ouverte)

Interaction

Dans le cadre de la création de la liste, des motifs de service et de requête sont préalablement définis, par exemple au moyen de caractères génériques via Any ([SWS_DM_01220]) ou de motifs finaux via EndsWith ([SWS_DM_01221]), comme décrit dans SWS Diagnostics §7.3.2.3.4 « DynamicAccessList Creation and Update ». Build finalise ce processus de construction et transmet la liste au serveur ([SWS_DM_01222]).

La méthode synchrone EndsWith de la classe ara::diag::DynamicAccessListDiagServiceBuilder permet aux applications de définir un octet unique (Byte value) comme motif de fin d'une liste d'accès dynamique [SWS_DM_01179]. Lors de l'appel, l'instance de Diagnostic Server affecte ce motif à la fin de la DynamicAccessList afin de vérifier sa correspondance exacte lors de l'évaluation des droits de service de diagnostic [SWS_DM_01221]. La fonction ne fournit aucune valeur de retour.

Concernant la gestion des erreurs, la fonction est spécifiée comme sûre vis-à-vis des exceptions (exception safe) et déclarée avec noexcept [SWS_DM_01179]. Aucun code d'erreur spécifique ni message DET ou DEM n'est prévu dans le périmètre de la spécification pour cet appel de méthode.

En matière de concurrence, la méthode est indiquée comme non thread-safe (not thread-safe) [SWS_DM_01179]. En cas d'accès concurrent à la même instance de constructeur (builder), une synchronisation externe par l'application est requise. Interprétation : la définition du motif de fin devrait devoir avoir lieu avant l'appel de Build [SWS_DM_01222], car le Diagnostic Server finalise la DynamicAccessList avec Build. Question Q-a0afa7deaafa306b (ouverte)

En interaction avec des exigences connexes, il existe outre cette variante à valeur unique une surcharge EndsWith(ByteRange range) [SWS_DM_01180], qui autorise la spécification d'une plage fermée de valeurs d'octets comme motif de terminaison SWS Diagnostics §8.15.1.2.3.6 « EndsWith(ByteRange) ». Les deux variantes configurent le motif de fin de la même liste d'accès avant son utilisation [SWS_DM_01221].

Utilisation

La méthode EndsWith de la classe ara::diag::DynamicAccessListDiagServiceBuilder sert à définir un intervalle d'octets fermé (ByteRange range) à la fin du modèle de recherche d'une liste d'accès dynamique (DynamicAccessList) [SWS_DM_01180]. Lors de l'appel de la méthode, l'instance du serveur de diagnostic ajoute le modèle spécifié à la fin de la DynamicAccessList [SWS_DM_01221]. Cette plage de valeurs est ensuite utilisée lors de l'évaluation des droits d'accès pour les services de diagnostic AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 « EndsWith(ByteRange) ». L'appel s'effectue de manière synchrone et ne fournit aucune valeur de retour (void) [SWS_DM_01180].

Gestion des erreurs et concurrence

L'opération est déclarée comme noexcept et spécifiée comme sûre vis-à-vis des exceptions (exception safe) ; aucun code d'erreur spécifique ni traitement d'exception n'existe [SWS_DM_01180]. En ce qui concerne la concurrence, la méthode est classée comme non sûre pour les threads (not thread-safe) [SWS_DM_01180]. Un accès parallèle à la même instance de monteur à travers plusieurs threads est interdit sans synchronisation externe.

Zusammenspiel et cycle de vie

Dans le cadre de la création du modèle, il existe, outre cette variante pour les plages de valeurs, une surcharge alternative de EndsWith qui définit un octet unique (Byte value) pour la concordance exacte du modèle à la fin [SWS_DM_01179]. Après la configuration du modèle, la liste doit être finalisée par l'appel de Build [SWS_DM_01222], avant que l'application ne puisse utiliser la DynamicAccessList générée pour les contrôles d'autorisation AUTOSAR_AP_SWS_Diagnostics §7.3.2 « End patterns of a DynamicAccessList ».