class ara::shwa::PropertyList

Die finale Klasse ara::shwa::PropertyList dient im AUTOSAR-Adaptive-Modul shwa der Aggregation und Übergabe von Eigenschaften. Die Erzeugung erfolgt über einen variadischen Template-Konstruktor, der als noexcept deklariert und somit ausnahmesicher ist ([AP_SWS_SHWA_00802]). Interpretation: Instanzen dürften vorwiegend als kurzlebige Werteobjekte genutzt werden, um Konfigurationsattribute gebündelt an Hardware-Schnittstellen zu übergeben. Frage Q-6303ee8ec36bf3e3 (offen) Als zentrale Randbedingung ist die Klasse nicht threadsicher (not thread-safe), weshalb gleichzeitige Zugriffe aus mehreren Threads extern synchronisiert werden müssen ([AP_SWS_SHWA_00802]).

mehr ›

Kontext

Die Klasse ara::shwa::PropertyList ist Bestandteil des Moduls shwa (Smart Hardware Actuator) innerhalb der AUTOSAR Adaptive Platform. Die Spezifikation definiert diesen Typ als finale Klasse (class PropertyList final), wodurch eine Ableitung durch Anwenderklassen im Vorfeld ausgeschlossen ist. Die primäre Rolle der Klasse besteht in der Bündelung und strukturierten Übergabe von Eigenschaften. Über das Konstruktortemplate [AP_SWS_SHWA_00802] nimmt die Klasse eine variable Menge an Eigenschaftsobjekten entgegen. Interpretation: Die Klasse dürfte innerhalb des Moduls als typsicherer Aggregationscontainer dienen, der heterogene Konfigurationen oder Hardware-Attribute für Aktoren und Sensoren zusammenfasst und an verarbeitende Schnittstellen weiterreicht. Frage Q-70687f2df4a18776 (offen)

Im Zusammenspiel mit anderen Komponenten agiert die Klasse als Informationsträger. Der Aufrufer aggregiert anwendungsspezifische Eigenschaften, während das SHWA-Subsystem diese Listen entgegennimmt, um hardwarenahe Operationen zu steuern. Da die Klassendefinition final ist, bildet PropertyList eine geschlossene Datenstruktur, die eine direkte Vererbungshierarchie verhindert und damit eine einheitliche Semantik bei der Parameterübergabe erzwingt.

Lebenszyklus

Der Lebenszyklus einer Instanz von ara::shwa::PropertyList beginnt mit der direkten Initialisierung über den variadischen Konstruktor template <typename... Properties> PropertyList(Properties... props) gemäß [AP_SWS_SHWA_00802]. Durch die Deklaration mit noexcept ist garantiert, dass die Erzeugung einer Instanz unter Beachtung der Exception Safety vollständig ausnahmesicher abläuft ([AP_SWS_SHWA_00802]). Treten bei der Parameterübergabe oder der internen Verarbeitung Fehler auf, führt dies aufgrund der noexcept-Garantie zum direkten Programmabbruch über std::terminate, sofern zugrunde liegende Operationen Ausnahmen werfen sollten.

Hinsichtlich des Nebenläufigkeitsverhaltens legt die Spezifikation fest, dass die Klasse nicht threadsicher (not thread-safe) ist ([AP_SWS_SHWA_00802]). Dies bedeutet, dass Instanzen während ihrer Erzeugung und bei allen Folgeoperationen nicht ohne externe Synchronisationsmechanismen von mehreren Threads gleichzeitig verwendet werden dürfen. Interpretation: Instanzen von PropertyList dürften typischerweise als lokale Werteobjekte (Value Objects) auf dem Stack angelegt oder per Move-Semantik an aufgerufene Funktionen übergeben werden, womit threadlokale Besitzverhältnisse ohne geteilten Zustand realisiert werden. Frage (offen)

Das Ende des Lebenszyklus folgt den regulären Regeln für automatische oder dynamische C++-Objekte. Da keine virtuellen Destruktoren oder Vererbung vorgesehen sind, werden alle enthaltenen Ressourcen bei Zerstörung des Objekts deterministisch freigegeben.

Nutzungspfad

Der reguläre Nutzungspfad von ara::shwa::PropertyList umfasst die Zusammenstellung relevanter Eigenschaften und die Weitergabe des aggregierten Objekts an das SHWA-Subsystem:

• Instanziierung: Der Anwender erzeugt ein Objekt der Klasse, indem er die gewünschten Eigenschaften direkt an den variadischen Konstruktor übergibt ([AP_SWS_SHWA_00802]). Durch das Template können verschiedene Eigenschaftstypen typkonform in einem einzelnen Aufruf zusammengeführt werden.
• Übergabe: Die erzeugte Instanz wird an die entsprechenden Zielmethoden oder Schnittstellen des Moduls shwa übergeben. Interpretation: Nach der Konstruktion erfolgt der Zugriff auf die gebündelten Werte vermutlich rein lesend durch die verarbeitenden Komponenten des Hardware-Subsystems. Frage Q-350de0ec77d53e28 (offen)
• Bereinigung: Nach Abschluss der Verarbeitung oder beim Verlassen des Gültigkeitsbereichs wird die Instanz automatisch zerstört, ohne dass explizite Deinitialisierungsschritte erforderlich sind.

Fehlerszenarien

Da der Konstruktor von ara::shwa::PropertyList explizit als noexcept deklariert ist, treten beim Aufruf keine C++-Exceptions auf ([AP_SWS_SHWA_00802]). Die Ausnahmesicherheit ist in der Anforderungsspezifikation ausdrücklich als exception safe ausgewiesen ([AP_SWS_SHWA_00802]). Anwender müssen daher keine try-catch-Blöcke um die Konstruktion von Eigenschaftslisten platzieren.

Ein wesentliches Fehlerszenario liegt in der Missachtung der Thread-Sicherheit. Da PropertyList gemäß [AP_SWS_SHWA_00802] als not thread-safe eingestuft ist, führt ein ungeschützter, nebenläufiger Zugriff mehrerer Ausführungsstränge auf dieselbe Instanz zu Race Conditions und undefiniertem Verhalten. Entwickler müssen sicherstellen, dass Instanzen entweder ausschließlich threadlokal betrieben oder durch geeignete Synchronisationsprimitive wie Mutexe vor nebenläufigen Zugriffen geschützt werden.