Java文件监视（Java File Watch）[编辑 | 编辑源代码]

Java文件监视是Java NIO（New I/O）包中的一个重要功能，它允许程序监控文件系统中的目录及其子目录的变化，例如文件的创建、修改和删除。这在需要实时响应文件系统变化的应用程序（如日志监控、配置文件热加载等）中非常有用。

概述[编辑 | 编辑源代码]

Java文件监视的核心类是

java.nio.file.WatchService

，它提供了一种高效的方式来监听文件系统事件。通过注册一个目录到

WatchService

，程序可以接收该目录下文件或子目录的变更通知。

主要事件类型包括：

```
ENTRY_CREATE
```
：文件或目录被创建
```
ENTRY_MODIFY
```
：文件或目录被修改
```
ENTRY_DELETE
```
：文件或目录被删除
```
OVERFLOW
```
：表示事件可能丢失或丢弃

基本用法[编辑 | 编辑源代码]

以下是一个简单的Java文件监视示例，展示如何监听目录中的文件变化：

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

public class FileWatcherExample {
    public static void main(String[] args) throws IOException, InterruptedException {
        // 1. 获取WatchService实例
        WatchService watchService = FileSystems.getDefault().newWatchService();

        // 2. 注册要监视的目录和事件类型
        Path dir = Paths.get("C:/watch_dir");
        dir.register(watchService, 
            StandardWatchEventKinds.ENTRY_CREATE,
            StandardWatchEventKinds.ENTRY_MODIFY,
            StandardWatchEventKinds.ENTRY_DELETE);

        System.out.println("开始监视目录: " + dir);

        // 3. 无限循环等待事件
        while (true) {
            WatchKey key = watchService.take(); // 阻塞直到事件发生

            // 4. 处理事件
            for (WatchEvent<?> event : key.pollEvents()) {
                WatchEvent.Kind<?> kind = event.kind();

                if (kind == StandardWatchEventKinds.OVERFLOW) {
                    continue; // 忽略溢出事件
                }

                // 获取触发事件的文件名
                WatchEvent<Path> ev = (WatchEvent<Path>) event;
                Path filename = ev.context();

                System.out.printf("事件类型: %s, 文件名: %s%n", kind.name(), filename);
            }

            // 5. 重置key，继续监听
            boolean valid = key.reset();
            if (!valid) {
                break; // 如果目录不再可访问，退出循环
            }
        }
    }
}

输出示例：

开始监视目录: C:\watch_dir
事件类型: ENTRY_CREATE, 文件名: test.txt
事件类型: ENTRY_MODIFY, 文件名: test.txt
事件类型: ENTRY_DELETE, 文件名: test.txt

工作原理[编辑 | 编辑源代码]

Java文件监视的实现依赖于操作系统提供的文件系统通知机制：

Windows使用ReadDirectoryChangesW API
Linux使用inotify
macOS使用FSEvents

高级特性[编辑 | 编辑源代码]

递归监视[编辑 | 编辑源代码]

默认情况下，

WatchService

只监视直接注册的目录，不包含子目录。要实现递归监视，需要手动注册所有子目录：

public static void registerAll(Path start, WatchService watcher) throws IOException {
    Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
        @Override
        public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) 
            throws IOException {
            dir.register(watcher, 
                StandardWatchEventKinds.ENTRY_CREATE,
                StandardWatchEventKinds.ENTRY_MODIFY,
                StandardWatchEventKinds.ENTRY_DELETE);
            return FileVisitResult.CONTINUE;
        }
    });
}

事件过滤[编辑 | 编辑源代码]

可以通过检查事件上下文来过滤特定文件：

if (filename.toString().endsWith(".log")) {
    System.out.println("日志文件变更: " + filename);
}

实际应用案例[编辑 | 编辑源代码]

案例1：配置文件热加载[编辑 | 编辑源代码]

当应用程序的配置文件被修改时，自动重新加载配置而无需重启应用。

public class ConfigReloader {
    private WatchService watchService;
    private Path configFile;
    
    public ConfigReloader(Path configFile) throws IOException {
        this.configFile = configFile;
        this.watchService = FileSystems.getDefault().newWatchService();
        configFile.getParent().register(watchService, StandardWatchEventKinds.ENTRY_MODIFY);
    }
    
    public void startWatching() {
        new Thread(() -> {
            try {
                while (true) {
                    WatchKey key = watchService.take();
                    for (WatchEvent<?> event : key.pollEvents()) {
                        if (event.context().equals(configFile.getFileName())) {
                            reloadConfig();
                        }
                    }
                    key.reset();
                }
            } catch (Exception e) {
                e.printStackTrace();
            }
        }).start();
    }
    
    private void reloadConfig() {
        System.out.println("检测到配置文件变更，重新加载...");
        // 实现配置重新加载逻辑
    }
}