DEENESPTFRRUARHIKOZHNL

class <SI-Namespace>::proxy::fields::<Field>

[SWS_CM_00008] Upstream: RS_CM_00216, RS_AP_00114

class <Field> final {...};

Service proxy Field class, one for each Field defined in the ServiceInterface in the role field.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Forwarding-Header#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy/<SiShortname>_proxy_fwd.h"
Scopenamespace <SI-Namespace>::proxy::fields

User GuideKI-GENERIERT

Ermöglicht Client-Anwendungen die asynchrone Abfrage, Modifikation und abonnierte Überwachung eines Service-Feldes.
KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 7495b8cd48c6 Herkunft Offene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Ermöglicht Client-Anwendungen die asynchrone Abfrage, Modifikation und abonnierte Überwachung eines Service-Feldes.

Die Klasse dient als clientseitige Schnittstelle für den Zugriff auf ein im ServiceInterface definiertes Feld und bündelt Getter-, Setter- sowie Benachrichtigungsfunktionen. Über [SWS_CM_00112] und [SWS_CM_00113] können Werte asynchron abgefragt und modifiziert werden, sofern die entsprechenden Operationen modelliert sind. Für Feld-Updates wird ein abonnementbasierter Cache-Mechanismus genutzt, der Benachrichtigungen zwischenspeichert und über Callback-Handler weiterleitet. Eine wesentliche Randbedingung ist die Beachtung von Mindestsendeintervallen sowie der Verzicht auf Rollback-Semantik bei Schreibzugriffen.

Kontext

Im Kommunikationsmanagement der AUTOSAR Adaptive Platform (ara::com) repräsentiert die Klasse <SI-Namespace>::proxy::fields::<Field> ein einzelnes im Service-Interface modelliertes Feld (Field) auf der Client- bzw. Proxy-Seite. Die Klasse bündelt den Zugriff auf Attributwerte und verbindet drei funktionale Rollen: das Abfragen des aktuellen Werts (Getter), das Modifizieren des Werts (Setter) sowie das Empfangen asynchroner Wertänderungen (Notifier) (AUTOSAR_AP_EXP_ARAComAPI S. 10). Sie fungiert als Schnittstelle zwischen der Client-Anwendung und der zugrundeliegenden Kommunikationsschicht (Network Binding).

Welche Operationen auf der Instanz verfügbar sind, bestimmt die Definition des Service-Interface: Die Methode Get() wird nur generiert, wenn Field.hasGetter == TRUE konfiguriert ist [SWS_CM_00112]. Die Methode Set() steht ausschließlich zur Verfügung, falls Field.hasSetter == TRUE gilt [SWS_CM_00113]. Der konkrete Datentyp des Feldes wird dabei typsicher über den bereitgestellten Typalias FieldType abgebildet [SWS_CM_11403].

Lebenszyklus

Die Feld-Objekte werden als Member der übergeordneten Proxy-Klasse instanziiert. Ihre Lebensdauer ist daher vermutlich direkt an den Lebenszyklus der entsprechenden Proxy-Instanz gebunden. Frage Q-22443af0e2e4cfab (offen) Für den ereignisbasierten Notifier-Mechanismus durchläuft die Instanz einen klar geregelten Abonnement-Lebenszyklus:

  • Nicht abonniert: Initial befindet sich das Feld im Zustand kNotSubscribed.
  • Abonnement angefordert: Durch den synchronen Aufruf von Subscribe(maxSampleCount) [SWS_CM_11601] wird der Puffer eingerichtet und die Registrierung gestartet. Der Notifier wechselt nach kSubscriptionPending bzw. nach Bestätigung durch die Kommunikationsschicht zu kSubscribed, wobei dieser Zustandswechsel vermutlich asynchron vollzogen wird. Frage Q-67af35e88035c41c (offen)
  • Abonnement beendet: Durch Unsubscribe() [SWS_CM_11602] wird der Benachrichtigungsstrom angehalten und der Zustand wechselt zurück zu kNotSubscribed.

Der aktuelle Zustand kann jederzeit synchron mit GetSubscriptionState() abgefragt werden [SWS_CM_11604]. Um Zustandsänderungen asynchron mitzubekommen, lässt sich mit SetSubscriptionStateChangeHandler() ein Callback hinterlegen [SWS_CM_11607], optional mit dediziertem Ausführungskontext [SWS_CM_11608]. Vor Zerstörung der Instanz oder bei Deaktivierung sollten registrierte Callbacks über UnsetReceiveHandler() [SWS_CM_11606], UnsetSubscriptionStateChangeHandler() [SWS_CM_11609] sowie UnsetTransportFaultConditionHandler() [SWS_CM_00126] explizit entfernt werden.

diag_field_lifecycle kNotSubscribed kNotSubscribed kSubscriptionPending kSubscriptionPending kNotSubscribed->kSubscriptionPending Subscribe() kSubscriptionPending->kNotSubscribed Unsubscribe() kSubscribed kSubscribed kSubscriptionPending->kSubscribed Abonnement bestätigt kSubscribed->kNotSubscribed Unsubscribe() kSubscribed->kSubscribed Subscribe() [gleiches maxSampleCount]

Zustandsdiagramm: Lebenszyklus des Notifier-Abonnements über ara::com::SubscriptionState. Quellen: [SWS_CM_11601], [SWS_CM_11602], [SWS_CM_11604].

Nutzungspfad

Der typische Nutzungspfad umfasst die Registrierung von Benachrichtigungen, die Entgegennahme neuer Daten sowie den punktuellen Lese- und Schreibzugriff:

  1. Abonnement einrichten: Die Anwendung ruft Subscribe() mit der gewünschten Cache-Kapazität auf [SWS_CM_11601] und registriert mittels SetReceiveHandler() einen parameterlosen Notifizierungs-Callback [SWS_CM_11605]. Für nebenläufige Architekturen kann die Ausführung über einen Executor delegiert werden [SWS_CM_11611]. Zudem kann für Notifier-Ereignisse ein Handler für Transportfehler hinterlegt werden [SWS_CM_00109], [SWS_CM_00110].
  2. Samples verarbeiten: Sobald das Kommunikationsmanagement neue Felddaten empfängt, löst es den Receive-Handler aus. Der Handler ermittelt verfügbare Pufferplätze über GetFreeSampleCount() [SWS_CM_11603] und verarbeitet die neuen Werte über GetNewSamples() [SWS_CM_11610]. Der E2E-Zustand der empfangenen Benachrichtigungen kann per GetE2EStateMachineStateNotifier() überprüft werden [SWS_CM_11612].
  3. Explizites Lesen: Das Abrufen des aktuellen Werts erfolgt asynchron über Get() [SWS_CM_00112] und gibt ein ara::core::Future<FieldType> zurück [SWS_CM_11403]. Nach Abschluss kann der E2E-Prüfstatus mit GetE2EStateMachineStateGetter() verifiziert werden [SWS_CM_00145].
  4. Explizites Schreiben: Die Modifikation des Werts erfolgt über Set(value) [SWS_CM_00113]. Das zurückgegebene ara::core::Future<FieldType> liefert das Ergebnis des Set-Vorgangs, dessen E2E-Status über GetE2EStateMachineStateSetter() ausgelesen werden kann [SWS_CM_00146].
