struct ara::com::FindServiceHandle

De structuur ara::com::FindServiceHandle dient als uniek controletoken voor de besturing van een op de achtergrond actieve servicebewaking (AUTOSAR_AP_EXP_ARAComAPI p. 34). Aangezien de standaardconstructor verwijderd is ([SWS_CM_00353]), wordt de handle uitsluitend door StartFindService aangemaakt en maakt deze na ontvangst van asynchrone status-callbacks het gericht beëindigen van de zoekopdracht via StopFindService mogelijk (AUTOSAR_AP_EXP_ARAComAPI p. 30). Ondersteunde vergelijkingsoperatoren waarborgen bovendien het opslagbare beheer van meerdere zoekopdrachten in standaardcontainers ([SWS_CM_11526], [SWS_CM_11527]).

meer ›

Context

De structuur ara::com::FindServiceHandle fungeert in de module com van het Adaptive Platform als unieke identificator en controletoken voor een asynchrone, continue servicezoekopdracht. Terwijl een synchrone bevraging via FindService eenmalig passende service-instanties vaststelt en direct handle-containers retourneert, initieert StartFindService een permanente bewaking van de servicebeschikbaarheid op de achtergrond (AUTOSAR_AP_EXP_ARAComAPI p. 34). Bij dit proces zijn typisch de applicatie-instantie, de typespecifieke proxyklasse (bijvoorbeeld RadarServiceProxy) evenals een door de gebruiker gedefinieerde callbackfunctie van het type FindServiceHandler betrokken (AUTOSAR_AP_EXP_ARAComAPI p. 30). De concrete interne representatie van ara::com::FindServiceHandle is implementatiespecifiek voor het desbetreffende Communication Management vormgegeven, maar stelt gestandaardiseerde C++-interfaces voor de hantering beschikbaar.

Levenscyclus

De levenscyclus van een ara::com::FindServiceHandle is vast gekoppeld aan het actieve zoekproces in het Communication Management:

• Aanmaak: De standaardconstructor is expliciet verwijderd ([SWS_CM_00353]). Een applicatie kan daardoor handle-instanties niet ongeïnitialiseerd of op eigen initiatief aanmaken. In plaats daarvan wordt een geldige handle uitsluitend gegenereerd als payload van een ara::core::Result door de statische methode StartFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30).
• Beheer en eigenaarschap: Een handle ondersteunt toewijzing via de copy assignment operator [SWS_CM_11528]. Om de applicatie in staat te stellen meerdere zoekopdrachten in standaardcontainers (zoals geordende verzamelingen of associatieve geheugens) op te slaan en te organiseren, voldoet het type aan de C++-concepten [equalitycomparable] en [lessthancomparable] via de operatoren operator== ([SWS_CM_11526]) en operator< ([SWS_CM_11527]).
• Beëindiging en vernietiging: De handle blijft geldig zolang de achtergrondbewaking actief is. De beëindiging van de zoekopdracht vindt plaats door overdracht van de handle aan StopFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34). Na deze aanroep representeert de handle niet langer een lopend zoekproces.

Gebruikspad

Het reguliere verloop omvat de registratie van de zoekopdracht, de continue ontvangst van beschikbaarheidsupdates en het ordentelijk stoppen van het bewakingsproces:

1. Zoekstart: De applicatie registreert een FindServiceHandler via StartFindService om geïnformeerd te worden over nieuw beschikbare of wegvallende service-instanties (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34).
2. Handle-ontvangst: Bij een succesvolle start levert de aanroep een ara::core::Result met de FindServiceHandle op (AUTOSAR_AP_EXP_ARAComAPI p. 30), die de applicatie bewaart voor latere besturingsaanroepen.
3. Asynchrone notificatie: Het Communication Management voert de achtergrondzoekopdracht uit en roept bij statuswijzigingen de beschikbaar gestelde handler aan (AUTOSAR_AP_EXP_ARAComAPI p. 34).
4. Zoekstop: Zodra de instanties zijn gevonden of de bewaking niet meer vereist is, overhandigt de applicatie de handle aan StopFindService (AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34).

Sequentiediagram: Typisch verloop van de asynchrone servicezoekopdracht vanaf de registratie via notificaties tot aan het beëindigen via FindServiceHandle. Bronnen: AUTOSAR_AP_EXP_ARAComAPI p. 30, AUTOSAR_AP_EXP_ARAComAPI p. 34.

Foutscenario's

Bij het gebruik van ara::com::FindServiceHandle moeten de volgende systeemspecifieke randvoorwaarden in acht worden genomen:

• Mislukte zoekstart: Indien technische bindings niet beschikbaar zijn of de service-deploymentconfiguratie foutief is (AUTOSAR_AP_EXP_ARAComAPI p. 34), mislukt StartFindService. De geretourneerde ara::core::Result bevat in dit geval geen geldige handle, maar een foutcode (AUTOSAR_AP_EXP_ARAComAPI p. 30).
• Uitzonderingsveiligheid: De geïmplementeerde vergelijkings- en toewijzingsoperatoren operator== ([SWS_CM_11526]), operator< ([SWS_CM_11527]) en operator= ([SWS_CM_11528]) zijn in de specificatie expliciet als niet uitzonderingsveilig (not exception safe) gedeclareerd.
• Meervoudig stoppen: Een herhaalde aanroep van StopFindService met dezelfde handle blijft vermoedelijk zonder effect of leidt tot een runtimefout, aangezien de onderliggende bewakingsactiviteit al is verwijderd. Vraag Q-f44130c33fa1caea (open)