org.apache.commons.vfs2.provider.zip

Class ZipFileObject

java.lang.Object

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

org.apache.commons.vfs2.provider.zip.ZipFileObject

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, java.lang.Comparable<FileObject>, java.lang.Iterable<FileObject>, FileObject

Direct Known Subclasses:

JarFileObject

public class ZipFileObject
extends AbstractFileObject<ZipFileSystem>

A file in a ZIP file system.

Field Summary

Fields

Modifier and Type	Field and Description
private java.util.HashSet<java.lang.String>	children
protected java.util.zip.ZipEntry	entry The ZipEntry.
private FileType	type

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ZipFileObject(AbstractFileName name, java.util.zip.ZipEntry entry, ZipFileSystem fs, boolean zipExists)

Method Summary

Modifier and Type	Method and Description
void	attachChild(FileName childName) Attaches a child.
protected void	doAttach() Attaches this file object to its file resource.
protected void	doDetach() Detaches this file object from its file resource.
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() Returns the last modified time of this file.
protected FileType	doGetType() Returns the file's type.
protected java.lang.String[]	doListChildren() Lists the children of the file.
boolean	isWriteable() Determines if this file can be written to.
protected void	setZipEntry(java.util.zip.ZipEntry 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, doCreateFileContent, doCreateFolder, doDelete, doGetAttributes, doGetCertificates, 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, 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 java.lang.Iterable

forEach, spliterator

Field Detail

entry

protected java.util.zip.ZipEntry entry

The ZipEntry.

children

private final java.util.HashSet<java.lang.String> children

type

private FileType type

Constructor Detail

ZipFileObject

protected ZipFileObject(AbstractFileName name,
                        java.util.zip.ZipEntry entry,
                        ZipFileSystem fs,
                        boolean zipExists)
                 throws FileSystemException

Throws:

FileSystemException

Method Detail

setZipEntry

protected void setZipEntry(java.util.zip.ZipEntry entry)

Sets the details for this file object.

Parameters:

entry - ZIP information related to this file.

attachChild

public void attachChild(FileName childName)

Attaches a child.

TODO: Shouldn't this method have package-only visibility? Cannot change this without breaking binary compatibility.

Parameters:

childName - The name of the 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<ZipFileSystem>

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

Returns:

the type of the file.

doListChildren

protected java.lang.String[] doListChildren()

Lists the children of the file.

Specified by:

doListChildren in class AbstractFileObject<ZipFileSystem>

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

Returns:

The size of the file in bytes.

doGetLastModifiedTime

protected long doGetLastModifiedTime()
                              throws java.lang.Exception

Returns the last modified time of this file.

Overrides:

doGetLastModifiedTime in class AbstractFileObject<ZipFileSystem>

Returns:

The last modification time.

Throws:

java.lang.Exception - if an error occurs.

doGetInputStream

protected java.io.InputStream doGetInputStream()
                                        throws java.lang.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<ZipFileSystem>

Returns:

An InputStream to read the file content.

Throws:

java.lang.Exception - if an error occurs.

doAttach

protected void doAttach()
                 throws java.lang.Exception

Description copied from class: AbstractFileObject

Attaches this file object to its file resource.

This method is called before any of the doBlah() or onBlah() methods. Sub-classes can use this method to perform lazy initialisation.

This implementation does nothing.

Overrides:

doAttach in class AbstractFileObject<ZipFileSystem>

Throws:

java.lang.Exception - if an error occurs.

doDetach

protected void doDetach()
                 throws java.lang.Exception

Description copied from class: AbstractFileObject

Detaches this file object from its file resource.

Called when this file is closed. Note that the file object may be reused later, so should be able to be reattached.

This implementation does nothing.

Overrides:

doDetach in class AbstractFileObject<ZipFileSystem>

Throws:

java.lang.Exception - if an error occurs.