namespace <SI-Namespace>::proxy::methods

De namespace <SI-Namespace>::proxy::methods stelt de klassen aan proxyzijde beschikbaar voor methode-aanroepen van een ServiceInterface in de module com van het AUTOSAR Adaptive Platform. Voor elke ClientServerOperation wordt afhankelijk van het metamodelattribuut ClientServerOperation.fireAndForget hetzij de klasse <Method> voor reguliere aanroepen, hetzij <FnFMethod> voor unidirectionele aanroepen geïnstantieerd. Terwijl reguliere methoden serverzijdige retourwaarden en foutmeldingen ondersteunen, verwerken fire-and-forget-methoden inherent geen antwoordberichten. De levensduur van de methode-objecten is daarbij vermoedelijk direct gebonden aan het bestaan van de bovenliggende proxy-instantie. Vraag (open)

meer ›

Context

De namespace <SI-Namespace>::proxy::methods representeert binnen de module com van het AUTOSAR Adaptive Platform de methodespecifieke interfaceklassen voor service-proxies. Elk in een ServiceInterface gemodelleerd ClientServerOperation wordt afhankelijk van zijn configuratie-eigenschappen afgebeeld op een overeenkomstige methodenklasse. De namespace bevat daarbij in wezen twee klassenpatronen: <Method> voor operaties met antwoordgedrag en <FnFMethod> voor zogeheten fire-and-forget-operaties.

De primaire verantwoordelijkheid van deze klassen bestaat uit het ontvangen van methode-aanroepen van een clientapplicatie, het voorbereiden van de overdrachtsparameters voor het transport en het afhandelen van de communicatie met de onderliggende middlewarelaag. Interactiepartners zijn aan de aanroeperszijde de applicatiespecifieke clientcomponenten en aan de bemiddelingszijde de bovenliggende proxyklasse van de namespace <SI-Namespace>::proxy, die de methode-instanties aggregeert.

Het onderscheid tussen beide klassen richt zich naar het metamodelattribuut ClientServerOperation.fireAndForget:

• <Method> wordt gegenereerd voor operaties waarbij ClientServerOperation.fireAndForget == FALSE is geconfigureerd. Vermoedelijk kapselt een instantie van deze klasse de asynchrone aanroep van een service in en stelt zij het resultaat of eventuele applicatiefouten beschikbaar via een toekomstgericht resultaattype. Vraag Q-75c8a4495ee9c1cb (open)
• <FnFMethod> wordt gegenereerd wanneer ClientServerOperation.fireAndForget == TRUE is geconfigureerd. Een methode van deze klasse is vermoedelijk geïmplementeerd als een unidirectionele aanroep die geen antwoord van de server verwacht en aan de aanroeper geen retourwaarde levert. Vraag Q-1f9698a27137b73d (open)

Levenscyclus

Het creëren en vernietigen van de in deze namespace gedefinieerde methodenklassen is nauw gekoppeld aan de bovenliggende proxy. De levensduur van de methode-objecten is vermoedelijk gebonden aan de levensduur van de omsluitende proxy-instantie in de namespace <SI-Namespace>::proxy. Vraag Q-ec1ef4d1ebc90d5a (open) Bij de instantiëring van het proxy-object worden de bijbehorende instanties van <Method> en <FnFMethod> als members geïnitialiseerd en staan zij direct ter beschikking aan de applicatie voor aanroepen.

Wat de interne toestand betreft, zijn de methode-objecten na hun initialisatie permanent gereed voor aanroepen zolang de proxy-instantie geldig blijft. Toestandsovergangen van afzonderlijke aanroepen hebben geen betrekking op de methode-instantie zelf, maar op de individuele aanroepcontexten. Bij gelijktijdige toegangen vanuit meerdere threads van de clientapplicatie moet gewaarborgd zijn dat parallelle aanroepen van dezelfde methode-instantie thread-safe kunnen worden geïnitieerd. De vernietiging vindt impliciet plaats bij het verlaten van het geldigheidsbereik of bij de expliciete vernietiging van de proxy-instantie, waarbij open communicatieresources worden opgeschoond.

Gebruikspad

De typische stroom bij het gebruik van de methodenklassen door een clientapplicatie volgt een vaste volgorde:

1. Proxy-beschikbaarstelling: de applicatie creëert of verkrijgt een geïnitialiseerde instantie van de service-proxy uit de namespace <SI-Namespace>::proxy.
2. Methodetoegang: de aanroep van de gewenste operatie vindt plaats via de methode-members van de proxy-instantie, die de klassen <Method> of <FnFMethod> instantiëren.
3. Uitvoering van een reguliere operatie: bij het aanroepen van een instantie van <Method> geeft de client de vereiste invoerparameters door. De aanroep brengt de overdracht naar het doelsysteem op gang. Het retourobject stelt de applicatie in staat om op de aankomst van het resultaat te wachten of asynchroon verder te werken.
4. Uitvoering van een fire-and-forget-operatie: bij het aanroepen van een instantie van <FnFMethod> worden de parameters overgedragen en direct ter doorzending aan de overdrachtslaag aangeboden. De methode keert direct na de overdracht terug naar de aanroeper.
5. Resultaatverwerking: bij reguliere methode-aanroepen evalueert de client het beschikbaar gestelde resultaat en controleert deze of de operatie succesvol is voltooid.

Foutscenario's

De foutafhandeling verschilt fundamenteel tussen beide methodevormen: bij reguliere operaties via <Method> kunnen zowel fouten van de overdrachtslaag als specifieke applicatiefouten optreden die in de interfacedefinitie zijn vastgelegd. Omdat ClientServerOperation.fireAndForget == FALSE is geconfigureerd, worden antwoordberichten inclusief mogelijke foutmeldingen door de server teruggemeld aan de proxy. De clientapplicatie kan deze fouten via het retourobject van de aanroep evalueren en passende afhandelingsroutines starten.

Daarentegen sluit het ontwerp van <FnFMethod> door ClientServerOperation.fireAndForget == TRUE een serverzijdige foutterugmelding aan de aanroeper inherent uit. Fouten die op de server optreden tijdens de verwerking van de operatie, kunnen niet aan de proxy worden doorgegeven. Pre- en postcondities beperken zich tot de lokale aanroeperszijde: precondities vereisen geldige parameterwaarden en een operationele communicatie-infrastructuur. Treedt bij het verzenden een lokale fout op, dan kan deze direct bij de methode-aanroep worden gesignaleerd, terwijl serverzijdige uitvoeringsfouten onopgemerkt blijven voor de aanroeper.