class ara::diag::DynamicAccessListDiagServiceBuilder

Verwendung

Die synchrone Methode Add der Klasse ara::diag::DynamicAccessListDiagServiceBuilder dient dazu, ein einzelnes Byte (Byte value) zu einem DynamicAccessListPattern hinzuzufügen [SWS_DM_01175]. Der übergebene Bytewert wird bei der Auswertung der Zugriffsrechte für Diagnosedienste auf exakte Übereinstimmung geprüft [SWS_DM_01175]. Durch die Rückgabe einer Referenz auf die Instanz desselben Objekts (DynamicAccessListDiagServiceBuilder&) unterstützt die Funktion den Aufruf als Fluent-API [SWS_DM_01175].

Fehlerbehandlung und Exception-Sicherheit

Die Operation ist als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert [SWS_DM_01175]. Es werden weder Fehlercodes noch Rückgabewerte vom Typ ara::core::Result zurückgegeben; spezifische DET- oder DEM-Meldungen sind im Payload für diese Funktion nicht ausgewiesen.

Nebenläufigkeit und Einschränkungen

Die Methode ist als nicht threadsicher (not thread-safe) spezifiziert [SWS_DM_01175]. Interpretation: Aufrufe an derselben Builder-Instanz dürften daher typischerweise sequenziell innerhalb eines einzelnen Threads erfolgen, bevor das erstellte Zugriffsmuster im Diagnoseserver ausgewertet wird. Frage Q-69d895fc6bf90cb4 (offen)

Zusammenspiel

Innerhalb der Schnittstelle DynamicAccessListDiagServiceBuilder ergänzt diese Methode verwandte Überladungen von Add, mit denen Bytefolgen über ByteString [SWS_DM_01176] oder Wertebereiche über ByteRange [SWS_DM_01177] zu einem DynamicAccessListPattern hinzugefügt werden können.

Die Elementfunktion Add der Klasse ara::diag::DynamicAccessListDiagServiceBuilder dient dem Hinzufügen einer Bytefolge zu einem DynamicAccessListPattern [SWS_DM_01176]. Über den Eingabeparameter values vom Typ ByteString wird eine Bytesequenz übergeben, die bei der späteren Auswertung von Zugriffsrechten für Diagnosedienste auf eine exakte Übereinstimmung geprüft wird [SWS_DM_01176]. Als Rückgabewert liefert die Methode eine Referenz auf dieselbe Builder-Instanz (DynamicAccessListDiagServiceBuilder&), was eine fluide Schnittstellenbenutzung (Fluent API) durch Verkettung mehrerer Aufrufe ermöglicht [SWS_DM_01176].

Hinsichtlich der Fehlerbehandlung ist die Funktion als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert [SWS_DM_01176]. Es werden weder Fehlercodes noch C++-Ausnahmen zurückgemeldet.

Bezüglich der Nebenläufigkeit ist die Methode als nicht threadsicher (not thread-safe) definiert [SWS_DM_01176]. Greifen mehrere Threads parallel auf dieselbe Builder-Instanz zu, müssen die Aufrufe anwendungsseitig synchronisiert werden. Interpretation: Der Aufruf dürfte synchron im Ausführungskontext des konfigurierenden Anwendungs-Threads erfolgen, da keine asynchronen Mechanismen spezifiziert sind. Frage Q-d93498e82292a88e (offen)

Im Zusammenspiel des Diagnosemanagements ergänzt diese Methode verwandte Builder-Funktionen zur Definition dynamischer Zugriffsmuster: Während mit dieser Funktion vollständige Bytefolgen registriert werden, können alternativ über überladene Add-Funktionen auch einzelne Bytes ([SWS_DM_01175]) oder Wertebereiche ([SWS_DM_01177]) zum Muster hinzugefügt werden.

Die Funktion Add der Klasse ara::diag::DynamicAccessListDiagServiceBuilder dient Anwendungen dazu, einem DynamicAccessListPattern einen Wertebereich von Bytes hinzuzufügen [SWS_DM_01177]. Der übergebene Parameter range vom Typ ByteRange definiert ein Werteintervall, welches während der Auswertung von Zugriffsrechten für Diagnosedienste auf Übereinstimmung geprüft wird [SWS_DM_01177].

Für den Aufruf und die Einbindung in das Diagnose-Management gelten folgende Eigenschaften:

