klasse ara::com::InstanceIdentifier

De klasse ara::com::InstanceIdentifier representeert de unieke technische identificatie van een concrete service-instantie in het AUTOSAR Adaptive Platform en maakt adressering via specifieke communicatie-bindings mogelijk (AUTOSAR_AP_EXP_ARAComAPI p. 22 §4.1 “InstanceIdentifier class”). Als serialiseerbaar waardetype kan deze worden aangemaakt uit tekenreeksen, vergeleken en beheerd in containers ([SWS_CM_11520], [SWS_CM_11523]). Terwijl standaardapplicaties primair abstracte model-identifiers gebruiken, dient het directe gebruik van deze technische identificator voor speciale gevallen zoals multi-binding en failover-oplossingen (AUTOSAR_AP_EXP_ARAComAPI p. 25 “InstanceIdentifier Usage”).

meer ›

Context

De klasse ara::com::InstanceIdentifier dient voor de unieke identificatie van een concrete service-instantie op het Adaptive Platform (AdaptivePlatformServiceInstance), om verschillende instanties van exact dezelfde service van elkaar te onderscheiden. Deze kapselt de technologiespecifieke adressering van de gekozen communicatie-binding in, maar bevat bewust geen fully qualified name met servicetype-informatie. Voor de reguliere softwareontwikkelaar is de directe interactie met ara::com::InstanceIdentifier doorgaans geabstraheerd: terwijl in het softwarecomponentmodel voornamelijk logische namen via ara::core::InstanceSpecifier worden gebruikt (AUTOSAR_AP_EXP_ARAComAPI p. 23 §4.2 “InstanceSpecifier class”), wijst de integrator deze via manifestbestanden toe aan de technische bindings en hun respectieve instantie-ID's (AUTOSAR_AP_EXP_ARAComAPI p. 23 §4.2 “InstanceSpecifier class”).

In het kader van zogeheten multi-binding kan een enkele abstracte identifier worden gekoppeld aan meerdere technische bindings. De resolutie via ResolveInstanceIDs() retourneert daarom een ara::com::InstanceIdentifierContainer die meerdere ara::com::InstanceIdentifier bundelt (ARAComAPI p. 1 “Figure 6.6: InstanceIdentifier Resolution”, AUTOSAR_AP_EXP_ARAComAPI p. 24 §4.3 “InstanceSpecifier Resolution”). Dit stelt servers (skeletons) in staat om clients via verschillende transporttechnologieën te bedienen, of clients (proxies) om failover-paden te realiseren (ARAComAPI p. 1 “Figure 6.6: InstanceIdentifier Resolution”).

Contextdiagram: samenspel van applicatie, deployment-manifest, instantie-resolutie en service-interfaces. Bronnen: ARAComAPI p. 103 “Figure 6.5: Service Discovery”, AUTOSAR_AP_EXP_ARAComAPI p. 23 §4.2 “InstanceSpecifier class”, AUTOSAR_AP_EXP_ARAComAPI p. 24 §4.3 “InstanceSpecifier Resolution”

Levenscyclus

Instanties van ara::com::InstanceIdentifier beschikken over volwaardige waardesemantiek. Ze voldoen aan de eisen equalitycomparable, lessthancomparable en copyassignable volgens ISO/IEC 14882:2014, waardoor ze kunnen worden beheerd in standaardcontainers, gesorteerd en gelogd. De klasse stelt de volgende constructors en levenscyclusfuncties beschikbaar:

• Uitzonderingsvrije creatie via de statische fabrieksmethode Create ([SWS_CM_11520]) met noexcept.
• Expliciete constructor op basis van een string-representatie ([SWS_CM_11521]), die uitdrukkelijk niet uitzonderingsveilig (not exception safe) is.
• Copy-constructor ([SWS_CM_00056]) en move-constructor ([SWS_CM_00053]), beide gespecificeerd als noexcept.
• Copy-toekenningsoperator ([SWS_CM_11525]) en move-toekenningsoperator ([SWS_CM_00054]), telkens met noexcept.
• Vergelijkingsoperatoren operator== ([SWS_CM_11523]) en operator< ([SWS_CM_11524]) voor gelijkheids- en ordeningscontrole.
• Destructor ~InstanceIdentifier() ([SWS_CM_00055]) met noexcept.

