Package org.apache.commons.vfs2.provider.tar

Class TarFileObject

java.lang.Object

org.apache.commons.vfs2.provider.AbstractFileObject<TarFileSystem>

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

All Implemented Interfaces:

Closeable, AutoCloseable, Comparable<FileObject>, Iterable<FileObject>, FileObject

public class TarFileObject
extends AbstractFileObject<TarFileSystem>

A file in a Tar file system.

Field Summary

Fields

Modifier and Type	Field	Description
private final HashSet<String>	children
private org.apache.commons.compress.archivers.tar.TarArchiveEntry	entry	The TarArchiveEntry
private FileType	type

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

DEFAULT_BUFFER_SIZE

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

EMPTY_ARRAY

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	TarFileObject(AbstractFileName name, org.apache.commons.compress.archivers.tar.TarArchiveEntry entry, TarFileSystem fs, boolean tarExists)

Method Summary

Modifier and Type	Method	Description
protected void	attachChild(FileName childName)	Attaches a child.
protected long	doGetContentSize()	Returns the size of the file content (in bytes).
protected InputStream	doGetInputStream(int bufferSize)	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.compress.archivers.tar.TarArchiveEntry entry)	Sets the details for this file object.

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

canRenameTo, childrenChanged, close, compareTo, copyFrom, createFile, createFolder, delete, delete, deleteAll, doAttach, doCreateFileContent, doCreateFolder, doDelete, doDetach, doGetAttributes, doGetCertificates, doGetInputStream, doGetOutputStream, doGetRandomAccessContent, doIsExecutable, doIsHidden, doIsReadable, doIsSameFile, doIsSymbolicLink, doIsWriteable, doListChildrenResolved, doRemoveAttribute, doRename, doSetAttribute, doSetExecutable, doSetLastModifiedTime, doSetReadable, doSetWritable, endOutput, exists, finalize, findFiles, findFiles, getAbstractFileSystem, getChild, getChildren, getContent, getFileContentInfoFactory, getFileOperations, getFileSystem, getInputStream, getInputStream, getName, getOutputStream, getOutputStream, getParent, getPublicURIString, getRandomAccessContent, getType, getURL, handleChanged, handleCreate, handleDelete, holdObject, injectType, isAttached, isContentOpen, isExecutable, isFile, isFolder, isHidden, isReadable, isSameFile, isSymbolicLink, iterator, listFiles, moveTo, notifyAllStreamsClosed, onChange, onChildrenChanged, refresh, resolveFile, resolveFile, setExecutable, setReadable, setWritable, 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

getPath, getURI

Methods inherited from interface java.lang.Iterable

forEach, spliterator

Field Details

entry

private org.apache.commons.compress.archivers.tar.TarArchiveEntry entry

The TarArchiveEntry

children

private final HashSet<String> children

type

private FileType type

Constructor Details

TarFileObject

protected TarFileObject(AbstractFileName name,
 org.apache.commons.compress.archivers.tar.TarArchiveEntry entry,
 TarFileSystem fs,
 boolean tarExists)

Method Details

setTarEntry

protected void setTarEntry(org.apache.commons.compress.archivers.tar.TarArchiveEntry entry)

Sets the details for this file object. Consider this method package private. TODO Might be made package private in the next major version.

Parameters:

entry - Tar archive entry.

attachChild

protected void attachChild(FileName childName)

Attaches a child.

Parameters:

childName - Name of child to remember.

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<TarFileSystem>

Returns:

true if this file is writable, false if not.

Throws:

FileSystemException - if an error occurs.

doGetType

protected FileType doGetType()

Returns the file's type.

Specified by:

doGetType in class AbstractFileObject<TarFileSystem>

Returns:

the type of the file.

doListChildren

protected String[] doListChildren()

Lists the children of the file.

Specified by:

doListChildren in class AbstractFileObject<TarFileSystem>

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<TarFileSystem>

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<TarFileSystem>

Returns:

The last modification time.

Throws:

Exception - if an error occurs.

doGetInputStream

protected InputStream doGetInputStream(int bufferSize)
                                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.

Overrides:

doGetInputStream in class AbstractFileObject<TarFileSystem>

Parameters:

bufferSize - Buffer size hint.

Returns:

An InputStream to read the file content.

Throws:

Exception - if an error occurs.