Class FileTailer

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

public final class FileTailer extends Object
文件 tail -f 监控:虚拟线程增量读文件追加内容,按行回调,支持日志轮转自动重开。

特性:

  • 从文件尾部或文件头(跳过前 N 行)开始跟踪;
  • 行切分支持 LF / CRLF;
  • 编码自动探测 UTF-8 / GBK(也可显式指定);
  • 文件被替换(rename + 新建)后自动重开新通道并触发 TailerOptions.onRotate();
  • 文件被删除时按 TailerOptions.stopOnDelete() 决定停止或等待重建。

回调在虚拟线程上执行;单行回调抛异常不影响后续行。

  • Method Details

    • start

      public static FileTailer start(Path file, Consumer<String> lineListener)
      从文件尾部开始跟踪。
      Parameters:
      file - 待跟踪文件
      lineListener - 行回调(虚拟线程执行)
      Returns:
      FileTailer
    • start

      public static FileTailer start(Path file, Consumer<String> lineListener, TailerOptions options)
      按选项跟踪文件。
      Parameters:
      file - 待跟踪文件
      lineListener - 行回调(虚拟线程执行)
      options - tail 选项
      Returns:
      FileTailer
    • stop

      public void stop()
      停止跟踪(幂等)。
    • isRunning

      public boolean isRunning()
      是否正在跟踪。
      Returns:
      是否运行