AbstractThreadedSyncAdapter

public abstract class AbstractThreadedSyncAdapter
extends Object

一个SyncAdapter的抽象实现，它产生一个线程来调用同步操作。 如果在收到同步请求时同步操作已在进行中，则会向新请求返回错误，并允许现有请求继续。 但是，如果没有同步正在进行，则会生成一个线程并在该线程上调用onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult) 。

框架可以随时取消Syncs。 例如，一个非用户启动并且持续时间超过30分钟的同步将被视为超时并取消。 同样，框架将尝试通过在一分钟内监控其网络活动来确定适配器是否正在取得进展。 如果通过此窗口的网络流量足够接近零，则同步将被取消。 您还可以通过cancelSync(Account, String)或cancelSync(SyncRequest)请求取消同步。

通过在同步线程上发出interrupt()来取消同步。 onPerformSync(Account, Bundle, String, ContentProviderClient, SyncResult)的代码必须检查interrupted() ，或者您必须覆盖onSyncCanceled(Thread) onSyncCanceled() （具体取决于您的适配器是否支持并行同步多个帐户）。 如果您的适配器不尊重框架发布的取消请求，那么您的应用程序的整个流程将被终止。

为了同步适配器必须扩展这个类，为抽象方法的实现，并编写返回结果的服务getSyncAdapterBinder()在服务的onBind(android.content.Intent)时与动作的通知调用android.content.SyncAdapter 。 此服务必须在其AndroidManifest.xml文件中指定以下意图过滤器和元数据标记

   <intent-filter>
     <action android:name="android.content.SyncAdapter" />
   </intent-filter>
   <meta-data android:name="android.content.SyncAdapter"
             android:resource="@xml/syncadapter" />
 

 <sync-adapter xmlns:android="http://schemas.android.com/apk/res/android"
    android:contentAuthority="authority"
    android:accountType="accountType"
    android:userVisible="true|false"
    android:supportsUploading="true|false"
    android:allowParallelSyncs="true|false"
    android:isAlwaysSyncable="true|false"
    android:syncAdapterSettingsAction="ACTION_OF_SETTINGS_ACTIVITY"
 />
 

• The android:contentAuthority and android:accountType attributes indicate which content authority and for which account types this sync adapter serves.
• android:userVisible defaults to true and controls whether or not this sync adapter shows up in the Sync Settings screen.
• android:supportsUploading defaults to true and if true an upload-only sync will be requested for all syncadapters associated with an authority whenever that authority's content provider does a notifyChange(android.net.Uri, android.database.ContentObserver, boolean) with syncToNetwork set to true.
• android:allowParallelSyncs defaults to false and if true indicates that the sync adapter can handle syncs for multiple accounts at the same time. Otherwise the SyncManager will wait until the sync adapter is not in use before requesting that it sync an account's data.
• android:isAlwaysSyncable defaults to false and if true tells the SyncManager to intialize the isSyncable state to 1 for that sync adapter for each account that is added.
• android:syncAdapterSettingsAction defaults to null and if supplied it specifies an Intent action of an activity that can be used to adjust the sync adapter's sync settings. The activity must live in the same package as the sync adapter.

Summary

Inherited methods

From class java.lang.Object Object clone() 创建并返回此对象的副本。 boolean equals(Object obj) 指示其他某个对象是否“等于”这一个。 void finalize() 当垃圾收集确定没有更多对该对象的引用时，由对象上的垃圾回收器调用。 final Class<?> getClass() 返回此 Object的运行时类。 int hashCode() 返回对象的哈希码值。 final void notify() 唤醒正在等待该对象监视器的单个线程。 final void notifyAll() 唤醒在该对象监视器上等待的所有线程。 String toString() 返回对象的字符串表示形式。 final void wait(long millis, int nanos) 导致当前线程等待，直到其他线程调用 notify()方法或 notifyAll()方法此对象，或一些其它线程中断当前线程，或实时一定量已过去。 final void wait(long millis) 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法或经过了指定的时间量。 final void wait() 导致当前线程等待，直到另一个线程调用此对象的 notify()方法或 notifyAll()方法。

Constants

int LOG_SYNC_DETAILS

Public constructors

AbstractThreadedSyncAdapter (Context context, 
                boolean autoInitialize)

AbstractThreadedSyncAdapter (Context context, 
                boolean autoInitialize, 
                boolean allowParallelSyncs)

Public methods

Context getContext ()

IBinder getSyncAdapterBinder ()

void onPerformSync (Account account, 
                Bundle extras, 
                String authority, 
                ContentProviderClient provider, 
                SyncResult syncResult)

void onSecurityException (Account account, 
                Bundle extras, 
                String authority, 
                SyncResult syncResult)

void onSyncCanceled (Thread thread)

void onSyncCanceled ()