SyncRequest.Builder

SyncRequest.Builder

SyncRequest.Builder ()

build

SyncRequest build ()

如果此验证失败，则执行对请求的验证并引发运行时异常 IllegalArgumentException 。

setDisallowMetered

SyncRequest.Builder setDisallowMetered (boolean disallow)

如果被调用并且 setIgnoreSettings(boolean)已经被调用，将抛出 IllegalArgumentException 。

setExpedited

SyncRequest.Builder setExpedited (boolean expedited)

加速同步立即运行，并可以抢占其他非加速运行同步。 对于周期性同步无效， IllegalArgumentException在build()抛出build() 。

setExtras

SyncRequest.Builder setExtras (Bundle bundle)

实际发生同步时，开发人员提供的附加功能会返回。 该捆绑包被复制到由build()返回的build() 。 例：

   String[] syncItems = {"dog", "cat", "frog", "child"};
   SyncRequest.Builder builder =
     new SyncRequest.Builder()
       .setSyncAdapter(dummyAccount, dummyProvider)
       .syncOnce();

   for (String syncData : syncItems) {
     Bundle extras = new Bundle();
     extras.setString("data", syncData);
     builder.setExtras(extras);
     ContentResolver.sync(builder.build()); // Each sync() request creates a unique sync.
   }
 

• Integer
• Long
• Boolean
• Float
• Double
• String
• Account
• null

setIgnoreBackoff

SyncRequest.Builder setIgnoreBackoff (boolean ignoreBackoff)

方便功能设置SYNC_EXTRAS_IGNORE_BACKOFF 。 忽略退避将强制同步调度进程忽略任何由同步失败导致的delayUntil ，以及使可能由适配器设置的任何delayUntil值无效。 连续的失败不会兑现这个标志。 对于周期性同步无效， IllegalArgumentException在build()抛出build() 。

setIgnoreSettings

SyncRequest.Builder setIgnoreSettings (boolean ignoreSettings)

方便功能设置SYNC_EXTRAS_IGNORE_SETTINGS 。 不适用于定期同步，将抛出IllegalArgumentException在build() 。

如果调用， setDisallowMetered(boolean)抛出 IllegalArgumentException ，并且 setDisallowMetered(boolean)已被设置。

setManual

SyncRequest.Builder setManual (boolean isManual)

方便功能设置SYNC_EXTRAS_MANUAL 。 对于周期性同步无效， IllegalArgumentException在build()抛出build() 。

setNoRetry

SyncRequest.Builder setNoRetry (boolean noRetry)

方便功能设置SYNC_EXTRAS_DO_NOT_RETRY 。 除非设置为false，否则失败的一次性同步操作将以指数回退重试。 对于定期同步无效，并会在build（）中引发IllegalArgumentException 。

setRequiresCharging

SyncRequest.Builder setRequiresCharging (boolean requiresCharging)

指定同步是否需要插入电话。

setSyncAdapter

SyncRequest.Builder setSyncAdapter (Account account, 
                String authority)

为此传输指定一个权限和帐户。

syncOnce

SyncRequest.Builder syncOnce ()

请求立即发生同步。 例

     SyncRequest.Builder builder = (new SyncRequest.Builder()).syncOnce();
 

syncPeriodic

SyncRequest.Builder syncPeriodic (long pollFrequency, 
                long beforeSeconds)

建立一个定期同步。 必须为此构建器调用this或syncOnce（）。 同步由目标android.provider和附加软件包的内容标识。 在指定周期性同步后（通过调用此函数），您不能重复使用同一个构建器进行一次性同步。 如果你这样做， IllegalArgumentException将被抛出。

用于定期同步的软件包可以使用getPeriodicSyncs(Account, String)由具有正确权限的应用程序查询，因此不应在此传输敏感数据。 用法示例。

     Request a periodic sync every 5 hours with 20 minutes of flex.
     SyncRequest.Builder builder =
         (new SyncRequest.Builder()).syncPeriodic(5 * HOUR_IN_SECS, 20 * MIN_IN_SECS);

     Schedule a periodic sync every hour at any point in time during that hour.
     SyncRequest.Builder builder =
         (new SyncRequest.Builder()).syncPeriodic(1 * HOUR_IN_SECS, 1 * HOUR_IN_SECS);