有些情况下,我们难免需要监控一些文件的变化情况,这该如何实现呢?自然而然的我们会想要利用一个线程,每个一段时间便去看看文件的情况,这种方式本质上就是基于时间调度的轮训.虽然能够实现我们的需求,但是这种方式只适合文件经常变化的情况,其他情况下都非常低效,并且可能丢掉某些类型的变化,也就是说,这种方式无法实现实时的文件监控.
inotify简介
那还有其他的方式么?熟悉linux的童鞋应该记得从linux kernel 2.6.13开始引入inotify机制,用于通知用户相关文件变化情况:任何一个文件发生某种变化,都会产生一个相应的文件事件.
我们不仅好奇,文件的哪些事件能够被监控,也就是说inotify支持监控文件的哪些变化呢?继续往下看.
可监控事件类型
目前inotify能够监控的以下文件变化事件:
| 事件类型 | 说明 |
|---|---|
| IN_ACCESS | 文件被访问 |
| IN_MODIFY | 文件被修改 |
| IN_ATTRIB | 文件属性被修改 |
| IN_CLOSE_WRITE | 可写文件被关闭 |
| IN_CLOSE_NOWRITE | 不可写文件被关闭 |
| IN_CLOSE | 文件被关闭,也就以上两者的集合 |
| IN_OPEN | 文件被打开 |
| IN_MOVED_FROM | 文件被移来 |
| IN_MOVED_TO | 文件被移走 |
| IN_MOVE | 文件被移动,也就是以上两者的集合 |
| IN_CREATE | 文件被创建 |
| IN_DELETE | 文件被删除 |
| IN_DELETE_SELF | 自删除,也就是一个可执行文件在执行时尝试删除自己 |
| IN_MOVE_SELF | 自移动,也就是一个可执行文件在执行时尝试移动自己 |
| IN_UNMOUNT | 宿主文件系统被卸载 |
API说明
不难发现,inotify对文件监控的支持是非常全面的,足以满足我们绝大部门的需求.接下来,我们对innotify的api做个简单的说明:
| 方法 | 说明 |
|---|---|
| inotify_init | 用于创建一个inotify实例,返回一个指向该实例的的文件描述符 |
| inotify_add_watch | 添加对文件或者目录的监控,可以指定需要监控那些文件变化事件 |
| inotify_rm_watch | 从监控列表中移除监控文件或者目录 |
| read | 读取事件信息 |
| close | 关闭文件描述符,并会移除所有在该描述符上监控 |
事件通知
在可监控事件中,我们已经了解inotify支持的文件事件.现在来看看这些当这些文件事件产生时,其发出通知的结构.在inotify中,事件通知结构用结构体inotify_event表示:
struct inotify_event
{
int wd; //监控目标的watch描述符
uint32_t mask; //事件掩码
uint32_t cookie; //事件同步cookie
uint32_t len; //name字符串的长度
char name __flexarr; //被监视目标的路径名
};
这里需要记住一点:name字段并不是什么时候都有的:只有要监控的目标是一个目录,且产生的事件与目录内部的文件或子目录相关,且与目录本身无关时才会提供相应的name字段.
cookie用于关联被观察对象的IN_MOVED_FROM事件和IN_MOVED_TO 事件.
使用流程
了解以上之后,那么该怎么用呢?要实现对文件或者目录的监控需要经过以下几个步骤:
- 创建inotify实例
在应用程序中,首先需要创建inotify实例:
int fd=inotify_init();
该方法创建了一个inotify实例,并返回一个文件描述符以便能够通过这个描述符访问到inotify实例.
- 添加监控
在获得inotify实例产生的文件描述符之后,我们就可以为其添加watch.另外,我们也可以使用mask(事件掩码)来设置我们想监控的事件类型.当然可以我们也可以使用IN_ALL_EVENTS监控所有事件:
int wd=inotify_add_watch(fd,path,mask)
补充:
此处的fd即inotify_init()方法返回的文件描述符.每个文件描述符都有一个排序的事件序列.path则是需要监控的文件或者目录的路径.mask则是事件掩码,它表示应用程序对哪些事件感兴趣.
文件系统产生的事件由Watch对象来管理,该方法将返回的wd就是Watch对象的句柄.
- 等待事件与循环处理
在为inotify实例添加watch之后,接下来就是等待事件了.为了能不断的处理事件,我们将其放在循环体当中.
在循环中,通过read()方法可以一次获得多个事件.在没有事件产生时,read()被阻塞,一旦有事件产生,那么我们就可以读取事件到的我们设置的事件数组中,然后对事件数组进行处理,其简单代码如下:
//事件数组,自定义设置,这里我们设置为128
char event_buf[128];
while(true){
int num_bytes=read(fd,event_buf,len);
//处理事件
handleEvent(event_buf);
//....省略....
}
补充
event_buf是一个事件数组,用于接受文件变化所产生的事件(inotify_event).len则指定了要读的长度.通常来说,len大于事件数组的大小,很多时候,我们也会直接取事件数组的大小来作为len.
4.停止监控
当需要停止监控的时候,需要为文件描述符删除watch:
int r=inotify_rm_watch(fd,wd);
此处的fd也是在创建inotify时返回的文件描述符,wd则是上面提到watch对象的句柄.
到现在,我们已经对inotity有了初步的理解,感兴趣的童鞋可以自行研究.我们的重点还是Android中FileObserver的实现.接下来,我们真正的开始了解FileObserver的实现.
FileObserver实现原理
我们知道Android 1.5时对应的linux内核已经是2.6.26,因此完全可以在Android上利用inotify机制来实现对文件的监控.Google很显然意识到了这一点,并且帮我们在inotify的基础上进行封装---FileObserver,以实现监听文件访问,创建,修改,删除等操作
接下来,来看一下FileObserver如何借助inotify实现文件监控的.
监控线程初始化
在FileObserver中存在一个静态内部类ObserverThread,该线程类是实现了文件监控的过程:
public abstract class FileObserver {
//可监控的事件
public static final int ALL_EVENTS = ACCESS | MODIFY | ATTRIB | CLOSE_WRITE
| CLOSE_NOWRITE | OPEN | MOVED_FROM | MOVED_TO | DELETE | CREATE
| DELETE_SELF | MOVE_SELF;
private static class ObserverThread extends Thread {
//....省略多行代码....
}
private static ObserverThread s_observerThread;
static {
s_observerThread = new ObserverThread();
s_observerThread.start();
}
//....省略多行代码....
}
不难发现发现FileObserver通过静态代码块的方式构造了s_observerThread对象,我们来看一下其构造过程:
public ObserverThread() {
super("FileObserver");
m_fd = init();
}
这里又调用natvie方法init().既然这样,我们就在深入一下,看看init()方法的实现(现在,是不是发现我们自己编译源码的好处了?)该方法的实现在/frameworks/base/core/jni/android_util_FileObserver.cpp
static jint android_os_fileobserver_init(JNIEnv* env, jobject object)
{
#if defined(__linux__)
return (jint)inotify_init();
#else
return -1;
#endif
}
其实现非常简单，就是调用inotify中的inotify_init()来创建一个inotify实例。回到FileObserver中来看s_ObserverThread的启动：
public void run() {
observe(m_fd);
}
这里同样是调用natvie方法observe(int fd)：
static void android_os_fileobserver_observe(JNIEnv* env, jobject object, jint fd)
{
#if defined(__linux__)
//设置事件数组
char event_buf[512];
struct inotify_event* event;
//循环处理读到的事件
while (1)
{
int event_pos = 0;
//读取事件
int num_bytes = read(fd, event_buf, sizeof(event_buf));
if (num_bytes < (int)sizeof(*event))
{
if (errno == EINTR)
continue;
ALOGE("***** ERROR! android_os_fileobserver_observe() got a short event!");
return;
}
//处理事件数组
while (num_bytes >= (int)sizeof(*event))
{
int event_size;
event = (struct inotify_event *)(event_buf + event_pos);
jstring path = NULL;
if (event->len > 0)
{
path = env->NewStringUTF(event->name);
}
//调用ObserverThread中的onEvent方法
env->CallVoidMethod(object, method_onEvent, event->wd, event->mask, path);
if (env->ExceptionCheck()) {
env->ExceptionDescribe();
env->ExceptionClear();
}
if (path != NULL)
{
env->DeleteLocalRef(path);
}
event_size = sizeof(*event) + event->len;
num_bytes -= event_size;
event_pos += event_size;
}
}
#endif
}
不难看出,此处的循环主要就是从inotity中取出事件,然后回调ObserverThread中的onEvent()方法.现在,回到ObserverThread中的onEvent()方法中:
public void onEvent(int wfd, int mask, String path) {
// look up our observer, fixing up the map if necessary...
FileObserver observer = null;
synchronized (m_observers) {
//根据wfd找出FileObserver对象
WeakReference weak = m_observers.get(wfd);
if (weak != null) { // can happen with lots of events from a dead wfd
observer = (FileObserver) weak.get();
if (observer == null) {//observer已经被回收时,从m_observers中删除该对象
m_observers.remove(wfd);
}
}
}
// ...then call out to the observer without the sync lock held
if (observer != null) {
try {
//回调给FileObserver中的onEvent方法进行处理
observer.onEvent(mask, path);
} catch (Throwable throwable) {
Log.wtf(LOG_TAG, "Unhandled exception in FileObserver " + observer, throwable);
}
}
}
FileObserver中的onEvent()为抽象方法,也就是要求你继承FileObserver,并实现该方法,在其中做相关的操作.
到现在为止我们已经明白了ObserverThread如何被启动,以及如何获取inotify中的事件,并回调给上层进行处理.
启动监控
上面提到m_observers表,该表维护着已经注册的FileObserver对象.接下来,我们就就来看看FileObserver中的startWatching()方法,该方法注册FileObserver对象,也是启动监控的过程:
public void startWatching() {
if (m_descriptor < 0) {
m_descriptor = s_observerThread.startWatching(m_path, m_mask, this);
}
}
具体的注册操作委托给s_observerThread中的startWatching():
public int startWatching(String path, int mask, FileObserver observer) {
//调用native方法startWatching,并得到一个watch对象的句柄
int wfd = startWatching(m_fd, path, mask);
Integer i = new Integer(wfd);
if (wfd >= 0) {
synchronized (m_observers) {
//将watch对象句柄和当前FileObserver关联
m_observers.put(i, new WeakReference(observer));
}
}
return i;
}
该方法中同样调用了native方法,其具体实现是:
static jint android_os_fileobserver_startWatching(JNIEnv* env, jobject object, jint fd, jstring pathString, jint mask)
{
int res = -1;
#if defined(__linux__)
if (fd >= 0)
{
const char* path = env->GetStringUTFChars(pathString, NULL);
res = inotify_add_watch(fd, path, mask);
env->ReleaseStringUTFChars(pathString, path);
}
#endif
return res;
}
不难看出,这里通过inotify的inotify_add_watch()为上面生成的inotify对象添加watch对象,并将watch对象的句柄返回给ObserverThread.
停止监控
到现在我们已经了解了如何注册watch句柄到FileObserver对象.有了注册的过程,当然少不了反注册的过程.同样,FileObserver为我们提供了stopWatching()来实现反注册,即停止监控的过程:
public void stopWatching() {
if (m_descriptor >= 0) {//已经注册过的才能反注册
s_observerThread.stopWatching(m_descriptor);
m_descriptor = -1;
}
}
具体的实现也是交给了s_observerThread的stopWatching()方法:
public void stopWatching(int descriptor) {
stopWatching(m_fd, descriptor);
}
接着委托给了natvie方法:
static void android_os_fileobserver_stopWatching(JNIEnv* env, jobject object, jint fd, jint wfd)
{
#if defined(__linux__)
inotify_rm_watch((int)fd, (uint32_t)wfd);
#endif
}
这里的实现非常简单,就是调用inotify_rm_watch方法来解除inotify实例和watch实例的关系.
到现在为止我们已经弄明白了FileObserver的实现原理,为了方便理解,我们用一张简单的图来描述整个过程:
使用说明
想必你已经了解了FileObserver的实现原理,接下里我们来看看如何使用.要想实现文件监控,我们只需要继承FileObserver类,并在onEvent()处理相关事件即可,简单的用代码演示一下:
public class SDCardObserver extends FileObserver {
public SDCardObserver(String path) {
super(path);
}
@Override
public void onEvent(int i, String s) {
switch (i) {
case FileObserver.ALL_EVENTS:
//全部事件
break;
case FileObserver.CREATE:
//文件被创建
break;
case FileObserver.DELETE:
//文件被删除
break;
case FileObserver.MODIFY:
//文件被修改
break;
}
}
}
注意事项
这里我们需要注意两个问题:
- 谨慎的选择你要处理的事件,否则可能造成死循环.
- 当不再需要监听时,请记得停止监控
- 需要注意FileObserver对象被垃圾回收的情况,从上面的原理中我们知道,该对象被回收后将不会再触发事件.