• Aufrufkontext und Semantik: Der Aufruf erfolgt synchron. Als Rückgabewert liefert die Funktion eine Objektreferenz auf dieselbe Builder-Instanz (DynamicAccessListDiagServiceBuilder&), um eine flüssige Schnittstellennutzung (Fluent API) durch Methodenverkettung zu unterstützen [SWS_DM_01177].
• Fehlerbehandlung: Die Operation ist als noexcept deklariert und besitzt die Spezifikationseigenschaft exception safe [SWS_DM_01177]. Es werden keine spezifischen Fehlercodes zurückgegeben, und es werden keine Ausnahmen ausgelöst.
• Nebenläufigkeit: Die Funktion ist explizit als not thread-safe spezifiziert [SWS_DM_01177]. Interpretation: Greifen mehrere Ausführungsstränge auf dieselbe Builder-Instanz zu, muss die aufrufende Anwendung den Zugriff extern synchronisieren. Frage Q-c51760a8fe29bd5f (offen)
• Zusammenspiel: Die Methode ergänzt verwandte Funktionen der Builder-Klasse zum Hinzufügen einzelner Bytewerte über [SWS_DM_01175] sowie zur Definition von Bytefolgen mittels [SWS_DM_01176], um flexible Zugriffsmuster zu konfigurieren.

Verwendung

Die Methode ara::diag::DynamicAccessListDiagServiceBuilder::Any dient der Anwendungssoftware dazu, Wildcards in einem Zugriffsmuster zu definieren ([SWS_DM_01178]). Der synchrone Aufruf erfolgt an einer Instanz des Builders. Über den Parameter numberOfBytesToIgnore wird festgelegt, wie viele aufeinanderfolgende Bytes zwar in das Zugriffsmuster aufgenommen, beim späteren Musterabgleich (Pattern Matching) gegen eingehende Diagnoseanfragen jedoch ignoriert werden ([SWS_DM_01220]). Durch die Rückgabe einer Objektreferenz auf denselben Builder wird ein fluenter API-Aufrufstil ermöglicht (AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.4 „Any“).

Fehlerbehandlung und Ausnahmeverhalten

Die Funktion ist als noexcept und ausnahmesicher (exception safe) spezifiziert ([SWS_DM_01178]). Es werden weder Fehlercodes noch Rückmeldungen an DET oder DEM vorgesehen. Interpretation: Bei der Übergabe des Werts 0 für numberOfBytesToIgnore dürfte der Aufruf ohne Fehler zurückkehren und keine Wildcard-Bytes im Muster registrieren. Frage Q-e372cda9f8840893 (offen)

Nebenläufigkeit und Einschränkungen

Die Schnittstelle ist explizit als nicht threadsicher (not thread-safe) ausgewiesen ([SWS_DM_01178]). Mehrere Builder-Aufrufe an derselben Instanz von DynamicAccessListDiagServiceBuilder müssen daher zwingend sequenziell ablaufen oder durch den Aufrufer synchronisiert werden.

Zusammenspiel

Platzhalter-Definitionen über Any werden typischerweise mit Mustern wie EndsWith kombiniert ([SWS_DM_01221]). Nach dem Zusammenstellen aller Musterbestandteile muss die Konfiguration mit der Methode Build finalisiert werden ([SWS_DM_01222]), bevor die resultierende Zugriffsliste für Verifikationen zur Verfügung steht (AUTOSAR_AP_SWS_Diagnostics §7.3.2 „Adding wildcards to a DynamicAccessList“).

Verwendung

Die synchrone Methode Build der Klasse ara::diag::DynamicAccessListDiagServiceBuilder ([SWS_DM_01166]) schließt die Erstellung einer dynamischen Zugriffsliste ab ([SWS_DM_01181]). Die Funktion nimmt keine Übergabeparameter entgegen und besitzt keinen Rückgabewert ([SWS_DM_01181]). Durch den Aufruf übernimmt die zuständige Diagnostic-Server-Instanz die zusammengestellten Zugriffsregeln ([SWS_DM_01222]).

Fehlerbehandlung

Die Operation ist als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert ([SWS_DM_01181]). Es werden weder Fehlercodes zurückgegeben noch Ausnahmen geworfen.

Nebenläufigkeit und Einschränkungen

Die Methode ist als nicht threadsicher (not thread-safe) eingestuft ([SWS_DM_01181]). Gleichzeitige Zugriffe auf dasselbe Builder-Objekt aus mehreren Ausführungskontexten müssen daher extern abgesichert werden. Zudem besteht eine strikte Reihenfolgebedingung: Build muss zwingend aufgerufen werden, bevor das Service-Builder-Objekt zerstört wird ([SWS_DM_01181]). Interpretation: Unterbleibt dieser Aufruf vor dem Lebensende des Objekts, dürften die zuvor konfigurierten Muster verfallen und nicht für die Autorisierung wirksam werden. Frage Q-445ea33ece339d42 (offen)

