WatchMonitor 是为了简化文件和目录监听而设计的一个工具类，它基于JDK7中的WatchService进行了封装优化。

多级目录监听

相较于原生WatchService仅支持一级目录监听，WatchMonitor允许用户自定义监听目录深度，能够监控多级子目录下的文件和目录变化。

延迟合并触发

当文件发生连续快速的修改时，WatchMonitor能够合并一定时间内同一文件的多次修改事件为单次触发，有效避免因频繁触发事件而导致的系统资源浪费和响应过于频繁的问题。

简洁易用的API

提供了易于使用的API，开发者仅需调用少量方法就能设置监听规则，无须关注底层WatchService复杂的注册机制。

多种事件监听

支持监听四种类型的事件，分别是ENTRY_MODIFY（修改）、ENTRY_CREATE（创建）、ENTRY_DELETE（删除）和OVERFLOW（事件溢出）。

多观察者模式

允许定义多个Watcher来响应同一个事件，这意味着不同的业务逻辑可以独立实现并绑定到同一个监听器上，通过WatcherChain进行管理和调用。

监听示例

• 用户可以指定监听特定事件类型，如仅监听文件修改事件。

• 使用WatchMonitor.create方法创建监听器，并通过setWatcher方法设置自定义的监听回调逻辑。

• 可以通过setMaxDepth方法设置监听目录的层级深度。

• 使用start方法启动监听。

/** * @desc：监听指定事件 * @param args @Return: void * @author: jones * @date: 2024/4/5 12:47 */File file = FileUtil.file("/Users/mac/logs/");// 这里只监听文件或目录的修改事件WatchMonitor watchMonitor = WatchMonitor.create(file, WatchMonitor.ENTRY_MODIFY);watchMonitor.setWatcher(    new Watcher() {      @Override      public void onCreate(WatchEvent<?> event, Path currentPath) {        Object obj = event.context();        Console.log("onCreate：{}-> {}", currentPath, obj);      }      @Override      public void onModify(WatchEvent<?> event, Path currentPath) {        Object obj = event.context();        Console.log("onModify：{}-> {}", currentPath, obj);      }      @Override      public void onDelete(WatchEvent<?> event, Path currentPath) {        Object obj = event.context();        Console.log("onDelete：{}-> {}", currentPath, obj);      }      @Override      public void onOverflow(WatchEvent<?> event, Path currentPath) {        Object obj = event.context();        Console.log("onOverflow：{}-> {}", currentPath, obj);      }    });// 设置监听目录的最大深入，目录层级大于制定层级的变更将不被监听，默认只监听当前层级目录watchMonitor.setMaxDepth(3);// 启动监听watchMonitor.start();

若要监听所有事件，可使用WatchMonitor.createAll方法，该方法接受一个文件对象和一个简单的Watcher实现作为参数，后者只需要覆盖关心的事件处理方法即可。

// 监听全部事件WatchMonitor.createAll(        file,        new SimpleWatcher() {          @Override          public void onModify(WatchEvent<?> event, Path currentPath) {            Console.log("EVENT modify");          }        })    .start();

为了防止文件修改时反复触发过多事件，还提供了DelayWatcher类，它可以合并短期内同一流水线的修改事件，在规定的时间窗口内仅触发一次处理动作。

总之，WatchMonitor极大地提升了我们对文件和目录变更事件处理的便捷性和灵活性，同时也增强了系统的稳定性和响应效率。在诸如实时同步、日志监控、配置热更新等场景中尤为实用。