com.dropbox.core

Class DbxEntry.File

java.lang.Object

com.dropbox.core.DbxDataObject

com.dropbox.core.DbxEntry

com.dropbox.core.DbxEntry.File

All Implemented Interfaces:

Serializable

Enclosing class:

DbxEntry

public static final class DbxEntry.File
extends DbxEntry

The subclass of DbxEntry used to represent file metadata (as opposed to folder metadata).

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class com.dropbox.core.DbxEntry

DbxEntry.File, DbxEntry.Folder, DbxEntry.WithChildren, DbxEntry.WithChildrenC<C>

Field Summary

Fields

Modifier and Type	Field and Description
Date	clientMtime The modification time sent up by the Dropbox desktop client when the file was added or modified.
String	humanSize A human-readable string version of the file size (ex: "13 kb").
Date	lastModified The time the file was added, moved, or last had it's contents changed on the Dropbox server.
String	mimeType
long	numBytes The size, in bytes, of the file content.
String	revision The revision of the file at this path.
static long	serialVersionUID

Fields inherited from class com.dropbox.core.DbxEntry

iconName, mightHaveThumbnail, name, path, Reader

Constructor Summary

Constructors

Constructor and Description
DbxEntry.File(String path, String iconName, boolean mightHaveThumbnail, long numBytes, String humanSize, Date lastModified, Date clientMtime, String mimeType, String revision)

Method Summary

Methods

Modifier and Type	Method and Description
DbxEntry.File	asFile() If this metadata entry is a file, return it as a DbxEntry.File instance.
DbxEntry.Folder	asFolder() If this metadata entry is a folder, return it as a DbxEntry.Folder instance.
protected void	dumpFields(DumpWriter w)
protected String	getTypeName()
boolean	isFile() Whether this metadata is for a file, which can be cast to type DbxEntry.File.
boolean	isFolder() Whether this metadata is for a folder, which can be cast to type DbxEntry.Folder.
String	toString() A abbreviated version of DbxDataObject.toStringMultiline().

Methods inherited from class com.dropbox.core.DbxEntry

extract

Methods inherited from class com.dropbox.core.DbxDataObject

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

Methods inherited from class java.lang.Object

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

Field Detail

serialVersionUID

public static final long serialVersionUID

See Also:

Constant Field Values

numBytes

public final long numBytes

The size, in bytes, of the file content.

humanSize

public final String humanSize

A human-readable string version of the file size (ex: "13 kb"). This string will be localized based on the Locale in DbxRequestConfig.userLocale (passed in to the DbxClient constructor).

lastModified

public final Date lastModified

The time the file was added, moved, or last had it's contents changed on the Dropbox server. (This probably won't match the time on the Dropbox user's filesystem. For that the clientMtime is a better estimate.)

clientMtime

public final Date clientMtime

The modification time sent up by the Dropbox desktop client when the file was added or modified. This time is based on the system clock of the particular host that the client was running on, as opposed to the system clock of the Dropbox servers.

This field should not be used to determine if a file has changed, but only as a way to sort files by date (when displaying a list of files to the user).

mimeType

public final String mimeType

revision

public final String revision

The revision of the file at this path. This can be used with DbxClient.uploadFile(java.lang.String, com.dropbox.core.DbxWriteMode, long, java.io.InputStream) and the DbxWriteMode.update(java.lang.String) mode to make sure you're overwriting the revision of the file you think you're overwriting.

Constructor Detail

DbxEntry.File

public DbxEntry.File(String path,
             String iconName,
             boolean mightHaveThumbnail,
             long numBytes,
             String humanSize,
             Date lastModified,
             Date clientMtime,
             String mimeType,
             String revision)

Parameters:

path - DbxEntry.path

iconName - DbxEntry.iconName

mightHaveThumbnail - DbxEntry.mightHaveThumbnail

numBytes - numBytes

humanSize - humanSize

lastModified - lastModified

clientMtime - clientMtime

mimeType - mimeType

revision - revision

Method Detail

dumpFields

protected void dumpFields(DumpWriter w)

Overrides:

dumpFields in class DbxEntry

getTypeName

protected String getTypeName()

Overrides:

getTypeName in class DbxDataObject

toString

public String toString()

A abbreviated version of DbxDataObject.toStringMultiline(). Only includes the path.

Overrides:

toString in class Object

isFolder

public boolean isFolder()

Description copied from class: DbxEntry

Whether this metadata is for a folder, which can be cast to type DbxEntry.Folder. (Every metadata object is either for a file or a folder.)

Specified by:

isFolder in class DbxEntry

isFile

public boolean isFile()

Description copied from class: DbxEntry

Whether this metadata is for a file, which can be cast to type DbxEntry.File. (Every metadata object is either for a file or a folder.)

Specified by:

isFile in class DbxEntry

asFolder

public DbxEntry.Folder asFolder()

Description copied from class: DbxEntry

If this metadata entry is a folder, return it as a DbxEntry.Folder instance. If it's not a folder, return null.

Specified by:

asFolder in class DbxEntry

asFile

public DbxEntry.File asFile()

Description copied from class: DbxEntry

If this metadata entry is a file, return it as a DbxEntry.File instance. If it's not a file, return null.

Specified by:

asFile in class DbxEntry