FileObserver 是一个用来监听文件变化的抽象类,子类必须实 onEvent(int, String) 事件处理的方法。由于最近做了两个项目都用上就查阅了官方文档,写下这篇文章记录一下。
每一个 FileObserver 实例用来监听一个文件或者文件夹,当文件夹被监听时,任意子文件或文件夹的访问或修改都会触发事件。注意:FileObserver 不能监听到二级子文件夹或文件的变化。
所有常量 (可监听的事件)
Constant
描述
ACCESS
文件被读取
ATTRIB
权限 所有者 时间戳被修改
CLOSE_NOWRITE
打开并关闭了文件夹(未修改)
CLOSE_WRITE
打开并关闭了文件夹(有修改)
CREATE
监控的文件夹下创建了子文件或文件夹
DELETE
监控的文件夹下删除了子文件或文件夹
DELETE_SELF
被监控的文件或文件夹被删除,监控停止
MODIFY
文件被修改
MOVED_FROM
被监控文件夹有子文件或文件夹移走
MOVED_TO
被监控文件夹有子文件或文件夹被移入
MOVE_SELF
被监控文件或文件夹被移动
OPEN
文件或文件夹被打开
ALL_EVENTS
以上所有事件
方法说明
Public constructors 构造方法
FileObserver(String path, int mask)
为 path 路径的文件或者文件夹创建一个文件观察者。
path–文件路径 , mask–监听事件类型
FileObserver(String path)
创建一个文件观察者
== FileObserver(path, FileObserver.ALL_EVENTS).)
Public methods 公共方法
onEvent(int event, String path) —–void
抽象方法,当监听到文件变化会回调此方法
event 事件类型 , path 触发事件的文件相对监听文件的路径( 某些事件 path 可能为 null , 像监听的是一个文件,或者 MOVE_SELF 等事件)
startWatching( ) —-void
开始监听
stopWatching( ) —–void
结束监听
基本用法示例
// 创建一个 FileObserver 监听文件夹变化
TestFileObserver testFileObserver = new TestFileObserver("/sdcard/Download/File");
// 开始监听
testFileObserver.startWatching();
// TestFileObserver 文件观察类
class TestFileObserver extends FileObserver {
// path 为 需要监听的文件或文件夹
public TestFileObserver(String path) {
super(path,FileObserver.ALL_EVENTS);
}
@Override
public void onEvent(int event, String path) {
// 如果文件修改了 打印出文件相对监听文件夹的位置
if(event==FileObserver.MODIFY){
Log.d("edong",path);
}
}
}
上述代码只是一个简单用法的介绍,在我工作的项目中用到的情况是
Android 底层实现了一套唤醒机制,当设备唤醒时底层会将唤醒状态,唤醒角度等值写入一个文件。应用层使用 FileObserver 来监听这个文件,当文件变化时认为设备被唤醒,就去读取唤醒相关的数值。