萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android FileObserver 實作檔案與目錄變更監聽完整教學

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:包含以上所有事件

實作範例:監聽 SD 卡目錄建立事件

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 處理耗時,建議派發至背景執行緒,避免阻塞後續事件回呼。

copyright © 萬盛學電腦網 all rights reserved