DEENESPTFRRUARHIKOZHNL
AUTOSAR_SWS_Persistency FIG-08c78db8ef539276 819 × 549 px 1 Release(s)

Figure 7.1: Typical usage of Persistency within an Adaptive Application

SHA-256 Inhalts-Fingerabdruck: 08c78db8ef539276c0ba74cbe2ec59108a0f090fa4e8c98bbc65cbac5a8a48ed

Im Versions-Explorer öffnen

Kanonischer Bildausschnitt (144 DPI WebP, gerendert aus Original-Vektorgrafik) · nicht öffentlich, nur mit Anmeldung und Freigabe
✦ KI-generierte Bildanalyse & technische Beschreibung Modell: gemini-3.8-flash (via agy) · Rezept figure-series@1 · erstellt am 2026-10-08

1. Diagrammtyp & Architektur-Kontext

  • Klassifikation: Informelles Block- und Architektur-Strukturdiagramm (Komponenten- und Kapselungsmodell der AUTOSAR Adaptive Platform).
  • Technischer Zweck & Einordnung: Illustration der Speicherabstraktion innerhalb des Functional Clusters Persistency (ara::per) für eine Adaptive Application (AdaptiveApplicationSwComponentType). Es visualisiert die Koexistenz und logische Kapselung der beiden komplementären Persistenzmechanismen – schlüsselbasierter strukturierter Datenzugriff (Key-Value Storage) und dateibasierter Bytestream-Zugriff (File Storage).

2. Komponenten, Entitäten & Schnittstellen

  • Adaptive Application (AdaptiveApplicationSwComponentType): Der ausführende Anwendungsprozess im Userspace des POSIX-Betriebssystems, in dessen Kontext die Persistenzinstanzen instanziiert und betrieben werden.
  • Persistency (ara::per): Das funktionale Persistenz-Cluster, das als anwendungslokale C++-Bibliothek realisiert ist und die Low-Level-Interaktion mit dem darunterliegenden Dateisystem bzw. Flash/NVRAM kapselt.
  • Key-Value Storage (A & B):
    • Repräsentiert diskrete Schlüssel-Wert-Datenbanken (ara::per::KeyValueStorage).
    • Modellierung im AUTOSAR-Manifest über PortPrototype (P-Port / R-Port), typisiert durch ein PersistencyKeyValueDatabaseInterface.
    • Hält typisierte Schlüssel-Wert-Paare (Key_A1 = Value_A1, Key_A2 = Value_A2, Key_B1 = Value_B1, etc.), serialisiert über AUTOSAR-Datentypen.
    • Kardinalität: 1 … n Key-Value-Datenbanken pro Softwarekomponente (visualisiert durch Storage A und B mit vertikalen Auslassungspunkten ...); jede Datenbank verwaltet 0 … m Schlüssel-Wert-Paare.
  • File Storage (C & D):
    • Repräsentiert isolierte virtuelle Dateicontainer (ara::per::FileStorage).
    • Modellierung im AUTOSAR-Manifest über PortPrototype, typisiert durch ein PersistencyFileStorageInterface.
    • Verwaltet raw Byte-Streams bzw. diskrete Dateien (File_C1, File_C2, File_D1, File_D2, etc.).
    • Kardinalität: 1 … n File Storages pro Komponente (visualisiert durch Storage C und D mit vertikalen Auslassungspunkten ...); jeder Speicher kapselt 0 … k Dateien (ara::per::ReadAccessor, ara::per::ReadWriteAccessor).

3. Dynamisches Verhalten & Sequenzablauf

  • Initialisierung & Pre-Deployment:
    • Vordefinierte Key-Value-Paare und Init-Dateien werden während der Installations- bzw. Updatephase durch das Update and Configuration Management (UCM) auf Basis des Deployments und Manifests auf dem persistenten Speicher bereitgestellt.
  • Laufzeit-Zugriff (CRUD-Operationen):
    • Key-Value Storage: Synchrone/asynchrone API-Calls (GetValue, SetValue, SyncToStorage). Modifikationen im RAM-Cache werden synchron oder verzögert über SyncToStorage() redundant und transaktionssicher (Crash-Konsistenz) auf den persistenten Speicher geflusht.
    • File Storage: Öffnen und Modifizieren via Stream-Operatoren (OpenFileReadStream, OpenFileWriteStream). Sperren/Locks auf File-Ebene verhindern nebenläufige Konflikte innerhalb desselben Prozesses.
  • Fehler- und Abbruchverhalten:
    • Fehler (z. B. I/O-Fehler, Quota-Überschreitung, Korruption) werden über ara::core::Result<T> mit spezifischen PerErrc-Fehlercodes zurückgegeben.
    • Bei Datenkorruption greifen persistenzspezifische Integritätsprüfungen (CRC/Redundanz gemäß Redundancy Handling).

