Agrupa registros de data/hora e informações de estado sobre a origem e as alterações de um arquivo no módulo adaptativo de persistência.
GERADO POR IAnão revisadoModelo: gemini-3.8-flash-medium · Esforço: medium · Temperatura: não controlável · Prompt: c3acbafda95fProcedênciaPerguntas em aberto (3)
traduzido do guia alemãogemini-3.8-flash-low · 2026-10-13 · Original em alemão
Agrupa registros de data/hora e informações de estado sobre a origem e as alterações de um arquivo no módulo adaptativo de persistência.
A estrutura ara::per::FileInfo serve como contêiner de metadados para arquivos persistentes e é retornada por GetFileInfo. Ela fornece registros de data/hora baseados em UTC em nanossegundos para criação [SWS_PER_00441], modificação [SWS_PER_00442] e acesso [SWS_PER_00443], bem como informações de status sobre a geração [SWS_PER_00444] e a última edição [SWS_PER_00445]. Como tipo de dados passivo, ela está sujeita à semântica de valor da aplicação e não oferece sincronização de thread própria.
Contexto
A estrutura ara::per::FileInfo serve no módulo per (Persistency) da AUTOSAR Adaptive Platform como portadora estruturada de dados para metadados administrativos de arquivos. Em operações de arquivo processadas por meio das interfaces do arquivo de cabeçalho ara/per/file_storage.h, o módulo de persistência separa as informações de gerenciamento do conteúdo real dos arquivos. A estrutura é fornecida como resultado da operação GetFileInfo e assume a função de um objeto de transferência de dados (Data Transfer Object) entre a camada de persistência e a aplicação chamadora.
Em termos de conteúdo, FileInfo reúne duas categorias de atributos: dados precisos de registro temporal e informações qualitativas de estado sobre a criação e a manutenção de um arquivo. As informações temporais incluem o momento de criação [SWS_PER_00441], o momento de modificação [SWS_PER_00442] e o momento do último acesso [SWS_PER_00443]. Esses metadados são complementados por características descritivas de estado que descrevem como e por quem o arquivo foi criado [SWS_PER_00444] e modificado pela última vez [SWS_PER_00445].
Ciclo de vida
Como estrutura C++ passiva (struct), FileInfo não possui lógica de estado independente nem ciclo de vida ativo em tempo de execução. A instanciação ocorre tipicamente dentro da implementação de persistência durante a execução de GetFileInfo. Nesse processo, os metadados são lidos do sistema de arquivos subjacente e transferidos para os campos de dados da estrutura. A entrega à aplicação ocorre presumivelmente como uma cópia de valor ou empacotada em um tipo de resultado, transferindo a propriedade e a responsabilidade pelo ciclo de vida integralmente para o componente chamador. Pergunta Q-f5a9cf72c47f805e (aberta)
O tempo de vida de uma instância de FileInfo está vinculado ao escopo no qual a aplicação declara a variável; ao sair do escopo, a estrutura é liberada automaticamente. Como FileInfo encapsula apenas campos de dados puros e não fornece mecanismos internos de sincronização, a estrutura não é thread-safe: no caso de acesso concorrente de múltiplas threads à mesma instância, é provável que seja necessária uma sincronização explícita do lado da aplicação, desde que pelo menos um acesso seja de gravação. Pergunta Q-139f5e8f58d3fe07 (aberta)
Caminho de utilização
O fluxo típico de uso de FileInfo inclui a consulta das informações do arquivo por meio da interface de armazenamento de arquivos e a subsequente avaliação dos atributos pela aplicação. A aplicação inicia a consulta chamando GetFileInfo com a especificação do arquivo de destino. Após o retorno bem-sucedido, todos os metadados ficam disponíveis diretamente por meio das variáveis-membro públicas.
Durante a avaliação, a aplicação lê os registros de data/hora:
creationTime representa o momento da criação do arquivo em nanossegundos desde 01/01/1970 UTC (época Unix) [SWS_PER_00441].
modificationTime indica o momento da última alteração de conteúdo no mesmo formato de nanossegundos [SWS_PER_00442].
accessTime documenta o momento do último acesso de leitura ou gravação em nanossegundos desde 1970-01-01 UTC [SWS_PER_00443].
Além da classificação temporal, a aplicação verifica os atributos fileCreationState[SWS_PER_00444] e fileModificationState[SWS_PER_00445]. Esses valores de enumeração indicam sob quais condições e por quem o arquivo foi criado ou modificado. Isso permite que a aplicação verifique se um arquivo foi gerado regularmente em operação produtiva, durante um processo de recuperação ou por meio de um procedimento de atualização, antes de executar outras operações de leitura ou gravação no conteúdo do arquivo.
Este guia de classe foi gerado por um assistente de IA com base na especificação AUTOSAR para a versão R25-11.
gemini-3.8-flash-low· 2026-10-13 · Original em alemão