struct ara::per::FileInfo

Die Struktur ara::per::FileInfo dient als Metadaten-Container für persistente Dateien und wird von GetFileInfo zurückgegeben. Sie stellt UTC-basierte Zeitstempel in Nanosekunden für Erstellung [SWS_PER_00441], Modifikation [SWS_PER_00442] und Zugriff [SWS_PER_00443] sowie Statusangaben zu Entstehung [SWS_PER_00444] und letzter Bearbeitung [SWS_PER_00445] bereit. Als passiver Datentyp unterliegt sie der Wertsemantik der Anwendung und bietet keine eigene Thread-Synchronisation.

mehr ›

Kontext

Die Struktur ara::per::FileInfo dient im Modul per (Persistency) der AUTOSAR Adaptive Platform als strukturierter Datenträger für administrative Datei-Metadaten. Bei Dateioperationen, die über die Schnittstellen der Header-Datei ara/per/file_storage.h abgewickelt werden, trennt das Persistenzmodul die Verwaltungsinformationen von den eigentlichen Dateiinhalten. Die Struktur wird als Ergebnis der Operation GetFileInfo bereitgestellt und übernimmt die Funktion eines Datenübertragungsobjekts (Data Transfer Object) zwischen der Persistenzschicht und der aufrufenden Anwendung.

Inhaltlich fasst FileInfo zwei Kategorien von Attributen zusammen: präzise zeitliche Protokolldaten und qualitative Zustandsinformationen über die Entstehung und Pflege einer Datei. Zu den Zeitangaben zählen der Erstellungszeitpunkt [SWS_PER_00441], der Modifikationszeitpunkt [SWS_PER_00442] sowie der Zeitpunkt des letzten Zugriffs [SWS_PER_00443]. Ergänzt werden diese Metadaten durch deskriptive Zustandsmerkmale, die beschreiben, wie und durch wen die Datei angelegt [SWS_PER_00444] sowie zuletzt verändert wurde [SWS_PER_00445].

Lebenszyklus

Als passive C++-Struktur (struct) besitzt FileInfo keine eigenständige Zustandslogik und keinen aktiven Laufzeit-Lebenszyklus. Die Instanziierung erfolgt typischerweise innerhalb der Persistenz-Implementierung während der Ausführung von GetFileInfo. Dabei werden die Metadaten aus dem zugrunde liegenden Dateisystem ausgelesen und in die Datenfelder der Struktur übertragen. Die Auslieferung an die Anwendung erfolgt vermutlich als Wertkopie oder verpackt in einem Ergebnis-Typ, womit die Eigentümerschaft und die Verantwortung für den Lebenszyklus vollständig auf die aufrufende Komponente übergehen. Frage Q-f5a9cf72c47f805e (offen)

Die Lebensdauer einer FileInfo-Instanz ist an den Gültigkeitsbereich gebunden, in dem die Anwendung die Variable deklariert; bei Verlassen des Gültigkeitsbereichs wird die Struktur automatisch freigegeben. Da FileInfo reine Datenfelder kapselt und keine internen Synchronisationsmechanismen bereitstellt, ist die Struktur nicht thread-sicher: Bei einem nebenläufigen Zugriff mehrerer Threads auf dieselbe Instanz dürfte anwendungsseitig eine explizite Synchronisation erforderlich sein, sofern mindestens ein Zugriff schreibend erfolgt. Frage Q-139f5e8f58d3fe07 (offen)

Nutzungspfad

Der typische Ablauf zur Nutzung von FileInfo umfasst die Abfrage der Dateiinformationen über die Dateispeicher-Schnittstelle und die anschließende Auswertung der Attribute durch die Anwendung. Die Anwendung initiiert die Abfrage über den Aufruf von GetFileInfo unter Angabe der Zieldatei. Nach erfolgreicher Rückgabe stehen sämtliche Metadaten direkt über die öffentlichen Member-Variablen zur Verfügung.

Sequenzdiagramm: Typischer Ablauf zum Abruf und zur Auswertung von Datei-Metadaten über GetFileInfo. Quellen: [SWS_PER_00441], [SWS_PER_00442], [SWS_PER_00443], [SWS_PER_00444], [SWS_PER_00445].

Bei der Auswertung liest die Anwendung die Zeitstempel aus:

• creationTime repräsentiert den Zeitpunkt der Dateierstellung in Nanosekunden seit dem 01.01.1970 UTC (Unix-Epoche) [SWS_PER_00441].
• modificationTime gibt den Zeitpunkt der letzten inhaltlichen Änderung im selben Nanosekunden-Format an [SWS_PER_00442].
• accessTime dokumentiert den Zeitpunkt des letzten Lese- oder Schreibzugriffs in Nanosekunden seit 1970-01-01 UTC [SWS_PER_00443].

Zusätzlich zur zeitlichen Einordnung prüft die Anwendung die Attribute fileCreationState [SWS_PER_00444] und fileModificationState [SWS_PER_00445]. Diese Aufzählungswerte geben an, unter welchen Bedingungen und durch wen die Datei angelegt oder modifiziert wurde. Dies erlaubt es der Anwendung zu verifizieren, ob eine Datei regulär im Produktivbetrieb, während eines Wiederherstellungsprozesses oder durch ein Aktualisierungsverfahren erzeugt wurde, bevor weitere Lese- oder Schreiboperationen auf den Dateiinhalt ausgeführt werden.