klasse ara::shwa::PropertyList

De finale klasse ara::shwa::PropertyList dient in de AUTOSAR Adaptive-module shwa voor de aggregatie en overdracht van eigenschappen. De creatie vindt plaats via een variadische template-constructor die als noexcept is gedeclareerd en zodoende uitzonderingsveilig is ([AP_SWS_SHWA_00802]). Interpretatie: Instanties worden vermoedelijk hoofdzakelijk als kortlevende waarde-objecten gebruikt om configuratie-attributen gebundeld over te dragen aan hardware-interfaces. Vraag Q-6303ee8ec36bf3e3 (open) Als centrale randvoorwaarde is de klasse niet thread-safe (not thread-safe), waardoor gelijktijdige toegang vanuit meerdere threads extern moet worden gesynchroniseerd ([AP_SWS_SHWA_00802]).

meer ›

Context

De klasse ara::shwa::PropertyList maakt deel uit van de module shwa (Smart Hardware Actuator) binnen het AUTOSAR Adaptive Platform. De specificatie definieert dit type als finale klasse (class PropertyList final), waardoor afleiding door gebruikersklassen vooraf is uitgesloten. De primaire rol van de klasse bestaat uit het bundelen en gestructureerd overdragen van eigenschappen. Via de constructortemplate [AP_SWS_SHWA_00802] accepteert de klasse een variabele hoeveelheid eigenschapsobjecten. Interpretatie: De klasse fungeert binnen de module vermoedelijk als typeveilige aggregatiecontainer die heterogene configuraties of hardware-attributen voor actuatoren en sensoren samenvoegt en doorgeeft aan verwerkende interfaces. Vraag Q-70687f2df4a18776 (open)

In interactie met andere componenten fungeert de klasse als informatiedrager. De aanroeper aggregeert toepassingsspecifieke eigenschappen, terwijl het SHWA-subsysteem deze lijsten accepteert om hardwarenabije bewerkingen aan te sturen. Aangezien de klassedefinitie final is, vormt PropertyList een gesloten datastructuur die een directe overervingshiërarchie verhindert en daarmee een uniforme semantiek bij de parameteroverdracht afdwingt.

Levenscyclus

De levenscyclus van een instantie van ara::shwa::PropertyList begint met de directe initialisatie via de variadische constructor template <typename... Properties> PropertyList(Properties... props) conform [AP_SWS_SHWA_00802]. Door de declaratie met noexcept is gegarandeerd dat het aanmaken van een instantie met inachtneming van exception safety volledig uitzonderingsveilig verloopt ([AP_SWS_SHWA_00802]). Treden er bij de parameteroverdracht of de interne verwerking fouten op, dan leidt dit vanwege de noexcept-garantie tot een directe programmabeëindiging via std::terminate, mits onderliggende operaties excepties zouden werpen.

Wat betreft het concurrency-gedrag legt de specificatie vast dat de klasse niet thread-safe (not thread-safe) is ([AP_SWS_SHWA_00802]). Dit betekent dat instanties tijdens het aanmaken en bij alle vervolgbewerkingen niet zonder externe synchronisatiemechanismen door meerdere threads tegelijkertijd mogen worden gebruikt. Interpretatie: Instanties van PropertyList worden vermoedelijk typisch als lokale waarde-objecten (Value Objects) op de stack aangemaakt of via move-semantiek overgedragen aan aangeroepen functies, waarmee thread-lokale eigendomsverhoudingen zonder gedeelde toestand worden gerealiseerd. Vraag (open)

Het einde van de levenscyclus volgt de reguliere regels voor automatische of dynamische C++-objecten. Aangezien er geen virtuele destructors of overerving zijn voorzien, worden alle aanwezige resources bij de vernietiging van het object deterministisch vrijgegeven.

Gebruikspad

Het reguliere gebruikspad van ara::shwa::PropertyList omvat het samenstellen van relevante eigenschappen en het doorgeven van het geaggregeerde object aan het SHWA-subsysteem:

• Instantiatie: De gebruiker maakt een object van de klasse aan door de gewenste eigenschappen direct door te geven aan de variadische constructor ([AP_SWS_SHWA_00802]). Dankzij het template kunnen verschillende typen eigenschappen typeconform in een enkele aanroep worden samengevoegd.
• Overdracht: De aangemaakte instantie wordt overgedragen aan de overeenkomstige doelmethoden of interfaces van de module shwa. Interpretatie: Na de constructie vindt de toegang tot de gebundelde waarden vermoedelijk zuiver lezend plaats door de verwerkende componenten van het hardware-subsysteem. Vraag Q-350de0ec77d53e28 (open)
• Opschoning: Na afronding van de verwerking of bij het verlaten van de scope wordt de instantie automatisch vernietigd, zonder dat er expliciete de-initialisatiestappen vereist zijn.

Foutscenario's

Omdat de constructor van ara::shwa::PropertyList expliciet als noexcept is gedeclareerd, treden er bij de aanroep geen C++-exceptions op ([AP_SWS_SHWA_00802]). De uitzonderingsveiligheid is in de specificatie van eisen uitdrukkelijk aangeduid als exception safe ([AP_SWS_SHWA_00802]). Gebruikers hoeven daarom geen try-catch-blokken rond de constructie van eigenschappenlijsten te plaatsen.

Een wezenlijk foutscenario schuilt in het niet naleven van de thread-safety. Omdat PropertyList conform [AP_SWS_SHWA_00802] als not thread-safe is geclassificeerd, leidt onbeschermde, gelijktijdige toegang van meerdere executiedraden tot dezelfde instantie tot race conditions en ongedefinieerd gedrag. Ontwikkelaars moeten ervoor zorgen dat instanties uitsluitend thread-lokaal worden gebruikt of door geschikte synchronisatieprimitieven zoals mutexen tegen gelijktijdige toegang worden beschermd.