Android新的加载模式-Loader

最新推荐文章于 2024-05-18 07:26:44 发布

张鹿鹿

最新推荐文章于 2024-05-18 07:26:44 发布

阅读量1.4k

点赞数 1

分类专栏： Android笔记文章标签：异步

本文链接：https://blog.csdn.net/u013144863/article/details/52549040

版权

Android笔记专栏收录该内容

55 篇文章 0 订阅

订阅专栏

珍惜作者劳动成果转载请注明出处

Android 3.0 中引入了加载器，支持轻松在 Activity 或片段中异步加载数据。加载器具有以下特征：

可用于每个 Activity 和 Fragment。
支持异步加载数据。
监控其数据源并在内容变化时传递新结果。
在某一配置更改后重建加载器时，会自动重新连接上一个加载器的 Cursor。因此，它们无需重新查询其数据

Loader API 摘要

在应用中使用加载器时，可能会涉及到多个类和接口。下表汇总了这些类和接口：

类/接口	描述
LoaderManager	一种与 Activity 或 Fragment 相关联的的抽象类，用于管理一个或多个 Loader 实例。这有助于应用管理与 Activity 或 Fragment 生命周期相关联的、运行时间较长的操作。它最常见的用法是与 CursorLoader 一起使用，但应用可自由写入其自己的加载器，用于加载其他类型的数据。每个 Activity 或片段中只有一个 LoaderManager。但一个 LoaderManager 可以有多个加载器。
LoaderManager.LoaderCallbacks	一种回调接口，用于客户端与 LoaderManager 进行交互。例如，您可使用 onCreateLoader() 回调方法创建新的加载器。
Loader	一种执行异步数据加载的抽象类。这是加载器的基类。您通常会使用 CursorLoader，但您也可以实现自己的子类。加载器处于Activity状态时，应监控其数据源并在内容变化时传递新结果。
AsyncTaskLoader	提供 AsyncTask 来执行工作的抽象加载器。
CursorLoader	AsyncTaskLoader 的子类，它将查询 ContentResolver 并返回一个 Cursor。此类采用标准方式为查询 Cursor 实现 Loader 协议。它是以 AsyncTaskLoader 为基础而构建，在后台线程中执行 Cursor 查询，因此不会阻塞应用的 UI。使用此加载器是从 ContentProvider 异步加载数据的最佳方式，而不用通过片段或 Activity 的 API 来执行托管查询。

上表中的类和接口是您在应用中用于实现加载器的基本组件。并非您创建的每个加载器都要用到上述所有类和接口。但是，为了初始化加载器以及实现一个 Loader 类（如 CursorLoader），您始终需要要引用 LoaderManager。下文将为您展示如何在应用中使用这些类和接口。

在应用中使用加载器

此部分描述如何在 Android 应用中使用加载器。使用加载器的应用通常包括：

Activity 或 Fragment。
LoaderManager 的实例。
一个 CursorLoader，用于加载由 ContentProvider 支持的数据。您也可以实现自己的 Loader 或 AsyncTaskLoader 子类，从其他源中加载数据。
一个 LoaderManager.LoaderCallbacks 实现。您可以使用它来创建新加载器，并管理对现有加载器的引用。
一种显示加载器数据的方法，如 SimpleCursorAdapter。
使用 CursorLoader 时的数据源，如 ContentProvider。

启动加载器

LoaderManager 可在 Activity 或 Fragment 内管理一个或多个 Loader 实例。每个 Activity 或片段只有一个 LoaderManager。

通常，您会使用 Activity 的 onCreate() 方法或片段的 onActivityCreated() 方法初始化 Loader。您执行操作如下：

// Prepare the loader.  Either re-connect with an existing one,
// or start a new one.
getLoaderManager().initLoader(0, null, this);

initLoader() 方法采用以下参数：

用于标识加载器的唯一 ID。在此示例中，ID 为 0。
在构建时提供给加载器的可选参数（在此示例中为 null ）。
LoaderManager.LoaderCallbacks 实现， LoaderManager 将调用此实现来报告加载器事件。在此示例中，本地类实现 LoaderManager.LoaderCallbacks 接口，因此它会将引用 this 传递给自己。

initLoader() 调用确保加载器已初始化且处于Activity状态。这可能会出现两种结果：

如果 ID 指定的加载器已存在，则将重复使用上次创建的加载器。
如果 ID 指定的加载器不存在，则 initLoader() 将触发 LoaderManager.LoaderCallbacks 方法 onCreateLoader()。在此方法中，您可以实现代码以实例化并返回新加载器。有关详细介绍，请参阅 onCreateLoader 部分。

