DEENESPTFRRUARHIKOZHNL

class ara::fw::FirewallStateSwitchInterface

Diese Seite wurde vollständig KI-generiert auf Basis von SWS Firewall (R25-11) — kein offizieller AUTOSAR-Text und keine automatisch extrahierte API-Seite wie die übrigen Module. Als Interpretation gekennzeichnete Aussagen sind Schlussfolgerungen aus den Quellen.

[AP_SWS_Fw_82001] Wortlaut noch nicht übernommen · Header ara/fw/firewall_state.h

template <typename EnumT> class FirewallStateSwitchInterface final {...};

Interface to switch between firewall states, i.e. between different firewall filter-rule sets.

Header-Datei#include "ara/fw/firewall_state.h"
Scopenamespace ara::fw
Port-InterfaceFirewallStateSwitchInterface

User GuideKI-GENERIERT

Ermöglicht das asynchrone Umschalten zwischen verschiedenen Firewall-Zuständen und Filterregelsätzen.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 36188daebfa3 Herkunft Offene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Ermöglicht das asynchrone Umschalten zwischen verschiedenen Firewall-Zuständen und Filterregelsätzen.

Die Template-Klasse ara::fw::FirewallStateSwitchInterface dient in AUTOSAR Adaptive zum Umschalten zwischen verschiedenen Firewall-Zuständen und damit verbundenen Filterregelsätzen. Nach der threadsicheren Erzeugung über einen ara::core::InstanceSpecifier [AP_SWS_Fw_82002] wird der Zustandswechsel asynchron mittels SwitchFirewallState initiiert und über ein ara::core::Future<void> überwacht [AP_SWS_Fw_82008]. Die Klasse erzwingt reine Move-Semantik ohne Kopiermöglichkeit, wobei Destruktor und Move-Operationen nicht threadsicher sind und Fehler asynchron über das Future signalisiert werden.

Kontext

Die Template-Klasse ara::fw::FirewallStateSwitchInterface dient innerhalb des Funktionsclusters fw (Firewall) der AUTOSAR Adaptive Platform als primäre Schnittstelle zum Wechseln zwischen verschiedenen Firewall-Zuständen. Unter einem Firewall-Zustand wird eine definierte Konfiguration von Filterregelsätzen verstanden, die den Netzwerkverkehr absichern. Der Template-Parameter EnumT repräsentiert eine anwendungsspezifische Aufzählung aller zulässigen Firewall-Zustände. Als typische Interaktionspartner dürften übergeordnete Plattforminstanzen wie ein Mode-Management auftreten, welche die Filterregeln an veränderte Fahrzeug- oder Betriebsmodi anpassen. Frage Q-5424cd3802d53915 (offen)

Lebenszyklus

Die Erzeugung einer Instanz erfolgt explizit über den Konstruktor unter Angabe eines ara::core::InstanceSpecifier [AP_SWS_Fw_82002]. Dieser Konstruktionsschritt ist als threadsicher spezifiziert. Über den InstanceSpecifier wird vermutlich die konkrete Zuordnung zu einer im Plattform-Manifest modellierten Firewall-Instanz aufgelöst. Frage Q-97db4416453c9885 (offen)

Die Klasse ist als final deklariert und implementiert eine reine Move-Semantik: Der Kopierkonstruktor [AP_SWS_Fw_82004] und der Kopierzuweisungsoperator [AP_SWS_Fw_82005] sind gelöscht (=delete), wodurch eine Duplizierung unterbunden wird. Stattdessen werden Move-Konstruktor [AP_SWS_Fw_82006] sowie Move-Zuweisungsoperator [AP_SWS_Fw_82007] bereitgestellt, die beide als noexcept definiert sind. Wichtig für die Nebenläufigkeit ist, dass sowohl der Destruktor [AP_SWS_Fw_82003] als auch die Move-Operationen nicht threadsicher sind. Die aufrufende Anwendung muss daher sicherstellen, dass Lebenszyklusoperationen und Eigentumsübertragungen thread-lokal oder synchronisiert ablaufen.

Nutzungspfad

