org.apache.commons.vfs2.provider.tar
Class TarFileObject

java.lang.Object
  org.apache.commons.vfs2.provider.AbstractFileObject
      org.apache.commons.vfs2.provider.tar.TarFileObject

All Implemented Interfaces:

FileObject

public class TarFileObject
extends AbstractFileObject
implements FileObject

A file in a Tar file system.

Author:

Commons VFS team

Field Summary

protected org.apache.commons.vfs2.provider.tar.TarEntry

entry The TarEntry

Constructor Summary

protected

TarFileObject(AbstractFileName name, org.apache.commons.vfs2.provider.tar.TarEntry entry, TarFileSystem fs, boolean tarExists)

Method Summary

protected void	attachChild(FileName childName) Attaches a child
protected long	doGetContentSize() Returns the size of the file content (in bytes).
protected InputStream	doGetInputStream() Creates an input stream to read the file content from.
protected long	doGetLastModifiedTime() Returns the last modified time of this file.
protected FileType	doGetType() Returns the file's type.
protected String[]	doListChildren() Lists the children of the file.
boolean	isWriteable() Determines if this file can be written to.
protected void	setTarEntry(org.apache.commons.vfs2.provider.tar.TarEntry entry) Sets the details for this file object.

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

canRenameTo, childrenChanged, close, copyFrom, createFile, createFolder, delete, delete, doAttach, doCreateFileContent, doCreateFolder, doDelete, doDetach, doGetAttributes, doGetCertificates, doGetOutputStream, doGetRandomAccessContent, doIsHidden, doIsReadable, doIsSameFile, doIsWriteable, doListChildrenResolved, doRemoveAttribute, doRename, doSetAttribute, doSetLastModifiedTime, 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, moveTo, notifyAllStreamsClosed, onChange, onChildrenChanged, refresh, 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, moveTo, refresh, resolveFile, resolveFile

Field Detail

entry

protected org.apache.commons.vfs2.provider.tar.TarEntry entry

The TarEntry

Constructor Detail

TarFileObject

protected TarFileObject(AbstractFileName name,
                        org.apache.commons.vfs2.provider.tar.TarEntry entry,
                        TarFileSystem fs,
                        boolean tarExists)
                 throws FileSystemException

Throws:

FileSystemException

Method Detail

setTarEntry

protected void setTarEntry(org.apache.commons.vfs2.provider.tar.TarEntry entry)

Sets the details for this file object.

attachChild

protected void attachChild(FileName childName)

Attaches a child

isWriteable

public boolean isWriteable()
                    throws FileSystemException

Determines if this file can be written to.

Specified by:

isWriteable in interface FileObject

Overrides:

isWriteable in class AbstractFileObject

Returns:

true if this file is writeable, false if not.

Throws:

FileSystemException - if an error occurs.

doGetType

protected FileType doGetType()

Returns the file's type.

Specified by:

doGetType in class AbstractFileObject

Returns:

the type of the file.

doListChildren

protected String[] doListChildren()

Lists the children of the file.

Specified by:

doListChildren in class AbstractFileObject

Returns:

a possible empty String array if the file is a directory or null or an exception if the file is not a directory or can't be read.

doGetContentSize

protected long doGetContentSize()

Returns the size of the file content (in bytes). Is only called if doGetType() returns FileType.FILE.

Specified by:

doGetContentSize in class AbstractFileObject

Returns:

The size of the file in bytes.

doGetLastModifiedTime

protected long doGetLastModifiedTime()
                              throws Exception

Returns the last modified time of this file.

Overrides:

doGetLastModifiedTime in class AbstractFileObject

Returns:

The last modification time.

Throws:

Exception - if an error occurs.

doGetInputStream

protected InputStream doGetInputStream()
                                throws Exception

Creates an input stream to read the file content from. Is only called if doGetType() returns FileType.FILE. The input stream returned by this method is guaranteed to be closed before this method is called again.

Specified by:

doGetInputStream in class AbstractFileObject

Returns:

An InputStream to read the file content.

Throws:

Exception - if an error occurs.