struct ara::com::FindServiceHandle

Die Struktur ara::com::FindServiceHandle dient als eindeutiges Kontroll-Token zur Steuerung einer im Hintergrund laufenden Service-Überwachung (AUTOSAR_AP_EXP_ARAComAPI S. 34). Da der Standardkonstruktor gelöscht ist ([SWS_CM_00353]), wird das Handle ausschließlich von StartFindService erzeugt und ermöglicht nach Empfang asynchroner Status-Callbacks das gezielte Beenden der Suche über StopFindService (AUTOSAR_AP_EXP_ARAComAPI S. 30). Unterstützte Vergleichsoperatoren gewährleisten zudem die speicherbare Verwaltung mehrerer Suchaufträge in Standardcontainern ([SWS_CM_11526], [SWS_CM_11527]).

mehr ›

Kontext

Die Struktur ara::com::FindServiceHandle fungiert im Modul com der Adaptive Platform als eindeutiger Bezeichner und Kontroll-Token für eine asynchrone, kontinuierliche Dienstsuche. Während eine synchrone Abfrage über FindService einmalig passende Service-Instanzen ermittelt und direkt Handle-Container zurückliefert, initiiert StartFindService eine dauerhafte Überwachung der Dienstverfügbarkeit im Hintergrund (AUTOSAR_AP_EXP_ARAComAPI S. 34). An diesem Prozess sind typischerweise die Anwendungsinstanz, die typspezifische Proxy-Klasse (beispielsweise RadarServiceProxy) sowie eine anwenderdefinierte Callback-Funktion vom Typ FindServiceHandler beteiligt (AUTOSAR_AP_EXP_ARAComAPI S. 30). Die konkrete interne Repräsentation von ara::com::FindServiceHandle ist implementierungsspezifisch für das jeweilige Communication Management ausgestaltet, stellt jedoch standardisierte C++-Schnittstellen für die Handhabung bereit.

Lebenszyklus

Der Lebenszyklus eines ara::com::FindServiceHandle ist fest an den aktiven Suchvorgang im Communication Management gekoppelt:

• Erzeugung: Der Standardkonstruktor ist explizit gelöscht ([SWS_CM_00353]). Eine Applikation kann Handle-Instanzen somit nicht uninitialisiert oder eigenmächtig erzeugen. Stattdessen wird ein gültiges Handle ausschließlich als Nutzlast eines ara::core::Result durch die statische Methode StartFindService generiert (AUTOSAR_AP_EXP_ARAComAPI S. 30).
• Verwaltung und Besitz: Ein Handle unterstützt die Zuweisung über den Kopierzuweisungsoperator [SWS_CM_11528]. Um der Anwendung das Speichern und Organisieren mehrerer Suchaufträge in Standardcontainern (wie geordneten Mengen oder Assoziativspeichern) zu ermöglichen, erfüllt der Typ die C++-Konzepte [equalitycomparable] und [lessthancomparable] über die Operatoren operator== ([SWS_CM_11526]) und operator< ([SWS_CM_11527]).
• Beendigung und Zerstörung: Das Handle behält seine Gültigkeit, solange die Hintergrundüberwachung aktiv ist. Die Beendigung der Suche erfolgt durch Übergabe des Handles an StopFindService (AUTOSAR_AP_EXP_ARAComAPI S. 30, AUTOSAR_AP_EXP_ARAComAPI S. 34). Nach diesem Aufruf repräsentiert das Handle keinen laufenden Suchprozess mehr.

Nutzungspfad

Der reguläre Ablauf umfasst die Registrierung des Suchauftrags, den fortlaufenden Empfang von Verfügbarkeitsaktualisierungen und das geordnete Stoppen des Überwachungsprozesses:

1. Suchstart: Die Anwendung registriert einen FindServiceHandler über StartFindService, um über neu verfügbare oder wegfallende Service-Instanzen informiert zu werden (AUTOSAR_AP_EXP_ARAComAPI S. 30, AUTOSAR_AP_EXP_ARAComAPI S. 34).
2. Handle-Erhalt: Bei erfolgreichem Start liefert der Aufruf ein ara::core::Result mit dem FindServiceHandle zurück (AUTOSAR_AP_EXP_ARAComAPI S. 30), das die Anwendung für spätere Steuerungsaufrufe aufbewahrt.
3. Asynchrone Benachrichtigung: Das Communication Management führt die Hintergrundsuche aus und ruft bei Statusänderungen den bereitgestellten Handler auf (AUTOSAR_AP_EXP_ARAComAPI S. 34).
4. Suchstopp: Sobald die Instanzen gefunden wurden oder die Überwachung nicht mehr erforderlich ist, übergibt die Anwendung das Handle an StopFindService (AUTOSAR_AP_EXP_ARAComAPI S. 30, AUTOSAR_AP_EXP_ARAComAPI S. 34).

Sequenzdiagramm: Typischer Ablauf der asynchronen Dienstsuche von der Registrierung über Benachrichtigungen bis zum Beenden via FindServiceHandle. Quellen: AUTOSAR_AP_EXP_ARAComAPI S. 30, AUTOSAR_AP_EXP_ARAComAPI S. 34.

Fehlerszenarien

Beim Einsatz von ara::com::FindServiceHandle sind folgende systemspezifische Randbedingungen zu beachten:

• Fehlgeschlagener Suchstart: Falls technische Bindungen nicht verfügbar sind oder die Service-Deployment-Konfiguration fehlerhaft ist (AUTOSAR_AP_EXP_ARAComAPI S. 34), schlägt StartFindService fehl. Das zurückgegebene ara::core::Result enthält in diesem Fall kein gültiges Handle, sondern einen Fehlercode (AUTOSAR_AP_EXP_ARAComAPI S. 30).
• Ausnahmesicherheit: Die implementierten Vergleichs- und Zuweisungsoperatoren operator== ([SWS_CM_11526]), operator< ([SWS_CM_11527]) und operator= ([SWS_CM_11528]) sind in der Spezifikation explizit als nicht ausnahmesicher (not exception safe) deklariert.
• Mehrfaches Stoppen: Ein wiederholter Aufruf von StopFindService mit demselben Handle dürfte vermutlich wirkungslos bleiben oder zu einem Laufzeitfehler führen, da die zugrundeliegende Überwachungsaktivität bereits entfernt wurde. Frage Q-f44130c33fa1caea (offen)