Der reguläre Ablauf zur Umschaltung von Regelsätzen gliedert sich in folgende Schritte:

  1. Initialisierung: Das Schnittstellenobjekt wird unter Angabe des Ziel-InstanceSpecifier erzeugt [AP_SWS_Fw_82002].
  2. Zustandsumschaltung anfordern: Über die Methode SwitchFirewallState wird der gewünschte Zielzustand vom Typ EnumT übergeben [AP_SWS_Fw_82008].
  3. Asynchrone Bestätigung abwarten: Die Methode liefert ein ara::core::Future<void> zurück [AP_SWS_Fw_82008]. Aufrufer können das Future blockierend auflösen oder asynchron überwachen, bis der zugrundeliegende Regelsatzwechsel vollzogen ist.
Asynchrone Zustandsumschaltung der FirewallAnwendungFirewallStateSwitchInterfaceFirewall-DienstFirewallStateSwitchInterface(instance)SwitchFirewallState(firewallState)Zustandswechsel anfordernara::core::Future<void>altErfolgreicher WechselRegelsatz aktiviertFuture wird erfülltFehlerfallFehler kServiceNotAvailable / kInvalidStateDependentFirewallFuture enthält Fehlercode (FwErrc)

Sequenzdiagramm: Typischer Ablauf der asynchronen Zustandsumschaltung. Quellen: [AP_SWS_Fw_82002], [AP_SWS_Fw_82008].

Fehlerszenarien

Die Methode SwitchFirewallState ist mit noexcept deklariert und löst keine C++-Ausnahmen aus [AP_SWS_Fw_82008]. Fehler bei der Umschaltung werden im zurückgegebenen ara::core::Future<void> gekapselt. Folgende Fehlercodes sind für den Aufruf spezifiziert [AP_SWS_Fw_82008]:

  • FwErrc::kServiceNotAvailable: Der zuständige Firewall-Dienst ist nicht verfügbar oder antwortet nicht [AP_SWS_Fw_82008].
  • FwErrc::kInvalidStateDependentFirewall: Der angeforderte Zustand ist für die referenzierte Firewall ungültig oder in der Konfiguration nicht vorgesehen [AP_SWS_Fw_82008].

Als Vorbedingung für die Umschaltung gilt, dass das Schnittstellenobjekt gültig instanziiert ist und eine Verbindung zum Firewall-Dienst besteht. Als Nachbedingung ist im Erfolgsfall der neue Filterregelsatz aktiv, während im Fehlerfall der vorherige Zustand unverändert bleibt.

Dieser Klassen-Leitfaden stützt sich ausschließlich auf die Spezifikationsanforderungen des Moduls fw der AUTOSAR Adaptive Platform R25-11.

Mitgliederkarte

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Konstruktoren und Destruktor

Construct from an ara::core::InstanceSpecifier.

Überladungen FirewallStateSwitchInterface 3
explicit FirewallStateSwitchInterface(const ara::core::InstanceSpecifier &instance) noexcept; AP_SWS_Fw_82002
FirewallStateSwitchInterface(const FirewallStateSwitchInterface &se)=delete; AP_SWS_Fw_82004
FirewallStateSwitchInterface(FirewallStateSwitchInterface &&se) noexcept; AP_SWS_Fw_82006

Destructor.

~FirewallStateSwitchInterface() noexcept;

Methoden

Switch between firewall states.

ara::core::Future<void> SwitchFirewallState(EnumT firewallState) noexcept;

Operatoren

operator= function 2

Copy assignment constructor.

Überladungen = 2
FirewallStateSwitchInterface &operator=(const FirewallStateSwitchInterface &se)=delete; AP_SWS_Fw_82005
FirewallStateSwitchInterface &operator=(FirewallStateSwitchInterface &&se) noexcept; AP_SWS_Fw_82007

Dokumentation der Methoden und Typen

function FirewallStateSwitchInterface [AP_SWS_Fw_82002]

explicit FirewallStateSwitchInterface(const ara::core::InstanceSpecifier &instance) noexcept;

Construct from an ara::core::InstanceSpecifier.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface
Thread-Sicherheitthread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82002
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82002@rel:R25-11#cfdde1fe
Content hash
cfdde1fe
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82002
Status: valid/unmigrated Version: rel:R25-11#cfdde1fe Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82002@rel:R25-11#cfdde1fe
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function ~FirewallStateSwitchInterface [AP_SWS_Fw_82003]

~FirewallStateSwitchInterface() noexcept;

