namespace <SI-Namespace>::proxy::fields
User GuideKI-GENERIERT
Kapselt die typsicheren Proxy-Klassen für Lese-, Schreib- und Benachrichtigungszugriffe auf Felder eines Services.
Kapselt die typsicheren Proxy-Klassen für Lese-, Schreib- und Benachrichtigungszugriffe auf Felder eines Services.
Der Namespace <SI-Namespace>::proxy::fields kapselt im Modul com der Adaptive Platform die generierten Proxy-Klassen <Field> für jedes in einem ServiceInterface definierte Datenfeld. Client-Anwendungen greifen über den übergeordneten Service-Proxy auf diese Feldklassen zu, um entfernte Feldwerte abzufragen, zu setzen oder Benachrichtigungen über Wertänderungen zu verarbeiten. Aufrufe auf Feldern dürften dabei asynchron über die Kommunikationsinfrastruktur abgewickelt werden, um blockierungsfreie Interaktionen zu gewährleisten. Frage (offen) Die Lebensdauer der einzelnen Feld-Instanzen ist vermutlich fest an den Lebenszyklus des übergeordneten Proxy-Objekts gebunden und kann nicht unabhängig von diesem verwaltet werden.
Kontext
Der C++-Namespace <SI-Namespace>::proxy::fields übernimmt im Modul com der AUTOSAR Adaptive Platform eine klar abgegrenzte Strukturierungsfunktion für serviceorientierte Schnittstellen. Service-Schnittstellen (ServiceInterfaces) definieren neben Methoden und Events häufig Datenfelder, die einen aktuellen Zustand repräsentieren. Um diese Felder auf Client-Seite für Service-Konsumenten typsicher und semantisch eindeutig bereitzustellen, ordnet der Codegenerator die spezifischen Feld-Klassen in diesen dedizierten Unter-Namespace ein. Für jedes im jeweiligen ServiceInterface modellierte Feld wird genau eine Proxy-Feldklasse <Field> erzeugt. Diese strukturelle Kapselung verhindert Namenskonflikte mit gleichnamigen Methoden oder Events innerhalb des übergeordneten Proxy-Namespace. Interpretation: Die generierten Feldklassen <Field> stellen typischerweise spezialisierte Schnittstellenfunktionen für Get-, Set- und Notifikationsfunktionalitäten bereit, um gezielt Werte abzufragen, zu modifizieren oder abonnierte Änderungen zu empfangen. Frage Q-f088d0c5052459d3 (offen) Der direkte Interaktionspartner der Feldklassen ist die Anwendungslogik des Dienstkonsumenten auf der einen Seite sowie die zugrunde liegende Kommunikationsmiddleware auf der anderen Seite.
Lebenszyklus
Die Instanziierung und Verwaltung der Objekte aus <SI-Namespace>::proxy::fields ist untrennbar mit der Architektur des Service-Proxy verknüpft. Anwendungsentwickler erzeugen Instanzen der generierten Klasse <Field> im Regelfall nicht manuell als eigenständige Variablen auf dem Heap oder Stack. Stattdessen dürfte die Lebensdauer einer Instanz von <Field> vermutlich vollständig an den Lebenszyklus des übergeordneten Service-Proxy gebunden sein, der diese Felder als Member hält. Frage Q-4da7e86f88f269b1 (offen) Mit der erfolgreichen Konstruktion der Proxy-Instanz nach dem Auffinden eines passenden Service-Endpunkts werden die Feld-Objekte initialisiert und in einen betriebsbereiten Zustand versetzt. Während der aktiven Phase verwaltet das Feld-Objekt interne Kommunikationsressourcen sowie etwaige Registrierungen für Zustandsaktualisierungen. Wird die Proxy-Instanz durch die Anwendung zerstört oder verlässt ihren Gültigkeitsbereich, werden konsequenterweise auch die zugehörigen Feld-Instanzen ordnungsgemäß dekonstruiert, wodurch verknüpfte Middleware-Ressourcen freigegeben werden.
Nutzungspfad
Der typische Nutzungsablauf der Klassen im Namespace <SI-Namespace>::proxy::fields gliedert sich in eine feste Reihenfolge von Interaktionsschritten. Zunächst ermittelt die Client-Anwendung die Instanz des gewünschten Service über die Suchmechanismen der Adaptive Platform und instanziiert den entsprechenden Service-Proxy. Im zweiten Schritt greift die Anwendung über den Proxy auf die entsprechende Member-Instanz der generierten Klasse <Field> zu. Abhängig von den im Schnittstellenmodell definierten Eigenschaften des Feldes initiiert die Anwendung daraufhin einen Lesezugriff, einen Schreibzugriff oder registriert einen Callback für Benachrichtigungen über Werteänderungen. Aufrufe auf Feldern dürften dabei asynchron über ara::core::Future oder Callback-Mechanismen der Kommunikationsinfrastruktur abgewickelt werden, um blockierende Aufrufe im aufrufenden Thread zu vermeiden. Frage Q-33586a48d8777f7f (offen) Nach dem Eintreffen der Antwort oder Notifikation wertet der Aufrufer das gelieferte Ergebnis aus und reagiert auf den Zustand des entfernten Feldes.
Dieser Leitfaden basiert auf den Spezifikationen der AUTOSAR Adaptive Platform (Release R25-11, Modul com) und wurde automatisiert erstellt.
Für dieses Release liegen keine Elementdaten vor
Klassen
Service proxy Field class, one for each Field defined in the ServiceInterface in the role field.
Klassendiagramm
Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.
gemini-3.8-flash-medium· 2026-10-13