Typischer Nutzungspfad eines Proxy-FieldsClient<Field>Communication ManagementUse Case: Abonnement und EmpfangsregistrierungSubscribe(maxSampleCount)Abonnement anfordernSetReceiveHandler(handler)Use Case: Benachrichtigung und DatenabrufFeld-Update eingetroffenhandler()GetNewSamples(f)Result<size_t>Use Case: Expliziter WertzugriffGet()Future<FieldType>Set(value)Future<FieldType>

Sequenzdiagramm: Typischer Ablauf der Interaktion mit Benachrichtigungen sowie Get- und Set-Operationen. Quellen: [SWS_CM_00112], [SWS_CM_00113], [SWS_CM_11601], [SWS_CM_11605], [SWS_CM_11610].

Fehlerszenarien

Bei der Verwendung der Feld-Methoden können verschiedene Fehlerzustände auftreten:

  • Kommunikationsausfall: Schlägt die Netzwerkübertragung bei Get() oder Set() fehl, wird im Future der Fehler ComErrc::kCommunicationFailure übermittelt [SWS_CM_00112], [SWS_CM_00113]. Bei Get() greift Rollback-Semantik; bei Set() gilt no_rollback_semantics, sodass bei einem Timeout ein unbestimmter Zustand auf dem Server entstehen kann [SWS_CM_00113].
  • Verletzung des Sendeintervalls: Werden Anfragen schneller als im Deployment konfiguriert abgesetzt, resultiert dies in ComErrc::kMinimumSendIntervalViolationError [SWS_CM_00112], [SWS_CM_00113].
  • Puffergrenzen: Kann der Speicher bei Subscribe() nicht allokiert werden, liefert die Methode ComErrc::kMaxSampleCountNotRealizable [SWS_CM_11601]. Werden bei GetNewSamples() zu viele Samples abgerufen, scheitert der Aufruf mit ComErrc::kMaxSamplesExceeded [SWS_CM_11610].
  • Zugriffs- und Handler-Verletzungen: Fehlende Ausführungsrechte führen zu einer InsufficientPermissionsViolation bei Get(), Set() oder Subscribe() [SWS_CM_00112], [SWS_CM_00113], [SWS_CM_11601]. Die Übergabe leerer oder ungültiger Callable-Objekte an Handler-Registrierungen löst eine InvalidHandlerViolation aus [SWS_CM_11605], [SWS_CM_11607], [SWS_CM_00109].
  • Idempotenz: Ein erneutes Subscribe() mit identischem Pufferwert in den Zuständen kSubscribed oder kSubscriptionPending bleibt ohne Wirkung [SWS_CM_11601]; ebenso kehrt Unsubscribe() ohne aktives Abonnement wirkungslos zurück [SWS_CM_11602].

Dieser Klassen-Leitfaden wurde durch eine KI auf Basis der AUTOSAR-Spezifikation R25-11 generiert.

Mitgliederkarte

Klassendiagramm

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G n_SI_Namespace___proxy__fields___Field_138 <Field> + SetReceiveHandler() + SetTransportFaultConditionHandler() + UnsetTransportFaultConditionHandler() + GetE2EStateMachineStateGetter() + GetE2EStateMachineStateNotifier() + GetE2EStateMachineStateSetter() + Get() + GetFreeSampleCount() + GetNewSamples() + Set() + GetSubscriptionState() + SetSubscriptionStateChangeHandler() + Subscribe() + UnsetSubscriptionStateChangeHandler() + Unsubscribe() + UnsetReceiveHandler()

Detailansicht

Wähle in der Gliederung einen Eintrag aus.

Methoden

Get function

Get the current value of the Field. The method is present only if Field.hasGetter ==TRUE, otherwise it is not present (shall not be generated)

ara::core::Future< FieldType > Get () noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Get()

ara::com::e2e::SMState GetE2EStateMachineStateGetter () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

ara::com::e2e::SMState GetE2EStateMachineStateNotifier () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Set()

ara::com::e2e::SMState GetE2EStateMachineStateSetter () const noexcept;

Query Free Sample Slots

std::size_t GetFreeSampleCount () const noexcept;
GetNewSamples function

Method to update the field notification cache.

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max());

Query ara::com::SubscriptionState, as per [SWS_CM_00310].

ara::com::SubscriptionState GetSubscriptionState () const noexcept;
Set function

Set a new value of the Field. The method is present only if Field.hasSetter==TRUE, otherwise it is not present (shall not be generated). There is no need to have Get method itself return [Application Errors] errors when getting a field value (as there are no errors possible when getting a field value). The Set-Method may return [Application Errors], but does so via returning a value different from the one passed in the request parameter.

ara::core::Future< FieldType > Set (<PFieldDerivedType> value) noexcept;

Set/Register the Field notification receive handler

Überladungen SetReceiveHandler 2
void SetReceiveHandler (ara::com::FieldReceiveHandler handler) noexcept; SWS_CM_11605
template <typename ExecutorT> void SetReceiveHandler (ara::com::FieldReceiveHandler handler, ExecutorT &&executor) noexcept; SWS_CM_11611

Set ara::com::SubscriptionState change handler

Überladungen SetSubscriptionStateChangeHandler 2
void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept; SWS_CM_11607
template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept; SWS_CM_11608

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Field Notifier.

Überladungen SetTransportFaultConditionHandler 2
void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept; SWS_CM_00109
template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept; SWS_CM_00110
Subscribe function

Method to subscribe to a service field notification. If the Field is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSample Count value is the same as for the current subscription, the method shall return without action.

ara::core::Result< void > Subscribe (std::size_t maxSampleCount) noexcept;

Disable service field notification trigger

void UnsetReceiveHandler () noexcept;

Unset ara::com::SubscriptionState change handler

void UnsetSubscriptionStateChangeHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Field Notifier.

void UnsetTransportFaultConditionHandler () noexcept;
Unsubscribe function

Method to unsubscribe from a service field notification. If the Field is not subscribed to at the time of the call, Unsubscribe() shall return without action.

void Unsubscribe () noexcept;

Typaliase

FieldType type alias

As per [SWS_CM_11402]

using FieldType = <PFieldCppidt>;

Dokumentation der Methoden

function Get [SWS_CM_00112] Upstream: RS_CM_00218, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

ara::core::Future< FieldType > Get () noexcept;

Get the current value of the Field. The method is present only if Field.hasGetter ==TRUE, otherwise it is not present (shall not be generated)

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 980f973fd449 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung

Die Methode Get dient im Proxy-Scope <SI-Namespace>::proxy::fields::<Field> dem asynchronen Abruf des aktuellen Feldwerts ([SWS_CM_00112]; siehe auch AUTOSAR_AP_EXP_ARAComAPI §6 „FieldGet“). Die Funktion wird über den Proxy-Header <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h bereitgestellt und existiert nur dann, wenn für das Feld Field.hasGetter == TRUE modelliert ist ([SWS_CM_00112]). Sie nimmt keine Parameter entgegen und liefert ein ara::core::Future<FieldType> zurück, welches nach erfolgreicher Übertragung den aktuellen Wert enthält ([SWS_CM_00112]).

Fehlerbehandlung und Randbedingungen

