注意: 原始內容為空。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);
}
}
為什麼棄用?現代替代方案對比
| 缺點 | Loader | ViewModel + 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
}
}
}
遷移清單
- 移除
implements LoaderCallbacks、initLoader。
- 建立
ViewModel 持有 Repository。
- 將資料庫查詢移至
Dao 回傳 Flow/LiveData。
- UI 層用
observe/collect 取代 onLoadFinished。
- 刪除
CursorAdapter,改用 ListAdapter + DiffUtil。
Loader 是 Android 早期解決「非同步載入+生命週期+配置變更保留」的偉大嘗試,但架構侷限性導致被現代架構組件取代。維護舊專案時可保留運行,新功能請勿再引入 Loader API。