namespace <SI-Namespace>::proxy

De namespace <SI-Namespace>::proxy biedt binnen de module com de clientzijdige interface voor interactie met een Service Interface. De centrale component ervan is de proxyklasse <SI>Proxy, die de middlewarecommunicatie abstraheert en methodeaanroepen evenals gebeurtenisabonnementen mogelijk maakt. Het instantiëren van de proxy vereist vermoedelijk typisch een geldige handle uit de service discovery. Vraag (open) Als wezenlijke randvoorwaarde moet de aanroepende applicatie verbindingsonderbrekingen en asynchrone responstijden bij externe aanroepen robuust afhandelen.

meer ›

Context

De namespace <SI-Namespace>::proxy vormt binnen de communicatiemodule com van het AUTOSAR Adaptive Platform de clientzijdige representatie van een Service Interface. Deze bundelt alle artefacten en types die voor serviceconsumenten vereist zijn voor interactie met een via het communicatienetwerk aangeboden service. Centraal in deze namespace staat de gegenereerde proxyklasse <SI>Proxy. Deze klasse abstraheert de onderliggende berichtgebaseerde interproces- en netwerkconfiguratie en biedt een C++-interface waarmee applicatiesoftware methoden kan aanroepen, gebeurtenissen kan abonneren en velden kan opvragen en observeren.

Architectonisch fungeert de proxy als tussenpersoon tussen de applicatiespecifieke clientlogica en de runtime-omgeving van het Adaptive Platform. In plaats van directe netwerk- of shared-memory-interacties interageert de applicatieontwikkelaar uitsluitend met de instanties uit <SI-Namespace>::proxy. Hierdoor wordt een ontkoppeling gerealiseerd die het mogelijk maakt communicatieprotocollen, datatransmissieformaten en locatiedetails transparant door de onderliggende platform-middleware te laten beheren.

Levenscyclus

De levenscyclus van objecten in de namespace <SI-Namespace>::proxy is nauw gekoppeld aan de beschikbaarheid van de corresponderende service-instantie. Voordat een proxy-instantie kan worden aangemaakt, moet er instantiedetectie plaatsvinden. De instantiëring van de proxy <SI>Proxy vereist vermoedelijk typisch een handle die voortkomt uit de service discovery. Vraag Q-3dcfd734b218f865 (open) Na succesvolle instantiëring representeert het proxy-object een logische verbinding met de betreffende serviceprovider.

Tijdens de actieve operationele fase beheert de proxy-instantie de toestanden met betrekking tot geabonneerde gebeurtenissen en openstaande asynchrone methodeaanroepen. Wat betreft concurrency moet worden opgemerkt dat aanroepen naar de proxy thread-safe moeten zijn ontworpen of door de client dienovereenkomstig moeten worden gesynchroniseerd, indien meerdere threads hetzelfde proxy-object gebruiken. Het vrijgeven of vernietigen van het proxy-object beëindigt vermoedelijk de binding met de gevonden service-instantie en heft lopende abonnementen op. Vraag Q-e9d55205ba1bf55b (open)

Gebruikspad

Een typisch gebruikspad voor het aanwenden van de Service Interface-proxy is onderverdeeld in opeenvolgende fasen:

• Vinden van de service-instantie: De client initieert via de platformmechanismen van de module com een zoekopdracht naar beschikbare instanties van de service en ontvangt overeenkomstige handlestructuren terug.
• Constructie van de proxy: Met behulp van een geldige handle wordt een instantie van <SI>Proxy geïnstantieerd, waardoor het communicatiekanaal naar de server wordt opgebouwd.
• Interactie met service-elementen: Via de instantie worden methoden synchroon of asynchroon aangeroepen, gebeurtenissen geabonneerd en callbacks geregistreerd. Asynchrone communicatiepatronen worden vermoedelijk afgebeeld via getypeerde gebeurtenis- en methodewrappers binnen de proxy-instantie. Vraag Q-2e6b91c7e5f88567 (open)
• Beëindiging en opschoning: Na afronding van de communicatie worden abonnementen op gebeurtenissen opgezegd en wordt de proxy-instantie op correcte wijze vernietigd om bezette resources vrij te geven.

Foutscenario's

Bij interactie met de proxy-namespace kunnen verschillende foutbeelden optreden. Hiertoe behoren verbindingsverbrekingen met de server, time-outs bij externe aanroepen en de onbeschikbaarheid van opgevraagde service-instanties tijdens de initialisatie. Aangezien de communicatie over proces- en computergrenzen heen plaatsvindt, worden infrastructurele fouten of uitval van de tegenpartij weerspiegeld in de retourwaarden. Aanroepen vóór een succesvolle binding of na vernietiging van de instantie leiden tot ongeldige toestanden, waardoor randvoorwaarden met betrekking tot de geldigheid van de handle strikt moeten worden nageleefd.