到顶部
Android API
公众的静态的

SyncRequest(同步请求)。建设者

延伸对象
java.lang.Object(java.lang.对象)
android内容。同步请求。建设者

课程概述

的生成器类同步请求。当您构建SyncRequest时,该类还将执行验证。

总结

公共建筑商
SyncRequest(同步请求)。建设者()
公共方法
同步请求 建造()
对请求执行验证并引发运行时异常非法数据异常如果验证失败。
SyncRequest(同步请求)。建设者 设置不允许计量(不允许布尔值)
SyncRequest(同步请求)。建设者 设置加速(布尔加急)
快速同步会立即运行,并会抢占另一个非专用的运行同步。
SyncRequest(同步请求)。建设者 setExtras(设置附加项)(捆绑捆绑)
SyncRequest(同步请求)。建设者 setIgnoreBackoff(设置忽略回退)(布尔值ignoreBackoff)
设置方便功能同步_EXTRAS_IGNORE_BACKOFF
SyncRequest(同步请求)。建设者 设置忽略设置(布尔ignoreSettings)
设置方便功能同步_EXTRAS_IGNORE_SETTINGS
SyncRequest(同步请求)。建设者 设置手动(布尔值为手动)
设置方便功能同步_额外_手动
同步请求。建设者 设置否重试(布尔值noRetry)
设置方便功能同步_EXTRAS_DO_NOT_RETRY
SyncRequest(同步请求)。建设者 setSyncAdapter(设置同步适配器)(账户账户,字符串权限)
指定此转账的权限和帐户。
SyncRequest(同步请求)。建设者 syncOnce(同步一次)()
请求立即进行同步。
SyncRequest(同步请求)。建设者 syncPeriodic(同步周期)(长轮询频率,早于秒)
建立定期同步。
[展开]
继承的方法
来自班级java.lang.Object(java.lang.对象)

公共建筑商

公众的 SyncRequest(同步请求)。建设者 ()

已在中添加API等级19

公共方法

公众的同步请求 建造 ()

已在中添加API等级19

对请求执行验证并引发运行时异常非法数据异常如果验证失败。

退换商品
  • 一个SyncRequest,包含其中的信息建筑商。

公众的SyncRequest(同步请求)。建设者 设置不允许计量 (布尔值不允许)

已在中添加API等级19

参数
不允许 true强制此传输不在按流量计费的网络上发生。默认值为false。

公众的SyncRequest(同步请求)。建设者 设置加速 (布尔加急)

已在中添加API等级19

快速同步会立即运行,并会抢占另一个非专用的运行同步。对于定期同步无效,将引发非法数据异常在里面构建()

参数
加速的 是否加快运行。默认值为false。

公众的SyncRequest(同步请求)。建设者 设置附加项 (捆绑捆绑)

已在中添加API等级19

交回可选的开发人员提供的附加功能onPerformSync(帐户、捆绑包、字符串、ContentProviderClient、SyncResult)发生。此捆绑包被复制到SyncRequest中由返回构建()例子:

String[]syncItems={“狗”,“猫”,“青蛙”,“孩子”};SyncRequest(同步请求)。建筑商建筑商=新SyncRequest。建筑商().setSyncAdapter(dummyAccount,dummyProvider).syncOnce(5*MINUTES_IN_SECS);for(字符串syncData:syncItems){额外捆绑=新捆绑();extras.setString(“数据”,syncData);builder.setExtras(附加);ContentResolver.sync(builder.build());//每个sync()请求都是针对一个唯一的同步。}
额外捆绑包中只能使用以下类型的值:
  • 整数
  • 布尔值
  • 浮子
  • 双精度
  • 字符串
  • 账户
  • 无效的
如果包中存在任何非此类型的数据,build()将抛出运行时异常。

参数
要设置的附加捆绑包。

公众的SyncRequest(同步请求)。建设者 setIgnoreBackoff(设置忽略回退) (布尔值ignoreBackoff)

已在中添加API等级19

设置方便功能同步_EXTRAS_IGNORE_BACKOFF强制同步计划进程忽略由于失败而导致的任何回退同步,以及使任何延迟至可能具有的值由适配器设置。连续的失败不会尊重这面旗帜。对无效定期同步,并将抛出非法数据异常在里面构建()

参数
忽略后退 忽略回退设置。默认值为false。

公众的SyncRequest(同步请求)。建设者 设置忽略设置 (布尔ignoreSettings)

已在中添加API等级19

设置方便功能同步_EXTRAS_IGNORE_SETTINGS同步可以指定忽略系统同步设置(用户已关闭同步)。不是对于定期同步有效,并将引发非法数据异常在里面构建()

参数
ignoreSettings(忽略设置) true忽略同步自动设置。默认值为false。

公众的SyncRequest(同步请求)。建设者 设置手动 (布尔值为手动)

已在中添加API等级19

设置方便功能同步_额外_手动手动同步在功能上等同于调用setIgnoreBackoff(布尔值)setIgnoreSettings(布尔值)。对于定期同步无效,将引发非法数据异常在里面构建()

参数
是手动的 是否由用户启动同步。默认值为false。

公众的SyncRequest(同步请求)。建设者 设置否重试 (布尔值noRetry)

已在中添加API等级19

设置方便功能同步_EXTRAS_DO_NOT_RETRY失败的一次性同步操作将通过指数回退重试,除非这被设置为false。对于定期同步无效,将引发非法数据异常在build()中。

参数
否重试 true表示不重试失败的同步。默认值为false。

公众的同步请求。建设者 setSyncAdapter(设置同步适配器) (账户账户,字符串权限)

已在中添加API等级19

指定此转账的权限和帐户。

参数
解释 要同步的帐户。可以为空,除非这是定期同步。
权威 标识要同步的内容提供程序的字符串。

公众的SyncRequest(同步请求)。建设者 syncOnce(同步一次) ()

已在中添加API等级19

请求立即进行同步。例子

SyncRequest(同步请求)。Builder Builder=(new SyncRequest.Builder()).syncOnce();

公众的SyncRequest(同步请求)。建设者 syncPeriodic(同步周期) (长轮询频率,早于秒)

已在中添加API等级19

建立定期同步。this或syncOnce()必须被这个建筑商叫来。同步由目标识别android提供程序/账户以及额外捆绑包的内容。之后,不能将同一个生成器用于一次性同步(通过调用此函数)已指定定期同步。如果你这样做了非法数据异常将被抛出。示例用法。

请求每隔5小时进行一次周期性同步,并提供20分钟的灵活性。SyncRequest(同步请求)。建筑商建筑商=(新SyncRequest.Builder()).syncPeriodic(5*HOUR_IN_SECS,20*MIN_IN_SEC);在该小时内的任何时间点,每小时安排一次定期同步。SyncRequest(同步请求)。建筑商建筑商=(new SyncRequest.Builder()).syncPeriodic(1*HOUR_IN_SECS,1*HOUR_IN_SEC);
注意:定期同步不允许有任何同步_EXTRAS_DO_NOT_RETRY,同步_EXTRAS_IGNORE_BACKOFF,同步_EXTRAS_IGNORE_SETTINGS,同步提取初始化,同步_额外_强制,同步_额外_加速,同步_额外_手动设置为true。如果提供了任何,则非法数据异常被扔掉。

参数
轮询频率 您希望的时间量(以秒为单位)在周期性同步之间消逝。
beforeSeconds之前 之前的弹性时间(以秒为单位)轮询频率你允许同步地点。必须小于轮询频率