klasse {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton

De klasse dient als serverzijde-basisklasse voor de implementatie van een service-interface in ara::com, waarvan de serviceprovider-applicatie afleidt. Bij het aanmaken wordt via de constructor bepaald of binnenkomende methode-aanroepen gebeurtenisgestuurd of via polling worden verwerkt [SWS_CM_00130]. Foutieve processen worden bij methoden die als uitzonderingsveilig zijn gedeclareerd via de geretourneerde ara::core::Future als foutcode gesignaleerd [SWS_CM_00191].

meer ›

Context

De klasse {<hierarchical-namespace-list-lower-skeleton>}::skeleton::{ <service-interface-name>}Skeleton dient in het Adaptive Platform binnen de module com als gegenereerde, abstracte basisklasse voor de beschikbaarstelling aan serverzijde van een service-interface. Een applicatiespecifieke serviceprovider-component leidt af van deze skeleton-klasse om de functionele bedrijfslogica van de service te implementeren. De klasse bemiddelt tussen de concrete serviceprovider-applicatie en de communicatiemiddleware resp. de onderliggende protocolbinding zoals SOME/IP (SWS CommunicationManagement §8.1 “Method invocation”). Tot de interactiepartners behoren de serviceprovider-applicatie, die de instantie aanmaakt en beheert, de skeleton-klasse zelf en de communicatie-infrastructuur, die binnenkomende serviceverzoeken ontvangt, deserialiseert en doorstuurt naar het skeleton ([SWS_CM_10306], [SWS_CM_10307]).

Contextdiagram: interactie tussen serviceprovider-applicatie, ServiceSkeleton en communicatiemiddleware. Bronnen: [SWS_CM_10306], [SWS_CM_10307], SWS CommunicationManagement §8.1 “Method invocation”.

Levenscyclus

De aanmaak van de skeleton-instantie vindt plaats via de constructor, waaraan de gewenste verwerkingsmodus ara::com::MethodCallProcessingMode wordt meegegeven [SWS_CM_00130]. Deze modus legt de concurrency-strategie voor binnenkomende methode-aanroepen vast: wanneer kEvent of kEventSingleThread is geconfigureerd, worden binnenkomende methode-aanroepen direct gebeurtenisgestuurd aangeroepen door de communicatiemiddleware [SWS_CM_10306]. Wordt in plaats daarvan kPoll meegegeven, dan vindt de afhandeling polling-gebaseerd plaats door de applicatie [SWS_CM_10307]. Interpretatie: de skeleton-instantie blijft vermoedelijk gedurende de gehele actieve servicelevering in het bezit van de serviceprovider-applicatie en wordt pas bij het afsluiten van de service vernietigd. Vraag Q-ce25321f79393024 (open)

Gebruikspad

Het typische verloop omvat de implementatie van de zuiver virtuele methoden door de afgeleide providerklasse en de latere uitvoering bij binnenkomende verzoeken. Voor reguliere methode-aanroepen (request-response) definieert het skeleton een interface die een ara::core::Future met het bijbehorende uitvoerobject retourneert [SWS_CM_00191], [SWS_CM_99556]. Voor fire-and-forget-methoden zonder respons biedt het skeleton zuiver virtuele bewerkingen met het retourtype void [SWS_CM_90434]. Bij binnenkomende verzoeken deserialiseert de communicatiemiddleware de payload en stuurt de aanroep conform de geconfigureerde verwerkingsmodus door naar de concrete implementatie van de skeleton-klasse ([SWS_CM_10306], [SWS_CM_00191]).

Sequentiediagram: verloop van een methode-aanroep via het skeleton. Bronnen: [SWS_CM_00191], [SWS_CM_10306], SWS CommunicationManagement §8.1 “Method invocation”.

Foutscenario's

Zowel request-response-methoden als fire-and-forget-methoden zijn op serviceniveau geannoteerd met noexcept en gedeclareerd als uitzonderingsveilig ([SWS_CM_00191], [SWS_CM_90434]). Fouten bij de verwerking van reguliere methode-aanroepen worden niet via C++-uitzonderingen doorgegeven; in plaats daarvan transporteert het geretourneerde ara::core::Future in geval van een fout een bijbehorende foutcode van het type ara::com::ComErrc of een ApApplicationError [SWS_CM_00191]. Voor fire-and-forget-methoden zijn conform de specificatie noch retourwaarden noch gestandaardiseerde foutcodes voorzien [SWS_CM_90434].