klasse <SI-Namespace>::skeleton::triggers::<Trigger>

De methode Send verzendt een trigger zonder payload naar alle abonnerende applicaties ([SWS_CM_00721]). Deze behoort tot de skeleton-klasse <SI-Namespace>::skeleton::triggers::<Trigger> en wordt via het headerbestand #include "<SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h" beschikbaar gesteld ([SWS_CM_00721]).

De functie is als noexcept gedefinieerd, geldt als uitzonderingsveilig en verwacht geen overdrachtsparameters ([SWS_CM_00721]). Als retourtype dient ara::core::Result<void> ([SWS_CM_00721]):

• Succesgeval: Het resultaat bevat een lege waarde (void) en signaleert de succesvolle activering van de overdracht ([SWS_CM_00721]).
• Foutgeval: Het resultaat omhult een foutcode uit het domein ara::com::ComErrc ([SWS_CM_10432]). Mogelijke fouten met rollback-semantiek zijn:
  • ComErrc::kServiceNotOffered: De service werd vooraf nog niet middels OfferService() aangeboden ([SWS_CM_00721]).
  • ComErrc::kMinimumSendIntervalViolationError: Een overdrachtsverzoek vond plaats vóór afloop van het geconfigureerde minimale zendinterval ServiceInterfaceDeploymentElement.minimumSendInterval ([SWS_CM_00721]).

Met betrekking tot gelijktijdigheid en re-entrantie zwijgen de bronnen; vermoedelijk moeten gelijktijdige aanroepen op dezelfde instantie aan de applicatiezijde worden gesynchroniseerd. Vraag Q-ff3beeb7bad5dd32 (open) In tegenstelling tot de op gebeurtenissen gebaseerde gegevensoverdracht via Event::Send ([SWS_CM_00162], [SWS_CM_90437], AUTOSAR_AP_EXP_ARAComAPI p. 10) of veldupdates via Update ([SWS_CM_00119]) draagt Trigger::Send volgens [SWS_CM_00721] (AUTOSAR_AP_EXP_ARAComAPI p. 10) generlei payload over, maar dient als pure triggerpuls.

De functie SetSubscriptionStateChangeHandler dient aan de skeleton-zijde om een callback-functie voor het bewaken van subscriptiewijzigingen op een trigger te registreren [SWS_CM_01110]. De methode behoort tot de namespace <SI-Namespace>::skeleton::triggers::<Trigger> en wordt via het headerbestand <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h beschikbaar gesteld [SWS_CM_01110].

Als parameter wordt een aanroepbaar functie-object van het type SubscriptionStateChangeHandler overgedragen [SWS_CM_00311] [SWS_CM_01110]. De aanroep is gedeclareerd als noexcept, levert geen retourwaarde op en is gespecificeerd als exceptieveilig (exception safe) [SWS_CM_01110]. Wanneer het overgedragen handler-callable niet bestaat of null is, meldt het systeem een InvalidHandlerViolation [SWS_CM_01110].

Communication Management roept de geregistreerde callback-functie aan zodra de subscriptiestatus van de trigger verandert [SWS_CM_01101]:

• met de statuswaarde kSubscribed, zodra het aantal actieve subscripties voor deze trigger groter dan 0 wordt [SWS_CM_01102],
• met de statuswaarde kNotSubscribed aan de skeleton-zijde, wanneer er geen actieve abonnementen meer zijn [SWS_CM_01103].

De geregistreerde handler mag tijdens runtime worden overschreven [SWS_CM_01101]. Indien de uitvoering van de handler in een gedefinieerde uitvoeringscontext moet plaatsvinden, is als alternatief de overloaded template-variant met een ExecutorT&&-parameter beschikbaar [SWS_CM_01111].

De template-functie SetSubscriptionStateChangeHandler registreert op skeleton-niveau voor triggers ([SWS_CM_01111]) een callback-handler voor wijzigingen van de abonnementsstatus (ara::com::SubscriptionState). Naast de aanroepbare parameter handler accepteert de methode een uitvoeringscontext executor van het type ExecutorT ([SWS_CM_01111]). De functie heeft geen retourwaarde en is gedefinieerd in de scope <SI-Namespace>::skeleton::triggers::<Trigger> ([SWS_CM_01111]).

In tegenstelling tot de basisfunctie zonder executor ([SWS_CM_01110]) waarborgt deze signatuur dat de callback in een door de gebruiker gedefinieerde context wordt uitgevoerd ([SWS_CM_01111]). Zoals bij de op events gebaseerde variant conform [SWS_CM_12008] wordt de uitvoering vermoedelijk gedelegeerd aan het doorgegeven executor-object om de threading binnen de skeleton-applicatie doelgericht te sturen. Vraag Q-ba14993b00a7d972 (open)

De interface is gespecificeerd als noexcept en uitzonderingsveilig ([SWS_CM_01111]). Mocht de doorgegeven callable ongeldig of null zijn, dan is er volgens de specificatie sprake van een InvalidHandlerViolation ([SWS_CM_01111]).

Functioneel komt de methode overeen met de analoge executor-overloads voor skeleton-events ([SWS_CM_12009]) alsook de clientzijdige tegenhangers van de proxy-interface ([SWS_CM_01106], [SWS_CM_11354]).

De functie UnsetSubscriptionStateChangeHandler dient aan skeleton-zijde ertoe een eerder geregistreerde callback voor wijzigingen van de abonnementsstatus (SubscriptionState) op een service-trigger te verwijderen ([SWS_CM_01112]). Deze is gedefinieerd in de namespace <SI-Namespace>::skeleton::triggers::<Trigger> via de header <SiNamespaceDerivedDirectoryPath>/<SiShortname>_skeleton.h ([SWS_CM_01112]).

Gebruik en semantiek: De interface heeft de signatuur void UnsetSubscriptionStateChangeHandler() noexcept, verwacht geen overdrachtsparameters en heeft geen retourwaarde ([SWS_CM_01112]). Volgens de specificatie is deze geclassificeerd als uitzonderingsveilig (exception safe) ([SWS_CM_01112]). Foutcodes of specifieke rapportagemechanismen (DET/DEM) zijn voor deze aanroep niet voorzien.

Interactie en levenscyclus: De via [SWS_CM_01112] verwijderde callback wordt aangeroepen door Communication Management zodra de abonnementsstatus van de desbetreffende trigger verandert ([SWS_CM_01101], AUTOSAR_AP_SWS_CommunicationManagement §7.5.15 “Query Service Trigger Subscription State on Skeleton side”). Dit gebeurt bijvoorbeeld met de status kSubscribed wanneer het aantal actieve abonnementen groter dan nul wordt ([SWS_CM_01102]), of met kNotSubscribed ([SWS_CM_01103]). De handler mag tijdens runtime worden overschreven ([SWS_CM_01101]); het aanroepen van UnsetSubscriptionStateChangeHandler maakt de registratie weer ongedaan.

Gelijktijdigheid en gerelateerde interfaces: Met betrekking tot gelijktijdigheid vindt de deregistratie vermoedelijk synchroon plaats, zodat na terugkeer van de functieaanroep geen verdere statusmeldingen meer aan de eerder geregistreerde handler worden afgeleverd. Vraag Q-e005c4818e02e52f (open) Analoge deregistratiefuncties zijn gespecificeerd aan skeleton-zijde voor events ([SWS_CM_12010]) en aan proxy-zijde voor events ([SWS_CM_00334]), triggers ([SWS_CM_01108]) en fields ([SWS_CM_11609], AUTOSAR_AP_EXP_ARAComAPI §5.3.1 “Proxy Class API’s”).