klasse ara::diag::ExternalAuthentication

De expliciete constructor [SWS_DM_01193] initialiseert een instantie van de poortklasse ara::diag::ExternalAuthentication [SWS_DM_01191] voor de authenticatie van externe diagnose-clients (SWS Diagnostics §8.17 “Header: ara/diag/external_authentication.h”). Als parameter verwacht de functie een ara::core::InstanceSpecifier, die moet verwijzen naar een in het manifest gemodelleerde PortPrototype van een DiagnosticExternalAuthenticationInterface-service-instantie [SWS_DM_01193].

De synchrone aanroep is gedeclareerd als noexcept en gespecificeerd als zowel thread-safe als exception-safe [SWS_DM_01193]. Aangezien er geen exceptions worden gegenereerd, leiden modellerings- en configuratiefouten tot gedefinieerde violations van het framework [SWS_DM_01193]:

• InstanceSpecifierMappingIntegrityViolation: De identificator kan niet worden omgezet in de context van het executable of verwijst naar een ander modelelement dan een PortPrototype.
• PortInterfaceMappingViolation: De gereferentieerde PortPrototype is niet getypeerd door een DiagnosticExternalAuthenticationInterface.
• ProcessMappingViolation: Voor de referentie bestaat geen passend gemodelleerd runtime-proces.
• InstanceSpecifierAlreadyInUseViolation: De identificator wordt in het actieve proces al door een andere instantie gebruikt.

Kopieeroperaties zijn voor ExternalAuthentication expliciet verhinderd [SWS_DM_01196] [SWS_DM_01197], terwijl verplaatsingsoperaties worden ondersteund [SWS_DM_01194] [SWS_DM_01195]. In tegenstelling tot de constructor is de bijbehorende destructor niet thread-safe [SWS_DM_01198]. Na succesvolle instantiatie dient het object ertoe om via methoden zoals Get of GetAll bijbehorende client-authenticatie-instanties op te vragen [SWS_DM_01201] [SWS_DM_01202].

De synchrone methode ara::diag::ExternalAuthentication::Get stelt een adaptieve applicatie in staat om de voor een diagnoseverzoek verantwoordelijke instantie van ara::diag::ClientAuthentication op te halen [SWS_DM_01199]. Als parameter wordt een referentie naar metaInfo (const ara::diag::MetaInfo&) overgedragen, die metagegevens uit de context van het diagnoseverzoek beschikbaar stelt SWS Diagnostics §7.3.1.1 “MetaInfo class”. De retourwaarde van het type ara::core::Result<ClientAuthentication> капselt het overeenkomstige authenticatieobject in voor het beheer van de authenticatietoestand van de client [SWS_DM_01202].

Treedt er een fout op, dan bevat de geretourneerde Result de specifieke foutcode DiagErrc::kServiceNotAvailable [SWS_DM_01199]. Deze signaleert met rollback-semantiek dat de aanroep niet kan worden uitgevoerd omdat essentiële functies van de Diagnostic Manager (DM) op het aanroeptijdstip niet beschikbaar zijn [SWS_DM_01199].

Wat betreft gelijktijdigheid is de functie gespecificeerd als thread-safe en exception safe en gedeclareerd met noexcept [SWS_DM_01199]. Zij kan daarom zonder vergrendelingsmechanismen aan applicatiezijde veilig vanuit parallelle threads worden aangeroepen.

De methode staat in wisselwerking met de overladen variant Get(Address sourceAddress) [SWS_DM_01200], die dezelfde bevraging rechtstreeks via het bronadres van de client mogelijk maakt [SWS_DM_01202]. Het aantal beschikbare instanties wordt bepaald door de modelelementen DiagnosticExternalAuthenticationIdentification SWS Diagnostics “Get ClientAuthentication Instance”. Interpretatie: de functie zal intern vermoedelijk het voor de toewijzing benodigde bronadres bepalen uit de in metaInfo ingekapselde transportgegevens. Vraag Q-50d416201ccb5825 (open)

De synchrone methode Get van de klasse ara::diag::ExternalAuthentication stelt een adaptieve applicatie in staat om de instantie van ClientAuthentication op te halen die de authenticatietoestand van de diagnoseclient voor het opgegeven bronadres beheert [SWS_DM_01200]. De Diagnostic Manager resolveert hierbij via het overgedragen bronadres het verantwoordelijke authenticatieobject [SWS_DM_01202].

Het gebruik en de randvoorwaarden omvatten de volgende aspecten:

