com.box.sdk

Class BoxFileVersion

Object

BoxResource

BoxFileVersion

@BoxResourceType(value="file_version")
public class BoxFileVersion
extends BoxResource

Represents a particular version of a file on Box.

Nested Class Summary

Nested classes/interfaces inherited from class BoxResource

BoxResource.Info

Constructor Summary

Constructors

Constructor and Description
BoxFileVersion(BoxAPIConnection api, String json, String fileID) Constructs a BoxFileVersion from a JSON string.

Method Summary

Modifier and Type	Method and Description
void	delete() Deletes this version of the file.
void	download(OutputStream output) Downloads this version of the file to a given OutputStream.
void	download(OutputStream output, ProgressListener listener) Downloads this version of the file to a given OutputStream while reporting the progress to a ProgressListener.
Date	getCreatedAt() Gets the time that this version of the file was created.
String	getFileID()
Date	getModifiedAt() Gets the time that this version of the file was modified.
BoxUser.Info	getModifiedBy() Gets information about the user who last modified this version of the file.
String	getName() Gets the name of this version of the file.
String	getSha1() Gets the SHA1 hash of this version of the file.
long	getSize() Gets the size of this version of the file.
Date	getTrashedAt() Gets the time that this version of the file was deleted.
String	getVersionID() Gets the version ID of this version of the file.
void	promote() Promotes this version of the file to be the latest version.
void	setFileID(String fileID) Used if no or wrong file id was set with constructor.

Methods inherited from class BoxResource

equals, getAPI, getID, getResourceType, hashCode

Methods inherited from class Object

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

Constructor Detail

BoxFileVersion

public BoxFileVersion(BoxAPIConnection api,
                      String json,
                      String fileID)

Constructs a BoxFileVersion from a JSON string.

Parameters:

api - the API connection to be used by the file.

json - the JSON encoded file version.

fileID - the ID of the file.

Method Detail

setFileID

public void setFileID(String fileID)

Used if no or wrong file id was set with constructor.

Parameters:

fileID - the file id this file version belongs to.

getFileID

public String getFileID()

Returns:

the file id this file version belongs to.

getVersionID

public String getVersionID()

Gets the version ID of this version of the file.

Returns:

the version ID of this version of the file.

getSha1

public String getSha1()

Gets the SHA1 hash of this version of the file.

Returns:

the SHA1 hash of this version of the file.

getName

public String getName()

Gets the name of this version of the file.

Returns:

the name of this version of the file.

getSize

public long getSize()

Gets the size of this version of the file.

Returns:

the size of this version of the file.

getCreatedAt

public Date getCreatedAt()

Gets the time that this version of the file was created.

Returns:

the time that this version of the file was created.

getModifiedAt

public Date getModifiedAt()

Gets the time that this version of the file was modified.

Returns:

the time that this version of the file was modified.

getTrashedAt

public Date getTrashedAt()

Gets the time that this version of the file was deleted.

Returns:

the time that this version of the file was deleted.

getModifiedBy

public BoxUser.Info getModifiedBy()

Gets information about the user who last modified this version of the file.

Returns:

info about the user who last modified this version of the file.

delete

public void delete()

Deletes this version of the file.

download

public void download(OutputStream output)

Downloads this version of the file to a given OutputStream.

Parameters:

output - the stream to where the file will be written.

download

public void download(OutputStream output,
                     ProgressListener listener)

Downloads this version of the file to a given OutputStream while reporting the progress to a ProgressListener.

Parameters:

output - the stream to where the file will be written.

listener - a listener for monitoring the download's progress.

promote

public void promote()

Promotes this version of the file to be the latest version.