Class WatchDir

java.lang.Object
com.sure.tool.io.WatchDir

public final class WatchDir extends Object
目录监听(JDK WatchService 封装):虚拟线程轮询事件,支持递归注册、路径过滤与事件类型选择。

特性:

  • 递归监听子目录,新目录创建后动态注册;
  • 路径过滤器(后缀/前缀/正则等)与事件类型选择;
  • OVERFLOW(事件丢失)单独上报;
  • 回调在虚拟线程上执行,单次回调异常不影响后续事件。
  • Method Details

    • watch

      public static WatchDir watch(Path dir, DirListener listener)
      递归监听目录。
      Parameters:
      dir - 待监听目录
      listener - 事件回调(虚拟线程执行)
      Returns:
      WatchDir
    • watch

      public static WatchDir watch(Path dir, DirListener listener, WatchOptions... options)
      按选项监听目录。
      Parameters:
      dir - 待监听目录
      listener - 事件回调(虚拟线程执行)
      options - 监听选项
      Returns:
      WatchDir
      Throws:
      RuntimeException - 目录不存在或注册失败
    • stop

      public void stop()
      停止监听(幂等)。
    • isRunning

      public boolean isRunning()
      是否正在监听。
      Returns:
      是否运行