public class SyncStats
extends Object
implements Parcelable
java.lang.Object | |
↳ | android.content.SyncStats |
用于记录有关同步操作结果的各种统计信息。 SyncManager通过SyncResult访问这些SyncResult
并使用其中的一些来确定同步的处置。 有关SyncResult
如何使用这些值的进一步讨论,请参见SyncResult
。
Inherited constants |
---|
From interface android.os.Parcelable
|
Fields |
|
---|---|
public static final Creator<SyncStats> |
CREATOR |
public long |
numAuthExceptions SyncAdapter无法验证请求中指定的 |
public long |
numConflictDetectedExceptions 当SyncAdapter尝试更新或删除服务器上的资源版本时,检测到存在不可恢复的版本冲突。 |
public long |
numDeletes 跟踪由SyncAdapter定义的同步操作执行多少次删除的计数器。 |
public long |
numEntries 跟踪由SyncAdapter定义的同步操作影响了多少条目的计数器。 |
public long |
numInserts 跟踪由syncAdapter定义的同步操作执行的插入次数的计数器。 |
public long |
numIoExceptions SyncAdapter出现问题,很可能是网络连接或等待网络响应的超时。 |
public long |
numParseExceptions SyncAdapter在稍后从服务器或存储中收到数据时遇到问题。 |
public long |
numSkippedEntries 跟踪在同步操作期间忽略来自服务器或本地存储区的条目数的计数器。 |
public long |
numUpdates 跟踪由syncAdapter定义的同步操作执行多少更新的计数器。 |
Public constructors |
|
---|---|
SyncStats() |
|
SyncStats(Parcel in) |
Public methods |
|
---|---|
void |
clear() 将所有计数器重置为0。 |
int |
describeContents() 描述此Parcelable实例的封送表示中包含的特殊对象的种类。 |
String |
toString() 返回对象的字符串表示形式。 |
void |
writeToParcel(Parcel dest, int flags) 将此对象平铺到一个包裹中。 |
Inherited methods |
|
---|---|
From class java.lang.Object
|
|
From interface android.os.Parcelable
|
long numAuthExceptions
SyncAdapter无法验证请求中指定的Account
。 在未来的请求可望成功之前,用户需要采取一些行动来解决。 这被认为是一个严重的错误。
long numConflictDetectedExceptions
当SyncAdapter尝试更新或删除服务器上的资源版本时,检测到存在不可恢复的版本冲突。 一旦从服务器检索到新状态,它就会自动自动清除,尽管它可能会一直保留到用户手动干预,可能是通过清除本地存储并开始通过无用的临时存储。 这被认为是一个严重的错误。
long numIoExceptions
SyncAdapter出现问题,很可能是网络连接或等待网络响应的超时。 如果稍后再次尝试请求,该请求可能会成功。 这被认为是一个软错误。
long numParseExceptions
SyncAdapter在稍后从服务器或存储中收到数据时遇到问题。 如果再次尝试请求,该问题可能会重复。 问题将需要由服务器或存储层清理(可能需要用户的帮助)。 如果SyncAdapter自己清理数据,那么它通常不会增加此值,尽管它可能仍会这样做,以便记录它必须执行一些清理。 例如,如果SyncAdapter在处理条目提要时收到来自服务器的错误条目,则可能会选择删除条目并因此取得进展,并且仍会增加此值,以便SyncAdapter可以记录发生了错误。 这被认为是一个严重的错误。
long numSkippedEntries
跟踪在同步操作期间忽略来自服务器或本地存储区的条目数的计数器。 如果SyncAdapter检测到一些不可解析的数据,但决定跳过它并继续前进而不是立即失败,则可能会发生这种情况。
int describeContents ()
描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)
的输出中包含writeToParcel(Parcel, int)
,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR
位。
Returns | |
---|---|
int |
a bitmask indicating the set of special object types marshaled by this Parcelable object instance. |
String toString ()
返回对象的字符串表示形式。 一般来说, toString
方法返回一个“文本表示”该对象的字符串。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。
toString
类的方法Object
返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @
”和对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:
getClass().getName() + '@' + Integer.toHexString(hashCode())
Returns | |
---|---|
String |
a string representation of the object. |
void writeToParcel (Parcel dest, int flags)
将此对象平铺到一个包裹中。
Parameters | |
---|---|
dest |
Parcel : The Parcel in which the object should be written. |
flags |
int : Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE . |