Service proxy fire-and-forget method class, one for each ClientServerOperation ( ClientServerOperation.fireAndForget==TRUE) defined in the ServiceInterface in the role method.
Ermöglicht den unbestätigten Aufruf von Einweg-Methoden einer Service-Schnittstelle ohne Rückgabewert auf Client-Ebene.
KI-GENERIERTungeprüftModell: gemini-3.8-flash-medium · Aufwand: medium · Temperatur: nicht steuerbar · Prompt: c09dd8b0ab24HerkunftOffene Fragen (2)
KI-generiertgemini-3.8-flash-medium · 2026-10-13
Ermöglicht den unbestätigten Aufruf von Einweg-Methoden einer Service-Schnittstelle ohne Rückgabewert auf Client-Ebene.
Die Proxy-Klasse ermöglicht der Client-Anwendung das Auslösen unbestätigter Methodenaufrufe für Service-Operationen mit Fire-and-Forget-Semantik [SWS_CM_90435]. Beim Aufruf des Funktionsoperators werden die Eingabeparameter übermittelt, ohne dass ein Rückgabewert oder ein Antwort-Future für ein Ergebnis erzeugt wird. Gleichzeitig wird bei jedem Methodenaufruf die Ende-zu-Ende-Absicherung ausgeführt, deren aktueller Prüfzustand separat abgefragt werden kann [SWS_CM_00147]. Ein Aufruf erfolgt ausnahmesicher, scheitert jedoch bei unzureichenden Zugriffsrechten mit einer Berechtigungsverletzung.
Kontext
Die Klasse <SI-Namespace>::proxy::methods::<FnFMethod> repräsentiert eine Fire-and-Forget-Methode auf der Client- bzw. Proxy-Seite im Kommunikationsmanagement der AUTOSAR Adaptive Platform [SWS_CM_90435]. In einer serviceorientierten Architektur existiert für jede in der Schnittstelle definierte Operation (ClientServerOperation), bei der ClientServerOperation.fireAndForget == TRUE festgelegt ist, genau eine solche Instanz in der Proxy-Rolle [SWS_CM_90435], SWS CommunicationManagement §8.3.4.1.2.1 „operator()“.
Ihre Kernverantwortung liegt in der Entgegennahme von Aufrufargumenten und deren Weiterleitung an die Übertragungsschicht. Anders als bei synchronen oder asynchronen bidirektionalen Aufrufen, die den Aufrufer über ein ara::core::Future benachrichtigen und etwaige Anwendungsfehler transportieren [SWS_CM_00197], verlangt ein Fire-and-Forget-Aufruf weder eine Antwort noch eine Bestätigung der Serverseite. Die Interaktionspartner umfassen die aufrufende Client-Anwendung, die Methodeninstanz des Service-Proxys sowie das nachgelagerte Kommunikations-Binding inklusive der E2E-Absicherung.
Kontextdiagramm: Komponenten und Schnittstellenbeziehungen der Proxy-Fire-and-Forget-Methodenklasse. Quellen: [SWS_CM_90435], [SWS_CM_00147]
Lebenszyklus
Die Deklaration der Klasse erfolgt innerhalb der generierten Header-Datei #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_proxy.h" im hierarchischen Scope <SI-Namespace>::proxy::methods::<FnFMethod>[SWS_CM_90435]. Die Lebensdauer der Methodeninstanz dürfte an die Lebensdauer des übergeordneten Service-Proxy-Objekts gekoppelt sein (Interpretation: Die Methode wird als Subobjekt zusammen mit dem Service-Proxy erzeugt und zerstört). Frage Q-9ee6da68f325c3d0 (offen)
Über den reinen Aufruf hinaus besitzt die Klasse einen internen Status bezüglich des E2E-Schutzes (End-to-End-Protection). Dieser E2E-Zustand wird bei jedem Methodenaufruf über die Funktion E2E_Check() ermittelt und kann über GetE2EStateMachineState() abgefragt werden, welche den Statuswert vom Typ ara::com::e2e::SMState liefert [SWS_CM_00147], SWS CommunicationManagement §8.3.4.1.1.1 „GetE2EStateMachineState“. Sämtliche Elementfunktionen sind als noexcept deklariert [SWS_CM_00147], [SWS_CM_90435]; bei gleichzeitigem Aufruf aus mehreren Threads dürfte eine externe Synchronisation erforderlich sein, falls das Binding keine Reentrancy garantiert. Frage Q-e59aae09676d76c2 (offen)
Nutzungspfad
Der typische Ablauf zur Nutzung einer Fire-and-Forget-Methode umfasst folgende Schritte:
Proxy-Bereitstellung: Die Anwendung instanziiert oder beschafft den generierten Service-Proxy über die definierte Header-Schnittstelle [SWS_CM_90435].
Methodenaufruf ausführen: Die Anwendung ruft das Methodenobjekt über operator() unter Übergabe der Eingabeparameter auf [SWS_CM_90435]. Die Funktion liefert keinen Rückgabewert (void) und kehrt sofort zurück, ohne auf eine Server-Reaktion zu warten SWS CommunicationManagement §8.3.4.1.2.1 „operator()“.
E2E-Aktualisierung: Während des Aufrufs von operator() führt die Middleware intern die Schutzprüfung E2E_Check() durch und aktualisiert die interne Zustandsmaschine [SWS_CM_00147].
Sequenzdiagramm: Typische Interaktionsreihenfolge beim Aufruf einer Fire-and-Forget-Methode und anschließender Statusabfrage. Quellen: [SWS_CM_90435], [SWS_CM_00147]
Fehlerszenarien
Sowohl operator() als auch GetE2EStateMachineState() sind ausnahmesicher (exception safe) und als noexcept deklariert [SWS_CM_00147], [SWS_CM_90435]. Es werden daher keine C++-Ausnahmen ausgelöst.
Bei fehlenden Zugriffsrechten greift die Rechteprüfung (Grant Enforcement): Fehlen dem aufrufenden Kontext die notwendigen Berechtigungen, wird der Aufruf verweigert und eine InsufficientPermissionsViolation registriert [SWS_CM_90435].
Da keine Rückgabe über ein ara::core::Future erfolgt und Fire-and-Forget-Operationen keine Übermittlung eines ApApplicationError oder ara::core::ErrorCode unterstützen [SWS_CM_00197], werden Übertragungsfehler nicht an den Aufrufer zurückgemeldet. Etwaige Fehler in der Datensicherheit oder im Übertragungskanal manifestieren sich ausschließlich im Zustand der E2E-Zustandsmaschine, der über GetE2EStateMachineState() diagnostiziert werden kann [SWS_CM_00147].
Dieser Leitfaden basiert auf der Spezifikation AUTOSAR Adaptive Platform Release R25-11 und beschreibt die Funktionsweise der Proxy-Fire-and-Forget-Methodenklasse.
UML-Klassendiagramm
Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.
Returns the state of the specific fnfmethod class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
Returns the state of the specific fnfmethod class, which was determined by the last run of E2E_Check() function invoked during the last call of operator()
gemini-3.8-flash-medium· 2026-10-13