4. Normative Relevanz & Entwickler-Hinweise

  • Architektur- und Spezifikationsbezug: Das Diagramm veranschaulicht die funktionale Kapselung persistenter Datenzugriffe auf Anwendungsebene. Es besitzt informativen Charakter und definiert die logische Koexistenz von KeyValueStorage und FileStorage innerhalb eines Prozesses.
  • Port- und Manifest-Modellierung: Entwickler müssen jede Key-Value-Datenbank und jedes File-Storage im Software-Component-Description-Manifest über separate PortPrototype-Elemente mit PersistencyKeyValueDatabaseInterface bzw. PersistencyFileStorageInterface deklarieren.
  • Ressourcenallokation & Isolation: Persistente Speicherbereiche sind pro Instanz streng isoliert; Zugriffe erfordern die Konfiguration entsprechender Speicher- und Quota-Limits im Deployment-Manifest.

Versionsvergleich KI-generiert · gemini-3.8-flash (via agy)

R19-11 → R20-11 normative Änderung Vorgänger: FIG-a3aa323d1cfd6bec
  • Hardware & Verbindungspfeil: Der physische Speicherblock „Hardware“ am unteren Bildrand und der bidirektionale Verbindungspfeil zu „Persistency“ wurden entfernt.
  • Persistenzmechanismus (File Storage statt File-Proxy): Der Container „File-Proxy A“ mit den Dateien File1.ext ... Filen.ext wurde ersetzt durch zwei separate Speicherinstanzen „File Storage C“ (mit File_C1, File_C2, ...) und „File Storage D“ (mit File_D1, File_D2, ...), getrennt durch vertikale Auslassungspunkte ....
  • Äußerer Komponentenrahmen: Umbenennung von „Application“ zu „Adaptive Application“.
  • Subsystem Persistency: Der Titeltext „Persistency“ wurde von gelber Typografie auf zentrierte schwarze Schrift umgestellt.
  • Key-Value Storage: Bindestrich im Bezeichner entfernt („Key-Value Storage“ statt zuvor „Key-Value-Storage“), Schlüssel-Wert-Syntax vereinheitlicht (Key_A1 = Value_A1 statt KeyA1 = Value1) und vertikale Auslassungspunkte ... zwischen Speicher A und B ergänzt.
R20-11 → R21-11 redaktionell Nachfolger: FIG-f040c892db68f6ac
  • UML-2-Komponentenmodellierung: Überführung der informellen Blockgrafik in ein UML-2-Komponentendiagramm mit standardisierten Komponentensymbolen in den oberen rechten Ecken aller Rahmen.
  • Stereotyp «process»: Der Rahmen „Adaptive Application“ wurde mit dem Stereotyp «process» annotiert.
  • Stereotyp «subsystem,entity»: Der Rahmen „Persistency“ wurde mit dem Stereotyp «subsystem,entity» versehen.
  • Stereotyp «entity»: Alle Storage-Blöcke („Key-Value Storage A/B“, „File Storage C/D“) wurden mit dem Stereotyp «entity» klassifiziert.
  • Attributnotation & Sichtbarkeit: Schlüssel-Wert-Paare und Dateieinträge wurden als UML-Attribute mit vorangestelltem Sichtbarkeitsindikator + (public) formatiert (z. B. + Key_A1 = Value_A1, + File_C1).
  • Abschluss der Auflistungen: Die informellen Auslassungszeichen ... innerhalb der Attributlisten wurden durch n-te Elemente ersetzt (+ Key_An = Value_An, + File_Cn etc.); die vertikalen Auslassungspunkte zwischen den Komponentenblöcken wurden entfernt.

Zugeordnete Anforderungen

Diese Angaben zeigt der Versions-Explorer.

Aus dem Dokument extrahierter Text & Kontext

Begleitender Spezifikationstext:

Specification of Persistency AUTOSAR AP R20-11 7 Functional Specification 7.1 The Architecture of Persistency The functional cluster Persistency offers two different mechanisms to access persistent memory: Key-Value Storages offer access to a set of keys with associated values (similar to a database), while File Storages offer access to a set of files (similar to a directory of a file system). The typical usage of the Persistency within an Adaptive Application is depicted in Figure 7.1. As shown there, an Adaptive Application can use a combination of multiple Key-Value Storages and multiple File Storages. Figure 7.1: Typical usage of Persistency within an Adaptive Application 7.1.1 Persistency in the Manifest The Persistency usage of an Adaptive Application is modeled in the Execution Manifest (furtheron simply referred to as the “manifest”) as part of the AdaptiveApplicationSwComponentTypes of an Executable. The model has two principal parts: The application design information, aggregated by the PersistencyKeyValueStorageInterface and the PersistencyFileStorageInterface, and the deployment information, aggregated by the PersistencyKeyValueStorage and the PersistencyFileStorage. 23 of 150 Document ID 858: AUTOSAR_SWS_Persistency

Vorkommen in AUTOSAR-Releases (2)

Release Dokument Seite Nr. Bildunterschrift im Dokument
R20-11 AUTOSAR_SWS_Persistency S. 23 7.1 Figure 7.1: Typical usage of Persistency within an Adaptive Application
R20-11 AUTOSAR_SWS_Persistency S. 23 7.1 Figure 7.1: Typical usage of Persistency within an Adaptive Application