DEENESPTFRRUARHIKOZHNL

classe 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] libellé pas encore importé · 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

Guide utilisateurGÉNÉRÉ PAR IA

Permet la commutation asynchrone entre différents états de Firewall et jeux de règles de filtrage.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 36188daebfa3 Provenance Questions ouvertes (2)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Permet la commutation asynchrone entre différents états de Firewall et jeux de règles de filtrage.

La classe template ara::fw::FirewallStateSwitchInterface sert, dans AUTOSAR Adaptive, à commuter entre différents états de Firewall et les jeux de règles de filtrage associés. Après la création thread-safe via un ara::core::InstanceSpecifier [AP_SWS_Fw_82002], le changement d'état est initié de manière asynchrone au moyen de SwitchFirewallState et surveillé via un ara::core::Future<void> [AP_SWS_Fw_82008]. La classe impose une sémantique de déplacement pure, sans possibilité de copie, le destructeur et les opérations de déplacement n'étant pas thread-safe et les erreurs étant signalées de manière asynchrone via le future.

Contexte

La classe template ara::fw::FirewallStateSwitchInterface sert d'interface principale au sein du cluster fonctionnel fw (Firewall) de l'AUTOSAR Adaptive Platform pour basculer entre différents états de Firewall. Un état de Firewall s'entend comme une configuration définie de jeux de règles de filtrage qui sécurisent le trafic réseau. Le paramètre de template EnumT représente une énumération spécifique à l'application de tous les états de Firewall admissibles. Des entités de plate-forme de niveau supérieur, telles qu'un gestionnaire de modes, qui adaptent les règles de filtrage à des modes de véhicule ou de fonctionnement modifiés, devraient intervenir en tant que partenaires d'interaction types. Question Q-5424cd3802d53915 (ouverte)

Cycle de vie

La création d'une instance s'effectue explicitement via le constructeur en indiquant un ara::core::InstanceSpecifier [AP_SWS_Fw_82002]. Cette étape de construction est spécifiée comme étant thread-safe. L'affectation concrète à une instance de Firewall modélisée dans le manifeste de plate-forme est vraisemblablement résolue via le InstanceSpecifier. Question Q-97db4416453c9885 (ouverte)

La classe est déclarée comme final et implémente une sémantique de déplacement pure : le constructeur de copie [AP_SWS_Fw_82004] et l'opérateur d'assignation par copie [AP_SWS_Fw_82005] sont supprimés (=delete), ce qui empêche toute duplication. À la place, un constructeur de déplacement [AP_SWS_Fw_82006] ainsi qu'un opérateur d'assignation par déplacement [AP_SWS_Fw_82007] sont fournis, tous deux étant définis comme noexcept. Il est important pour la concurrence de noter qu'aussi bien le destructeur [AP_SWS_Fw_82003] que les opérations de déplacement ne sont pas thread-safe. L'application appelante doit donc s'assurer que les opérations de cycle de vie et les transferts de propriété se déroulent de manière locale au thread ou synchronisée.

Parcours d'utilisation

Le déroulement régulier de la commutation des jeux de règles se divise en plusieurs étapes :

  1. Initialisation : l'objet d'interface est créé en indiquant le InstanceSpecifier cible [AP_SWS_Fw_82002].
  2. Demander la commutation d'état : l'état cible souhaité de type EnumT est transmis via la méthode SwitchFirewallState [AP_SWS_Fw_82008].
  3. Attendre la confirmation asynchrone : la méthode renvoie un ara::core::Future<void> [AP_SWS_Fw_82008]. Les appelants peuvent résoudre le future de manière bloquante ou le surveiller de manière asynchrone jusqu'à ce que le changement de jeu de règles sous-jacent soit accompli.
Commutation d'état asynchrone du FirewallApplicationFirewallStateSwitchInterfaceFirewall-DienstFirewallStateSwitchInterface(instance)SwitchFirewallState(firewallState)Zustandswechsel anfordernara::core::Future<void>altErfolgreicher WechselRegelsatz aktiviertFuture est résoluFehlerfallFehler kServiceNotAvailable / kInvalidStateDependentFirewallFuture contient un code d'erreur (FwErrc)