Die Schnittstelle ist als noexcept und exceptionsicher definiert ([SWS_CM_00112]). Schlägt die Operation fehl, enthält das zurückgegebene ara::core::Future einen Fehlercode mit Rollback-Semantik ([SWS_CM_00112]):

  • ComErrc::kCommunicationFailure: Das Netzwerk-Binding meldet einen behebbaren Kommunikationsfehler oder das Fehlschlagen einer gesicherten Kommunikation ([SWS_CM_00112]).
  • ComErrc::kMinimumSendIntervalViolationError: Eine Sendeanforderung erfolgte schneller als das für das Element konfigurierte Mindestsendeintervall (minimumSendInterval) erlaubt ([SWS_CM_00112]).
  • InsufficientPermissionsViolation: Die Ausführung wird durch das Grant Enforcement abgewiesen ([SWS_CM_00112]).

Anwendungsfehler (Application Errors) existieren für den Getter nicht ([SWS_CM_00113]).

Zusammenspiel

Auf der Skeleton-Seite setzt die Bearbeitung der Getter-Anfrage einen Callback voraus, der über RegisterGetHandler hinterlegt wird ([SWS_CM_00114]). Jeder Aufruf von Get() führt eine End-to-End-Prüfung (E2E) aus; der daraus resultierende Zustandsstatus kann auf Proxy-Seite synchron über GetE2EStateMachineStateGetter abgefragt werden ([SWS_CM_00145]).

Dieser Text wurde von einer KI auf Basis der Spezifikationsdokumente erstellt.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Rückgabewert

TypBeschreibung
ara::core::Future< FieldType >• If successful: an ara::core::Future containing a Field Type object as per [SWS_CM_11403] • If unsuccessful: an ara::core::Future containing a corresponding ara::core::FutureErrc

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailurerollback_semantics The network binding reported a recoverable communications error or a secure communication failure
ComErrc::kMinimumSendIntervalViolationErrorrollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.

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

Record
AUTOSAR/AP/record/SWS_CM_00112
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00112@rel:R25-11#0bc1ce77
Content hash
0bc1ce77
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00112
Status: valid/unmigrated Version: rel:R25-11#ec4a8dc1 Versionshistorie & Revisions (1 transition, 8 revision)
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/SWS_CM_00112@rel:R25-11#ec4a8dc1
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0bc1ce772026-09-30
  • R19-11rel:R19-11#85c2390c2026-10-14
  • R20-11rel:R20-11#85c2390c2026-10-14
  • R21-11rel:R21-11#85c2390c2026-10-14
  • R22-11rel:R22-11#5a1fa5a12026-10-14
  • R23-11rel:R23-11#da1367322026-10-14
  • R24-11rel:R24-11#78164d832026-10-14
  • R25-11rel:R25-11#ec4a8dc12026-10-14 active
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 GetE2EStateMachineStateGetter [SWS_CM_00145] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateGetter () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Get()

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::e2e::SMStateState of the specific field class
Siehe auch: [SWS_CM_90417]

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

Record
AUTOSAR/AP/record/SWS_CM_00145
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00145@rel:R25-11#cd76263f
Content hash
cd76263f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00145
Status: valid/unmigrated Version: rel:R25-11#cd76263f 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/SWS_CM_00145@rel:R25-11#cd76263f
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 GetE2EStateMachineStateNotifier [SWS_CM_11612] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateNotifier () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of GetNewSamples()

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::e2e::SMStateState of the specific field class
Siehe auch: [SWS_CM_90417]

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

Record
AUTOSAR/AP/record/SWS_CM_11612
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11612@rel:R25-11#de1830f7
Content hash
de1830f7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11612
Status: valid/unmigrated Version: rel:R25-11#cf34f3ea Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11612@rel:R25-11#cf34f3ea
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#de1830f72026-09-30
  • R24-11rel:R24-11#22d8a9c22026-10-14
  • R25-11rel:R25-11#cf34f3ea2026-10-14 active
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 GetE2EStateMachineStateSetter [SWS_CM_00146] Upstream: RS_CM_00224, RS_E2E_08534

ara::com::e2e::SMState GetE2EStateMachineStateSetter () const noexcept;

Returns the state of the specific field class, which was determined by the last run of E2E_Check() function invoked during the last call of Set()

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::e2e::SMStateState of the specific field class
Siehe auch: [SWS_CM_90417]

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

Record
AUTOSAR/AP/record/SWS_CM_00146
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00146@rel:R25-11#beb55f07
Content hash
beb55f07
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00146
Status: valid/unmigrated Version: rel:R25-11#beb55f07 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/SWS_CM_00146@rel:R25-11#beb55f07
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 GetFreeSampleCount [SWS_CM_11603] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00139

std::size_t GetFreeSampleCount () const noexcept;

Query Free Sample Slots

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
std::size_tThe number of free/unused slots for field notification sample data in the local cache

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

Record
AUTOSAR/AP/record/SWS_CM_11603
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11603@rel:R25-11#72605269
Content hash
72605269
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11603
Status: valid/unmigrated Version: rel:R25-11#8c94be2d Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11603@rel:R25-11#8c94be2d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#726052692026-09-30
  • R24-11rel:R24-11#6336d44d2026-10-14
  • R25-11rel:R25-11#8c94be2d2026-10-14 active
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 GetNewSamples [SWS_CM_11610] Upstream: RS_CM_00202, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00139

template <typename F> ara::core::Result< std::size_t > GetNewSamples (F &&f, std::size_t max NumberOfSamples=std::numeric_limits< std::size_t >::max());

Method to update the field notification cache.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitnot exception safe

Template-Parameter

ParameterBeschreibung
FAs per [SWS_CM_00701]

Parameter (in)

ParameterBeschreibung
fAs per [SWS_CM_00701]
maxNumberOfSamplesAs per [SWS_CM_00701]

Rückgabewert

TypBeschreibung
ara::core::Result<std::size_t >As per [SWS_CM_00701]

Fehler

FehlercodeBeschreibung
ComErrc::kMaxSamplesExceededrollback_semantics As per [SWS_CM_00701]

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

Record
AUTOSAR/AP/record/SWS_CM_11610
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11610@rel:R25-11#bd0fe935
Content hash
bd0fe935
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11610
Status: valid/unmigrated Version: rel:R25-11#ad5c10b2 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11610@rel:R25-11#ad5c10b2
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#bd0fe9352026-09-30
  • R24-11rel:R24-11#3801b4392026-10-14
  • R25-11rel:R25-11#ad5c10b22026-10-14 active
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 GetSubscriptionState [SWS_CM_11604] Upstream: RS_CM_00106

ara::com::SubscriptionState GetSubscriptionState () const noexcept;
Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
ara::com::SubscriptionStateThe state of the subscription.

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

Record
AUTOSAR/AP/record/SWS_CM_11604
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11604@rel:R25-11#485e4d78
Content hash
485e4d78
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11604
Status: valid/unmigrated Version: rel:R25-11#990d7855 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11604@rel:R25-11#990d7855
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#485e4d782026-09-30
  • R24-11rel:R24-11#de9197112026-10-14
  • R25-11rel:R25-11#990d78552026-10-14 active
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 Set [SWS_CM_00113] Upstream: RS_CM_00217, RS_AP_00114, RS_AP_00120, RS_AP_00121, RS_AP_00127, RS_AP_00128, RS_AP_00138

ara::core::Future< FieldType > Set (<PFieldDerivedType> value) noexcept;