• Aanroep en parameters: Als parameter wordt sourceAddress van het type Address overgedragen [SWS_DM_01200]. De resolutie steunt in het systeemmodel op geconfigureerde DiagnosticExternalAuthenticationIdentification-elementen die vaste bronadressen of adresbereiken definiëren SWS Diagnostics p. 129 “ClientAuthentication”. Bovendien bestaat er een overload van Get die de instantie bepaalt via een MetaInfo-object [SWS_DM_01199], [SWS_DM_01202].
• Retourwaarde en foutafhandeling: De functie levert een ara::core::Result<ClientAuthentication> op [SWS_DM_01200]. Is de uitvoering niet mogelijk omdat essentiële functies van de Diagnostic Manager niet beschikbaar zijn, dan wordt de fout DiagErrc::kServiceNotAvailable met rollback-semantiek geretourneerd [SWS_DM_01200].
• Gelijktijdigheid: De operatie is gespecificeerd als thread-safe en exception safe en gedeclareerd met noexcept, waardoor aanroepen vanuit parallelle threads uitzonderingsveilig kunnen worden uitgevoerd [SWS_DM_01200].

Gebruik

De methode GetAll van de klasse ara::diag::ExternalAuthentication (headerbestand ara/diag/external_authentication.h) stelt applicaties in staat om alle momenteel door de Diagnostic Manager beheerde instanties van ClientAuthentication synchroon op te vragen [SWS_DM_01201], [SWS_DM_01203]. De aanroep geschiedt zonder parameters en retourneert een ara::core::Vector<ClientAuthentication> die alle toegewezen authenticatieobjecten bevat [SWS_DM_01201].

Foutafhandeling en retourwaarden

De functie is gedeclareerd als uitzonderingsveilig (exception safe) en noexcept [SWS_DM_01201]. Specifieke foutcodes of meldingen aan DET resp. DEM bestaan niet voor deze interface. Voor zover er geen authenticatieobjecten beschikbaar zijn, wordt dit niet behandeld als een fout, maar levert de methode een lege vector op [SWS_DM_01201].

Gelijktijdigheid en beperkingen

De specificatie merkt GetAll aan als threadveilig (thread-safe) [SWS_DM_01201]. Interpretatie: aanroepen vanuit meerdere parallelle applicatiethreads zijn vermoedelijk dan ook toelaatbaar zonder aanvullende synchronisatie aan applicatiezijde. Vraag Q-9f26d94068ebd3fe (open)

Samenspel

De verzameling opvraagbare instanties correspondeert met de geconfigureerde modelelementen van het type DiagnosticExternalAuthenticationIdentification, die vaste bronadressen of adresbereiken definiëren AUTOSAR_AP_SWS_Diagnostics p. 129. Terwijl GetAll het geheel van alle instanties levert [SWS_DM_01203], maakt de methode Get de gerichte opvraag voor een specifiek bronadres of specifieke meta-informatie mogelijk [SWS_DM_01202].

De destructor ~ExternalAuthentication() beëindigt de levenscyclus van een instantie van de klasse ara::diag::ExternalAuthentication uit de header ara/diag/external_authentication.h [SWS_DM_01198]. Deze wordt synchroon uitgevoerd bij het verlaten van de scope of bij het vrijgeven van het object, vereist geen overdrachtparameters en heeft geen retourwaarde AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 “Destructor”.

Wat betreft foutafhandeling is de functie voorzien van de specificator noexcept en formeel gedefinieerd als uitzonderingsveilig (exception safe) [SWS_DM_01198]. De aanroep garandeert derhalve dat er bij een fout geen C++-excepties zijn die het vernietigingsproces onderbreken of naar de aanroeper worden doorgegeven.

Wat betreft gelijktijdigheid en beperkingen dient in acht te worden genomen dat de destructor gespecificeerd is als niet threadveilig (not thread-safe) [SWS_DM_01198]. Aanroepende componenten moeten er daarom voor zorgen dat er tijdens de vernietiging geen gelijktijdige toegang via afzonderlijke threads plaatsvindt tot dezelfde instantie van ara::diag::ExternalAuthentication. Vermoedelijk moeten vóór de aanroep alle actieve diagnose- en authenticatieoperaties van deze instantie volledig zijn beëindigd om ongecoördineerde geheugentoegangen te voorkomen. Vraag Q-67c112ea87f722d2 (open)

In de functionele context realiseert de interface de overkoepelende requirement RS_Diag_04251 voor Diagnostic Management (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 “Destructor”. De tabellarische aanduiding als destructor van een Dynamic-Access-List is vermoedelijk een redactionele onnauwkeurigheid van de specificatie, aangezien scope en naamruimte de binding aan ExternalAuthentication vastleggen [SWS_DM_01198]. Vraag Q-30744aac322624cb (open)