Destructor.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82003
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82003@rel:R25-11#c0fc1439
Content hash
c0fc1439
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82003
Status: valid/unmigrated Version: rel:R25-11#c0fc1439 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82003@rel:R25-11#c0fc1439
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function FirewallStateSwitchInterface [AP_SWS_Fw_82004]

FirewallStateSwitchInterface(const FirewallStateSwitchInterface &se)=delete;

Copy constructor.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82004
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82004@rel:R25-11#c391a24a
Content hash
c391a24a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82004
Status: valid/unmigrated Version: rel:R25-11#c391a24a Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82004@rel:R25-11#c391a24a
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function operator= [AP_SWS_Fw_82005]

FirewallStateSwitchInterface &operator=(const FirewallStateSwitchInterface &se)=delete;

Copy assignment constructor.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82005
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82005@rel:R25-11#0da2f2f8
Content hash
0da2f2f8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82005
Status: valid/unmigrated Version: rel:R25-11#0da2f2f8 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82005@rel:R25-11#0da2f2f8
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function FirewallStateSwitchInterface [AP_SWS_Fw_82006]

FirewallStateSwitchInterface(FirewallStateSwitchInterface &&se) noexcept;

Move constructor.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82006
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82006@rel:R25-11#5d9fe00a
Content hash
5d9fe00a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82006
Status: valid/unmigrated Version: rel:R25-11#5d9fe00a Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82006@rel:R25-11#5d9fe00a
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function operator= [AP_SWS_Fw_82007]

FirewallStateSwitchInterface &operator=(FirewallStateSwitchInterface &&se) noexcept;

Move assignment constructor.

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface
Thread-Sicherheitnot thread-safe

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82007
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82007@rel:R25-11#821a44db
Content hash
821a44db
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82007
Status: valid/unmigrated Version: rel:R25-11#821a44db Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82007@rel:R25-11#821a44db
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

function SwitchFirewallState [AP_SWS_Fw_82008]

ara::core::Future<void> SwitchFirewallState(EnumT firewallState) noexcept;

Switch between firewall states.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 0a930dc12144 Herkunft Offene Fragen (1)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Funktion SwitchFirewallState der Schnittstelle ara::fw::FirewallStateSwitchInterface dient dem Umschalten zwischen Firewall-Zuständen [AP_SWS_Fw_82008]. Die Deklaration ist über den Header ara/fw/firewall_state.h verfügbar [AP_SWS_Fw_82008].

Als Übergabewert erwartet die Funktion den Parameter firewallState vom Typ EnumT, welcher den gewünschten Zielzustand der Firewall festlegt [AP_SWS_Fw_82008]. Der Aufruf wird asynchron ausgeführt und liefert ein ara::core::Future<void> zurück, über das der Aufrufer den Abschluss der Zustandsumschaltung synchronisieren oder abfragen kann [AP_SWS_Fw_82008]. Die Funktion ist als noexcept spezifiziert und wirft keine C++-Ausnahmen [AP_SWS_Fw_82008].

Mögliche Fehlersituationen sind durch spezifische Fehlercodes definiert [AP_SWS_Fw_82008]:

  • FwErrc::kServiceNotAvailable: Zeigt an, dass der Firewall-Dienst nicht verfügbar ist.
  • FwErrc::kInvalidStateDependentFirewall: Signalisiert, dass eine ungültige zustandsabhängige Firewall vorliegt.

Interpretation: Diese Fehler dürften nicht als Ausnahme geworfen, sondern über das resultierende ara::core::Future<void> bereitgestellt werden. Frage Q-8baa266f2c17d200 (offen)

Dieser Nutzungshinweis wurde automatisiert durch eine KI auf Basis der Spezifikation von AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität I1)

Header-Datei#include "ara/fw/firewall_state.h"
Scopeclass ara::fw::FirewallStateSwitchInterface
FehlerFwErrc::kServiceNotAvailable; FwErrc::kInvalidStateDependentFirewall

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/AP_SWS_Fw_82008
Status
valid/unmigrated
Version
AUTOSAR/AP/record/AP_SWS_Fw_82008@rel:R25-11#ffb0209d
Content hash
ffb0209d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Firewall.pdf#nameddest=AP_SWS_Fw_82008
Status: valid/unmigrated Version: rel:R25-11#ffb0209d Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/AP_SWS_Fw_82008@rel:R25-11#ffb0209d
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill