klasse ara::fw::FirewallStateSwitchInterface

De template-klasse ara::fw::FirewallStateSwitchInterface dient in AUTOSAR Adaptive voor het omschakelen tussen verschillende firewall-toestanden en de daaraan gekoppelde filterregelsets. Na de thread-safe creatie via een ara::core::InstanceSpecifier [AP_SWS_Fw_82002] wordt de toestandsverandering asynchroon geïnitieerd via SwitchFirewallState en bewaakt via een ara::core::Future<void> [AP_SWS_Fw_82008]. De klasse dwingt een zuivere move-semantiek af zonder kopieermogelijkheid, waarbij de destructor en move-bewerkingen niet thread-safe zijn en fouten asynchroon via de future worden gesignaleerd.

meer ›

Context

De template-klasse ara::fw::FirewallStateSwitchInterface dient binnen het functionele cluster fw (Firewall) van het AUTOSAR Adaptive Platform als primaire interface voor het wisselen tussen verschillende firewall-toestanden. Onder een firewall-toestand wordt een gedefinieerde configuratie van filterregelsets verstaan die het netwerkverkeer beveiligen. De template-parameter EnumT representeert een applicatiespecifieke enumeratie van alle toegestane firewall-toestanden. Als typische interactiepartners treden vermoedelijk overkoepelende platforminstanties op, zoals een mode-management, die de filterregels aanpassen aan veranderde voertuig- of bedrijfsmodi. Vraag Q-5424cd3802d53915 (open)

Levenscyclus

Het aanmaken van een instantie gebeurt expliciet via de constructor onder opgave van een ara::core::InstanceSpecifier [AP_SWS_Fw_82002]. Deze constructiestap is gespecificeerd als thread-safe. Via de InstanceSpecifier wordt vermoedelijk de concrete toewijzing aan een in het platformmanifest gemodelleerde firewall-instantie herleid. Vraag Q-97db4416453c9885 (open)

De klasse is gedeclareerd als final en implementeert een zuivere move-semantiek: de copy-constructor [AP_SWS_Fw_82004] en de copy-assignment-operator [AP_SWS_Fw_82005] zijn verwijderd (=delete), waardoor duplicatie wordt verhinderd. In plaats daarvan worden een move-constructor [AP_SWS_Fw_82006] en een move-assignment-operator [AP_SWS_Fw_82007] aangeboden, die beide als noexcept zijn gedefinieerd. Belangrijk voor de gelijktijdigheid is dat zowel de destructor [AP_SWS_Fw_82003] als de move-bewerkingen niet thread-safe zijn. De aanroepende applicatie moet daarom waarborgen dat levenscyclusbewerkingen en eigendomsoverdrachten thread-lokaal of gesynchroniseerd verlopen.

Gebruikspad

Het reguliere verloop voor het omschakelen van regelsets bestaat uit de volgende stappen:

1. Initialisatie: het interface-object wordt aangemaakt onder opgave van het doel-InstanceSpecifier [AP_SWS_Fw_82002].
2. Toestandswijziging aanvragen: via de methode SwitchFirewallState wordt de gewenste doeltoestand van het type EnumT doorgegeven [AP_SWS_Fw_82008].
3. Asynchrone bevestiging afwachten: de methode levert een ara::core::Future<void> op [AP_SWS_Fw_82008]. Aanroepers kunnen de future blokkerend afhandelen of asynchroon bewaken totdat de onderliggende wisseling van de regelset is voltooid.

Sequentiediagram: typisch verloop van de asynchrone toestandswijziging. Bronnen: [AP_SWS_Fw_82002], [AP_SWS_Fw_82008].

Foutscenario's

De methode SwitchFirewallState is gedeclareerd met noexcept en gooit geen C++-excepties [AP_SWS_Fw_82008]. Fouten bij de omschakeling worden ingekapseld in de geretourneerde ara::core::Future<void>. De volgende foutcodes zijn gespecificeerd voor de aanroep [AP_SWS_Fw_82008]:

• FwErrc::kServiceNotAvailable: de verantwoordelijke firewall-service is niet beschikbaar of antwoordt niet [AP_SWS_Fw_82008].
• FwErrc::kInvalidStateDependentFirewall: De aangevraagde toestand is ongeldig voor de gereferentieerde Firewall of niet voorzien in de configuratie [AP_SWS_Fw_82008].

Als voorwaarde voor de omschakeling geldt dat het interface-object geldig geïnstantieerd is en er een verbinding bestaat met de firewall-service. Als nabepaling is bij succes de nieuwe filterregelset actief, terwijl bij een fout de eerdere toestand ongewijzigd blijft.