Diagramme de séquence : déroulement type de la commutation d'état asynchrone. Sources : [AP_SWS_Fw_82002], [AP_SWS_Fw_82008].

Scénarios d'erreur

La méthode SwitchFirewallState est déclarée avec noexcept et ne déclenche aucune exception C++ [AP_SWS_Fw_82008]. Les erreurs lors de la commutation sont encapsulées dans le ara::core::Future<void> renvoyé. Les codes d'erreur suivants sont spécifiés pour l'appel [AP_SWS_Fw_82008] :

  • FwErrc::kServiceNotAvailable : le service de Firewall concerné n'est pas disponible ou ne répond pas [AP_SWS_Fw_82008].
  • FwErrc::kInvalidStateDependentFirewall : l'état demandé n'est pas valide pour la Firewall référencée ou n'est pas prévu dans la configuration [AP_SWS_Fw_82008].

La précondition pour la commutation est que l'objet d'interface soit validement instancié et qu'une connexion au service de Firewall existe. La postcondition en cas de succès est que le nouveau jeu de règles de filtrage soit actif, tandis qu'en cas d'erreur, l'état précédent demeure inchangé.

Ce guide de classe repose exclusivement sur les exigences de spécification du module fw de l'AUTOSAR Adaptive Platform R25-11.

Carte des membres

Vue détaillée

Sélectionnez une entrée dans le plan.

Constructeurs et destructeur

Construct from an ara::core::InstanceSpecifier.

Surcharges 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;

Méthodes

Switch between firewall states.

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

Opérateurs

operator= fonction 2

Copy assignment constructor.

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

Documentation des méthodes et types

fonction 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#21cc45c3
Content hash
21cc45c3
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

fonction ~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#4de20d3c
Content hash
4de20d3c
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

fonction 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#46ab314d
Content hash
46ab314d
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

fonction 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#66e46c2d
Content hash
66e46c2d
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

fonction 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#74ed2ac8
Content hash
74ed2ac8
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

fonction 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#64f7894a
Content hash
64f7894a
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

fonction SwitchFirewallState [AP_SWS_Fw_82008]

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

Switch between firewall states.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 0a930dc12144 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

La fonction SwitchFirewallState de l'interface ara::fw::FirewallStateSwitchInterface sert à la commutation entre les états de Firewall [AP_SWS_Fw_82008]. La déclaration est disponible via l'en-tête ara/fw/firewall_state.h [AP_SWS_Fw_82008].

Comme valeur de transmission, la fonction attend le paramètre firewallState de type EnumT, qui définit l'état cible souhaité du Firewall [AP_SWS_Fw_82008]. L'appel est exécuté de manière asynchrone et renvoie un ara::core::Future<void> permettant à l'appelant de synchroniser ou d'interroger la fin du changement d'état [AP_SWS_Fw_82008]. La fonction est spécifiée comme noexcept et ne lève pas d'exceptions C++ [AP_SWS_Fw_82008].

Les situations d'erreur possibles sont définies par des codes d'erreur spécifiques [AP_SWS_Fw_82008] :

  • FwErrc::kServiceNotAvailable : indique que le service Firewall n'est pas disponible.
  • FwErrc::kInvalidStateDependentFirewall : signale la présence d'un Firewall dépendant de l'état invalide.

Interprétation : ces erreurs ne devraient pas être levées sous forme d'exception, mais fournies par l'intermédiaire du ara::core::Future<void> résultant. Question Q-8baa266f2c17d200 (ouverte)

Cette note d'utilisation a été générée automatiquement par une IA sur la base de la spécification d'AUTOSAR Adaptive R25-11.

Guide de l'implémenteur à venir (complexité 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#bdbcf43f
Content hash
bdbcf43f
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