Loader

Loader

Loader (Context context)

存储与上下文关联的应用程序上下文。 由于Loaders可以用于多个活动，因此直接存储上下文是很危险的。 总是使用getContext()来检索Loader的上下文，不要直接使用构造函数参数。 由getContext()返回的getContext()可安全地在各个Activity实例中使用。

abandon

void abandon ()

当重新启动加载程序时，通常会通过LoaderManager自动调用此函数。 当使用装载机LoaderManager ，你一定不要自己调用该方法，否则你将其加载器的管理冲突。 告诉Loader它正在被抛弃。 这被称为在reset()之前使其保留其当前数据但不报告任何新数据。

cancelLoad

boolean cancelLoad ()

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

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

commitContentChanged

void commitContentChanged ()

承诺您已经完全处理了由takeContentChanged()返回的内容更改。 这是与rollbackContentChanged()一起使用以处理负载被取消的情况。 当您完全处理负载而未被取消时调用此函数。

dataToString

String dataToString (D data)

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

deliverCancellation

void deliverCancellation ()

通知已注册Loader.OnLoadCanceledListener负载已被取消。 只能由子类调用。 必须从进程的主线程中调用。

deliverResult

void deliverResult (D data)

将加载结果发送给注册的侦听器。 只能由子类调用。 必须从进程的主线程中调用。

dump

void dump (String prefix, 
                FileDescriptor fd, 
                PrintWriter writer, 
                String[] args)

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

forceLoad

void forceLoad ()

强制执行异步加载。 与startLoading()不同，这将忽略以前加载的数据集并加载新的数据集。 这只需要调用实现的onForceLoad() 。 通常应该只在加载程序启动时调用它 - 也就是isStarted()返回true。

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

getContext

Context getContext ()

getId

int getId ()

isAbandoned

boolean isAbandoned ()

返回这个加载器是否被放弃。 在这种状态下，加载程序不得报告任何新数据，并且必须保持其上次报告的数据有效，直至最终重置。

isReset

boolean isReset ()

返回此负载是否已重置。 也就是说，装载机还没有第一次启动，或者它的reset()已经被调用。

isStarted

boolean isStarted ()

返回这个加载是否已经开始。 也就是说，它的startLoading()已被呼叫，并且尚未拨打stopLoading()或reset() 。

onContentChanged

void onContentChanged ()

当Loader.ForceLoadContentObserver检测到更改时调用。 缺省实现检查加载器是否当前已启动; 如果是这样，它只需调用forceLoad() ; 否则，它会设置一个标志，以便takeContentChanged()返回true。

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

registerListener

void registerListener (int id, 
                OnLoadCompleteListener<D> listener)

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

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

registerOnLoadCanceledListener

void registerOnLoadCanceledListener (OnLoadCanceledListener<D> listener)

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

reset

void reset ()

这个函数通常会在销毁Loader时由LoaderManager自动调用。 当使用装载机LoaderManager ，你一定不要自己调用该方法，否则你将其加载器的管理冲突。 重置Loader的状态。 装载者应该在这一点上释放所有资源，因为它可能永远不会再被调用; 然而，它的startLoading()稍后可能被调用，它必须能够再次开始运行。

这将更新Loader的内部状态，以便 isStarted()和 isReset()将返回正确的值，然后调用实现的 onReset() 。

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

rollbackContentChanged

void rollbackContentChanged ()

报告您已经放弃了由takeContentChanged()返回的内容更改处理，并且希望回滚到还有待处理内容更改的状态。 这是为了处理在数据被传送回加载程序之前，由于内容更改而导致的数据加载已被取消的情况。

startLoading

void startLoading ()

当关联的片段/活动正在启动时，通常会通过LoaderManager自动为您调用此函数。 当使用装载机LoaderManager ，你一定不要自己调用该方法，否则你将其加载器的管理冲突。 启动加载程序数据的异步加载。 当结果准备好时，回调将在进程的主线程上调用。 如果之前的加载已完成且仍然有效，则结果可能会立即传递给回调。 加载器将监视数据集的来源，并且如果源更改，可能会提供未来的回调。 拨打stopLoading()将停止传送回传。

这会更新Loader的内部状态，以便 isStarted()和 isReset()将返回正确的值，然后调用实现的 onStartLoading() 。

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

stopLoading

void stopLoading ()

当关联的片段/活动停止时，通常会通过LoaderManager自动为您调用此函数。 当使用LoaderManager的加载程序时，您不得自己调用此方法，否则您将与加载程序的管理发生冲突。

停止传送更新，直到下一次startLoading() 。 实现不应该在这一点上他们的无效数据-客户仍然可以自由使用装载机报告的最后数据。 但是，如果数据发生变化，他们通常会停止报告新数据; 他们仍然可以监视更改，但不能将它们报告给客户端，直到稍后调用startLoading() 。

这将更新Loader的内部状态，以便 isStarted()将返回正确的值，然后调用实现的 onStopLoading() 。

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

takeContentChanged

boolean takeContentChanged ()

以当前标志指示加载程序的内容在停止时是否已更改。 如果有，则返回true并且标志被清除。

toString

String toString ()

返回对象的字符串表示形式。 通常， toString方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述，对于一个人来说很容易阅读。 建议所有子类重写此方法。

用于类Object的toString方法返回一个字符串，其中包含对象为实例的类的名称，符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说，这个方法返回一个字符串，其值等于：

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

unregisterListener

void unregisterListener (OnLoadCompleteListener<D> listener)

删除先前添加了registerListener(int, Loader.OnLoadCompleteListener ) 的侦听registerListener(int, Loader.OnLoadCompleteListener ) 。 必须从进程的主线程中调用。

unregisterOnLoadCanceledListener

void unregisterOnLoadCanceledListener (OnLoadCanceledListener<D> listener)

取消注册以前添加了registerOnLoadCanceledListener(Loader.OnLoadCanceledListener ) 的侦听registerOnLoadCanceledListener(Loader.OnLoadCanceledListener ) 。 必须从进程的主线程中调用。

onAbandon

void onAbandon ()

子类实现这个来照顾被抛弃。 这是一个在onReset()之前的可选中间状态 - 这意味着客户端不再对来自加载程序的任何新数据感兴趣，因此加载程序不得报告任何更新的更新。 然而，加载器必须保持其最后报告的数据有效，直到最终的onReset()发生。 您可以使用isAbandoned()检索当前已放弃的状态。

onCancelLoad

boolean onCancelLoad ()

子类必须实现这个来处理cancelLoad()的请求。 这将始终从进程的主线程中调用。

onForceLoad

void onForceLoad ()

子类必须实现这个来处理对forceLoad()的请求。 这将始终从进程的主线程中调用。

onReset

void onReset ()

按照reset() ，子类必须实现此操作来照顾重置其加载程序。 这不是由客户直接调用，而是由于致电reset() 。 这将始终从进程的主线程中调用。

onStartLoading

void onStartLoading ()

按照startLoading() ，子类必须实现这个来负责加载它们的数据。 这不是由客户直接调用，而是由于致电startLoading() 。

onStopLoading

void onStopLoading ()

按照stopLoading() ，子类必须实现此功能以停止加载器。 这不是由客户直接调用，而是由于致电stopLoading() 。 这将始终从进程的主线程中调用。