struct <SI-Namespace>::skeleton::<SI>Skeleton::<Method>Output

De structuur bundelt alle uitvoerargumenten van een service-interfacemethode aan serverzijde voor overdracht aan de aanroeper. Bij het uitvoeren van een skeletonmethode instantieert de service-implementatie deze datastructuur, vult de attributen ervan met de berekende resultaten en draagt deze weer over aan de communicatielaag. De middleware serialiseert vervolgens de opgenomen parameters en verzendt het antwoordpakket naar de aanroepende proxy. Aangezien er geen expliciete specificatie-eisen in de payload zijn opgeslagen, komen de elementtypen vermoedelijk direct overeen met de in de service-interface gemodelleerde datatypen van de uitvoerparameters. Vraag Q-55d242e98cd76967 (open)

meer ›

Context

De C++-structuur <SI-Namespace>::skeleton::<SI>Skeleton::<Method>Output is een gegenereerd onderdeel van het servicedeel in de module com van het AUTOSAR Adaptive Platform (release R25-11). Binnen de service-interface bundelt dit type alle uitvoerargumenten (out-parameters) van een gedefinieerde servicemethode aan providerzijde. De structuur fungeert als tussenlaag tussen de concrete service-implementatie van de serviceprovider en de communicatiemiddleware ara::com. Omdat C++-functiesignaturen doorgaans slechts één enkele retourwaarde ondersteunen, biedt dit type een gestructureerd aggregaat om methoden met meerdere uitvoerparameters typeveilig terug te geven aan de aanroepende runtime-omgeving.

Levenscyclus

Het creëren van een instantie van <Method>Output vindt plaats in de applicatiecontext van de serviceprovider, zodra een servicemethode de vereiste berekeningen heeft voltooid. De service-implementatie instantieert het data-aggregaat lokaal, initialiseert de daarin gedeclareerde membervariabelen met de bepaalde waarden en draagt de instantie vervolgens over aan de communicatielaag. Met de overdracht aan het framework eindigen de directe eigendomsrechten van de applicatiespecifieke methode-implementatie; het object wordt overgedragen naar het verantwoordelijkheidsgebied van de middleware. De levensduur van de instantie is transiënt en eindigt zodra de communicatielaag de opgenomen parameters in de achterliggende protocolpayloads heeft geserialiseerd en de buffer heeft vrijgegeven. Wat betreft gelijktijdigheid is elke methode-aanroep geïsoleerd: elke aanroepcontext opereert op een eigen instantie, zodat er geen synchronisatiemechanismen op klasseniveau vereist zijn zolang de getransporteerde waarden geen onbeschermde gedeelde resources delen.

Gebruikspad

Het typische verloop bij het gebruik van <Method>Output voltrekt zich in een vaste interactievolgorde tussen de runtime-omgeving, de skeletonmethode-implementatie en de uitvoerstructuur. Na binnenkomst van een methodeverzoek stuurt de middleware de aanroep door naar de geïmplementeerde skeletonklasse. De applicatielogica voert de verwerking uit, creëert de structuur <Method>Output en vult alle uitvoerparameters in. Vervolgens wordt de instantie verzonden naar het runtimesysteem, dat de serialisatie uitvoert en het antwoordbericht via het netwerk naar de verzoekende proxy stuurt.

Sequentiediagram: aanroep- en retourpad bij gebruik van de outputstructuur in het skeleton. Bronnen: geen bewijsvoering in payload gespecificeerd.

Foutscenario's

Als puur data-aggregaat beschikt <Method>Output niet over eigen foutafhandelingsroutines of statusmethoden. Fouttoestanden ontstaan primair aan de interfaces door onvolledige initialisatie of schendingen van voorwaarden. Als de applicatiezijdige implementatie nalaat om individuele membervariabelen voorafgaand aan de teruggave correct toe te wijzen, kunnen niet-geïnitialiseerde waarden of null-toestanden worden geserialiseerd. Mislukt de functionele berekening van de servicemethode al vooraf, dan wordt in de reguliere controlestroom geen geldige <Method>Output-instantie overgedragen; in plaats daarvan meldt de implementatie de opgetreden fout via de daarvoor bestemde foutkanalen van de service-interface. Treden er bij dynamische datastructuren binnen de uitvoerargumenten geheugenallocatiefouten op, dan moeten deze binnen de aangeroepen methode worden afgevangen voordat overdracht aan de middleware plaatsvindt.