Set a new value of the Field. The method is present only if Field.hasSetter==TRUE, otherwise it is not present (shall not be generated). There is no need to have Get method itself return [Application Errors] errors when getting a field value (as there are no errors possible when getting a field value). The Set-Method may return [Application Errors], but does so via returning a value different from the one passed in the request parameter.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 4f6a6aee9527 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Verwendung und Aufrufkontext

Die Funktion Set wird im Namensraum <SI-Namespace>::proxy::fields::<Field> bereitgestellt und steht ausschließlich dann zur Verfügung, wenn für das Feld Field.hasSetter == TRUE konfiguriert ist [SWS_CM_00113]. Vor der Verwendung muss die Service-Instanz serverseitig angeboten (OfferService()) und clientseitig gefunden sowie verbunden worden sein ARAComAPI §4.2 „Means of Communication“. Der Aufruf erfolgt asynchron: Er übergibt den neuen Feldwert über den Parameter value und liefert ein ara::core::Future<FieldType> zurück [SWS_CM_00113]. Die Methode ist als noexcept spezifiziert und gilt als ausnahmesicher [SWS_CM_00113].

Fehlerbehandlung

Schlägt die Übertragung fehl, wird der entsprechende Fehler über das zurückgegebene ara::core::Future bereitgestellt [SWS_CM_00113]:

  • ComErrc::kCommunicationFailure: Meldet einen behebbaren Kommunikationsfehler oder eine Störung der sicheren Übertragung; im Falle eines Timeouts kann ein unbestimmter Zustand auf Serverseite ohne Rollback-Semantik vorliegen [SWS_CM_00113].
  • ComErrc::kMinimumSendIntervalViolationError: Tritt auf, wenn eine Sendeanforderung schneller als das konfigurierte Mindestsendeintervall (minimumSendInterval) abgesetzt wurde (ebenfalls ohne Rollback-Semantik) [SWS_CM_00113].
  • Fehlende Zugriffsrechte führen zu einer Verweigerung durch Grant Enforcement (InsufficientPermissionsViolation) [SWS_CM_00113].
  • Anwendungsfehler werden nicht über Ausnahmen transportiert, sondern indem im Erfolgsfall des Futures ein vom Anforderungsparameter abweichender Wert zurückgeliefert wird [SWS_CM_00113].

Zusammenspiel und Nebenläufigkeit

Auf Serverseite korrespondiert der Aufruf mit einem Callback an der Skeleton-Instanz, der zuvor mittels RegisterSetHandler hinterlegt werden muss [SWS_CM_00116] ARAComAPI §4.2 „Means of Communication“. Zur Überwachung der E2E-Übertragungssicherheit auf Clientseite kann der Status der E2E-Zustandsmaschine des letzten Set()-Aufrufs über GetE2EStateMachineStateSetter() abgefragt werden [SWS_CM_00146].

Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation AUTOSAR R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
valueNew value of field

Rückgabewert

TypBeschreibung
ara::core::Future< FieldType >• If successful: an ara::core::Future containing a Field Type object as per [SWS_CM_11403] • If unsuccessful: an ara::core::Future containing a corresponding ara::core::FutureErrc

Fehler

FehlercodeBeschreibung
ComErrc::kCommunicationFailureno_rollback_semantics The network binding reported a recoverable communications error or a secure communication failure. In case of a communication timeout this could lead to an uncertain state on the remote server side.
ComErrc::kMinimumSendIntervalViolationErrorno_rollback_semantics Minimum Send Interval violation, because a transmission request for a service instance element (event, field or method call) was issued faster than allowed, i.e., the configured minimum send interval ServiceInterfaceDeploymentElement. minimumSendInterval for the service instance element has not yet expired.

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

Record
AUTOSAR/AP/record/SWS_CM_00113
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00113@rel:R25-11#9918c4b6
Content hash
9918c4b6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00113
Status: valid/unmigrated Version: rel:R25-11#46c10d7a Versionshistorie & Revisions (1 transition, 8 revision)
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/SWS_CM_00113@rel:R25-11#46c10d7a
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#9918c4b62026-09-30
  • R19-11rel:R19-11#73765f662026-10-14
  • R20-11rel:R20-11#73765f662026-10-14
  • R21-11rel:R21-11#73765f662026-10-14
  • R22-11rel:R22-11#fcbc0baa2026-10-14
  • R23-11rel:R23-11#009371872026-10-14
  • R24-11rel:R24-11#ae7474142026-10-14
  • R25-11rel:R25-11#46c10d7a2026-10-14 active
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 SetReceiveHandler [SWS_CM_11605] Upstream: RS_CM_00203, RS_AP_00114, RS_AP_00120, RS_AP_00121

void SetReceiveHandler (ara::com::FieldReceiveHandler handler) noexcept;

Set/Register the Field notification receive handler

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

Verwendung und Aufrufkontext

Die Funktion SetReceiveHandler wird proxyseitig im Namensraum <SI-Namespace>::proxy::fields::<Field> über die Header-Datei <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h bereitgestellt ([SWS_CM_11605]). Sie registriert auf Client-Seite einen Callback für Benachrichtigungen bei Wertänderungen eines Feldes ([SWS_CM_11605]). Dieser Mechanismus folgt dem Benachrichtigungsverfahren von Events, wodurch das Communication Management den Client bei Aktualisierungen informiert (EXP_ARAComAPI §4.2 „Means of Communication“).

Als Parameter wird ein ara::com::FieldReceiveHandler übergeben, der eine parameterlose Funktion darstellt ([SWS_CM_11605]). Die Funktion liefert keinen Rückgabewert (void) zurück und ist als ausnahmesicher (noexcept) spezifiziert ([SWS_CM_11605]).

Fehlerbehandlung und Nebenläufigkeit

Falls das übergebene Callable-Objekt nicht existiert oder null ist, meldet die Funktion die Verletzung InvalidHandlerViolation ([SWS_CM_11605]). Wenn die Ausführung des Handlers in einem definierten Ausführungskontext erfolgen soll, steht die Template-Variante mit ExecutorT zur Verfügung ([SWS_CM_11611]).

Zusammenspiel

Das Verhalten entspricht den Handler-Registrierungen für Events ([SWS_CM_00181]) und Trigger ([SWS_CM_00250]). Eine Aufhebung der Registrierung dürfte dem Schnittstellenmuster der Proxy-Klasse folgend über UnsetReceiveHandler() stattfinden (EXP_ARAComAPI §5.3.1 „Proxy Class API’s“). Frage Q-74cd83b99aadec16 (offen)

Dieser Text wurde von einer KI erstellt und dient als Orientierungshilfe. Maßgeblich ist die offizielle AUTOSAR-Spezifikation.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerThe handler that shall be called by Communication Management upon notification arrival. The FieldReceiveHandler constitutes a function without parameters and has to use the f method of the specific Field class to access the retrieved event data. See [SWS_CM_11615] for its definition.

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11605
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11605@rel:R25-11#03682cbd
Content hash
03682cbd
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11605
Status: valid/unmigrated Version: rel:R25-11#86f81336 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11605@rel:R25-11#86f81336
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#03682cbd2026-09-30
  • R24-11rel:R24-11#8bb5f2572026-10-14
  • R25-11rel:R25-11#86f813362026-10-14 active
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 SetReceiveHandler [SWS_CM_11611] Upstream: RS_CM_00211, RS_AP_00151, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetReceiveHandler (ara::com::FieldReceiveHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_11605] but the handler shall execute in a provided context

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

