namespace ara::nm

L'espace de noms ara::nm fournit avec NetworkHandle des interfaces pour l'accès contrôlé à l'état réseau demandé et effectif de l'AUTOSAR Adaptive Platform. Les situations d'erreur possibles lors du fonctionnement sont représentées par les codes d'erreur standardisés de l'énumération NmErrc tels que kServiceNotAvailable ou kInvalidHandler [SWS_ANM_01111]. Pour un traitement structuré des erreurs, MakeErrorCode génère de manière thread-safe des codes d'erreur pour le domaine d'erreur NmErrorDomain, qui est référencé via GetNmDomain [SWS_ANM_01109]. Les applications doivent prendre en compte la disponibilité du service de gestion de réseau avant tout appel afin d'éviter des défaillances lors des interrogations d'état.

plus ›

Contexte

L'espace de noms ara::nm fournit sur l'AUTOSAR Adaptive Platform les interfaces clés pour le Network Management fonctionnel. L'interface fonctionnelle principale est constituée par la classe NetworkHandle, qui encapsule l'accès contrôlé tant à l'état réseau demandé qu'à l'état réseau effectif. Grâce à ce mécanisme d'abstraction, les applications fonctionnelles et les services de plateforme peuvent surveiller l'état de fonctionnement actuel du réseau de communication sous-jacent et initier des changements d'état.

Pour un traitement des erreurs cohérent et robuste, ara::nm fournit des types et des fonctions utilitaires standardisés qui sont intégrés dans l'architecture de gestion des erreurs d'AUTOSAR Adaptive. En font partie le domaine d'erreur NmErrorDomain, la classe d'exception NmException ainsi que l'énumération spécifique au domaine NmErrc [SWS_ANM_01111]. En complément, les fonctions thread-safe GetNmDomain [SWS_ANM_01109] et MakeErrorCode [SWS_ANM_01110] sont disponibles, assurant une manipulation des états d'erreur conforme au typage et à l'instanciation.

Diagramme de contexte : interaction entre l'application, NetworkHandle et l'architecture de gestion des erreurs dans ara::nm. Sources : [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Parcours d'utilisation

Dans un scénario d'utilisation typique, une Adaptive Application interagit avec l'espace de noms ara::nm afin de contrôler l'état du réseau et de réagir aux événements d'exécution. La séquence d'interaction se divise selon les étapes suivantes :

• Initier l'accès à l'état : l'application utilise un NetworkHandle pour interroger l'état réseau demandé ou actuellement effectif.
• Détection d'erreur : si la demande réseau ne peut pas être traitée correctement, l'interface signale un événement d'erreur correspondant. Interprétation : en cas de défaillance des services réseau sous-jacents, NetworkHandle devrait générer en interne des codes d'erreur basés sur NmErrc. Question Q-97b1567be5e28121 (ouverte)
• Générer le code d'erreur : la fonction utilitaire MakeErrorCode [SWS_ANM_01110] reçoit une valeur issue de NmErrc [SWS_ANM_01111] ainsi que des données supplémentaires spécifiques à l'application (ara::core::ErrorDomain::SupportDataType) et génère à partir de celles-ci un ara::core::ErrorCode à part entière. La fonction est spécifiée comme constexpr et noexcept et garantit une sécurité de thread totale [SWS_ANM_01110].
• Vérifier le domaine d'erreur : le composant appelant peut obtenir via GetNmDomain [SWS_ANM_01109] une référence thread-safe vers le NmErrorDomain global afin de vérifier le domaine d'erreur du code renvoyé et de résoudre les descriptions d'erreurs spécifiques au domaine.

Diagramme de séquence : déroulement de l'interrogation de l'état réseau et de la résolution d'erreurs via ara::nm. Sources : [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Scénarios d'erreur

Les codes d'erreur standardisés du module sont regroupés dans l'énumération NmErrc, qui est basée sur ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. Le module distingue les cas d'erreur suivants :

• NmErrc::kServiceNotAvailable (code 1) : cette erreur indique que le service requis pour la gestion de réseau n'est pas joignable ou opérationnel à l'exécution [SWS_ANM_01111]. Dans ce cas, les appelants doivent réagir par des tentatives de relance ou des stratégies de repli.
• NmErrc::kInvalidHandler (code 2) : survient lorsqu'un gestionnaire non valide ou non enregistré a été transmis ou référencé lors d'une opération [SWS_ANM_01111]. Cela indique généralement une erreur de configuration ou d'initialisation chez l'appelant.

Les préconditions pour des appels robustes sont une infrastructure de service initialisée ainsi que des paramètres valides lors de l'accès à NetworkHandle, afin d'éviter NmErrc::kServiceNotAvailable ou NmErrc::kInvalidHandler [SWS_ANM_01111]. Toutes les fonctions clés de traitement des erreurs telles que MakeErrorCode [SWS_ANM_01110] et GetNmDomain [SWS_ANM_01109] ne lèvent elles-mêmes aucune exception (noexcept). Interprétation : pour les applications qui privilégient une structure de contrôle basée sur des exceptions, la classe d'exception NmException devrait faire office de vecteur pour propager de manière structurée les états d'erreur à travers la pile d'appels. Question Q-67a17c37021e8beb (ouverte)