Figure 5.2: Interfaces Provided by Persistency to Other Functional Clusters

1. Diagrammtyp & Architektur-Kontext

UML-Klassendiagramm und Komponentendiagramm der AUTOSAR Adaptive Platform (Spezifikation AUTOSAR_AP_SWS_Persistency, Release R23-11). Das Diagramm modelliert die statischen Port-Abhängigkeiten und Schnittstellenbeziehungen des Functional Clusters Persistency für den dateibasierten Zugriff (FileStorage) gegenüber anderen plattforminternen, daemon-basierten Funktionsclustern. Es spezifiziert den strukturellen Rahmen, über den Plattformdienste über AUTOSAR-Port-Schnittstellen (Required Ports) persistenten Dateizugriff anfordern.

2. Komponenten, Entitäten & Schnittstellen

Zentrale Entität ist die Schnittstelle «aapAPI,aapPortInterface» Persistency::FileStorage mit vollqualifiziertem Namensraum. Sie deklariert die öffentlichen Operationen:

• DeleteFile()
• FileExists()
• GetAllFileNames()
• GetCurrentFileSize()
• GetFileInfo()
• OpenFileReadOnly(): ReadAccessor
• OpenFileReadWrite(): ReadWriteAccessor
• OpenFileWriteOnly(): ReadWriteAccessor
• RecoverFile()
• ResetFile()

Dienstanbieter ist der Funktionscluster «aapFunctionalCluster» Persistency (daemon-based), der die Schnittstelle über eine UML-Interface-Realization (gestrichelte Linie mit geschlossener, nicht ausgefüllter Dreiecksspitze) implementiert. Als Dienstkonsumenten greifen zwei daemon-basierte funktionale Cluster über gerichtete Abhängigkeiten mit den Stereotypen «use» und «aapRequiredPort» auf die Schnittstelle zu:

1. «aapFunctionalCluster» Diagnostic Management (im Klassensymbol typografisch verkürzt als «aapFunctionalClust...»),
2. «aapFunctionalCluster» Update and Configuration Management.

3. Dynamisches Verhalten & Sequenzablauf

Statisches Strukturmodell ohne explizite Ablauf- oder Zeitpfade. Die deklarierten Methoden definieren die Schnittstellensequenz für Dateioperationen: Dienstkonsumenten prüfen die Dateiexistenz (FileExists()) oder ermitteln das Dateiinventar (GetAllFileNames()), rufen Datei-Metadaten ab (GetFileInfo(), GetCurrentFileSize()) und erzeugen über OpenFileReadOnly(), OpenFileReadWrite() oder OpenFileWriteOnly() Zugriffs-Handler (ReadAccessor bzw. ReadWriteAccessor) für Lese- und Schreiboperationen. Zur Bereinigung dient DeleteFile(). Bei erkannten Datenfehlern oder Rollbacks initiieren Konsumenten über RecoverFile() die Wiederherstellung redundanter Daten oder über ResetFile() das Zurücksetzen auf den Werks- bzw. Auslieferungszustand.

4. Normative Relevanz & Entwickler-Hinweise

Normativ verbindlich ist die Modellierung typisierter Port-Interfaces zwischen den beteiligten Plattformclustern. Diagnostic Management und Update and Configuration Management müssen entsprechende «aapRequiredPort»-Verbindungen im Manifest deklarieren, um Dateiressourcen deterministisch zu verwalten. Eine herstellerspezifische Besonderheit in R23-11 ist die Methodensignatur von OpenFileWriteOnly(), die fälschlicherweise bzw. historisch bedingt einen ReadWriteAccessor statt eines reinen WriteAccessor zurückgibt, sowie die explizite Namensraumpräfixung Persistency::FileStorage im Schnittstellennamen.