鸿蒙OS FileWatcher

FileWatcher

java.lang.Object

|---ohos.utils.FileWatcher

public class FileWatcher
extends Object

提供监控指定文件目录状态变化的能力。

要监控文件，首先需要实现 FileWatcher.EventHandler 类，该类处理被监控文件目录的状态变化事件。 然后，您应该使用 addWatch(java.nio.file.Path,ohos.utils.FileWatcher.EventHandler,boolean,java.nio.file.WatchEvent.Kind...) 方法添加要监视的文件目录和 关联的事件处理程序。 当指定目录中的文件发生更改时，将触发事件处理程序来处理该事件。

FileWatcher 支持 StandardWatchEventKinds 中定义的以下事件：

• StandardWatchEventKinds.ENTRY_CREATE
• StandardWatchEventKinds.ENTRY_DELETE
• StandardWatchEventKinds.ENTRY_MODIFY

嵌套类摘要

修饰符和类型	类	描述
static interface	FileWatcher.EventHandler	提供处理文件事件的处理程序。

构造函数摘要

构造函数	描述
FileWatcher()	默认构造函数用于创建文件观察者实例。

方法总结

修饰符和类型	方法	描述
void	addWatch(Path directory, FileWatcher.EventHandler eventHandler, boolean isRecursive, WatchEvent.Kind<?>... events)	添加监视程序以监视指定的文件目录。

从类 java.lang.Object 继承的方法
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

构造函数详细信息

FileWatcher

public FileWatcher()

默认构造函数用于创建文件观察者实例。

Throws:

Throw名称	Throw描述
RuntimeException	如果没有文件观察器服务，则引发此异常。

方法详情

addWatch

public void addWatch(Path directory, FileWatcher.EventHandler eventHandler, boolean isRecursive, WatchEvent.Kind<?>... events)

添加监视程序以监视指定的文件目录。

您可以指定要监视的文件事件。 如果未指定事件，则监视文件目录上的所有事件。

参数：

参数名称	参数描述
directory	指示要监视的文件目录。
eventHandler	指示要添加指定文件目录的事件处理程序。
isRecursive	指定是否递归监视指定的文件目录。

Throws:

Throw名称	Throw描述
NullPointerException	如果 directory 或 eventHandler 为 null，则引发此异常。
RuntimeException	如果添加观察者失败，就会引发此异常。