重启装载器
当你使用initLoader()
时,如果指定ID的装载器已经存在,则它使用这个装载器.如果不存在呢,它将创建一个新的.但是有时你却是想丢弃旧的然后开始新的数据.
要想丢弃旧数据,你应使用restartLoader()
.例如,下面这个
SearchView.OnQueryTextListener
的实现在用户查询发生改变时重启了装载器,装载器于是需重启从而能使用新的搜索过虑来进行一次新的查询.
<span style="font-family:KaiTi_GB2312;">public boolean onQueryTextChanged(String newText) {
// 当动作栏的搜索字串发生改时被调用.
// 更新搜索过虑,然后重新启动装载利用这个新过虑进行新的查询.
mCurFilter = !TextUtils.isEmpty(newText) ? newText : null;
getLoaderManager().restartLoader(0, null, this);
return true;
}</span>
使用LoaderManager的回调
LoaderManager.LoaderCallbacks
是一个回调接口,它使得客户端可以与LoaderManager
进行交互.
装载器,一般指的是CursorLoader
,我们希望在它停止后依然保持数据.这使得应用可以在activity或fragment的 onStop()
和onStart()
之间保持数据,所以当用户回到一个应用时,它们不需等待数据加载.你使用LoaderManager.LoaderCallbacks
的方法们,在需要时创建新的装载器,并且告诉应用什么时候要停止使用装载器的数据.
LoaderManager.LoaderCallbacks
包含以下方法们:
-
onCreateLoader()
—跟据传入的ID,初始化并返回一个新的装载器. -
onLoadFinished()
—当一个装载器完成了它的装载过程后被调用. -
onLoaderReset()
—当一个装载器被重置而什其数据无效时被调用.
onCreateLoader
当你试图去操作一个装载器时(比如,通过initLoader()
),会检查是否指定ID的装载器已经存在.如果它不存在,将会触发LoaderManager.LoaderCallbacks
的方法onCreateLoader()
.这是你创建一个新装载器的地方.通常这个装载器是一个CursorLoader
,但是你也可以实现你自己的装载器.
在下面的例子中,回调方法onCreateLoader()
创建一个CursorLoader
.你必须使用构造方法来建立CursorLoader
,构造方法需要向ContentProvider
执行一次查询的完整信息作为参数,它尤其需要:
-
uri —要获取的内容的URI.
-
projection —要返回的列组成的列被.传入
null
将会返回所有的列,但这是低效的. -
selection —一个过滤器,表明哪些行将被返回.格式化成类似SQLWHERE 语句的样子(除了没有WHERE).传入
null
将返回所有的行. -
selectionArgs —你可以在selection 中包含一些'?',它将被本参数的值替换掉.这些值出现的顺序与'?'在selection中出现的顺序一至.值将作为字符串.
-
sortOrder —如何为行们排序.格式化成类似于SQLORDER BY 语句的样字(除了没有ORDERBY).传入
null
将使用默认顺序,默认顺序可能是无顺序.
例子:
// If non-null, this is the current filter the user has provided.
String mCurFilter;
...
public Loader<Cursor> onCreateLoader(int id, Bundle args) {
// 这里是在需要创建新装载器时被调用的.
// 我们只是简单的拥有一个装载器,所以我们不需要关心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");
}