namespace ara::com::runtime

De namespace ara::com::runtime stelt centrale runtimediensten beschikbaar voor het oplossen van communicatie-eindpunten in communicatiemanagement AUTOSAR_AP_SWS_CommunicationManagement p. 39. Seine Kernfunktion ResolveInstanceIDs vertaalt abstracte model-identifiers van het type ara::core::InstanceSpecifier in concrete, voor proxies en skeletons bruikbare ara::com::InstanceIdentifierContainer [SWS_CM_00118]. Als de toewijzing van een formeel geldige identifier in het deployment mislukt, levert de uitzonderingsveilige functie de foutcode ComErrc::kInstanceIDNotResolvable binnen een ara::core::Result op. Oproepers moeten daarom het Result-object vóór de service-instantiëring evalueren.

meer ›

Context

De namespace ara::com::runtime stelt centrale runtimefunctionaliteiten voor het communicatiemanagement (ara::com) van het AUTOSAR Adaptive Platform beschikbaar AUTOSAR_AP_SWS_CommunicationManagement p. 39. Zijn primaire functionele verantwoordelijkheid bestaat uit het ontkoppelen van de abstracte softwarearchitectuur van de concrete communicatie-infrastructuur tijdens runtime. Terwijl applicaties en softwarecomponenten in hun interfaces via abstracte model-identifiers (ara::core::InstanceSpecifier) aan poorten zijn gebonden, heeft de communicatie-middleware voor het opbouwen van verbindingen concrete adresserings- en instantiëringsgegevens nodig in de vorm van ara::com::InstanceIdentifier-objecten [SWS_CM_00118].

De in header ara/com/runtime.h gedeclareerde functie ResolveInstanceIDs vormt de brug tussen deze twee abstractieniveaus [SWS_CM_00118]. Ze neemt een ara::core::InstanceSpecifier in ontvangst en transformeert deze in een ara::com::InstanceIdentifierContainer AUTOSAR_AP_SWS_CommunicationManagement p. 40. Interpretatie: De concrete toewijzing zal vermoedelijk intern gebaseerd zijn op de in de uitvoeringscontext opgeslagen manifest- en deploymentconfiguraties, waardoor applicatiecode draagbaar en vrij van vast bekabelde netwerk- of protocoladressen blijft. Vraag Q-8fab6de1c39a065a (open)

Contextdiagram: Plaatsing van ara::com::runtime tussen applicatiearchitectuur en communicatie-deployment. Bronnen: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 39.

Gebruikspad

Het typische gebruik van de namespace ara::com::runtime vindt plaats tijdens de initialisatie- en opstartfase van een adaptieve applicatie, voordat communicatierelaties via service-proxies of service-skeletons tot stand worden gebracht AUTOSAR_AP_SWS_CommunicationManagement p. 41. Een service consumer of provider doorloopt daarbij een deterministisch oplossingspad:

• Specificator bepalen: De applicatie instantieert of refereert aan de voor de desbetreffende communicatiepoort gedefinieerde identifier van het type ara::core::InstanceSpecifier.
• Instanties oplossen: De identifier wordt overgedragen aan de functie ara::com::runtime::ResolveInstanceIDs [SWS_CM_00118].
• Resultaat controleren: De aanroep levert een object van het type ara::core::Result<ara::com::InstanceIdentifierContainer> op, dat op succesvolle uitvoering of fouttoestanden wordt gecontroleerd [SWS_CM_00118].
• Container verwerken: Bij succes bevat de ara::com::InstanceIdentifierContainer een aantal instantie-identifiers dat proportioneel is aan het aantal gevonden treffers in het deployment [SWS_CM_00118]. De applicatie kan gericht een instantie selecteren of over alle beschikbare instanties itereren.
• Proxy of skeleton instantiëren: De opgeloste ara::com::InstanceIdentifier-objecten worden vervolgens gebruikt voor het genereren van concrete proxy- of skeleton-instanties AUTOSAR_AP_SWS_CommunicationManagement p. 42.

Sequentiediagram: Aanroep- en verwerkingsverloop van de instantie-oplossing via ResolveInstanceIDs. Bronnen: [SWS_CM_00118], AUTOSAR_AP_SWS_CommunicationManagement p. 41.

Foutscenario's

De interfaces in de namespace ara::com::runtime volgen het platformbrede paradigma van robuuste, uitzonderingsvrije foutafhandeling. Conform de specificatie is ResolveInstanceIDs als noexcept gedeclareerd en heeft het veiligheidsniveau voor uitzonderingen exception safe [SWS_CM_00118]. Fouten worden daarom nooit via C++-exceptions gesignaleerd, maar volledig via de foutmonade ara::core::Result getransporteerd AUTOSAR_AP_SWS_CommunicationManagement p. 47.

Het centrale gespecificeerde foutscenario betreft de foutcode ComErrc::kInstanceIDNotResolvable [SWS_CM_00118]. Deze fout treedt op wanneer de overgedragen ara::core::InstanceSpecifier formeel geldig is, maar in de actuele systeemconfiguratie of in het manifest aan geen bestaande ara::com::InstanceIdentifier kan worden toegewezen [SWS_CM_00118]. Dit wijst in de praktijk op discrepanties tussen modellering en deployment, bijvoorbeeld wanneer een service provider op een andere machine niet is gedeployd of de binding in het manifest ontbreekt. Voor deze fout geldt de rollback-semantiek (rollback_semantics): er worden geen deeltoestanden gegenereerd of resources gebonden, zodat de oproeper de configuratie kan controleren of naar een gedefinieerde fouttoestand kan overgaan [SWS_CM_00118].