Java WatchService フォルダ監視｜変更を検知する方法と実装例

Java：フォルダ監視（watch service）で変更を検知する方法

ファイル監視は、ログの更新検知、外部連携ファイルの受信待ち処理、バッチ処理のトリガーなど、業務システムやツール作成で頻繁に必要になる機能です。
Javaには標準で**WatchService API**が用意されており、追加ライブラリなしでフォルダの変更を監視できます。

本記事では、WatchService の基本的な使い方から、作りがちな落とし穴・例外パターンまでまとめています。

🔍 WatchService で検知できるイベント種類

イベント種類	内容
ENTRY_CREATE	ファイル・フォルダが作成されたタイミング
ENTRY_MODIFY	既存ファイルの更新
ENTRY_DELETE	削除時

※Windows と Linux では MODIFY の挙動が異なることがあります。
（例）Windows は保存時に複数回 MODIFY が発生しがちです。

📌 基本サンプル：フォルダ監視してイベントを表示するコード

import java.nio.file.*;
import static java.nio.file.StandardWatchEventKinds.*;

public class DirectoryWatcher {

    public static void main(String[] args) {
        try {
            // 監視対象フォルダを指定
            Path path = Paths.get("C:/tmp/watch_folder");

            // WatchService を生成
            WatchService watchService = FileSystems.getDefault().newWatchService();

            // 監視イベントを登録（作成、変更、削除）
            path.register(watchService, ENTRY_CREATE, ENTRY_MODIFY, ENTRY_DELETE);

            System.out.println("監視開始: " + path);

            while (true) {
                // イベント待機（ブロッキング）
                WatchKey key = watchService.take();

                for (WatchEvent<?> event : key.pollEvents()) {
                    WatchEvent.Kind<?> kind = event.kind();
                    Path fileName = (Path) event.context();

                    System.out.println("検知: " + kind.name() + " - " + fileName);
                }

                // 次監視ループへ
                boolean valid = key.reset();
                if (!valid) {
                    System.out.println("監視対象が削除されたため終了します。");
                    break;
                }
            }

        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

import java.nio.file.*;

import static java.nio.file.StandardWatchEventKinds.*;

public class DirectoryWatcher {

public static void main(String[] args) {

try {

// 監視対象フォルダを指定

Path path = Paths.get("C:/tmp/watch_folder");

// WatchService を生成

WatchService watchService = FileSystems.getDefault().newWatchService();

// 監視イベントを登録（作成、変更、削除）

path.register(watchService, ENTRY_CREATE, ENTRY_MODIFY, ENTRY_DELETE);

System.out.println("監視開始: " + path);

while (true) {

// イベント待機（ブロッキング）

WatchKey key = watchService.take();

for (WatchEvent<?> event : key.pollEvents()) {

WatchEvent.Kind<?> kind = event.kind();

Path fileName = (Path) event.context();

System.out.println("検知: " + kind.name() + " - " + fileName);

}

// 次監視ループへ

boolean valid = key.reset();

if (!valid) {

System.out.println("監視対象が削除されたため終了します。");

break;

}

} catch (Exception e) {

e.printStackTrace();

}

💡 注意点・よくある落とし穴

問題点	よくある症状	対策
MODIFY が複数回発生	Windows で保存時に連続イベント	一定時間バッファリング or ハッシュ比較
サブフォルダの変更が検知されない	下層フォルダ変更が無視される	再帰登録が必要
監視対象フォルダが消えると止まる	例外またはreset()がfalseに	再監視ロジックを入れる
巨大ファイルアップロード中にイベント発火	完了前に処理が動く	サイズ・ロック状態チェックが必要

📌 サブフォルダも監視する再帰登録版サンプル

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

public class RecursiveWatcher {

    private final WatchService watchService;

    public RecursiveWatcher(Path root) throws IOException {
        watchService = FileSystems.getDefault().newWatchService();
        registerDirectory(root);
    }

    private void registerDirectory(Path path) throws IOException {
        Files.walk(path)
             .filter(Files::isDirectory)
             .forEach(p -> {
                 try {
                     p.register(watchService, ENTRY_CREATE, ENTRY_MODIFY, ENTRY_DELETE);
                     System.out.println("登録済み: " + p);
                 } catch (IOException e) {
                     throw new RuntimeException(e);
                 }
             });
    }

    public void watch() throws InterruptedException {
        while (true) {
            WatchKey key = watchService.take();
            for (WatchEvent<?> event : key.pollEvents()) {
                System.out.println(event.kind() + " → " + event.context());
            }
            key.reset();
        }
    }

    public static void main(String[] args) throws Exception {
        Path path = Paths.get("C:/tmp/watch_test");
        RecursiveWatcher watcher = new RecursiveWatcher(path);
        watcher.watch();
    }
}

import java.io.IOException;

import java.nio.file.*;

import static java.nio.file.StandardWatchEventKinds.*;

public class RecursiveWatcher {

private final WatchService watchService;

public RecursiveWatcher(Path root) throws IOException {

watchService = FileSystems.getDefault().newWatchService();

registerDirectory(root);

}

private void registerDirectory(Path path) throws IOException {

Files.walk(path)

.filter(Files::isDirectory)

.forEach(p -> {

try {

p.register(watchService, ENTRY_CREATE, ENTRY_MODIFY, ENTRY_DELETE);

System.out.println("登録済み: " + p);

} catch (IOException e) {

throw new RuntimeException(e);

}

});

}

public void watch() throws InterruptedException {

while (true) {

WatchKey key = watchService.take();

for (WatchEvent<?> event : key.pollEvents()) {

System.out.println(event.kind() + " → " + event.context());

}

key.reset();

}

public static void main(String[] args) throws Exception {

Path path = Paths.get("C:/tmp/watch_test");

RecursiveWatcher watcher = new RecursiveWatcher(path);

watcher.watch();

}

🧰 業務システムでの実運用ポイント

内容	推奨事項
CPU 負荷	take() で待機するため基本問題なし
ログ運用	必ずファイル名・日時で記録
存在確認	大容量ファイルの場合「完成」判定が必要
再起動バックアップ	JVMプロセスが停止すると監視も停止 → JP1等のジョブ管理併用推奨

まとめ

Java の WatchService を利用すると、追加ライブラリなしでフォルダの変更を自動検知できます。
サーバー間連携やバッチ処理トリガー、ログ監視ツールなど様々なシーンで有用ですが、OSごとの挙動差や複数イベント発火といった癖があるため、実装時には考慮する必要があります。

標準APIだけで完結するため小規模な監視機能であれば十分活用できます。

日	月	火	水	木	金	土
	1	2	3	4	5	6
7	8	9	10	11	12	13
14	15	16	17	18	19	20
21	22	23	24	25	26	27
28	29	30	31

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

Java WatchService フォルダ監視｜変更を検知する方法と実装例

Java：フォルダ監視（watch service）で変更を検知する方法

🔍 WatchService で検知できるイベント種類

📌 基本サンプル：フォルダ監視してイベントを表示するコード

💡 注意点・よくある落とし穴

📌 サブフォルダも監視する再帰登録版サンプル

🧰 業務システムでの実運用ポイント

まとめ

Ads by Google

「駑馬十駕」を信念に IT系情報を中心に調べた事をコツコツ綴っています。

Java：フォルダ監視（watch service）で変更を検知する方法

🔍 WatchService で検知できるイベント種類

📌 基本サンプル：フォルダ監視してイベントを表示するコード

💡 注意点・よくある落とし穴

📌 サブフォルダも監視する再帰登録版サンプル

🧰 業務システムでの実運用ポイント

まとめ

関連記事

Ads by Google

　関連記事