com.dropbox.core

Class DbxDeltaC<C,MD extends DbxDataObject>

java.lang.Object

com.dropbox.core.DbxDataObject

com.dropbox.core.DbxDeltaC<C,MD>

Type Parameters:

C - The type of value used to aggregate all the delta entries. For example, if you process the delta entries as they come in and throw the rest away

MD - The type of metadata being returned in the delta results. For example, in the DbxClient.getDeltaC(java.lang.String, com.dropbox.core.util.Collector<com.dropbox.core.DbxDeltaC.Entry<com.dropbox.core.DbxEntry>, C>), this is instantiated to DbxEntry.

public class DbxDeltaC<C,MD extends DbxDataObject>
extends DbxDataObject

Represents a single "page" of results from a delta-style API call. This is the more generic version of DbxDelta object.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DbxDeltaC.Entry<MD extends DbxDataObject> A single "delta entry" in a DbxDeltaC page.
static class	DbxDeltaC.Reader<C,MD extends DbxDataObject> For JSON parsing.

Field Summary

Fields

Modifier and Type	Field and Description
String	cursor A string that is used by the server to keep track of which entries have already been returned to you.
C	entries Apply these entries to your local state to catch up with the Dropbox server's state.
boolean	hasMore If true, then there are more entries available.
boolean	reset If true, then you should reset your local state to be an empty folder before processing the list of delta entries.

Constructor Summary

Constructors

Constructor and Description
DbxDeltaC(boolean reset, C entries, String cursor, boolean hasMore)

Method Summary

Methods

Modifier and Type	Method and Description
protected void	dumpFields(DumpWriter out)

Methods inherited from class com.dropbox.core.DbxDataObject

dump, dump, dump, dump, dump, getTypeName, toStringDate, toStringMultiline, toStringMultiline

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

reset

public final boolean reset

If true, then you should reset your local state to be an empty folder before processing the list of delta entries.

This is always true for the first delta result, but for subsequent results it is true only in true rare situations. For example, if Dropbox changes their cursor format, or if a user asks Dropbox to completely reset his/her account, then the next time you call a delta API it may send down a reset and start you from scratch.

entries

public final C entries

Apply these entries to your local state to catch up with the Dropbox server's state.

cursor

public final String cursor

A string that is used by the server to keep track of which entries have already been returned to you. This is what you pass in to the next API call to continue where you left off.

This cursor is valid for a long time. You'd typically store this somewhere persistent (such as a database) so you can resume continue you left off.

hasMore

public final boolean hasMore

If true, then there are more entries available. You can retrieve them immediately by making the call again (passing in cursor). If false, then wait at least 5 minutes before checking again.

Constructor Detail

DbxDeltaC

public DbxDeltaC(boolean reset,
         C entries,
         String cursor,
         boolean hasMore)

Parameters:

reset - reset

entries - entries

cursor - cursor

hasMore - hasMore

Method Detail

dumpFields

protected void dumpFields(DumpWriter out)

Specified by:

dumpFields in class DbxDataObject