Verwendung und Aufrufkontext

Die Template-Funktion SetReceiveHandler ist Teil der Proxy-Klasse class <SI-Namespace>::proxy::fields::<Field> ([SWS_CM_11611]; Header #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"). Sie dient dazu, auf Clientseite einen Empfangshandler für Benachrichtigungen bei Wertänderungen eines Feldes zu registrieren (AUTOSAR_AP_EXP_ARAComAPI §4.2 „Means of Communication“, [SWS_CM_11605]). Über die Parameter werden ein aufrufbares Objekt handler vom Typ ara::com::FieldReceiveHandler sowie ein Ausführungskontext executor als universelle Referenz ExecutorT&& übergeben ([SWS_CM_11611]). Die Funktion besitzt keinen Rückgabewert (void).

Fehlerbehandlung und Exception-Sicherheit

Die Methode ist als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert ([SWS_CM_11611]). Wenn das übergebene Callable handler nicht existiert oder null ist, liegt eine InvalidHandlerViolation vor ([SWS_CM_11611]). Aufrufer müssen daher sicherstellen, dass vor dem Aufruf ein valides Funktions- oder Funktionsobjekt bereitgestellt wird.

Nebenläufigkeit und Zusammenspiel

Im Unterschied zur Standardregistrierung ohne Executor ([SWS_CM_11605]) wird der Callback bei Eintreffen einer Feld-Benachrichtigung in dem durch executor bereitgestellten Ausführungskontext abgearbeitet ([SWS_CM_11611]). Interpretation: Dies dürfte eine Entkopplung bewirken, sodass die anwendungsspezifische Datenverarbeitung nicht in den Ausführungskontexten interner Middleware-Threads erfolgt. Frage Q-cbe1af19bea15a88 (offen) Die Methode gehört zu den Proxy-Klassen-APIs (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 „Proxy Class API’s“) und folgt dem gleichen Muster wie die Executor-Varianten für Events ([SWS_CM_11356] basierend auf [SWS_CM_00181]) sowie Trigger ([SWS_CM_00352] basierend auf [SWS_CM_00250]).

Dieser Nutzungshinweis wurde automatisch auf Basis der Spezifikation von AUTOSAR Adaptive (R25-11) erstellt.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_11605]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11611
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11611@rel:R25-11#7debf332
Content hash
7debf332
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11611
Status: valid/unmigrated Version: rel:R25-11#b32e3974 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11611@rel:R25-11#b32e3974
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#7debf3322026-09-30
  • R24-11rel:R24-11#2328e4dd2026-10-14
  • R25-11rel:R25-11#b32e39742026-10-14 active
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 SetSubscriptionStateChangeHandler [SWS_CM_11607] Upstream: RS_CM_00106

void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler) noexcept;

Set ara::com::SubscriptionState change handler

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 0dd6ef6a44f3 Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Funktion SetSubscriptionStateChangeHandler registriert auf einem Proxy-Feld (Scope <SI-Namespace>::proxy::fields::<Field>) einen benutzerdefinierten Callback, der vom Communication Management aufgerufen wird, sobald sich der Abonnementzustand (ara::com::SubscriptionState) des Feldes ändert ([SWS_CM_11607], [SWS_CM_00333]). Der Aufruf erfolgt synchron und liefert keinen Rückgabewert zurück ([SWS_CM_11607]). Sie zählt zu den zentralen Proxy-Schnittstellen zur Verwaltung von Ereignis- und Feld-Abonnements (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 „Proxy Class API’s“).

Hinsichtlich der Fehlerbehandlung ist die Registrierungsfunktion als exception safe spezifiziert und mit noexcept deklariert ([SWS_CM_11607]). Falls das übergebene Callable-Objekt handler nicht existiert oder null ist, liegt ein Spezifikationsverstoß in Form einer InvalidHandlerViolation vor ([SWS_CM_11607]).

Im Zusammenspiel mit dem Verbindungsaufbau ist zu beachten, dass Subscribe() grundsätzlich als asynchrone Operation betrachtet werden muss ([SWS_CM_12006]). Anwendungen dürfen daher selbst nach fehlerfreier Rückkehr von Subscribe() erst dann von einem erfolgreichen Abonnement ausgehen, wenn der registrierte Handler den Zustand kSubscribed signalisiert hat ([SWS_CM_12006]). Zudem ruft das Communication Management den Handler mit kSubscriptionPending auf, wenn die tatsächliche Bindung nicht sofort abgeschlossen werden kann oder die Serverinstanz beispielsweise infolge eines Neustarts oder Netzwerkfehlers ausfällt ([SWS_CM_00313]). Soll der Handler in einem spezifischen Ausführungskontext ausgeführt werden, steht hierfür die überladene Template-Variante mit einem ExecutorT bereit ([SWS_CM_11608]).

Dieser Nutzungshinweis wurde von einer KI auf Basis der AUTOSAR-Spezifikationen für Release R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_00333]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11607
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11607@rel:R25-11#ad5e599c
Content hash
ad5e599c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11607
Status: valid/unmigrated Version: rel:R25-11#ab897290 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11607@rel:R25-11#ab897290
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#ad5e599c2026-09-30
  • R24-11rel:R24-11#13e960cd2026-10-14
  • R25-11rel:R25-11#ab8972902026-10-14 active
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 SetSubscriptionStateChangeHandler [SWS_CM_11608] Upstream: RS_CM_00211, RS_AP_00151, RS_AP_00114, RS_AP_00120, RS_AP_00127, RS_AP_00128, RS_AP_00138

template <typename ExecutorT> void SetSubscriptionStateChangeHandler (ara::com::SubscriptionState ChangeHandler handler, ExecutorT &&executor) noexcept;

As per [SWS_CM_11607] but the handler shall execute in a provided context

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

Die Template-Funktion SetSubscriptionStateChangeHandler im Namensraum <SI-Namespace>::proxy::fields::<Field> dient der Registrierung einer Callback-Funktion zur Überwachung von Zustandsänderungen des Abonnements eines Feldes ([SWS_CM_11608]). Sie erweitert das Basisverhalten aus [SWS_CM_11607] darum, dass der registrierte Handler in einem explizit übergebenen Ausführungskontext (executor) ausgeführt wird ([SWS_CM_11608]).

Die Methode nimmt zwei Parameter entgegen ([SWS_CM_11608]):

  • handler: Der aufzurufende Callback vom Typ ara::com::SubscriptionStateChangeHandler ([SWS_CM_11354]), welcher ausgelöst wird, sobald sich der ara::com::SubscriptionState ändert ([SWS_CM_00333]).
  • executor: Eine Weiterleitungsreferenz vom Typ ExecutorT&& ([SWS_CM_11360]), die den Kontext für die Ausführung des Handlers bereitstellt ([SWS_CM_11608]).

Die Funktion liefert keinen Rückgabewert (void) und ist als noexcept deklariert ([SWS_CM_11608]). Sie ist exception safe spezifiziert ([SWS_CM_11608]). Als Verletzung ist InvalidHandlerViolation definiert, falls das übergebene Callable nicht existiert oder null ist ([SWS_CM_11608]).

