class ara::diag::ExternalAuthentication

Der explizite Konstruktor [SWS_DM_01193] initialisiert eine Instanz der Port-Klasse ara::diag::ExternalAuthentication [SWS_DM_01191] zur Authentifizierung externer Diagnose-Clients (SWS Diagnostics §8.17 „Header: ara/diag/external_authentication.h“). Als Parameter erwartet die Funktion einen ara::core::InstanceSpecifier, der auf einen im Manifest modellierten PortPrototype einer DiagnosticExternalAuthenticationInterface-Service-Instanz verweisen muss [SWS_DM_01193].

Der synchrone Aufruf ist als noexcept deklariert und sowohl thread-safe als auch exception-safe spezifiziert [SWS_DM_01193]. Da keine Exceptions geworfen werden, führen Modellierungs- und Konfigurationsfehler zu definierten Violations des Frameworks [SWS_DM_01193]:

• InstanceSpecifierMappingIntegrityViolation: Der Bezeichner lässt sich im Kontext des Executables nicht auflösen oder referenziert ein anderes Modellelement als einen PortPrototype.
• PortInterfaceMappingViolation: Der referenzierte PortPrototype ist nicht durch ein DiagnosticExternalAuthenticationInterface typisiert.
• ProcessMappingViolation: Zur Referenz existiert kein passender modellierter Laufzeitprozess.
• InstanceSpecifierAlreadyInUseViolation: Der Bezeichner wird im laufenden Prozess bereits von einer anderen Instanz genutzt.

Kopieroperationen sind für ExternalAuthentication explizit unterbunden [SWS_DM_01196] [SWS_DM_01197], während Verschiebeoperationen unterstützt werden [SWS_DM_01194] [SWS_DM_01195]. Im Gegensatz zum Konstruktor ist der zugehörige Destruktor nicht threadsicher [SWS_DM_01198]. Nach erfolgreicher Instanziierung dient das Objekt dazu, über Methoden wie Get oder GetAll zugehörige Client-Authentifizierungsinstanzen abzufragen [SWS_DM_01201] [SWS_DM_01202].

Die synchrone Methode ara::diag::ExternalAuthentication::Get dient einer adaptiven Anwendung dazu, die für eine Diagnoseanfrage zuständige Instanz von ara::diag::ClientAuthentication abzurufen [SWS_DM_01199]. Als Parameter wird eine Referenz auf metaInfo (const ara::diag::MetaInfo&) übergeben, welche Metainformationen aus dem Kontext der Diagnoseanfrage bereitstellt SWS Diagnostics §7.3.1.1 „MetaInfo class“. Der Rückgabewert vom Typ ara::core::Result<ClientAuthentication> kapselt das entsprechende Authentifizierungsobjekt zur Verwaltung des Authentifizierungszustands des Clients [SWS_DM_01202].

Tritt ein Fehler auf, enthält das zurückgegebene Result den spezifischen Fehlercode DiagErrc::kServiceNotAvailable [SWS_DM_01199]. Dieser signalisiert mit Rollback-Semantik, dass der Aufruf nicht ausgeführt werden kann, weil wesentliche Funktionen des Diagnostic Managers (DM) zur Aufrufzeit nicht zur Verfügung stehen [SWS_DM_01199].

Hinsichtlich der Nebenläufigkeit ist die Funktion als thread-safe sowie exception safe spezifiziert und mit noexcept deklariert [SWS_DM_01199]. Sie kann daher ohne anwendungsseitige Sperrmechanismen sicher aus parallelen Threads heraus aufgerufen werden.

Die Methode steht im Zusammenspiel mit der überladenen Variante Get(Address sourceAddress) [SWS_DM_01200], welche denselben Abruf direkt über die Quelladresse des Clients ermöglicht [SWS_DM_01202]. Die Anzahl der verfügbaren Instanzen wird durch die Modellelemente DiagnosticExternalAuthenticationIdentification bestimmt SWS Diagnostics „Get ClientAuthentication Instance“. Interpretation: Die Funktion dürfte intern die zur Zuordnung benötigte Quelladresse aus den in metaInfo gekapselten Transportdaten ermitteln. Frage Q-50d416201ccb5825 (offen)

Die synchrone Methode Get der Klasse ara::diag::ExternalAuthentication dient einer adaptiven Anwendung dazu, die Instanz von ClientAuthentication abzurufen, die den Authentifizierungszustand des Diagnose-Clients für die angegebene Quelladresse verwaltet [SWS_DM_01200]. Der Diagnostic Manager löst hierbei über die übergebene Quelladresse das zuständige Authentifizierungsobjekt auf [SWS_DM_01202].

Die Verwendung und Randbedingungen umfassen folgende Aspekte:

