namespace ara::nm

Der Namespace ara::nm stellt mit NetworkHandle Schnittstellen für den kontrollierten Zugriff auf den angeforderten und effektiven Netzwerkstatus der AUTOSAR Adaptive Platform bereit. Mögliche Fehlersituationen im Betriebsablauf werden über die standardisierten Fehlercodes der Enumeration NmErrc wie kServiceNotAvailable oder kInvalidHandler abgebildet [SWS_ANM_01111]. Zur strukturierten Fehlerbehandlung erzeugt MakeErrorCode thread-sicher Fehlercodes für die Fehlerdomäne NmErrorDomain, welche über GetNmDomain referenziert wird [SWS_ANM_01109]. Anwendungen müssen vor Aufrufen die Erreichbarkeit des Netzwerkmanagement-Dienstes berücksichtigen, um Ausfälle bei Statusabfragen zu vermeiden.

mehr ›

Kontext

Der Namespace ara::nm stellt auf der AUTOSAR Adaptive Platform die Kernschnittstellen für das funktionale Network Management bereit. Die primäre funktionale Schnittstelle bildet die Klasse NetworkHandle, welche den kontrollierten Zugang sowohl zum angeforderten als auch zum effektiven Netzwerkstatus kapselt. Über diesen Abstraktionsmechanismus können funktionale Anwendungen und Plattformdienste den aktuellen Betriebszustand des zugrunde liegenden Kommunikationsnetzwerks überwachen und Statusänderungen initiieren.

Für eine konsistente und robuste Fehlerbehandlung stellt ara::nm standardisierte Typen und Hilfsfunktionen bereit, die in die Fehlerarchitektur von AUTOSAR Adaptive eingebunden sind. Hierzu gehören die Fehlerdomäne NmErrorDomain, die Ausnahme-Klasse NmException sowie die domainspezifische Aufzählung NmErrc [SWS_ANM_01111]. Ergänzend stehen die thread-sicheren Funktionen GetNmDomain [SWS_ANM_01109] und MakeErrorCode [SWS_ANM_01110] zur Verfügung, welche die instanziierungs- und typkonforme Handhabung von Fehlerzuständen gewährleisten.

Kontextdiagramm: Zusammenspiel von Anwendung, NetworkHandle und Fehlerarchitektur in ara::nm. Quellen: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Nutzungspfad

In einem typischen Einsatzszenario interagiert eine Adaptive Application mit dem Namespace ara::nm, um den Status des Netzwerks zu kontrollieren und auf Laufzeitereignisse zu reagieren. Die Interaktionsabfolge gliedert sich in folgende Schritte:

• Statuszugriff initiieren: Die Anwendung nutzt ein NetworkHandle, um den angeforderten oder den gegenwärtig effektiven Netzstatus abzufragen.
• Fehlererkennung: Kann die Netzanforderung nicht ordnungsgemäß bedient werden, signalisiert die Schnittstelle ein entsprechendes Fehlerereignis. Interpretation: Bei Ausfällen der zugrunde liegenden Netzwerkdienste dürfte NetworkHandle intern Fehlercodes auf Basis von NmErrc erzeugen. Frage Q-97b1567be5e28121 (offen)
• Fehlercode erzeugen: Die Hilfsfunktion MakeErrorCode [SWS_ANM_01110] nimmt einen Wert aus NmErrc [SWS_ANM_01111] sowie anwendungsspezifische Zusatzdaten (ara::core::ErrorDomain::SupportDataType) entgegen und generiert daraus einen vollwertigen ara::core::ErrorCode. Die Funktion ist als constexpr und noexcept spezifiziert und garantiert vollständige Thread-Sicherheit [SWS_ANM_01110].
• Fehlerdomäne verifizieren: Die aufrufende Komponente kann über GetNmDomain [SWS_ANM_01109] eine thread-sichere Referenz auf die globale NmErrorDomain abrufen, um die Fehlerdomäne des zurückgegebenen Codes zu prüfen und domainspezifische Fehlerbeschreibungen aufzulösen.

Sequenzdiagramm: Ablauf der Netzstatusabfrage und Fehlerauflösung über ara::nm. Quellen: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Fehlerszenarien

Die standardisierten Fehlercodes des Moduls sind in der Enumeration NmErrc gebündelt, die auf ara::core::ErrorDomain::CodeType basiert [SWS_ANM_01111]. Das Modul unterscheidet folgende Fehlerfälle:

• NmErrc::kServiceNotAvailable (Code 1): Dieser Fehler kennzeichnet, dass der für die Netzwerkverwaltung erforderliche Dienst zur Laufzeit nicht erreichbar oder betriebsbereit ist [SWS_ANM_01111]. Aufrufer müssen in diesem Fall mit Wiederholungsversuchen oder Rückfallstrategien reagieren.
• NmErrc::kInvalidHandler (Code 2): Tritt auf, wenn bei einer Operation ein ungültiger oder nicht registrierter Handler übergeben oder referenziert wurde [SWS_ANM_01111]. Dies deutet in der Regel auf einen Konfigurations- oder Initialisierungsfehler im Aufrufer hin.

Vorbedingungen für robuste Aufrufe sind eine initialisierte Dienstinfrastruktur sowie gültige Parameter beim Zugriff auf NetworkHandle, um NmErrc::kServiceNotAvailable oder NmErrc::kInvalidHandler zu vermeiden [SWS_ANM_01111]. Alle Kernfunktionen der Fehlerbehandlung wie MakeErrorCode [SWS_ANM_01110] und GetNmDomain [SWS_ANM_01109] werfen selbst keine Ausnahmen (noexcept). Interpretation: Für Applikationen, die eine ausnahmebasierte Kontrollstruktur bevorzugen, dürfte die Exception-Klasse NmException als Träger fungieren, um Fehlerzustände strukturiert durch den Callstack zu propagieren. Frage Q-67a17c37021e8beb (offen)