异常教程

Java 实例 – 获取文件修改时间（建议收藏）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

在 Java 开发中，文件操作是一项基础且高频的编程任务。无论是构建日志系统、文件管理工具，还是实现数据同步功能，获取文件修改时间都是开发者需要掌握的核心技能之一。本文将通过 Java 实例 – 获取文件修改时间 的主题，结合代码示例和实际场景，系统性地讲解这一知识点。从基础语法到进阶技巧，从异常处理到性能优化，逐步帮助读者构建完整的知识体系。

一、理解文件修改时间的基本概念

1.1 文件时间属性的含义

文件在操作系统中通常会记录三种时间戳：

  • 创建时间（Creation Time）：文件首次被创建的时间
  • 最后访问时间（Last Access Time）：文件最后一次被读取的时间
  • 最后修改时间（Last Modified Time）：文件内容最后一次被修改的时间

在 Java 中，我们主要关注 最后修改时间。这个时间戳可以用于判断文件是否被更新、监控文件变动状态，或在构建缓存机制时验证数据有效性。

比喻：
可以把文件修改时间想象为文件的“身份证”，记录它最后一次“被改变”的时刻。例如，当你编辑一个文档并保存时，这个时间戳就会被系统自动更新。

二、基础方法：使用 File 类获取文件修改时间

2.1 File 类的 lastModified() 方法

Java 标准库中的 File 类提供了获取文件修改时间的最直接方式。

代码示例：

import java.io.File;

public class FileTimeExample {
    public static void main(String[] args) {
        File file = new File("example.txt");
        if (file.exists()) {
            long lastModifiedTime = file.lastModified();
            System.out.println("文件最后修改时间：" + lastModifiedTime);
        } else {
            System.out.println("文件不存在");
        }
    }
}

2.2 时间戳的转换与展示

lastModified() 返回的是自 1970年1月1日 00:00:00 UTC 以来的毫秒数。为了更直观地展示，可以将其转换为日期格式：

改进代码：

import java.text.SimpleDateFormat;
import java.util.Date;

// 在 main 方法中添加
Date date = new Date(lastModifiedTime);
SimpleDateFormat formatter = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
String formattedTime = formatter.format(date);
System.out.println("格式化后的时间：" + formattedTime);

2.3 注意事项

  • 文件不存在时的处理：必须先通过 file.exists() 判断文件是否存在
  • 跨时区问题：SimpleDateFormat 默认使用本地时区，若需处理不同时区，需显式设置时区

三、进阶方法：Java NIO 的 Files 工具类

3.1 java.nio.file.Files 类的 readAttributes() 方法

从 Java 7 开始，引入了 NIO（New I/O）包，提供了更灵活和功能强大的文件操作方式。

代码示例：

import java.io.IOException;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;
import java.nio.file.attribute.BasicFileAttributes;

public class NioFileTimeExample {
    public static void main(String[] args) {
        Path path = Paths.get("example.txt");
        try {
            BasicFileAttributes attributes = Files.readAttributes(path, BasicFileAttributes.class);
            System.out.println("文件最后修改时间：" + attributes.lastModifiedTime());
        } catch (IOException e) {
            System.err.println("文件读取失败：" + e.getMessage());
        }
    }
}

3.2 NIO 方法的优势

  • 支持更多文件属性：如文件大小、隐藏属性等
  • 返回 FileTime 对象：比原始 long 类型更易读，且包含时区信息

比喻：
传统 File 类是“基础工具箱”，而 NIO 类似“专业工具套装”，提供更精细的操作能力。

四、异常处理与容错机制

4.1 文件路径无效的处理

如果文件路径错误或权限不足，程序会抛出 IOException。需通过 try-catch 块捕获异常：

示例代码：

try {
    // 文件操作代码
} catch (IOException e) {
    System.err.println("文件路径无效或权限不足");
}

4.2 空文件或特殊文件的处理

对于空文件（如 0 字节文件）或特殊文件（如符号链接），需额外判断：

代码扩展：

if (Files.exists(path) && Files.isRegularFile(path)) {
    // 执行操作
}

五、性能优化与最佳实践

5.1 避免频繁调用文件操作

频繁读取文件时间会增加 I/O 开销。可考虑缓存结果或使用观察者模式：

示例逻辑：

// 单次获取后缓存结果
long cachedTime = file.lastModified();
// 后续判断时直接比较
if (cachedTime != file.lastModified()) {
    // 文件被修改，执行响应操作
}

5.2 处理大文件目录的遍历

若需批量处理目录下的所有文件，可通过 Files.walk() 结合流式操作：

代码示例：

Files.walk(Paths.get("data/"))
     .filter(Files::isRegularFile)
     .forEach(path -> {
         try {
             BasicFileAttributes attr = Files.readAttributes(path, BasicFileAttributes.class);
             System.out.println(path + " 的最后修改时间：" + attr.lastModifiedTime());
         } catch (IOException e) {
             e.printStackTrace();
         }
     });

六、实际应用案例：文件监控工具

6.1 需求场景

构建一个简单的文件监控器，当指定目录下的文件被修改时，打印提示信息。

6.2 实现思路

  • 使用 WatchService 监控目录变动
  • 结合文件修改时间判断是否为内容修改

完整代码：

import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;

public class FileMonitor {
    public static void main(String[] args) throws IOException, InterruptedException {
        Path dir = Paths.get("monitor/");
        WatchService watcher = FileSystems.getDefault().newWatchService();
        dir.register(watcher, StandardWatchEventKinds.ENTRY_MODIFY);

        System.out.println("开始监控目录：" + dir);

        while (true) {
            WatchKey key = watcher.take();
            for (WatchEvent<?> event : key.pollEvents()) {
                WatchEvent.Kind<?> kind = event.kind();
                if (kind == StandardWatchEventKinds.OVERFLOW) {
                    continue;
                }
                Path modifiedFile = (Path) event.context();
                System.out.println("文件被修改：" + modifiedFile);
                
                // 获取并展示修改时间
                BasicFileAttributes attr = Files.readAttributes(dir.resolve(modifiedFile), BasicFileAttributes.class);
                System.out.println("最后修改时间：" + attr.lastModifiedTime());
            }
            boolean valid = key.reset();
            if (!valid) {
                break;
            }
        }
    }
}

6.3 扩展方向

  • 记录修改历史到数据库
  • 发送邮件或通知
  • 支持多目录监控

七、常见问题与解决方案

7.1 问题：时间显示为“1970-01-01 08:00:00”

原因：文件未被修改过（时间戳为0）或路径错误
解决：检查文件是否存在，并确认权限

7.2 问题：NIO 方法返回 null

原因：文件系统不支持该属性查询（如某些网络文件系统）
解决：添加异常处理逻辑

八、总结与展望

通过本文的学习，读者已掌握：

  1. 通过 File 类和 NIO 工具类获取文件修改时间的两种核心方法
  2. 异常处理与性能优化的最佳实践
  3. 在实际项目中构建文件监控工具的完整流程

随着 Java 版本的演进（如 Java 8 引入的 java.time 包），时间处理方式也在持续优化。建议读者关注新特性（如 Instant 和 ZonedDateTime 类），以进一步提升代码的可维护性和可扩展性。

掌握 Java 实例 – 获取文件修改时间 的核心技巧后，开发者可以将其应用于日志分析、版本控制、自动化备份等场景，为构建高效可靠的系统打下坚实基础。

最新发布

查看更多文章