namespace ara::fw

L'espace de noms ara::fw fournit des types et des interfaces pour la commande de Firewall ainsi que leur traitement des erreurs standardisé dans l'AUTOSAR Adaptive Platform. Le module définit avec FirewallStateSwitchInterface une interface pour les états de Firewall et génère, via la fonction thread-safe MakeErrorCode, des objets d'erreur typés basés sur le domaine d'erreur FwErrorDomain [AP_SWS_Fw_83003]. Les problèmes survenant sont représentés par l'énumération FwErrc, qui indique entre autres des services non disponibles ou des configurations dépendantes de l'état non valides [AP_SWS_Fw_83001]. Toutes les fonctions centrales de génération d'erreurs sont thread-safe et déclarées comme noexcept.

plus ›

Contexte

L'espace de noms ara::fw regroupe les interfaces de programmation et les types pour la fonctionnalité Firewall de l'AUTOSAR Adaptive Platform dans la version R25-11. Le rôle principal du module consiste à fournir des mécanismes de filtrage et de sécurisation de la communication réseau intra-véhicule. Les éléments constitutifs clés de l'espace de noms comprennent l'interface FirewallStateSwitchInterface ainsi que les composants pour le traitement standardisé des erreurs, constitués de FwErrorDomain, FwException et des codes d'erreur associés. L'architecture s'intègre de manière transparente dans le concept d'erreur de plateforme de ara::core. Les partenaires d'interaction externes tels que les services de plateforme de gestion d'état ou les applications utilisent l'espace de noms pour commander des états de Firewall pertinents pour la sécurité ou résoudre les erreurs d'exécution survenues. Interprétation : la classe FirewallStateSwitchInterface sert vraisemblablement d'interface principale pour l'activation et la commutation de jeux de règles en fonction de l'état global du système. Question Q-d4ba0994e0147cf1 (ouverte)

Diagramme de contexte : interaction entre l'application, FirewallStateSwitchInterface et FwErrorDomain lors de la résolution d'erreurs. Sources : [AP_SWS_Fw_83001], [AP_SWS_Fw_83002], [AP_SWS_Fw_83003].

Parcours d'utilisation

Le chemin d'utilisation typique dans l'espace de noms ara::fw comprend l'initiation de changements d'état ainsi que la génération, la transmission et l'évaluation d'états d'erreur lors de l'exécution de fonctions de Firewall. Si une opération dans le contexte de FirewallStateSwitchInterface échoue ou si une demande d'état ne peut être satisfaite, le module accède au domaine d'erreur spécifique afin de fournir à l'appelant un résultat de diagnostic précis. Pour instancier une telle erreur, la fonction MakeErrorCode est appelée [AP_SWS_Fw_83003]. Cette fonction crée un ara::core::ErrorCode en recevant une valeur d'erreur issue de FwErrc [AP_SWS_Fw_83001] et des données supplémentaires facultatives spécifiques au constructeur de type ara::core::ErrorDomain::SupportDataType [AP_SWS_Fw_83003]. Comme MakeErrorCode est déclarée comme constexpr et noexcept, la création du code d'erreur peut s'effectuer de manière déterministe et économe en ressources.

Du côté de l'appelant, l'erreur retournée est généralement reçue dans un objet de résultat (tel que ara::core::Result). La fonction libre GetFwErrorDomain [AP_SWS_Fw_83002], qui fournit une référence constante vers le singleton du domaine d'erreur FwErrorDomain, sert à la vérification programmatique de l'origine de l'erreur. Les appelants peuvent ainsi vérifier si une erreur survenue provient effectivement du module Firewall et déterminer sa description textuelle. Interprétation : dans les architectures système qui utilisent des exceptions C++, la classe FwException sert vraisemblablement à encapsuler le ara::core::ErrorCode de manière interceptable et à le transmettre de façon synchrone aux routines de traitement d'erreurs de niveau supérieur. Question (ouverte)

Scénarios d'erreur

Pour les situations d'erreur, l'énumération FwErrc dans l'espace de noms ara::fw définit des causes d'erreur spécifiques pour le domaine d'erreur FwErrorDomain [AP_SWS_Fw_83001]. Le fichier d'en-tête ara/fw/fw_error_domain.h déclare à cet effet les états d'erreur standardisés suivants :

• kServiceNotAvailable (valeur 1) : indique que le service Firewall adressé n'est pas joignable à l'exécution ou n'est actuellement pas opérationnel [AP_SWS_Fw_83001]. Les causes possibles résident dans des composants d'arrière-plan pas encore initialisés ou des coupures de connexion temporaires. Les préconditions pour les appels ultérieurs ne sont pas remplies, de sorte que les appelants doivent interroger l'état du service ou réitérer la requête ultérieurement.
• kInvalidStateDependentFirewall (valeur 2) : survient lorsqu'une configuration de Firewall dépendante de l'état demandée n'est pas valide ou qu'une transition d'état non valide a été demandée [AP_SWS_Fw_83001]. La précondition pour des opérations de commutation réussies est que le Firewall cible prenne en charge les états souhaités et que le système se trouve dans un état de base admissible. Après l'apparition de cette erreur, le Firewall demeure inchangé dans son mode de protection antérieur.

Les deux valeurs d'erreur sont basées sur le type de base ara::core::ErrorDomain::CodeType [AP_SWS_Fw_83001]. Les fonctions GetFwErrorDomain [AP_SWS_Fw_83002] et MakeErrorCode [AP_SWS_Fw_83003] sont expressément déclarées comme thread-safe (thread-safe) et noexcept, garantissant ainsi un traitement des erreurs sûr même dans des contextes hautement concurrents ou critiques en temps.