klasse ara::diag::ReleaseHandler

De klasse ara::diag::ReleaseHandler beheert een gezamenlijke toestand om vast te stellen of een lopende diagnoseverwerking kan worden afgebroken en een gedeelde resource kan worden vrijgegeven [SWS_DM_01340]. Applicaties kunnen via SetNotifier een notificatiefunctie registreren en met MayRelease synchroon opvragen of de resource niet meer in gebruik is [SWS_DM_01536]. Omdat standaardconstructie en kopieerbewerkingen niet zijn toegestaan, wordt de instantie overgedragen via move-semantiek, waarbij modificaties en vernietiging niet thread-safe zijn.

meer ›

Context

De klasse ara::diag::ReleaseHandler kapselt in de AUTOSAR Adaptive-diagnosemodule een gezamenlijke toestand (shared state) in, die aangeeft of een lopende verwerking moet worden geannuleerd of een gedeelde resource moet worden vrijgegeven [SWS_DM_01340], AUTOSAR_AP_SWS_Diagnostics §8.23 “Header: ara/diag/release_handler.h”. In de diagnose-architectuur dient deze als synchronisatie- en notificatie-interface tussen de AUTOSAR-diagnoseruntime-omgeving en de applicatiespecifieke diagnosehandlers. Dit betreft in het bijzonder langer lopende of resource-intensieve verwerkingen, zoals die bijvoorbeeld optreden in de context van bestands- en gegevensoverdrachtsessies AUTOSAR_AP_SWS_Diagnostics §7.x “DataTransfer”.

Via de ReleaseHandler krijgt de applicatie de mogelijkheid om geïnformeerd te worden over het beëindigen of annuleren van verwerkingscycli, zonder gebruik te hoeven maken van blokkerende mechanismen. Daarmee vervult de klasse de rol van ontkoppelaar tussen het interne verloop van de diagnoseserver en de onderliggende verwerkingsroutines van de applicatie.

Levenscyclus

De levenscyclus van een instantie van ReleaseHandler is onderworpen aan strikte semantische voorschriften. De klasse verbiedt een parameterloze instantiëring via de standaardconstructor expliciet [SWS_DM_01530], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.1 “Default Constructor”. Omdat er geen verdere publieke constructor is gespecificeerd, vindt de daadwerkelijke aanmaak van het object vermoedelijk intern plaats door de diagnoseserver, voordat de instantie aan de desbetreffende servicehandler wordt overgedragen. Vraag Q-05a2e8b6b7deca40 (open) Bovendien is ReleaseHandler ontworpen als een pure move-only klasse: zowel de copy-constructor [SWS_DM_01534] als de toewijzingsoperator voor kopieën [SWS_DM_01535] zijn verwijderd.

Het eigendom van de instantie kan uitsluitend worden overgedragen via move-bewerkingen. De move-constructor is gedefinieerd als uitzonderingsveilig (noexcept) en expliciet als thread-safe [SWS_DM_01532], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.2 “Move Constructor”. Daarentegen is de move-toewijzingsoperator operator= weliswaar eveneens uitzonderingsveilig, maar niet thread-safe [SWS_DM_01533]. De vernietiging vindt plaats via de destructor ~ReleaseHandler() [SWS_DM_01531], AUTOSAR_AP_SWS_Diagnostics §8.23.1.2.1.4 “Destructor”, die uitzonderingsveilig (noexcept) is, maar niet thread-safe mag worden aangeroepen.

Gebruikspad

Het typische gebruikspad omvat de registratie van een notificatiefunctie en de synchrone of asynchrone controle van de vrijgavestatus. Een applicatie registreert een callback via de methode SetNotifier [SWS_DM_01537]. Als parameter wordt een callable van het type ReleaseHandlerSetNotifier doorgegeven, die is gespecificeerd als type-alias voor std::function<void(void)> [SWS_DM_02079], AUTOSAR_AP_SWS_Diagnostics §8.23.1.1.1 “Type Alias: ReleaseHandlerSetNotifier”. Een herhaalde aanroep van SetNotifier overschrijft daarbij een eerder geregistreerde functie volledig [SWS_DM_01537].

Zodra de gedeelde resource kan worden vrijgegeven of er sprake is van een annulering, wordt de geregistreerde notifier geactiveerd. Vermoedelijk vindt deze aanroep asynchroon plaats in de threadcontext van de diagnoseserver. Vraag Q-d948326514d200a1 (open) Parallel daaraan of binnen de reguliere controlelus kan de applicatie via MayRelease() controleren of de gedeelde resource niet meer in gebruik is [SWS_DM_01536]. De methode retourneert true wanneer de resource mag worden vrijgegeven, en anders false [SWS_DM_01536].

Sequentiediagram: verloop voor de registratie van de notificatie en vrijgave van gedeelde resources. Bronnen: [SWS_DM_01536], [SWS_DM_01537], [SWS_DM_02079].

Foutscenario's

Alle methoden van ReleaseHandler zijn geannoteerd met noexcept en gespecificeerd als uitzonderingsveilig; er worden bijgevolg geen excepties geworpen en geen foutcodes geretourneerd ([SWS_DM_01531], [SWS_DM_01532], [SWS_DM_01533], [SWS_DM_01536], [SWS_DM_01537]). Foutscenario's vloeien daarom primair voort uit schendingen van precondities of ontoereikende synchronisatie.

Een centrale preconditie bij het aanroepen van SetNotifier is dat het doorgegeven object een aanroepbaar doel (callable) moet bevatten en de uitvoering daarvan geen excepties mag werpen [SWS_DM_01537]. Een leeg of ongeldig functie-object vormt een schending van de preconditie. Met betrekking tot concurrency moet er rekening mee worden gehouden dat SetNotifier, de move-toewijzingsoperator en de destructor zijn gedocumenteerd als niet thread-safe ([SWS_DM_01531], [SWS_DM_01533], [SWS_DM_01537]). Alleen MayRelease() en de move-constructor zijn expliciet thread-safe ([SWS_DM_01532], [SWS_DM_01536]). Als notifier-registraties of toewijzingen zonder externe synchronisatie gelijktijdig worden uitgevoerd, leidt dit tot ongedefinieerd gedrag.