com.dropbox.core.v2.files

Class CommitInfo

java.lang.Object

com.dropbox.core.v2.files.CommitInfo

public class CommitInfo
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	CommitInfo.Builder Builder for CommitInfo.

Field Summary

Fields

Modifier and Type	Field and Description
protected boolean	autorename
protected Date	clientModified
protected WriteMode	mode
protected boolean	mute
protected String	path

Constructor Summary

Constructors

Constructor and Description
CommitInfo(String path) None
CommitInfo(String path, WriteMode mode, boolean autorename, Date clientModified, boolean mute) Use newBuilder to create instances of this class without specifying values for all optional fields.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object obj)
boolean	getAutorename() If there's a conflict, as determined by getMode(), have the Dropbox server try to autorename the file to avoid conflict.
Date	getClientModified() The value to store as the getClientModified() timestamp.
WriteMode	getMode() Selects what to do if the file already exists.
boolean	getMute() Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software.
String	getPath() Path in the user's Dropbox to save the file.
int	hashCode()
static CommitInfo.Builder	newBuilder(String path) Returns a new builder for creating an instance of this class.
String	toString()
String	toStringMultiline() Returns a String representation of this object formatted for easier readability.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

path

protected final String path

mode

protected final WriteMode mode

autorename

protected final boolean autorename

clientModified

protected final Date clientModified

mute

protected final boolean mute

Constructor Detail

CommitInfo

public CommitInfo(String path,
                  WriteMode mode,
                  boolean autorename,
                  Date clientModified,
                  boolean mute)

Use newBuilder to create instances of this class without specifying values for all optional fields.

Parameters:

path - Path in the user's Dropbox to save the file. Must match pattern "(/(.|[\\r\\n])*)|(ns:[0-9]+(/.*)?)" and not be null.

mode - Selects what to do if the file already exists. Must not be null.

autorename - If there's a conflict, as determined by getMode(), have the Dropbox server try to autorename the file to avoid conflict.

clientModified - The value to store as the getClientModified() timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified.

mute - Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification.

Throws:

IllegalArgumentException - If any argument does not meet its preconditions.

CommitInfo

public CommitInfo(String path)

None

The default values for unset fields will be used.

Parameters:

path - Path in the user's Dropbox to save the file. Must match pattern "(/(.|[\\r\\n])*)|(ns:[0-9]+(/.*)?)" and not be null.

Throws:

IllegalArgumentException - If any argument does not meet its preconditions.

Method Detail

getPath

public String getPath()

Path in the user's Dropbox to save the file.

Returns:

value for this field, never null.

getMode

public WriteMode getMode()

Selects what to do if the file already exists.

Returns:

value for this field, or null if not present. Defaults to WriteMode.ADD.

getAutorename

public boolean getAutorename()

If there's a conflict, as determined by getMode(), have the Dropbox server try to autorename the file to avoid conflict.

Returns:

value for this field, or null if not present. Defaults to false.

getClientModified

public Date getClientModified()

The value to store as the getClientModified() timestamp. Dropbox automatically records the time at which the file was written to the Dropbox servers. It can also record an additional timestamp, provided by Dropbox desktop clients, mobile clients, and API apps of when the file was actually created or modified.

Returns:

value for this field, or null if not present.

getMute

public boolean getMute()

Normally, users are made aware of any file modifications in their Dropbox account via notifications in the client software. If true, this tells the clients that this modification shouldn't result in a user notification.

Returns:

value for this field, or null if not present. Defaults to false.

newBuilder

public static CommitInfo.Builder newBuilder(String path)

Returns a new builder for creating an instance of this class.

Parameters:

path - Path in the user's Dropbox to save the file. Must match pattern "(/(.|[\\r\\n])*)|(ns:[0-9]+(/.*)?)" and not be null.

Returns:

builder for this class.

Throws:

IllegalArgumentException - If any argument does not meet its preconditions.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

toString

public String toString()

Overrides:

toString in class Object

toStringMultiline

public String toStringMultiline()

Returns a String representation of this object formatted for easier readability.

The returned String may contain newlines.

Returns:

Formatted, multiline String representation of this object