Zusammenspiel

Im Rahmen der Listenerstellung werden vorab Dienst- und Anforderungsmuster definiert, beispielsweise durch Wildcards über Any ([SWS_DM_01220]) oder Endmuster über EndsWith ([SWS_DM_01221]), wie in SWS Diagnostics §7.3.2.3.4 „DynamicAccessList Creation and Update“ beschrieben. Build finalisiert diesen Konstruktionsprozess und übergibt die Liste an den Server ([SWS_DM_01222]).

Die synchrone Methode EndsWith der Klasse ara::diag::DynamicAccessListDiagServiceBuilder dient Anwendungen dazu, ein einzelnes Byte (Byte value) als Abschlussmuster einer dynamischen Zugriffsliste festzulegen [SWS_DM_01179]. Bei Aufruf weist die Diagnostic-Server-Instanz dieses Muster dem Ende der DynamicAccessList zu, um es bei der Auswertung diagnostischer Servicerechte auf exakte Übereinstimmung zu prüfen [SWS_DM_01221]. Die Funktion liefert keinen Rückgabewert.

Hinsichtlich der Fehlerbehandlung ist die Funktion als ausnahmesicher (exception safe) spezifiziert und mit noexcept deklariert [SWS_DM_01179]. Spezifische Fehlercodes, DET- oder DEM-Meldungen sind im Spezifikationsumfang für diesen Methodenaufruf nicht vorgesehen.

In Bezug auf Nebenläufigkeit ist die Methode als nicht threadsicher (not thread-safe) ausgewiesen [SWS_DM_01179]. Bei nebenläufigem Zugriff auf dieselbe Builder-Instanz ist eine externe Synchronisation durch die Anwendung erforderlich. Interpretation: Das Festlegen des Endmusters dürfte vor dem Aufruf von Build erfolgen müssen [SWS_DM_01222], da der Diagnostic Server die DynamicAccessList mit Build finalisiert. Frage Q-a0afa7deaafa306b (offen)

Im Zusammenspiel mit verwandten Requirements existiert neben dieser Einzelwert-Variante eine Überladung EndsWith(ByteRange range) [SWS_DM_01180], welche die Angabe eines geschlossenen Byte-Wertebereichs als Abschlussmuster erlaubt SWS Diagnostics §8.15.1.2.3.6 „EndsWith(ByteRange)“. Beide Varianten konfigurieren das Endmuster derselben Zugriffsliste vor deren Verwendung [SWS_DM_01221].

Verwendung

Die Methode EndsWith der Klasse ara::diag::DynamicAccessListDiagServiceBuilder dient dazu, ein geschlossenes Byte-Intervall (ByteRange range) am Ende des Suchmusters einer dynamischen Zugriffsliste (DynamicAccessList) festzulegen [SWS_DM_01180]. Beim Methodenaufruf fügt die Instanz des Diagnostic Servers das angegebene Muster an das Ende der DynamicAccessList an [SWS_DM_01221]. Dieser Wertebereich wird anschließend bei der Auswertung der Zugriffsrechte für Diagnosedienste herangezogen AUTOSAR_AP_SWS_Diagnostics §8.15.1.2.3.6 „EndsWith(ByteRange)“. Der Aufruf erfolgt synchron und liefert keinen Rückgabewert (void) [SWS_DM_01180].

Fehlerbehandlung und Nebenläufigkeit

Die Operation ist als noexcept deklariert und als ausnahmesicher (exception safe) spezifiziert; spezifische Fehlercodes oder Ausnahmebehandlungen existieren nicht [SWS_DM_01180]. Hinsichtlich der Nebenläufigkeit ist die Methode als nicht threadsicher (not thread-safe) eingestuft [SWS_DM_01180]. Ein paralleler Zugriff auf dieselbe Builder-Instanz über mehrere Threads hinweg ist ohne externe Synchronisation unzulässig.

Zusammenspiel und Lebenszyklus

Im Rahmen der Mustererstellung existiert neben dieser Variante für Wertebereiche eine alternative Überladung von EndsWith, die ein einzelnes Byte (Byte value) für den exakten Musterabgleich am Ende definiert [SWS_DM_01179]. Nach der Konfiguration des Musters muss die Liste durch den Aufruf von Build finalisiert werden [SWS_DM_01222], bevor die Anwendung die erzeugte DynamicAccessList für Berechtigungsprüfungen einsetzen kann AUTOSAR_AP_SWS_Diagnostics §7.3.2 „End patterns of a DynamicAccessList“.