com.lf.vfslib.gdrive

Class GDriveFileObject

java.lang.Object

org.apache.commons.vfs2.provider.AbstractFileObject

com.lf.vfslib.gdrive.GDriveFileObject

All Implemented Interfaces:

org.apache.commons.vfs2.FileObject

public class GDriveFileObject
extends org.apache.commons.vfs2.provider.AbstractFileObject
implements org.apache.commons.vfs2.FileObject

Represents a Google® Drive file or folder.

Since:

1.6

Version:

$Revision: 1.7 $, $Date: 2013/10/19 15:29:46 $

Author:

Axel Schwolow

Field Summary

Fields

Modifier and Type	Field and Description
protected GDriveFileSystem	fileSystem The underlying file system.
protected com.google.api.services.drive.model.File	googleFile The underlying Google® Drive file/folder.
protected boolean	inRefresh Helper to avoid multiple refreshing.
protected java.lang.String	relPath The relative path on the Google® Drive server.
protected java.lang.String	rootID The shared ID of the Google® Drive root folder.

Constructor Summary

Constructors

Constructor and Description
GDriveFileObject(org.apache.commons.vfs2.provider.AbstractFileName name, GDriveFileSystem filesystem) Constructor method.

Method Summary

Methods

Modifier and Type	Method and Description
protected void	doCreateFolder() Creates this file as a folder.
protected void	doDelete() Deletes the file.
protected void	doDetach() Detach from the file system.
protected long	doGetContentSize() Returns the size of the file content (in bytes).
protected java.io.InputStream	doGetInputStream() Creates an input stream to read the file content from.
protected long	doGetLastModifiedTime() Gets the last modification date and time.
protected java.io.OutputStream	doGetOutputStream(boolean append) Creates an output stream to write the file content to.
protected org.apache.commons.vfs2.RandomAccessContent	doGetRandomAccessContent(org.apache.commons.vfs2.util.RandomAccessMode mode) Provides the instance to model random access for files.
protected org.apache.commons.vfs2.FileType	doGetType() Determines the type of this file, returns null if the file does not exist.
protected java.lang.String[]	doListChildren() Lists the children of this file.
protected org.apache.commons.vfs2.FileObject[]	doListChildrenResolved() Lists the children of this file.
protected void	doRename(org.apache.commons.vfs2.FileObject newfile) Rename the file.
protected boolean	doSetLastModifiedTime(long modtime) Sets the last modified time of this file.
VFSLib	getVFSLib() Provides the VFSLib instance for this filesystem.
protected void	onChange() Called when the type or content of this file changes.
void	refresh() Refresh this file.
protected void	statSelf() Determines the type of this file.

Methods inherited from class org.apache.commons.vfs2.provider.AbstractFileObject

canRenameTo, childrenChanged, close, copyFrom, createFile, createFolder, delete, delete, doAttach, doCreateFileContent, doGetAttributes, doGetCertificates, doIsHidden, doIsReadable, doIsSameFile, doIsWriteable, doRemoveAttribute, doSetAttribute, endOutput, exists, finalize, findFiles, findFiles, getChild, getChildren, getContent, getFileContentInfoFactory, getFileOperations, getFileSystem, getInputStream, getName, getOutputStream, getOutputStream, getParent, getRandomAccessContent, getType, getURL, handleChanged, handleCreate, handleDelete, holdObject, injectType, isAttached, isContentOpen, isHidden, isReadable, isSameFile, isWriteable, moveTo, notifyAllStreamsClosed, onChildrenChanged, resolveFile, resolveFile, toString

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.commons.vfs2.FileObject

canRenameTo, close, copyFrom, createFile, createFolder, delete, delete, exists, findFiles, findFiles, getChild, getChildren, getContent, getFileOperations, getFileSystem, getName, getParent, getType, getURL, isAttached, isContentOpen, isHidden, isReadable, isWriteable, moveTo, resolveFile, resolveFile

Field Detail

fileSystem

protected final GDriveFileSystem fileSystem

The underlying file system.

relPath

protected java.lang.String relPath

The relative path on the Google® Drive server.

inRefresh

protected boolean inRefresh

Helper to avoid multiple refreshing.

googleFile

protected com.google.api.services.drive.model.File googleFile

The underlying Google® Drive file/folder.

rootID

protected java.lang.String rootID

The shared ID of the Google® Drive root folder.

Constructor Detail

GDriveFileObject