Interpretation: Durch die Übergabe des executor dürfte die Ausführung des Handlers aus dem internen Kontext des Kommunikationsmanagements in den Thread- oder Aufgabenkontext der Anwendung verlagert werden. Frage Q-647f618545799c4e (offen) Im Zusammenspiel der Proxy-APIs reiht sich der Aufruf neben Methoden wie Subscribe(), Unsubscribe() und UnsetSubscriptionStateChangeHandler() ein (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 „Proxy Class API’s“). Analoge überladene Varianten mit Ausführungskontext existieren für Proxy-Events ([SWS_CM_11354]) sowie Proxy-Trigger ([SWS_CM_01106]).

Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikationen des Releases R25-11 erstellt.

Implementer's Guide folgt (Komplexität I3)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Template-Parameter

ParameterBeschreibung
ExecutorTAs per [SWS_CM_11360]

Parameter (in)

ParameterBeschreibung
handlerAs per [SWS_CM_11354]
executorAs per [SWS_CM_11360]

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11608
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11608@rel:R25-11#27b2d698
Content hash
27b2d698
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11608
Status: valid/unmigrated Version: rel:R25-11#d63fd7bc Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11608@rel:R25-11#d63fd7bc
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#27b2d6982026-09-30
  • R24-11rel:R24-11#9fc7873d2026-10-14
  • R25-11rel:R25-11#d63fd7bc2026-10-14 active
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 SetTransportFaultConditionHandler [SWS_CM_00109] Upstream: RS_CM_00224, RS_E2E_08534

void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler) noexcept;

Provides possibility to register a ara::com::e2e::TransportFaultConditionHandler for a given Proxy Field Notifier.

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

Verwendung und Aufrufkontext

Die Elementfunktion SetTransportFaultConditionHandler dient der Registrierung eines Fehler-Handlers für den Notifier eines Proxy-Felds im Namensraum <SI-Namespace>::proxy::fields::<Field> [SWS_CM_00109]. Als Parameter wird ein aufrufbares Objekt (Callable) vom Typ ara::com::e2e::TransportFaultConditionHandler übergeben. Die Funktion liefert keinen Rückgabewert und bindet den Callback an die Notifier einzelner Service-Instanzen, um Übertragungsfehler des Kommunikations-Backends entgegenzunehmen AUTOSAR_AP_SWS_CommunicationManagement §7.4 „End-to-end communication protection“ S. 235.

Fehlerbehandlung und Exception-Sicherheit

Die Methode ist als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert [SWS_CM_00109]. Ist das übergebene Callable ungültig oder null, liegt eine Verletzung der Vorbedingung in Form einer InvalidHandlerViolation vor [SWS_CM_00109]. Interpretation: Da die Funktion keine Ausnahmen werfen darf, dürfte eine solche Verletzung in AUTOSAR Adaptive typischerweise zum sofortigen Programmabbruch führen. Frage Q-74df6934d4ae3c93 (offen)

Nebenläufigkeit und Zusammenspiel

Während diese Grundform den Handler direkt registriert, existiert mit [SWS_CM_00110] eine überladene Template-Variante, die zusätzlich einen Executor (ExecutorT&& executor) zur Festlegung des asynchronen Ausführungskontextes entgegennimmt. Die Funktion reiht sich in die End-to-End-Fehlerbehandlung ein: Während Notifier ([SWS_CM_00109], [SWS_CM_00110]), Events ([SWS_CM_00099]) und Trigger ([SWS_CM_00106]) Übertragungsfehler asynchron über solche Handler melden, werden Transportfehler bei Methoden- sowie Getter- und Setter-Anfragen stattdessen über ComErrc::kCommunicationFailure im resultierenden ara::core::Future zurückgemeldet [SWS_CM_00090].

Dieser Nutzungshinweis wurde automatisiert auf Basis des AUTOSAR-R25-11-Spezifikationsstandes erstellt.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler of type ara::com::e2e:: TransportFaultConditionHandler to be set

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00109
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00109@rel:R25-11#57896b86
Content hash
57896b86
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00109
Status: valid/unmigrated Version: rel:R25-11#989525ac Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_00109@rel:R25-11#989525ac
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#57896b862026-09-30
  • R24-11rel:R24-11#1aaf6ef92026-10-14
  • R25-11rel:R25-11#989525ac2026-10-14 active
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 SetTransportFaultConditionHandler [SWS_CM_00110] Upstream: RS_CM_00224, RS_E2E_08534

template <typename ExecutorT> void SetTransportFaultConditionHandler (ara::com::e2e::TransportFault ConditionHandler handler, ExecutorT &&executor) noexcept;

Execution Context overload for hierarchicalnamespacelistlowerproxy::proxy:: fields::fieldname::SetTransportFaultConditionHandler for a given Proxy Field Notifier.

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

Verwendung

Die Template-Elementfunktion SetTransportFaultConditionHandler dient im Scope einer Proxy-Field-Klasse (<SI-Namespace>::proxy::fields::<Field>) zur Registrierung eines Handlers für den Notifier des jeweiligen Felds [SWS_CM_00110]. Sie nimmt zwei Eingabeparameter entgegen:

  • handler: das zu registrierende Callable vom Typ ara::com::e2e::TransportFaultConditionHandler [SWS_CM_00110].
  • executor: eine Rvalue-Referenz auf ein Executor-Objekt (ExecutorT&&), in dessen Ausführungskontext etwaige asynchron angestoßene Berechnungen gestartet werden [SWS_CM_00110].

Die Funktion liefert keinen Rückgabewert (void) und ist als noexcept deklariert [SWS_CM_00110].

Fehlerbehandlung und Ausführungssicherheit

Die Schnittstelle ist als exceptionsicher (exception safe) spezifiziert [SWS_CM_00110]. Wird als handler ein nicht existentes oder nullwertiges Callable übergeben, führt dies zu einer InvalidHandlerViolation [SWS_CM_00110]. Über diesen Handler werden spezifische Transportfehlerbedingungen gemeldet, wohingegen Methoden sowie Field-Getter und -Setter etwaige Transportfehler über ComErrc::kCommunicationFailure an ihren jeweiligen Rückgabe-Futures signalisieren [SWS_CM_00090].

Nebenläufigkeit und Zusammenspiel

Die Methode bildet die Execution-Context-Überladung zur parameterärmeren Basisfunktion [SWS_CM_00109]. Durch das übergebene Executor-Objekt entkoppelt die Implementierung die Handler-Ausführung vom internen Empfangskontext der Kommunikationsverwaltung [SWS_CM_00110]. Gleichartige Überladungen stehen für Proxy-Events [SWS_CM_00100], Proxy-Trigger [SWS_CM_00107] sowie für Skeleton-Methoden [SWS_CM_00094] und Skeleton-Fields [SWS_CM_00097] bereit. Interpretation: Der Aufruf dürfte sinnvollerweise vor dem Eintreffen von Notifier-Mitteilungen bzw. dem Abonnieren des Notifiers erfolgen, um eine lückenlose Fehlerüberwachung sicherzustellen. Frage Q-bc5c62dd39c09029 (offen)

Dieser Nutzungshinweis wurde automatisiert auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InvalidHandlerVio- Provided Callable handler does not exist or is null lation

Parameter (in)