Door het samenspel van de string-constructor met de methode toString() ([SWS_CM_11522]) is de klasse serialiseerbaar (AUTOSAR_AP_EXP_ARAComAPI p. 22 §4.1 “InstanceIdentifier class”). Dit maakt het persisteren, overdragen en later hergebruiken van een identifier mogelijk. Een inhoudelijke interpretatie (introspectie) van de geserialiseerde string door de applicatielogica is niet voorzien, aangezien de opbouw volledig afhangt van het middlewareproduct en de binding (AUTOSAR_AP_EXP_ARAComAPI p. 22 §4.1 “InstanceIdentifier class”).

Gebruikspad

Aangezien ara::com voor gangbare methoden overloads aanbiedt die direct ara::core::InstanceSpecifier accepteren, richt het handmatig omgaan met ara::com::InstanceIdentifier zich primair op geavanceerde usecases zoals gespecialiseerde bindings of gerichte fail-over (AUTOSAR_AP_EXP_ARAComAPI p. 25 “InstanceIdentifier Usage”). Het typische verloop is onderverdeeld in de volgende stappen:

1. Resolutie: de applicatie vertaalt de abstracte model-identifier door middel van ResolveInstanceIDs() naar de toegewezen technische instantie-identificaties (AUTOSAR_AP_EXP_ARAComAPI p. 24 §4.3 “InstanceSpecifier Resolution”).
2. Selectie: uit de resulterende ara::com::InstanceIdentifierContainer kiest de applicatie de gewenste ara::com::InstanceIdentifier (ARAComAPI p. 1 “Figure 6.6: InstanceIdentifier Resolution”).
3. Zoeken naar services: de identifier wordt doorgegeven aan de statische methode FindService(ara::com::InstanceIdentifier instance) van de proxy-klasse (ARAComAPI p. 103 “Figure 6.5: Service Discovery”).
4. Verwerking: het zoeken naar services levert een ServiceHandleContainer op, op basis waarvan proxies worden geïnstantieerd (ARAComAPI p. 103 “Figure 6.5: Service Discovery”). Via GetInstanceId() kan de instantie-identificatie worden opgevraagd (AUTOSAR_AP_EXP_ARAComAPI p. 30 “GetInstanceId”).

Sequentiediagram: resolutie van de identifier en gericht zoeken naar services via de technische InstanceIdentifier. Bronnen: ARAComAPI p. 103 “Figure 6.5: Service Discovery”, AUTOSAR_AP_EXP_ARAComAPI p. 24 §4.3 “InstanceSpecifier Resolution”

Foutscenario's

Bij het omgaan met ara::com::InstanceIdentifier moet met name rekening worden gehouden met twee foutsituaties:

• Ongeldig stringformaat (InvalidInstanceIdentifierStringViolation): wanneer een geserialiseerde identifier aan Create ([SWS_CM_11520]) of de constructor ([SWS_CM_11521]) wordt doorgegeven die beschadigd, niet-conform of gedupliceerd is, doet deze schending zich voor. Interpretatie: terwijl de uitzonderingsvrije fabrieksmethode Create dit vermoedelijk via een foutobject meldt, zal de niet-uitzonderingsveilige constructor in geval van een fout waarschijnlijk een exceptie genereren. Vraag Q-45a6fdd0859218bd (open)
• Ontbrekende mapping bij de resolutie: als de integrator in het deploymentmanifest geen toewijzing voor een ara::core::InstanceSpecifier heeft vastgelegd, retourneert de aanroep van ResolveInstanceIDs() een lege lijst (ARAComAPI p. 1 “Figure 6.6: InstanceIdentifier Resolution”, AUTOSAR_AP_EXP_ARAComAPI p. 24 §4.3 “InstanceSpecifier Resolution”). Dit vormt doorgaans een configuratiefout.
• Ontbrekende service-instantie: als er voor de opgegeven identifier geen corresponderende OfferService() aan skeletonzijde is uitgevoerd, blijft de door FindService geleverde ServiceHandleContainer leeg (ARAComAPI p. 103 “Figure 6.5: Service Discovery”).