class ara::exec::ExecutionClient

Die Klasse ara::exec::ExecutionClient dient Applikationsprozessen dazu, ihren internen Ausführungszustand verbindlich an das Execution Management zu melden ([SWS_EM_02003]). Bei der Initialisierung übernimmt sie zudem das Abfangen des SIGTERM-Signals und leitet dieses an einen benutzerdefinierten Beendigungshandler in einem Hintergrund-Thread weiter ([SWS_EM_02562]). Als Move-only-Objekt bindet die Instanz die Signalbehandlung strikt an ihren Lebenszyklus und stellt bei der Zerstörung den vorherigen Signalzustand wieder her. Aufrufer müssen sicherstellen, dass der registrierte Callback während der gesamten Instanzlebensdauer aufrufbar bleibt.

mehr ›

Kontext

Die Klasse ara::exec::ExecutionClient dient Prozessen auf der Adaptive Platform dazu, ihren internen Ausführungszustand an das Execution Management zu melden ([SWS_EM_02003]). Sie fungiert als standardisierte Schnittstelle zwischen der laufenden Applikation und dem zentralen Prozessmanagement. Neben der Weiterleitung von Zustandsübergängen übernimmt die Instanz die Verantwortung für die Behandlung des Betriebssystemsignals SIGTERM ([SWS_EM_02562], [SWS_EM_02002]). Bei Eintreffen des Signals führt sie einen benutzerdefinierten Callback in einem separaten Hintergrund-Thread aus, um der Anwendung eine geordnete Beendigung zu ermöglichen ([SWS_EM_02562]). Interpretation: Das Betriebssystem oder das Execution Management dürfte das Signal SIGTERM an den Prozess übermitteln, wenn eine Beendigung der Ausführungseinheit angefordert wird. Frage Q-51eee947d01ae8b4 (offen)

Kontextdiagramm: Interaktion zwischen Applikationsprozess, ExecutionClient, Execution Management und Signalmechanismus. Quellen: [SWS_EM_02003], [SWS_EM_02562], [SWS_EM_02002].

Lebenszyklus

Die Instanziierung von ara::exec::ExecutionClient erfolgt wahlweise über die statische Fabrikmethode Create ([SWS_EM_02562]) oder den regulären Konstruktor ([SWS_EM_02560]). Während Create ausnahmesicher (noexcept) ist und das Ergebnis gekapselt in einem ara::core::Result zurückliefert ([SWS_EM_02562]), ist der reguläre Konstruktor als noexcept(false) deklariert ([SWS_EM_02560]). Beide Erzeugungspfade erwarten als Parameter einen aufrufbaren std::function<void()>-Callback (terminationHandler). Dieser Callback muss während der gesamten Lebensdauer der ExecutionClient-Instanz gültig und aufrufbar bleiben ([SWS_EM_02562], [SWS_EM_02560]).

Hinsichtlich der Besitzverhältnisse ist die Klasse als Move-only konzipiert: Der Kopierkonstruktor ([SWS_EM_02563]) sowie der Kopierzuweisungsoperator ([SWS_EM_02564]) sind explizit gelöscht (delete). Eine Übertragung von Instanzen ist ausschließlich über den Move-Konstruktor ([SWS_EM_02580]) und den Move-Zuweisungsoperator ([SWS_EM_02581]) möglich, welche beide ausnahmesicher (noexcept), jedoch nicht threadsicher sind. Die Fabrikmethode Create und der Konstruktor selbst gelten als threadsicher ([SWS_EM_02562], [SWS_EM_02560]).

Der Destruktor ~ExecutionClient() ist als noexcept definiert ([SWS_EM_02002]) und nicht threadsicher. Beim Zerstören der Instanz wird die Verantwortung für das Signal SIGTERM wieder abgegeben: Der Destruktor setzt den Signal-Handler für SIGTERM auf den ursprünglichen Zustand zurück, der vor der Instanziierung aktiv war ([SWS_EM_02002]).

Nutzungspfad

Der reguläre Ablauf gliedert sich in Initialisierung, Zustandsübermittlung und geordnete Terminierung:

• Erzeugung: Zu Beginn der Prozesslaufzeit wird die Instanz über Create initialisiert, wobei der Beendigungshandler übergeben wird ([SWS_EM_02562]). Typischerweise setzt dieser Handler ein Flag oder signalisiert Synchronisationsprimitive, um laufende Threads zu deblockieren.
• Zustandsmeldung: Sobald der Prozess bereit ist, meldet er seinen Ausführungsstatus über ReportExecutionState an das Execution Management ([SWS_EM_02003]). Der Aufruf ist threadsicher und kann aus verschiedenen Arbeits-Threads erfolgen.
• Signalempfang und Beendigung: Trifft während der Laufzeit ein SIGTERM-Signal ein, aktiviert ExecutionClient den hinterlegten terminationHandler asynchron in einem Hintergrund-Thread ([SWS_EM_02562]). Der Prozess schließt offene Aufgaben geordnet ab.
• Zerstörung: Beim Verlassen des Gültigkeitsbereichs stellt der Destruktor die ursprüngliche Signalkonfiguration wieder her ([SWS_EM_02002]).

Sequenzdiagramm: Ablauf von Erzeugung über Zustandsmeldung bis zur signalgesteuerten Terminierung. Quellen: [SWS_EM_02562], [SWS_EM_02003], [SWS_EM_02002].

Fehlerszenarien

Bei der Verwendung von ExecutionClient sind unterschiedliche Fehlersituationen durch Fehlercodes aus ara::exec::ExecErrc abgedeckt:

• ara::exec::ExecErrc::kInvalidArgument: Tritt bei der Instanziierung über Create ([SWS_EM_02562]) oder den regulären Konstruktor ([SWS_EM_02560]) auf, falls das übergebene terminationHandler-Objekt keine aufrufbare Funktion enthält. Das System wendet Rollback-Semantik an; zur Behebung muss ein gültiges Callable übergeben werden.
• ara::exec::ExecErrc::kNoCommunication: Kann sowohl bei der Erzeugung ([SWS_EM_02562], [SWS_EM_02560]) als auch bei ReportExecutionState ([SWS_EM_02003]) auftreten, wenn ein Kommunikationsfehler zwischen dem Applikationsprozess und dem Execution Management vorliegt (z. B. keine Bestätigung des Meldungsempfangs). Hierbei gilt keine Rollback-Semantik; als Wiederherstellungsmassnahme ist ein erneuter Aufrufversuch vorgesehen.
• ara::exec::ExecErrc::kInvalidTransition: Wird von ReportExecutionState ([SWS_EM_02003]) zurückgegeben, falls ein unzulässiger Zustandswechsel angefordert wird, beispielsweise ein erneutes Melden eines bereits aktiven Zustands wie kRunning. Da der Zustand bereits gemeldet wurde, ist keine erneute Übermittlung erforderlich (Rollback-Semantik).