ParameterBeschreibung
handlerHandler to be set
executorExecutor object in which any asynchronous computation spawn shall be invoked

Rückgabewert

TypBeschreibung
None
Siehe auch: [SWS_CM_00109]

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

Record
AUTOSAR/AP/record/SWS_CM_00110
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00110@rel:R25-11#b46bf659
Content hash
b46bf659
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00110
Status: valid/unmigrated Version: rel:R25-11#9be0f9ef Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_00110@rel:R25-11#9be0f9ef
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b46bf6592026-09-30
  • R24-11rel:R24-11#e56df0462026-10-14
  • R25-11rel:R25-11#9be0f9ef2026-10-14 active
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 Subscribe [SWS_CM_11601] Upstream: RS_CM_00103

ara::core::Result< void > Subscribe (std::size_t maxSampleCount) noexcept;

Method to subscribe to a service field notification. If the Field is already in state kSubscribed or in state kSubscriptionPending at the time of the call, and the provided maxSample Count value is the same as for the current subscription, the method shall return without action.

KI-GENERIERT ungeprüft Modell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: 54ef39af6b4b Herkunft
KI-generiertgemini-3.8-flash-medium · 2026-10-13

Die Methode Subscribe dient dazu, Benachrichtigungen für ein Field einer Service-Proxy-Instanz im Scope proxy::fields::<Field> zu abonnieren ([SWS_CM_11601]). Über den Parameter maxSampleCount legt die Anwendung die maximale Anzahl an Daten-Samples fest, die sie gleichzeitig halten möchte, und richtet damit den lokalen Empfangscache ein ([SWS_CM_11601], EXP ARAComAPI §5.3 „Proxy Class API’s“). Der Aufruf ist asynchron: Das zurückgegebene ara::core::Result<void> signalisiert lediglich die Annahme des Abonnements durch das Communication Management (EXP ARAComAPI §5.3.5.2 „Monitoring Event Subscription“).

Hinsichtlich des Zustandsverhaltens und der Fehlerbehandlung gelten folgende Regeln:

  • Idempotenz: Befindet sich das Field bereits im Zustand kSubscribed oder kSubscriptionPending und stimmt der übergebene maxSampleCount mit dem Wert der aktuellen Subskription überein, kehrt die Methode wirkungslos zurück ([SWS_CM_11601]).
  • Fehlercodes: Kann der geforderte Cache nicht bereitgestellt werden, schlägt die Operation mit dem Fehler ComErrc::kMaxSampleCountNotRealizable fehl ([SWS_CM_11601], [SWS_CM_10432]).
  • Berechtigungsprüfung: Fehlen die erforderlichen Rechte, wird der Aufruf durch das Grant Enforcement mit einer InsufficientPermissionsViolation abgewiesen ([SWS_CM_11601]).

Die Methode ist als noexcept deklariert und als Exception-safe spezifiziert ([SWS_CM_11601]). Semantisch folgt sie dem Verhalten der Event-Subskription ([SWS_CM_00141]); der konfigurierte Cache bildet die Grundlage für den anschließenden Sample-Empfang über Methoden wie GetNewSamples ([SWS_CM_00701]).

Dieser Nutzungshinweis wurde von einer KI auf Basis der AUTOSAR-R25-11-Spezifikation generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe
Verletzungen (Violations)InsufficientPer- Refused by Grant Enforcement missionsViolation

Parameter (in)

ParameterBeschreibung
maxSampleCountAs per [SWS_CM_00141]

Rückgabewert

TypBeschreibung
ara::core::Result< void >As per [SWS_CM_00141]

Fehler

FehlercodeBeschreibung
ComErrc::kMaxSampleCountNotRealizablerollback_semantics As per [SWS_CM_00141]

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

Record
AUTOSAR/AP/record/SWS_CM_11601
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11601@rel:R25-11#4d27d607
Content hash
4d27d607
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11601
Status: valid/unmigrated Version: rel:R25-11#ae9652a7 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11601@rel:R25-11#ae9652a7
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#4d27d6072026-09-30
  • R24-11rel:R24-11#19da91452026-10-14
  • R25-11rel:R25-11#ae9652a72026-10-14 active
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 UnsetReceiveHandler [SWS_CM_11606] Upstream: RS_CM_00203

void UnsetReceiveHandler () noexcept;

Disable service field notification trigger

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

Die Funktion UnsetReceiveHandler() dient auf Proxy-Ebene dazu, einen zuvor registrierten Empfangs-Handler für Feld-Benachrichtigungen zu deregistrieren ([SWS_CM_11606]). Sie gehört zu den Proxy-Klassen-APIs von ara::com (AUTOSAR_AP_EXP_ARAComAPI §5.3.1 „Proxy Class API’s“) und ist im Namensraum <SI-Namespace>::proxy::fields::<Field> angesiedelt ([SWS_CM_11606]).

Hinsichtlich Aufrufkontext und Semantik nimmt die Methode keine Parameter entgegen und liefert keinen Rückgabewert ([SWS_CM_11606]). Durch den Aufruf kann eine Anwendung jederzeit von einem ereignisgesteuerten Benachrichtigungsmodell zu einem abfragebasierten Polling-Betrieb wechseln, indem der anwenderspezifische Callback zurückgezogen wird (AUTOSAR_AP_EXP_ARAComAPI §5.3.2 „RadarService Proxy Class Example“).

Für die Fehlerbehandlung ist die Funktion als noexcept sowie exception safe spezifiziert ([SWS_CM_11606]); spezifische Fehlercodes existieren laut Spezifikation nicht. Der Aufruf erfolgt synchron; nach erfolgreichem Entzug des Handlers löst das Communication Management bei neu eingehenden Daten keine weiteren Callback-Aufrufe mehr aus (Interpretation: laufende oder bereits eingeplante Ausführungen dürften vor dem Rückzug noch abgeschlossen bzw. serialisiert abgearbeitet werden, da Callback-Aufrufe durch das Communication Management serialisiert erfolgen müssen; vgl. AUTOSAR_AP_EXP_ARAComAPI §5.3.2 „RadarService Proxy Class Example“). Frage Q-fbc65e80b8d8be38 (offen)

Im Zusammenspiel korrespondiert die Methode mit dem Deaktivieren von Triggern bei Service-Events ([SWS_CM_00183]; AUTOSAR_AP_EXP_ARAComAPI §10) und Triggern ([SWS_CM_11614]). Im DDS-Binding wird das Verhalten über das Mapping von UnsetReceiveHandler() auf den jeweiligen DataReader abgebildet ([SWS_CM_11141]).

Dieser Hinweis wurde von einer KI auf Basis des AUTOSAR-R25-11-Datenbestands erstellt.

Implementer's Guide folgt (Komplexität I1)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11606
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11606@rel:R25-11#e89f906f
Content hash
e89f906f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11606
Status: valid/unmigrated Version: rel:R25-11#16565755 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11606@rel:R25-11#16565755
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#e89f906f2026-09-30
  • R24-11rel:R24-11#d180a3442026-10-14
  • R25-11rel:R25-11#165657552026-10-14 active
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 UnsetSubscriptionStateChangeHandler [SWS_CM_11609] Upstream: RS_CM_00106, RS_AP_00114, RS_AP_00120

void UnsetSubscriptionStateChangeHandler () noexcept;