无论何种情况，给定的 LoaderManager.LoaderCallbacks 实现均与加载器相关联，且将在加载器状态变化时调用。如果在调用时，调用程序处于启动状态，且请求的加载器已存在并生成了数据，则系统将立即调用 LoaderManager.LoaderCallbacks#onLoadFinished onLoadFinished() （在 initLoader() 期间），因此您必须为此做好准备。有关此回调的详细介绍，请参阅 onLoadFinished。

请注意，initLoader() 方法将返回已创建的 Loader，但您不必捕获其引用。LoaderManager 将自动管理加载器的生命周期。LoaderManager 将根据需要启动和停止加载，并维护加载器的状态及其相关内容。这意味着您很少直接与加载器进行交互（有关使用加载器方法调整加载器行为的示例，请参阅 LoaderThrottle 示例）。当特殊事件发生时，您通常会使用 LoaderManager.LoaderCallbacks 方法干预加载进程。有关此主题的详细介绍，请参阅使用 LoaderManager 回调。

重启加载器

当您使用 initLoader() 时（如上所述），它将使用含有指定 ID 的现有加载器（如有）。如果没有，则它会创建一个。但有时，您想放弃这些旧数据并重新开始。

要放弃旧数据，请使用 restartLoader()。例如，当用户的查询更改时，此 SearchView.OnQueryTextListener 实现将重启加载器。加载器需要重启，以便它能够使用修订后的搜索筛选器执行新查询：

public boolean onQueryTextChanged(String newText) {
    // Called when the action bar search text has changed.  Update
    // the search filter, and restart the loader to do a new query
    // with this filter.
    mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;
    getLoaderManager().restartLoader(0, null, this);
    return true;
}

使用 LoaderManager 回调

LoaderManager.LoaderCallbacks 是一个支持客户端与 LoaderManager 交互的回调接口。

加载器（特别是 CursorLoader）在停止运行后，仍需保留其数据。这样，应用即可保留 Activity 或片段的 onStop() 和 onStart() 方法中的数据。当用户返回应用时，无需等待它重新加载这些数据。您可使用 LoaderManager.LoaderCallbacks 方法了解何时创建新加载器，并告知应用何时停止使用加载器的数据。

LoaderManager.LoaderCallbacks 包括以下方法：

onCreateLoader()：针对指定的 ID 进行实例化并返回新的 Loader
onLoadFinished() ：将在先前创建的加载器完成加载时调用
onLoaderReset()：将在先前创建的加载器重置且其数据因此不可用时调用

下文更详细地描述了这些方法:

onCreateLoader

当您尝试访问加载器时（例如，通过 initLoader()），该方法将检查是否已存在由该 ID 指定的加载器。如果没有，它将触发 LoaderManager.LoaderCallbacks 方法 onCreateLoader()。在此方法中，您可以创建新加载器。通常，这将是 CursorLoader，但您也可以实现自己的 Loader 子类。

在此示例中，onCreateLoader() 回调方法创建了 CursorLoader。您必须使用其构造函数方法来构建 CursorLoader。该方法需要对 ContentProvider 执行查询时所需的一系列完整信息。具体地说，它需要：

uri：用于检索内容的 URI
projection：要返回的列的列表。传递 null 时，将返回所有列，这样会导致效率低下
selection：一种用于声明要返回哪些行的过滤器，其格式为 SQL WHERE 子句（WHERE 本身除外）。传递 null 时，将为指定的 URI 返回所有行
selectionArgs：您可以在 selection 中包含 ?s，它将按照在 selection 中显示的顺序替换为 selectionArgs 中的值。该值将绑定为字串符
sortOrder：行的排序依据，其格式为 SQL ORDER BY 子句（ORDER BY 自身除外）。传递 null 时，将使用默认排序顺序（可能并未排序）

例如:

 // If non-null, this is the current filter the user has provided.
