萬盛學電腦網

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

Android Loaders 框架:CursorLoader、AsyncTaskLoader 與現代替代方案

注意: 原始內容為空。Loader 框架 (API 11+) 在 Android 9 (API 28) 正式**棄用**,現代開發請使用 ViewModel + LiveData/Flow + Room/Coroutines。本文記錄 Loader 歷史機制供維護舊專案參考,並說明遷移路徑。

Loader 核心設計目標

  • 生命週期感知: 綁定 Activity/Fragment 生命週期,自動管理啟動/停止/重置。
  • 非同步載入: 在背景執行緒查詢資料,避免阻塞 UI 執行緒。
  • 資料變更監聽: 內建 ContentObserver / ForceLoadContentObserver,資料庫變更自動觸發重新載入。
  • 配置變更保留: 畫面旋轉時 Loader 不銷毀,保留資料與狀態,避免重複查詢。

兩大核心實作

Loader用途關鍵方法
CursorLoader查詢 ContentProvider (SQLite)、自動觀察 Uri 變更loadInBackground() 回傳 Cursor
AsyncTaskLoader<D>通用非同步載入 (網路、檔案、計算),需自行實作觀察邏輯loadInBackground() 回傳泛型 D

CursorLoader 使用範例 (舊專案)

public class UserListFragment extends ListFragment implements LoaderManager.LoaderCallbacks {
    private SimpleCursorAdapter adapter;

    @Override
    public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);
        adapter = new SimpleCursorAdapter(getActivity(),
                android.R.layout.simple_list_item_2, null,
                new String[]{UserContract.NAME, UserContract.EMAIL},
                new int[]{android.R.id.text1, android.R.id.text2}, 0);
        setListAdapter(adapter);
        getLoaderManager().initLoader(0, null, this); // 初始化 Loader ID=0
    }

    @NonNull @Override
    public Loader onCreateLoader(int id, Bundle args) {
        return new CursorLoader(getActivity(),
                UserContract.CONTENT_URI,
                new String[]{UserContract._ID, UserContract.NAME, UserContract.EMAIL},
                null, null, UserContract.NAME + " ASC");
    }

    @Override
    public void onLoadFinished(@NonNull Loader loader, Cursor data) {
        adapter.swapCursor(data); // 替換游標,舊游標自動關閉
    }

    @Override
    public void onLoaderReset(@NonNull Loader loader) {
        adapter.swapCursor(null);
    }
}

AsyncTaskLoader 自定義載入 (如網路請求)

public class JsonLoader extends AsyncTaskLoader> {
    private List cachedData;
    private String url;

    public JsonLoader(Context context, String url) {
        super(context);
        this.url = url;
    }

    @Override
    protected void onStartLoading() {
        if (cachedData != null) deliverResult(cachedData); // 快取資料立即送達
        if (takeContentChanged() || cachedData == null) forceLoad(); // 資料變更或無快取則重新載入
    }

    @Override
    public List loadInBackground() {
        // 背景執行緒執行網路請求、解析 JSON
        return NetworkUtils.fetchJson(url);
    }

    @Override
    public void deliverResult(List data) {
        cachedData = data;
        super.deliverResult(data);
    }
}

為什麼棄用?現代替代方案對比

缺點LoaderViewModel + LiveData/Flow
API 侷限綁定 Activity/Fragment 生命週期,難以在非 UI 層複用ViewModel 範圍更廣,可跨 Fragment/Activity 共享
樣板碼多需實作 LoaderCallbacks 三方法、initLoader/restartLoader一行 viewModel.data.observe() 或 collect()
Cursor 耦合CursorLoader 強綁 SQLite/Cursor,難以單元測試Repository 暴露領域模型,可測試、可替換資料源
錯誤處理弱無標準錯誤傳遞機制Flow/LiveData 支援 catch/retry/State 封裝
並發控制單一 Loader ID,難以表達複雜依賴Coroutines supervisorScope、flatMapLatest 靈活組合

遷移路徑:Loader → ViewModel + Room + Flow

// 1. Repository (單一資料來源)
class UserRepository @Inject constructor(private val dao: UserDao) {
    fun getUsers(): Flow> = dao.getAllUsers() // Room 回傳 Flow 自動觀察 DB 變更
}

// 2. ViewModel
@HiltViewModel
class UserViewModel @Inject constructor(private val repo: UserRepository) : ViewModel() {
    val users: StateFlow> = repo.getUsers()
        .stateIn(viewModelScope, SharingStarted.WhileSubscribed(), emptyList())
}

// 3. Fragment/Activity
@AndroidEntryPoint
class UserFragment : Fragment() {
    private val viewModel: UserViewModel by viewModels()
    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        viewModel.users.observe(viewLifecycleOwner) { users ->
            adapter.submitList(users) // RecyclerView ListAdapter
        }
    }
}

遷移清單

  1. 移除 implements LoaderCallbacks、initLoader。
  2. 建立 ViewModel 持有 Repository。
  3. 將資料庫查詢移至 Dao 回傳 Flow/LiveData。
  4. UI 層用 observe/collect 取代 onLoadFinished。
  5. 刪除 CursorAdapter,改用 ListAdapter + DiffUtil。
Loader 是 Android 早期解決「非同步載入+生命週期+配置變更保留」的偉大嘗試,但架構侷限性導致被現代架構組件取代。維護舊專案時可保留運行,新功能請勿再引入 Loader API。
copyright © 萬盛學電腦網 all rights reserved