namespace ara::nm

De namespace ara::nm stelt met NetworkHandle interfaces beschikbaar voor de gecontroleerde toegang tot de aangevraagde en effectieve netwerkstatus van het AUTOSAR Adaptive Platform. Mogelijke foutsituaties tijdens de operationele werking worden gerepresenteerd via de gestandaardiseerde foutcodes van de enumeratie NmErrc zoals kServiceNotAvailable of kInvalidHandler [SWS_ANM_01111]. Voor een gestructureerde foutafhandeling genereert MakeErrorCode thread-veilig foutcodes voor het foutdomein NmErrorDomain, dat via GetNmDomain wordt gerefereerd [SWS_ANM_01109]. Toepassingen moeten voorafgaand aan aanroepen rekening houden met de bereikbaarheid van de netwerkbeheerservice om uitval bij statusopvragingen te voorkomen.

meer ›

Context

De namespace ara::nm stelt op het AUTOSAR Adaptive Platform de kerninterfaces voor het functionele Network Management beschikbaar. De primaire functionele interface wordt gevormd door de klasse NetworkHandle, die de gecontroleerde toegang tot zowel de aangevraagde als de effectieve netwerkstatus inkapselt. Via dit abstractiemechanisme kunnen functionele toepassingen en platformservices de actuele bedrijfstoestand van het onderliggende communicatienetwerk bewaken en statuswijzigingen initiëren.

Voor een consistente en robuuste foutafhandeling stelt ara::nm gestandaardiseerde typen en hulpfuncties beschikbaar die zijn geïntegreerd in de foutarchitectuur van AUTOSAR Adaptive. Hiertoe behoren het foutdomein NmErrorDomain, de exceptieklasse NmException en de domeinspecifieke enumeratie NmErrc [SWS_ANM_01111]. Daarnaast zijn de thread-veilige functies GetNmDomain [SWS_ANM_01109] en MakeErrorCode [SWS_ANM_01110] beschikbaar, die de instantiërings- en typeconforme afhandeling van fouttoestanden waarborgen.

Contextdiagram: Samenspel van toepassing, NetworkHandle en foutarchitectuur in ara::nm. Bronnen: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Gebruikspad

In een typisch gebruiksscenario communiceert een Adaptive Application met de namespace ara::nm om de status van het netwerk te controleren en op runtime-events te reageren. De interactiesequentie is onderverdeeld in de volgende stappen:

• Statusoegang initiëren: De toepassing gebruikt een NetworkHandle om de aangevraagde of de momenteel effectieve netwerkstatus op te vragen.
• Foutdetectie: Als de netwerkaanvraag niet correct kan worden afgehandeld, signaleert de interface een overeenkomstig foutevent. Interpretatie: Bij uitval van de onderliggende netwerkservices zal NetworkHandle intern vermoedelijk foutcodes op basis van NmErrc genereren. Vraag Q-97b1567be5e28121 (open)
• Foutcode genereren: De hulpfunctie MakeErrorCode [SWS_ANM_01110] neemt een waarde uit NmErrc [SWS_ANM_01111] en toepassingsspecifieke aanvullende gegevens (ara::core::ErrorDomain::SupportDataType) in ontvangst en genereert daaruit een volwaardige ara::core::ErrorCode. De functie is gespecificeerd als constexpr en noexcept en garandeert volledige thread-veiligheid [SWS_ANM_01110].
• Foutdomein verifiëren: De aanroepende component kan via GetNmDomain [SWS_ANM_01109] een thread-veilige referentie naar het globale NmErrorDomain opvragen om het foutdomein van de geretourneerde code te controleren en domeinspecifieke foutbeschrijvingen op te lossen.

Sequentiediagram: Verloop van de netwerkstatusopvraging en foutresolutie via ara::nm. Bronnen: [SWS_ANM_01109], [SWS_ANM_01110], [SWS_ANM_01111].

Foutscenario's

De gestandaardiseerde foutcodes van de module zijn gebundeld in de enumeratie NmErrc, die is gebaseerd op ara::core::ErrorDomain::CodeType [SWS_ANM_01111]. De module onderscheidt de volgende foutgevallen:

• NmErrc::kServiceNotAvailable (code 1): Deze fout geeft aan dat de voor het netwerkbeheer vereiste service tijdens runtime niet bereikbaar of operationeel is [SWS_ANM_01111]. Aanroepers moeten in dit geval reageren met nieuwe pogingen of fallback-strategieën.
• NmErrc::kInvalidHandler (code 2): Treedt op wanneer bij een bewerking een ongeldige of niet-geregistreerde handler is doorgegeven of gerefereerd [SWS_ANM_01111]. Dit duidt doorgaans op een configuratie- of initialisatiefout in de aanroeper.

Voorwaarden voor robuuste aanroepen zijn een geïnitialiseerde service-infrastructuur en geldige parameters bij de toegang tot NetworkHandle, om NmErrc::kServiceNotAvailable of NmErrc::kInvalidHandler te voorkomen [SWS_ANM_01111]. Alle kernfuncties van de foutafhandeling zoals MakeErrorCode [SWS_ANM_01110] en GetNmDomain [SWS_ANM_01109] werpen zelf geen excepties (noexcept). Interpretatie: Voor applicaties die de voorkeur geven aan een op excepties gebaseerde controlestructuur fungeert de exception-klasse NmException vermoedelijk als drager om fouttoestanden gestructureerd door de callstack te propageren. Vraag Q-67a17c37021e8beb (open)