String mCurFilter;
...
public Loader<Cursor> onCreateLoader(int id, Bundle args) {
    // This is called when a new Loader needs to be created.  This
    // sample only has one Loader, so we don't care about the ID.
    // First, pick the base URI to use depending on whether we are
    // currently filtering.
    Uri baseUri;
    if (mCurFilter != null) {
        baseUri = Uri.withAppendedPath(Contacts.CONTENT_FILTER_URI,
                  Uri.encode(mCurFilter));
    } else {
        baseUri = Contacts.CONTENT_URI;
    }

    // Now create and return a CursorLoader that will take care of
    // creating a Cursor for the data being displayed.
    String select = "((" + Contacts.DISPLAY_NAME + " NOTNULL) AND ("
            + Contacts.HAS_PHONE_NUMBER + "=1) AND ("
            + Contacts.DISPLAY_NAME + " != '' ))";
    return new CursorLoader(getActivity(), baseUri,
            CONTACTS_SUMMARY_PROJECTION, select, null,
            Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC");
}

onLoadFinished

当先前创建的加载器完成加载时，将调用此方法。该方法必须在为此加载器提供的最后一个数据释放之前调用。此时，您应移除所有使用的旧数据（因为它们很快会被释放），但不要自行释放这些数据，因为这些数据归其加载器所有，其加载器会处理它们。

当加载器发现应用不再使用这些数据时，即会释放它们。例如，如果数据是来自 CursorLoader 的一个 Cursor，则您不应手动对其调用 close()。如果 Cursor 放置在 CursorAdapter 中，则应使用 swapCursor() 方法，使旧 Cursor 不会关闭。例如：

// This is the Adapter being used to display the list's data.
SimpleCursorAdapter mAdapter;
...

public void onLoadFinished(Loader<Cursor> loader, Cursor data) {
    // Swap the new cursor in.  (The framework will take care of closing the
    // old cursor once we return.)
    mAdapter.swapCursor(data);
}

onLoaderReset

此方法将在先前创建的加载器重置且其数据因此不可用时调用。通过此回调，您可以了解何时将释放数据，因而能够及时移除其引用。

此实现调用值为 null 的swapCursor()：


// This is the Adapter being used to display the list's data.
SimpleCursorAdapter mAdapter;
...

public void onLoaderReset(Loader<Cursor> loader) {
    // This is called when the last Cursor provided to onLoadFinished()
    // above is about to be closed.  We need to make sure we are no
    // longer using it.
    mAdapter.swapCursor(null);
}

示例

以下是一个 Fragment 完整实现示例。它展示了一个 ListView，其中包含针对联系人内容提供程序的查询结果。它使用 CursorLoader 管理提供程序的查询。

应用如需访问用户联系人（正如此示例中所示），其清单文件必须包括权限 READ_CONTACTS。


public static class CursorLoaderListFragment extends ListFragment
        implements OnQueryTextListener, LoaderManager.LoaderCallbacks<Cursor> {

    // This is the Adapter being used to display the list's data.
    SimpleCursorAdapter mAdapter;

    // If non-null, this is the current filter the user has provided.
    String mCurFilter;

    @Override public void onActivityCreated(Bundle savedInstanceState) {
        super.onActivityCreated(savedInstanceState);

        // Give some text to display if there is no data.  In a real
        // application this would come from a resource.
        setEmptyText("No phone numbers");

        // We have a menu item to show in action bar.
        setHasOptionsMenu(true);

        // Create an empty adapter we will use to display the loaded data.
        mAdapter = new SimpleCursorAdapter(getActivity(),
                android.R.layout.simple_list_item_2, null,
                new String[] { Contacts.DISPLAY_NAME, Contacts.CONTACT_STATUS },
                new int[] { android.R.id.text1, android.R.id.text2 }, 0);
        setListAdapter(mAdapter);

        // Prepare the loader.  Either re-connect with an existing one,
        // or start a new one.
        getLoaderManager().initLoader(0, null, this);
    }

    @Override public void onCreateOptionsMenu(Menu menu, MenuInflater inflater) {
        // Place an action bar item for searching.
        MenuItem item = menu.add("Search");
        item.setIcon(android.R.drawable.ic_menu_search);
        item.setShowAsAction(MenuItem.SHOW_AS_ACTION_IF_ROOM);
        SearchView sv = new SearchView(getActivity());
        sv.setOnQueryTextListener(this);
        item.setActionView(sv);
    }

    public boolean onQueryTextChange(String newText) {
        // Called when the action bar search text has changed.  Update
        // the search filter, and restart the loader to do a new query
        // with this filter.
        mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;
        getLoaderManager().restartLoader(0, null, this);
        return true;
    }

    @Override public boolean onQueryTextSubmit(String query) {
        // Don't care about this.
        return true;
    }

    @Override public void onListItemClick(ListView l, View v, int position, long id) {
        // Insert desired behavior here.
        Log.i("FragmentComplexList", "Item clicked: " + id);
    }

    // These are the Contacts rows that we will retrieve.
    static final String[] CONTACTS_SUMMARY_PROJECTION = new String[] {
        Contacts._ID,
        Contacts.DISPLAY_NAME,
        Contacts.CONTACT_STATUS,
        Contacts.CONTACT_PRESENCE,
        Contacts.PHOTO_ID,
        Contacts.LOOKUP_KEY,
    };
    public Loader<Cursor> onCreateLoader(int id, Bundle args) {
        // This is called when a new Loader needs to be created.  This
        // sample only has one Loader, so we don't care about the ID.
        // First, pick the base URI to use depending on whether we are
        // currently filtering.
        Uri baseUri;
        if (mCurFilter != null) {
            baseUri = Uri.withAppendedPath(Contacts.CONTENT_FILTER_URI,
                    Uri.encode(mCurFilter));
        } else {
            baseUri = Contacts.CONTENT_URI;
        }

        // Now create and return a CursorLoader that will take care of
        // creating a Cursor for the data being displayed.
        String select = "((" + Contacts.DISPLAY_NAME + " NOTNULL) AND ("
                + Contacts.HAS_PHONE_NUMBER + "=1) AND ("
                + Contacts.DISPLAY_NAME + " != '' ))";
        return new CursorLoader(getActivity(), baseUri,
                CONTACTS_SUMMARY_PROJECTION, select, null,
                Contacts.DISPLAY_NAME + " COLLATE LOCALIZED ASC");
    }

    public void onLoadFinished(Loader<Cursor> loader, Cursor data) {
        // Swap the new cursor in.  (The framework will take care of closing the
        // old cursor once we return.)
        mAdapter.swapCursor(data);
    }

    public void onLoaderReset(Loader<Cursor> loader) {
        // This is called when the last Cursor provided to onLoadFinished()
        // above is about to be closed.  We need to make sure we are no
        // longer using it.
        mAdapter.swapCursor(null);
    }
}

实现自定义的Loader

自定义Loader用来加载特定的数据，不局限于数据库，可以加载文件、网络、…
自定义的Loader 不需要开发人员手动管理 Fragment/Activity的生命周期，Loader会自己根据生命周期进行创建、加载、释放操作。
Loader 实际上只能够用于数据的获取。
Loader实现时：loadInBackground() 用于数据后台加载（可以认为子线程）

步骤 :

AsyncTaskLoader : API 作用，一个抽象的，能够在子线程中进行数据加载的Loader，需要开发人员实现loadInBackground()
自定义的AsyncTaskLoader 必须要重写一个方法，这个方法叫做 onStartLoading(), 在onStartLoading方法中，强制调用 forceLoad() 可以进行数据的自动加载；

代码:



/**
 * Created with IntelliJ IDEA.
 * User: vhly[FR]
 * Date: 16/9/10
 * Email: vhly@163.com
 */

/**
 * 1. 继承AsyncTaskLoader,确认好 返回的数据类型 范型就是结果类型 doInBackground 返回值
 */
public class NetworkLoader extends AsyncTaskLoader<JSONObject> {

    private String mUrl;

    /**
     * 在构造中传递各种参数
     *
     * @param context
     * @param url
     */
    public NetworkLoader(Context context, String url) {
        super(context);
        mUrl = url;
    }


    @Override
    protected void onStartLoading() {
        // 这个方法必须要重写，如果没有重写，数据不会自动加载
        // forceLoad 会强制触发异步任务的加载，执行 loadInBackground()
        forceLoad();
    }

    /**
     * 子线程加载数据的部分，
     *
     * @return
     */
    @Override
    public JSONObject loadInBackground() {

        JSONObject ret = null;

        byte[] data = HttpTool.doGet(mUrl);

        //Log.d("NetworkLoader", "get data " + data.length);

        // 网络链接完成之后，考虑，cancel, reset, abort 各种情况的处理

        if (isLoadInBackgroundCanceled()) {
            // 不处理,不返回
        } else {

            if (isReset()) {
                // 不返回数据，但是可以考虑，把数据保存到本地
            } else {

                if (data != null) {
                    try {
                        String str = new String(data, "UTF-8");
                        ret = new JSONObject(str);
                    } catch (UnsupportedEncodingException e) {
                        e.printStackTrace();
                    } catch (JSONException e) {
                        e.printStackTrace();
                    }
                }
            }
        }

        return ret;
    }
}

重要的图:

Loader数据加载原理:

这里写图片描述

Note

Loader 的使用

1. 创建Loader，使用LoaderManager类 initLoader 方法来初始化

2. 接口方法 onCreateLoader 来创建实际的Loader对象，Android中提供了 CursorLoader 加载内容提供者的

    AsyncTaskLoader 这种Loader，是需要重写的，自定义Loader

3. Activity onResume时，Loader开始加载数据，完成时调用 onLoadFinished 方法

4. Activity onDestroy时，Loader 会进行销毁，释放数据 onLoaderReset


Loader的综合使用

1. 网络请求 Loader 类，请求数据

2. 数据回来，生成实体类，保存到 ContentProvider

3. 网络数据，刷新ListView

4. 程序启动，初始化一个数据缓存Loader 也就是  CursorLoader

5. CursorLoader 加载内容提供者的数据，显示到ListView上；

6. 本地数据库加载完成才会启动网络Loader，更好处理

张鹿鹿

关注

1
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
Android新的加载模式-Loader

珍惜作者劳动成果转载请注明出处Android 3.0 中引入了加载器，支持轻松在 Activity 或片段中异步加载数据。加载器具有以下特征：可用于每个 Activity 和 Fragment。支持异步加载数据。监控其数据源并在内容变化时传递新结果。在某一配置更改后重建加载器时，会自动重新连接上一个加载器的 Cursor。因此，它们无需重新查询其数据Loader API 摘要在应用
复制链接

扫一扫

专栏目录