结构体 ara::per::FileInfo

结构 ara::per::FileInfo 用作持久性文件的元数据容器，并由 GetFileInfo 返回。它提供用于创建 [SWS_PER_00441]、修改 [SWS_PER_00442] 和访问 [SWS_PER_00443] 的以纳秒为单位的基于 UTC 的时间戳，以及关于产生 [SWS_PER_00444] 和最后编辑 [SWS_PER_00445] 的状态信息。作为被动数据类型，它遵循应用程序的值语义，不提供自身的线程同步。

更多 ›

上下文

结构 ara::per::FileInfo 在 AUTOSAR Adaptive Platform 的模块 per（Persistency）中用作管理性文件元数据的结构化数据载体。对于通过头文件 ara/per/file_storage.h 的接口处理的文件操作，持久化模块将管理信息与实际文件内容分离。该结构作为操作 GetFileInfo 的结果提供，并在持久层与调用应用程序之间承担数据传输对象（Data Transfer Object）的功能。

在内容上，FileInfo 概括了两类属性：精确的时间记录数据，以及关于文件创建和维护的定性状态信息。时间信息包括创建时间 [SWS_PER_00441]、修改时间 [SWS_PER_00442] 以及最后访问时间 [SWS_PER_00443]。这些元数据通过描述性状态特征进行补充，这些特征描述了文件如何以及由谁创建 [SWS_PER_00444] 以及最后被修改 [SWS_PER_00445]。

生命周期

作为被动 C++ 结构（struct），FileInfo 没有独立的状态逻辑，也没有活动运行时生命周期。实例化通常在执行 GetFileInfo 期间在持久化实现内部发生。在此过程中，从底层文件系统读取元数据并传输到结构的数据字段中。向应用程序的传递推测是以值副本形式或打包在结果类型中进行，从而所有权和生命周期职责完全转移给调用组件。 问题 Q-f5a9cf72c47f805e (未决)

FileInfo 实例的生命周期绑定在应用程序声明变量的作用域；在离开作用域时，该结构会自动释放。由于 FileInfo 封装了纯数据字段且不提供内部同步机制，因此该结构不是线程安全的：当多个线程并发访问同一实例时，只要至少有一个访问是写入访问，应用程序端应该就需要显式同步。 问题 Q-139f5e8f58d3fe07 (未决)

使用路径

使用 FileInfo 的典型流程包括通过文件存储接口查询文件信息，随后由应用程序评估属性。应用程序通过调用 GetFileInfo 并指定目标文件来发起查询。成功返回后，所有元数据均可直接通过公共成员变量获取。

时序图：通过 GetFileInfo 获取和评估文件元数据的典型流程。来源：[SWS_PER_00441]、[SWS_PER_00442]、[SWS_PER_00443]、[SWS_PER_00444]、[SWS_PER_00445]。

在评估时，应用程序读取时间戳：

• creationTime 表示自 1970-01-01 UTC（Unix 纪元）以来以纳秒为单位的文件创建时间点 [SWS_PER_00441]。
• modificationTime 以相同的纳秒格式指示最后一次内容更改的时间点 [SWS_PER_00442]。
• accessTime 记录自 1970-01-01 UTC 以来以纳秒为单位的最后一次读取或写入访问时间点 [SWS_PER_00443]。

除了时间归属之外，应用程序还会检查属性 fileCreationState [SWS_PER_00444] 和 fileModificationState [SWS_PER_00445]。这些枚举值指示了在何种条件下以及由谁创建或修改了文件。这允许应用程序在对文件内容执行进一步读取或写入操作之前，验证文件是在生产运行中、恢复过程中还是通过更新过程常规创建的。