Click here to view and discuss this page in DocCommentXchange. In the future, you will be sent there automatically.
指定是否应在同步过程中允许部分下载。
abstract void SyncParms.setKeepPartialDownload( boolean c ) throws ULjException
c 设置为 true 以启用部分下载。
缺省设置为 false。设置为 true 以在同步过程中启用和保存部分下载;否则设置为 false 以禁用部分下载,并在发生错误时回退下载。
UltraLite 能够通过 SyncObserver 对象恢复因通信错误而失败或由用户中止的下载。UltraLite 在接收下载的过程中对其进行处理。如果下载被中断,则部分下载事务仍保留在数据库中,并且可在下一次同步过程中恢复。
要指示 UltraLite 应保存部分下载,请设置为 true;否则,当发生错误时将回退下载。
如果保留了部分下载,则当 Connection.synchronize 方法退出时,SyncResult.getPartialDownloadRetained 方法将返回 true。
如果 KeepPartialDownload 同步参数设置为 true,则可恢复部分下载。要恢复部分下载,请在 setResumePartialDownload 方法设置为 true 的情况下,调用 Connection.synchronize 方法。
建议保持 KeepPartialDownload 同步参数的 true 设置,以防发生其它通信错误。如果跳过某一下载,将不执行任何上载。
您在恢复下载期间接收的下载会与下载最初开始时一样旧。如果您需要最新数据,则可以在恢复的下载完成后再立即进行一次下载。
在恢复下载时,由 SyncParms 类指定的许多同步参数是无关的参数。例如,Publications 参数就是不使用的参数。您会收到在最初下载期间请求的发布。仅需使用 setResumePartialDownload 和 setUserName 方法。如果需要,还可使用 setKeepPartialDownload 方法。
如果不再需要现有的部分下载,则可以调用 Connection.rollbackPartialDownload 回退失败的下载事务。此外,如果您尝试再次同步但没有指定 ResumePartialDownload 参数,则下次同步开始之前将回退部分下载。