public GDriveFileObject(org.apache.commons.vfs2.provider.AbstractFileName name,
                GDriveFileSystem filesystem)
                 throws org.apache.commons.vfs2.FileSystemException

Constructor method.

Parameters:

name - The file name

filesystem - The file system

Throws:

java.lang.NullPointerException - If a parameter is null

org.apache.commons.vfs2.FileSystemException - If something goes wrong

Since:

1.6

Method Detail

doDetach

protected void doDetach()
                 throws java.lang.Exception

Detach from the file system.

Overrides:

doDetach in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

refresh

public void refresh()
             throws org.apache.commons.vfs2.FileSystemException

Refresh this file.

Specified by:

refresh in interface org.apache.commons.vfs2.FileObject

Overrides:

refresh in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

org.apache.commons.vfs2.FileSystemException - If something goes wrong

Since:

1.6

doGetType

protected org.apache.commons.vfs2.FileType doGetType()
                                              throws java.lang.Exception

Determines the type of this file, returns null if the file does not exist.

Specified by:

doGetType in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The file type

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

statSelf

protected void statSelf()
                 throws java.lang.Exception

Determines the type of this file.

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

onChange

protected void onChange()
                 throws java.lang.Exception

Called when the type or content of this file changes.

Overrides:

onChange in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doCreateFolder

protected void doCreateFolder()
                       throws java.lang.Exception

Creates this file as a folder.

Overrides:

doCreateFolder in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doGetLastModifiedTime

protected long doGetLastModifiedTime()
                              throws java.lang.Exception

Gets the last modification date and time.

Overrides:

doGetLastModifiedTime in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The last modification time in milliseconds

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doSetLastModifiedTime

protected boolean doSetLastModifiedTime(long modtime)
                                 throws java.lang.Exception

Sets the last modified time of this file.

Overrides:

doSetLastModifiedTime in class org.apache.commons.vfs2.provider.AbstractFileObject

Parameters:

modtime - Last modification time in milliseconds

Returns:

Successful?

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doDelete

protected void doDelete()
                 throws java.lang.Exception

Deletes the file.

Entries either can be put into trash (may be restored) or be deleted permanently here.

Overrides:

doDelete in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

See Also:

GDriveFileSystemConfigBuilder.setUseTrash(FileSystemOptions, Boolean)

doRename

protected void doRename(org.apache.commons.vfs2.FileObject newfile)
                 throws java.lang.Exception

Rename the file.

This may take a while that Google Drive has finished renaming the file/folder internally. So please give it a little timeout before exists() etc. is called.

Overrides:

doRename in class org.apache.commons.vfs2.provider.AbstractFileObject

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doListChildrenResolved

protected org.apache.commons.vfs2.FileObject[] doListChildrenResolved()
                                                               throws java.lang.Exception

Lists the children of this file.

Overrides:

doListChildrenResolved in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The list of children, may be empty

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doListChildren

protected java.lang.String[] doListChildren()
                                     throws java.lang.Exception

Lists the children of this file.

Specified by:

doListChildren in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The list of children, may be empty

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doGetContentSize

protected long doGetContentSize()
                         throws java.lang.Exception

Returns the size of the file content (in bytes).

Specified by:

doGetContentSize in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The size, -1 if not available

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doGetRandomAccessContent

protected org.apache.commons.vfs2.RandomAccessContent doGetRandomAccessContent(org.apache.commons.vfs2.util.RandomAccessMode mode)
                                                                        throws java.lang.Exception

Provides the instance to model random access for files.

Overrides:

doGetRandomAccessContent in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The instance

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doGetInputStream

protected java.io.InputStream doGetInputStream()
                                        throws java.lang.Exception

Creates an input stream to read the file content from.

Specified by:

doGetInputStream in class org.apache.commons.vfs2.provider.AbstractFileObject

Returns:

The input stream

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

doGetOutputStream

protected java.io.OutputStream doGetOutputStream(boolean append)
                                          throws java.lang.Exception

Creates an output stream to write the file content to.

Overrides:

doGetOutputStream in class org.apache.commons.vfs2.provider.AbstractFileObject

Parameters:

append - Append? Create freshly otherwise.

Returns:

The output stream

Throws:

java.lang.Exception - If something goes wrong

Since:

1.6

getVFSLib

public VFSLib getVFSLib()

Provides the VFSLib instance for this filesystem.

Returns:

The instance

Since:

1.6