Figure 9.36: Interfaces for file storage

1. Diagrammtyp & Architektur-Kontext

UML-Klassendiagramm zur Darstellung der Schnittstellenarchitektur für Dateispeicherung (File Storage) innerhalb der AUTOSAR Adaptive Platform. Das Diagramm spezifiziert die Interaktion zwischen einer Anwendungsentität (Adaptive Application), den angebotenen C++-Schnittstellen und dem Funktionscluster Persistency.

2. Komponenten, Entitäten & Schnittstellen

• Komponenten:
  • Adaptive Application (Komponente, stereotype-los, konsumierende Rolle)
  • Persistency (Komponente mit Stereotyp «aapFunctionalCluster», implementierende Rolle)
• Schnittstellen und Klassen:
  • Persistency («aapAPI,aapNativeInterface»): Statische Methoden GetCurrentFileStorageSize(), OpenFileStorage(): FileStorage, RecoverAllFiles(), ResetAllFiles().
  • Persistency::FileStorage («aapAPI,aapPortInterface»): Methoden DeleteFile(), FileExists(), GetAllFileNames(), GetCurrentFileSize(), GetFileInfo(), OpenFileReadOnly(): ReadAccessor, OpenFileReadWrite(): ReadWriteAccessor, OpenFileWriteOnly(): ReadWriteAccessor, RecoverFile(), ResetFile().
  • Persistency::ReadAccessor («aapAPI,aapNativeInterface»): Methoden GetByte(), GetChar(), GetPosition(), GetSize(), IsEof(), MovePosition(), PeekByte(), PeekChar(), ReadBinary(), ReadLine(), ReadText(), SetPosition().
  • Persistency::ReadWriteAccessor («aapAPI,aapNativeInterface»): Methoden operator<<(), SetFileSize(), SyncToFile(), WriteBinary(), WriteText().
• Beziehungen:
  • Adaptive Application nutzt über gerichtete Abhängigkeiten («use») alle vier Schnittstellen (Persistency, Persistency::FileStorage, Persistency::ReadAccessor, Persistency::ReadWriteAccessor).
  • Persistency::ReadWriteAccessor erbt via Generalisierung von Persistency::ReadAccessor.
  • Der Cluster Persistency implementiert alle vier Schnittstellen über Interface-Realisierungspfeile (gestrichelt mit geschlossener, nicht ausgefüllter Pfeilspitze).

3. Dynamisches Verhalten & Sequenzablauf

Statisches Strukturdiagramm ohne explizite Interaktions- oder Sequenzpfade. Der funktionale Ablauf impliziert:

1. Zugriff auf globale Persistenz-Funktionen über das native Interface Persistency zur Öffnung eines Speichers (OpenFileStorage()), der ein Persistency::FileStorage-Objekt zurückgibt.
2. Verwaltung von Dateien und Dateizugriffen über Persistency::FileStorage. Das Öffnen einer Datei liefert typisierte Accessor-Instanzen (ReadAccessor oder ReadWriteAccessor).
3. Datenübertragung bzw. sequentieller/wahlfreier Lese- und Schreibzugriff über Methoden der Accessoren.
4. Datei- und Speicherwiederherstellung über entsprechende Recover*- bzw. Reset*-Operationen.

4. Normative Relevanz & Entwickler-Hinweise

• Persistency::FileStorage fungiert sowohl als C++-API als auch als Port-Interface («aapAPI,aapPortInterface») zur standardisierten Modellierung von Service-Ports und Manifesten.
• Methoden von Persistency sind unterstrichen dargestellt und damit als statische Methoden der Schnittstelle definiert.
• Datei-Streams bzw. Puffer werden über spezialisierte Zugriffsobjekte gekapselt (ReadAccessor für Leseoperationen, ReadWriteAccessor für kombinierte Lese-/Schreibzugriffe).
• Transaktions- bzw. Flush-Garantien für Dateiinhalte werden über SyncToFile() adressiert.