Unset ara::com::SubscriptionState change handler

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

Verwendung

Die Methode UnsetSubscriptionStateChangeHandler dient im Rahmen der AUTOSAR-Adaptive-Plattform dazu, einen zuvor registrierten Callback für Änderungen des Abonnementstatus (ara::com::SubscriptionState) eines Feldes zu entfernen [SWS_CM_11609]. Sie wird synchron auf Instanzen von Feldern eines Dienst-Proxys im Namensraum <SI-Namespace>::proxy::fields::<Field> aufgerufen und erfordert die Einbindung des generierten Headers #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.4.5 „UnsetSubscriptionStateChangeHandler“. Der Aufruf nimmt keine Übergabeparameter entgegen und liefert keinen Rückgabewert.

Fehlerbehandlung und Nebenläufigkeit

Die Schnittstelle ist als noexcept deklariert und erfüllt laut Spezifikation die Eigenschaft exception safe [SWS_CM_11609]. Ein Auftreten von Fehlern oder Exceptions ist somit ausgeschlossen. Da das Deregistrieren unmittelbar wirksam wird, ist davon auszugehen (Interpretation), dass nach Beendigung der Methode keine neuen Benachrichtigungen mehr an den vormaligen Handler übergeben werden. Frage Q-30238329b76b64f4 (offen)

Zusammenspiel

Die Funktion gehört zu den grundlegenden Proxy-Klassen-APIs zur Verwaltung von Abonnements in ara::com AUTOSAR_AP_EXP_ARAComAPI §5.3.1 „Proxy Class API’s“. Gleichartige Methoden zur Deaktivierung von Statusänderungs-Handlern existieren für Proxy-Events [SWS_CM_00334] und Trigger [SWS_CM_01108] sowie spiegelbildlich auf der Skeleton-Seite für Events [SWS_CM_12010] und Trigger [SWS_CM_01112].

Dieser Nutzungshinweis wurde automatisiert anhand der AUTOSAR-Spezifikationen erstellt.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11609
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11609@rel:R25-11#0c91f75a
Content hash
0c91f75a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11609
Status: valid/unmigrated Version: rel:R25-11#1abd2b15 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11609@rel:R25-11#1abd2b15
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0c91f75a2026-09-30
  • R24-11rel:R24-11#678da2882026-10-14
  • R25-11rel:R25-11#1abd2b152026-10-14 active
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 UnsetTransportFaultConditionHandler [SWS_CM_00126] Upstream: RS_CM_00224, RS_E2E_08534

void UnsetTransportFaultConditionHandler () noexcept;

Provides the possibility to unregister a previously set ara::com::e2e:: TransportFaultConditionHandler for a given Proxy Field Notifier.

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

Verwendung

Die Funktion UnsetTransportFaultConditionHandler dient dazu, einen zuvor registrierten ara::com::e2e::TransportFaultConditionHandler für den Notifier eines bestimmten Proxy-Feldes wieder abzumelden [SWS_CM_00126]. Sie ist innerhalb des Scopes <SI-Namespace>::proxy::fields::<Field> definiert und wird über die Header-Datei <SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h eingebunden AUTOSAR_AP_SWS_CommunicationManagement §8.3.3.2.1.4 „UnsetTransportFaultConditionHandler“. Der Aufruf erfolgt parameterlos und liefert keinen Rückgabewert (void).

Fehlerbehandlung

Die Methode ist als noexcept deklariert und besitzt die Ausnahme-Garantie exception safe [SWS_CM_00126]. Es werden keine Fehlercodes zurückgegeben oder Exceptions geworfen. Falls kein Handler zuvor registriert war, dürfte ein wiederholter Aufruf vermutlich ohne Auswirkung bleiben. Frage Q-85da9a7b00678748 (offen)

Nebenläufigkeit und Einschränkungen

Die Spezifikation definiert keine gesonderten Nebenläufigkeits- oder Thread-Sicherheitsanforderungen. Da die Schnittstelle synchron arbeitet und keine asynchronen Typen nutzt, dürfte das Zurücknehmen des Fehler-Handlers synchron und unmittelbar greifen. Frage Q-ed4cc712bb55aee5 (offen) Aufrufer sollten den Aufruf im Anwendungslebenszyklus so koordinieren, dass Notifier-Meldungen einzelner Service-Instanzen nicht unkontrolliert ohne Handler verarbeitet werden AUTOSAR_AP_SWS_CommunicationManagement §7.4.1 „End-to-end communication protection for SOMEIP“.

Zusammenspiel

Das Deregistrieren folgt einem konsistenten Namens- und Funktionsmuster in AUTOSAR Adaptive:

  • Auf Proxy-Ebene stehen äquivalente Funktionen für Events ([SWS_CM_00105]) sowie für Trigger ([SWS_CM_00108]) bereit.
  • Auf Skeleton-Ebene existieren entsprechende Pendants für Field-Getter und -Setter ([SWS_CM_00098]) sowie übergreifend für alle Methoden des Skeleton-Interfaces ([SWS_CM_00095]).

Dieser Nutzungshinweis wurde automatisch auf Basis der Spezifikation AUTOSAR Adaptive R25-11 generiert.

Implementer's Guide folgt (Komplexität I2)

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_00126
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_00126@rel:R25-11#b31fdb2c
Content hash
b31fdb2c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_00126
Status: valid/unmigrated Version: rel:R25-11#34c05de8 Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_00126@rel:R25-11#34c05de8
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#b31fdb2c2026-09-30
  • R24-11rel:R24-11#00a5c4a32026-10-14
  • R25-11rel:R25-11#34c05de82026-10-14 active
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 Unsubscribe [SWS_CM_11602] Upstream: RS_CM_00104

void Unsubscribe () noexcept;

Method to unsubscribe from a service field notification. If the Field is not subscribed to at the time of the call, Unsubscribe() shall return without action.

Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_CM_11602
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11602@rel:R25-11#0705e32a
Content hash
0705e32a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11602
Status: valid/unmigrated Version: rel:R25-11#77e3e54d Versionshistorie & Revisions (1 transition, 3 revision)
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/SWS_CM_11602@rel:R25-11#77e3e54d
Point-in-Time History:
Recorded Revisions (3):
  • R25-11rel:R25-11#0705e32a2026-09-30
  • R24-11rel:R24-11#af6d228d2026-10-14
  • R25-11rel:R25-11#77e3e54d2026-10-14 active
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

Dokumentation der Typaliase

type alias FieldType [SWS_CM_11403] Upstream: RS_CM_00216, RS_AP_00114

using FieldType = <PFieldCppidt>;
Header-Datei#include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h"
Scopeclass <SI-Namespace>::proxy::fields::<Field>
SymbolFieldType

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

Record
AUTOSAR/AP/record/SWS_CM_11403
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11403@rel:R25-11#92627104
Content hash
92627104
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11403
Status: valid/unmigrated Version: rel:R25-11#cc450956 Versionshistorie & Revisions (1 transition, 5 revision)
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/SWS_CM_11403@rel:R25-11#cc450956
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#926271042026-09-30
  • R22-11rel:R22-11#8ef005dd2026-10-14
  • R23-11rel:R23-11#8ef005dd2026-10-14
  • R24-11rel:R24-11#46a194152026-10-14
  • R25-11rel:R25-11#cc4509562026-10-14 active
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