android.os.FileObserver 是基於 Linux inotify 機制實作的抽象類別,專門用於監聽特定檔案或目錄的存取、建立、修改、刪除、移動等事件。每個 FileObserver 實例只能監聽單一檔案或目錄;若監聽的是目錄,其下所有檔案與遞迴子目錄的變更皆會觸發事件回呼。
以下為 FileObserver 定義的靜態常數,可單獨或組合(位元或運算)使用:
ACCESS:檔案被讀取MODIFY:檔案內容被修改ATTRIB:檔案屬性變更(如 chmod、chown、touch)CLOSE_WRITE:可寫入檔案被關閉CLOSE_NOWRITE:不可寫入檔案被關閉OPEN:檔案被開啟MOVED_FROM:檔案被移出監聽目錄MOVED_TO:檔案被移入監聽目錄CREATE:建立新檔案DELETE:檔案被刪除DELETE_SELF:監聽對象本身被刪除MOVE_SELF:監聽對象本身被移動CLOSE:CLOSE_WRITE | CLOSE_NOWRITE 的組合ALL_EVENTS:包含以上所有事件import android.os.FileObserver;
import android.util.Log;
public class SDCardListener extends FileObserver {
public SDCardListener(String path) {
// 預設監聽 ALL_EVENTS,亦可用 super(path, mask) 指定特定事件
super(path);
}
@Override
public void onEvent(int event, String path) {
switch (event) {
case FileObserver.ALL_EVENTS:
Log.d("FileObserver", "All event - path: " + path);
break;
case FileObserver.CREATE:
Log.d("FileObserver", "Created - path: " + path);
// 此處可加入業務邏輯,如掃描媒體、更新 UI 等
break;
// 可依需求補充其他 case
}
}
}
// 建立監聽器,監聽 /sdcard 目錄
SDCardListener listener = new SDCardListener("/sdcard");
// 開始監聽
listener.startWatching();
// ... 執行相關操作(如建立資料夾、複製檔案等) ...
// 結束監聽(務必在不需要時呼叫,避免資源洩漏)
listener.stopWatching();
關鍵提醒:
FileObserver物件必須被強參考持有(例如宣告為類別成員變數),否則會被垃圾回收器回收,導致事件不再觸發。若onEvent處理耗時,建議派發至背景執行緒,避免阻塞後續事件回呼。