• Aufruf und Parameter: Als Parameter wird sourceAddress vom Typ Address übergeben [SWS_DM_01200]. Die Auflösung stützt sich im Systemmodell auf konfigurierte DiagnosticExternalAuthenticationIdentification-Elemente, die feste Quelladressen oder Adressbereiche definieren SWS Diagnostics S. 129 „ClientAuthentication“. Zudem existiert eine Überladung von Get, welche die Instanz über ein MetaInfo-Objekt bestimmt [SWS_DM_01199], [SWS_DM_01202].
• Rückgabewert und Fehlerbehandlung: Die Funktion liefert ein ara::core::Result<ClientAuthentication> zurück [SWS_DM_01200]. Ist die Ausführung nicht möglich, weil wesentliche Funktionen des Diagnostic Managers nicht verfügbar sind, wird der Fehler DiagErrc::kServiceNotAvailable mit Rollback-Semantik zurückgegeben [SWS_DM_01200].
• Nebenläufigkeit: Die Operation ist als thread-safe und exception safe spezifiziert sowie mit noexcept deklariert, weshalb Aufrufe aus parallelen Threads ausnahmesicher durchgeführt werden können [SWS_DM_01200].

Verwendung

Die Methode GetAll der Klasse ara::diag::ExternalAuthentication (Header-Datei ara/diag/external_authentication.h) dient Anwendungen dazu, alle aktuell durch den Diagnostic Manager verwalteten Instanzen von ClientAuthentication synchron abzufragen [SWS_DM_01201], [SWS_DM_01203]. Der Aufruf erfolgt parameterlos und gibt einen ara::core::Vector<ClientAuthentication> zurück, welcher sämtliche zugeordnete Authentifizierungsobjekte enthält [SWS_DM_01201].

Fehlerbehandlung und Rückgabewerte

Die Funktion ist als ausnahmesicher (exception safe) und noexcept deklariert [SWS_DM_01201]. Spezifische Fehlercodes oder Meldungen an DET bzw. DEM existieren für diese Schnittstelle nicht. Sofern keine Authentifizierungsobjekte verfügbar sind, wird dies nicht als Fehler behandelt, sondern die Methode liefert einen leeren Vektor zurück [SWS_DM_01201].

Nebenläufigkeit und Einschränkungen

Die Spezifikation weist GetAll als threadsicher (thread-safe) aus [SWS_DM_01201]. Interpretation: Aufrufe aus mehreren parallelen Anwendungs-Threads dürften somit ohne zusätzliche anwendungsseitige Synchronisation zulässig sein. Frage Q-9f26d94068ebd3fe (offen)

Zusammenspiel

Die Menge der abrufbaren Instanzen korrespondiert mit den konfigurierten Modellelementen vom Typ DiagnosticExternalAuthenticationIdentification, welche feste Quelladressen oder Adressbereiche definieren AUTOSAR_AP_SWS_Diagnostics S. 129. Während GetAll die Gesamtheit aller Instanzen bereitstellt [SWS_DM_01203], erlaubt die Methode Get die gezielte Abfrage für eine bestimmte Quelladresse oder Metainformation [SWS_DM_01202].

Der Destruktor ~ExternalAuthentication() beendet den Lebenszyklus einer Instanz der Klasse ara::diag::ExternalAuthentication aus dem Header ara/diag/external_authentication.h [SWS_DM_01198]. Er wird synchron beim Verlassen des Gültigkeitsbereichs oder bei der Freigabe des Objekts ausgeführt, erfordert keine Übergabeparameter und besitzt keinen Rückgabewert AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 „Destructor“.

Hinsichtlich der Fehlerbehandlung ist die Funktion mit dem Spezifizierer noexcept versehen und formell als ausnahmesicher (exception safe) definiert [SWS_DM_01198]. Der Aufruf garantiert demnach, dass im Fehlerfall keine C++-Ausnahmen den Zerstörungsvorgang unterbrechen oder an den Aufrufer weitergereicht werden.

Bezüglich Nebenläufigkeit und Einschränkungen ist zu beachten, dass der Destruktor als nicht threadsicher (not thread-safe) spezifiziert ist [SWS_DM_01198]. Aufrufende Komponenten müssen daher sicherstellen, dass während der Zerstörung keine gleichzeitigen Zugriffe über separate Threads auf dieselbe Instanz von ara::diag::ExternalAuthentication stattfinden. Vermutlich sollten vor dem Aufruf alle aktiven Diagnose- und Authentifizierungsoperationen dieser Instanz vollständig beendet sein, um unkoordinierte Speicherzugriffe zu vermeiden. Frage Q-67c112ea87f722d2 (offen)

Im funktionalen Kontext realisiert die Schnittstelle die übergeordnete Anforderung RS_Diag_04251 für das Diagnosemanagement (DM) AUTOSAR_AP_SWS_Diagnostics §8.17.1.2.1.2 „Destructor“. Die tabellarische Kennzeichnung als Destruktor einer Dynamic-Access-List dürfte eine redaktionelle Unschärfe der Spezifikation sein, da Scope und Namensraum die Bindung an ExternalAuthentication festlegen [SWS_DM_01198]. Frage Q-30744aac322624cb (offen)