誰有用過 FileObserver ？

Use the FileObserver class to monitor the file/directory changes

為了要監視某個檔案是否有被更改，原先寫了個 Thread 去定期檢查檔案的修改時間。不過用 Thread 的問題就是，這 polling 的時間該抓多少才好？久久才查一次，運氣不好的話，檔案被改後，你得等到下次 polling 的時間，才知道。如果將 polling 的時間縮短，常常去檢查，又怕影響整個系統效能。

前幾天查了一下，發現有個 android.os.FileObserver 這個類別。不過這 SDK 都已經出到 1.1r1 了，這個類別的文件還真是簡單到沒有任何的說明，我只能從 API 的名字上去猜他的用法。好在他的 API 沒幾個，大多一看名字，就可猜到他是用來做什麼的。

底下是這個類別的所有 APIs：

// Public Constructors public FileObserver(String path); public FileObserver(String path, int mask); // Public Methods public abstract void onEvent(int event, String path); public void startWatching(); public void stopWatching();

看樣子，你可以用這個類別去監視某個目錄或是某個檔案，是否有被存取。

實踐是檢驗真理的唯一標準。因此，我寫了個簡單的程式，來觀察 FileObserver 的行為：

public void onCreate(Bundle savedInstanceState) { ... m_myDirObsv.startWatching(); m_myFileObsv.startWatching(); } public void onDestroy() { m_myDirObsv.stopWatching(); m_myFileObsv.stopWatching(); super.onDestroy(); } private MyDirObserver m_myDirObsv = new MyDirObserver(); private MyFileObserver m_myFileObsv = new MyFileObserver(); class MyDirObserver extends FileObserver { public MyDirObserver() { super("/sdcard/sam/", ALL_EVENTS); } public void onEvent(int event, String path) { _Dump("dir", event, path); } } class MyFileObserver extends FileObserver { public MyFileObserver() { super("/sdcard/sam/test.txt", ALL_EVENTS); } public void onEvent(int event, String path) { _Dump("file", event, path); } } private void _Dump(String tag, int event, String path) { Log.d(tag, "=== dump begin ==="); Log.d(tag, "path=" + path); Log.d(tag, "event list:"); if ((event & FileObserver.OPEN) != 0) Log.d(tag, " OPEN"); if ((event & FileObserver.CLOSE_NOWRITE) != 0) Log.d(tag, " CLOSE_NOWRITE"); if ((event & FileObserver.CLOSE_WRITE) != 0) Log.d(tag, " CLOSE_WRITE"); if ((event & FileObserver.CREATE) != 0) Log.d(tag, " CREATE"); if ((event & FileObserver.DELETE) != 0) Log.d(tag, " DELETE"); if ((event & FileObserver.DELETE_SELF) != 0) Log.d(tag, " DELETE_SELF"); if ((event & FileObserver.ACCESS) != 0) Log.d(tag, " ACCESS"); if ((event & FileObserver.MODIFY) != 0) Log.d(tag, " MODIFY"); if ((event & FileObserver.MOVED_FROM) != 0) Log.d(tag, " MOVED_FROM"); if ((event & FileObserver.MOVED_TO) != 0) Log.d(tag, " MOVED_TO"); if ((event & FileObserver.MOVE_SELF) != 0) Log.d(tag, " MOVE_SELF"); if ((event & FileObserver.ATTRIB) != 0) Log.d(tag, " ATTRIB"); Log.d(tag, "=== dump end ==="); }

然後，用 adb shell 打幾個指令觀察結果：

# pwd pwd /sdcard/sam # mv ../a.txt . mv ../a.txt . dir: === dump begin === dir: path=a.txt dir: event list: dir:   MOVED_TO dir: === dump end === # echo 123 > test.txt echo 123 > test.txt file: === dump begin === file: path=null file: event list: file:   MODIFY file: === dump end === dir: === dump begin === dir: path=test.txt dir: event list: dir:   MODIFY dir: === dump end === dir: === dump begin === dir: path=test.txt dir: event list: dir:   OPEN dir: === dump end === file: === dump begin === file: path=null file: event list: file:   OPEN file: === dump end === dir: === dump begin === dir: path=test.txt dir: event list: dir:   MODIFY dir: === dump end === file: === dump begin === file: path=null file: event list: file:   MODIFY file: === dump end === dir: === dump begin === dir: path=test.txt dir: event list: dir:   CLOSE_WRITE dir: === dump end === file: === dump begin === file: path=null file: event list: file:   CLOSE_WRITE file: === dump end ===

反應還蠻即時的，你也可以自己打個其他的指令，試著觀察他的結果，看看是否和你認知的相同。

還沒有仔細 trace 他的原始碼。先問問看，有誰知道 FileObserver 是如何實現這部分的功能？啟動 startWatching()，對系統效能的影響大嗎？