到顶部
Android API
公众的班

装载机

延伸对象
java.lang.Object（java.lang.对象）
   ↳ android内容。装载机<D>
已知的直接子类
已知间接子类

课程概述

执行数据异步加载的抽象类。装载机激活时他们应该监控数据的来源，并在内容更改。请参见加载器管理器了解更多详细信息。

螺纹说明：加载程序的客户端通常应执行从进程的主线程对Loader的任何调用（即，“活动”回调和其他事件发生的线程）。子类装载机（例如异步任务加载器)将经常执行他们的工作在一个单独的线程中，但在交付结果时，这也应该在主线程上完成。

子类通常必须至少实现开始加载时（）,停止加载（）,强制加载（）、和onReset（）.

大多数实现不应该直接从这个类派生，但是而是继承自异步任务加载器.

开发人员指南

有关使用加载器的更多信息，请阅读装载机开发人员指南。

总结

内部类
班 装载机。强制加载内容观察员 负责连接的ContentObserver的实现当观察者被告知情况发生了变化。 
接口 装载机。OnLoadCanceledListener<D> 用于发现Loader何时被取消的接口在它完成数据加载之前。 
接口 装载机。OnLoadCompleteListener<D> 实现用于发现Loader何时完成的接口正在加载其数据。 
公共建筑商
装载机(上下文上下文）
存储与上下文关联的应用程序上下文。
公共方法
空隙 放弃()
此函数通常由自动调用加载器管理器重新启动Loader时。
布尔值 取消负载()
尝试取消当前加载任务。
空隙 承诺内容已更改()
承诺您实际上已经完全处理了一项内容更改由返回takeContentChanged（）.
字符串 数据到字符串（D数据）
为了进行调试，将Loader数据类的实例转换为可以打印的字符串。
空隙 交货取消()
通知注册人装载机。OnLoadCanceledListener加载已取消。
空隙 交付结果（D数据）
将加载结果发送到已注册的侦听器。
空隙 倾倒(字符串前缀，文件描述符fd、，字符打印流作者，字符串[]参数）
将Loader的状态打印到给定流中。
空隙 force加载()
强制异步加载。
上下文 获取上下文()
整数 获取Id()
布尔值 已放弃()
返回此加载程序是否已被放弃。
布尔值 isReset（重置）()
返回此负载是否已重置。
布尔值 is已启动()
返回此加载是否已启动。
空隙 onContentChanged（内容已更改）()
调用时间：装载机。强制加载内容观察员检测到更改。
空隙 寄存器侦听器（int id，OnLoadCompleteListener<D> 监听器）
注册一个类，该类将在加载完成时接收回调。
空隙 寄存器OnLoadCanceledListener(OnLoadCanceledListener<D> 监听器）
注册在取消加载时将接收回调的侦听器。
空隙 重置()
此函数通常会由自动调用装载机管理器销毁Loader时。
空隙 回滚内容更改()
报告您已放弃处理由返回takeContentChanged（）并希望回滚到再次存在挂起内容更改的状态。
最终的空隙 开始加载()
此函数通常由自动调用加载器管理器当相关片段/活动正在启动。
空隙 停止加载()
此函数通常由自动调用加载器管理器当相关片段/活动正在停止。
布尔值 takeContentChanged（获取内容更改）()
采用当前标志，指示加载程序的内容是否停止时发生了更改。
字符串 toString（字符串）()
返回一个字符串，该字符串包含此对象。
空隙 unregister侦听器(OnLoadCompleteListener<D> 监听器）
删除以前添加的侦听器registerListener（int，Loader.OnLoadCompleteListener).
空隙 取消注册OnLoadCanceledListener(OnLoadCanceledListener<D> 监听器）
注销以前使用添加的侦听器寄存器OnLoadCanceledListener（Loader.OnLoadCanceledListener).
受保护的方法
空隙 论放弃()
子类实现这一点是为了避免被抛弃。
布尔值 onCancelLoad（取消加载）()
子类必须实现此功能，以处理对取消加载（）.
空隙 onForceLoad（强制加载）()
子类必须实现此功能，以处理对强制加载（）.
空隙 on重置()
子类必须实现这一点，以负责重置它们的加载器，根据重置（）.
空隙 开始加载时()
子类必须实现这一点，以负责加载其数据，根据启动加载（）.
空隙 停止加载时()
子类必须实现此功能，以停止其加载程序，根据停止加载（）.
[展开]
继承的方法
来自班级java.lang.Object（java.lang.对象）

公共建筑商

公众的 装载机 (上下文上下文）

存储与上下文关联的应用程序上下文。由于Loader可以跨多个活动使用，因此直接存储上下文；始终使用获取上下文（）检索Loader的Context，不要直接使用构造函数参数。返回的上下文获取上下文（）可安全使用活动实例。

参数
上下文 用于检索应用程序上下文。

公共方法

公众空隙 放弃 ()

此函数通常由自动调用加载器管理器重新启动Loader时。使用时一台装载机加载器管理器,你不能你自己调用这个方法，否则会发生冲突装载机的管理。告诉加载器它被丢弃了。这称为优先到重置（）让其保留当前数据但不报告任何新数据。

公众布尔值 cancelLoad（取消加载） ()

尝试取消当前加载任务。必须在进程的主线程上调用。

取消不是立即操作，因为执行了加载在后台线程中。如果当前正在加载，则此方法请求取消加载，并注意到这种情况；后台线程完成其工作后的剩余状态将被清除。如果在此期间出现另一个加载请求，它将一直保持到取消的加载完成。

退换商品
  • 退换商品假如果该任务不能被取消，通常是因为它已经正常完成，或者因为启动加载（）尚未呼叫；收益真的否则。什么时候？真的返回，则任务仍在运行装载机。OnLoadCanceledListener将被调用任务完成时。

公众空隙 承诺内容已更改 ()

已在中添加API等级18

承诺您实际上已经完全处理了一项内容更改由返回takeContentChanged（）。这是用于回滚内容更改（）处理负载情况已取消。当你处理完一个负载后调用这个没有被取消。

公众的字符串 数据到字符串 （D数据）

为了进行调试，将Loader数据类的实例转换为可以打印的字符串。必须处理空数据。

公众空隙 交货取消 ()

已在中添加API级别16

通知注册人装载机。OnLoadCanceledListener加载已取消。只能由子类调用。必须从进程的主线程调用。

公众空隙 交付结果 （D数据）

将加载结果发送到已注册的侦听器。应该只由子类调用。必须从进程的主线程调用。

参数
数据 荷载的结果

公众空隙 倾倒 (字符串前缀，文件描述符fd、，字符打印流作者，字符串[]参数）

将Loader的状态打印到给定流中。

参数
前缀 要在每行前面打印的文本。
fd公司 转储发送到的原始文件描述符。
作家 要设置转储的PrintWriter。
参数 转储请求的其他参数。

公众空隙 force加载 ()

强制异步加载。不同于启动加载（）这将忽略以前的加载数据集并加载新数据集。这只是调用实现的强制加载（）。您通常只应将其称为加载程序启动时--也就是说，已启动（）返回true。

必须从进程的主线程调用。

公众的上下文 获取上下文 ()

退换商品
  • 从传递给构造函数的context中检索的应用程序上下文。

公众整数 获取Id ()

退换商品
  • 此加载程序的ID

公众布尔值 已放弃 ()

返回此加载程序是否已被放弃。在这种状态下装载机不能报告任何新数据，以及必须保持其上次报告的数据在最终重置之前有效。

公众布尔值 isReset（重置） ()

返回此负载是否已重置。也就是说，装载机尚未首次启动，或其重置（）已被调用。

公众布尔值 is已启动 ()

返回此加载是否已启动。也就是说，它启动加载（）已被呼叫，但没有呼叫停止加载（）或重置（）已经完成。

公众空隙 onContentChanged（内容已更改） ()

调用时间：装载机。强制加载内容观察员检测到更改。这个默认实现检查加载程序当前是否已启动；如果是，它只需调用强制加载（）; 否则，它会设置一个标志以便takeContentChanged（）返回true。

必须从进程的主线程调用。

公众空隙 寄存器侦听器 （int id，OnLoadCompleteListener<D> 监听器）

注册一个类，该类将在加载完成时接收回调。回调将在进程的主线程上调用，因此可以安全地将结果传递给小部件。

必须从进程的主线程调用。

公众空隙 寄存器OnLoadCanceledListener (OnLoadCanceledListener<D> 监听器）

已在中添加API级别16

注册在取消加载时将接收回调的侦听器。回调将在进程的主线程上调用，因此可以安全地将结果传递给小部件。必须从进程的主线程调用。

参数
听众 要注册的侦听器。

公众空隙 重置 ()

此函数通常由自动调用加载器管理器销毁Loader时。使用时一台装载机加载器管理器,你不能你自己调用这个方法，否则会发生冲突装载机的管理。重置加载器的状态。此时，装载机应释放它的所有资源，因为它可能永远不会被调用；然而，它启动加载（）可能稍后被调用，此时它必须能够再次开始跑步。

这将更新Loader的内部状态，以便已启动（）和是重置（）将返回正确的值，然后调用实现的on重置（）.

必须从进程的主线程调用。

公众空隙 回滚内容更改 ()

已在中添加API等级18

报告您已放弃处理由返回takeContentChanged（）并希望回滚到再次存在挂起内容更改的状态。这是处理由于内容更改而导致数据加载的情况在其数据返回加载程序之前取消。

公众最终的空隙 开始加载 ()

此函数通常由自动调用加载器管理器当相关片段/活动正在启动。使用Loader时加载器管理器,你不能你自己调用这个方法，否则会发生冲突装载机的管理。启动Loader数据的异步加载。当结果出现时准备就绪，将在进程的主线程上调用回调。如果之前的加载已完成且仍然有效结果可能会立即传递给回调。装载机将监控数据集，如果源发生更改，可能会在将来进行回调。打电话停止加载（）将停止发送回调。

这将更新Loader的内部状态，以便已启动（）和是重置（）将返回正确的值，然后调用实现的开始加载时（）.

必须从进程的主线程调用。

公众空隙 停止加载 ()

此函数通常由自动调用加载器管理器当相关片段/活动正在停止。使用Loader时加载器管理器,你不能你自己调用这个方法，否则会发生冲突装载机的管理。

停止传递更新，直到下次启动加载（）被调用。实施应不此时使其数据无效--客户端仍然可以自由使用加载程序报告的最后数据。他们将，然而，如果数据发生变化，通常会停止报告新数据；他们可以仍然监视更改，但在和之前不得向客户报告更改如果启动加载（）稍后调用。

这将更新Loader的内部状态，以便已启动（）将返回正确的值，然后调用实现的停止加载（）.

必须从进程的主线程调用。

公众布尔值 takeContentChanged（获取内容更改） ()

采用当前标志，指示加载程序的内容是否停止时发生了更改。如果有，则返回true标志被清除。

公众的字符串 toString（字符串） ()

返回一个字符串，该字符串包含此对象。鼓励子类重写此方法并提供考虑对象类型和数据的实现。这个默认实现等效于以下表达式：

getClass（）.getName（）+“@”+整数.toHexString（hashCode（））

请参见编写有用的toString（字符串）方法如果你打算实现你自己的toString（字符串）方法。

退换商品
  • 此对象的可打印表示。

公众空隙 unregister侦听器 (OnLoadCompleteListener<D> 监听器）

删除以前添加的侦听器registerListener（int，Loader.OnLoadCompleteListener).必须从进程的主线程调用。

公众空隙 取消注册OnLoadCanceledListener (OnLoadCanceledListener<D> 听众）

已在中添加API级别16

注销以前使用添加的侦听器寄存器OnLoadCanceledListener（Loader.OnLoadCanceledListener).必须从进程的主线程调用。

参数
听众 要注销的侦听器。

受保护的方法

受保护的空隙 论放弃 ()

子类实现了这一点，以处理被放弃的情况。这是之前的可选中间状态onReset（）--这意味着客户对加载器中的任何新数据不再感兴趣，因此，加载程序不得报告任何进一步的更新。然而装载机必须保持最后报告的数据有效，直到最终onReset（）发生。你可以找回当前被遗弃的状态为被放弃（）.

受保护的布尔值 onCancelLoad（取消加载） ()

已在中添加API级别16

子类必须实现此功能，以处理对取消加载（）.这将始终从进程的主线程调用。

退换商品

受保护的空隙 onForceLoad（强制加载） ()

子类必须实现此功能，以处理对强制加载（）.这将始终从进程的主线程调用。

受保护的空隙 onReset（重置） ()

子类必须实现此功能，以重置其加载程序，根据重置（）。这不是客户直接调用的，但由于重置（）.这将始终从进程的主线程调用。

受保护的空隙 开始加载时 ()

子类必须实现这一点，以负责加载它们的数据，根据启动加载（）。这不是客户直接调用的，但由于启动加载（）.

受保护的空隙 停止加载时 ()

子类必须实现此功能，以停止其加载程序，根据停止加载（）。这不是客户直接调用的，但由于停止加载（）.这将始终从进程的主线程调用。