com.caucho.vfs
Class Jar

java.lang.Object
  com.caucho.vfs.Jar

All Implemented Interfaces:

CacheListener

public class Jar
extends java.lang.Object
implements CacheListener

Jar is a cache around a jar file to avoid scanning through the whole file on each request.

When the Jar is created, it scans the file and builds a directory of the Jar entries.

Method Summary

boolean	canRead(java.lang.String path) Readable if the jar is readable and the path refers to a file.
boolean	canWrite(java.lang.String path) Can't write to jars.
void	clearCache() Clears any cached JarFile.
static void	clearJarCache() Clears all the cached files in the jar.
void	close()
static PersistentDependency	createDepend(Path backing) Return a Jar for the path.
static PersistentDependency	createDepend(Path backing, long digest) Return a Jar for the path.
boolean	equals(java.lang.Object o)
boolean	exists(java.lang.String path) Returns true if the entry exists in the jar.
java.security.cert.Certificate[]	getCertificates(java.lang.String path) Returns any certificates.
PersistentDependency	getDepend() Returns the dependency.
long	getLastModified(java.lang.String path) Returns the length of the entry in the jar file.
long	getLength(java.lang.String path) Returns the length of the entry in the jar file.
java.util.jar.Manifest	getManifest() Returns true if the entry is a file in the jar.
boolean	isDirectory(java.lang.String path) Returns true if the entry is a directory in the jar.
boolean	isFile(java.lang.String path) Returns true if the entry is a file in the jar.
java.lang.String[]	list(java.lang.String path) Lists all the files in this directory.
StreamImpl	openReadImpl(Path path) Opens a stream to an entry in the jar.
void	removeEvent()
java.lang.String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Method Detail

createDepend

public static PersistentDependency createDepend(Path backing)

Return a Jar for the path. If the backing already exists, return the old jar.

createDepend

public static PersistentDependency createDepend(Path backing,
                                                long digest)

Return a Jar for the path. If the backing already exists, return the old jar.

getDepend

public PersistentDependency getDepend()

Returns the dependency.

getManifest

public java.util.jar.Manifest getManifest()
                                   throws java.io.IOException

Returns true if the entry is a file in the jar.

Parameters:

path - the path name inside the jar.

Throws:

java.io.IOException

getCertificates

public java.security.cert.Certificate[] getCertificates(java.lang.String path)

Returns any certificates.

exists

public boolean exists(java.lang.String path)

Returns true if the entry exists in the jar.

Parameters:

path - the path name inside the jar.

isDirectory

public boolean isDirectory(java.lang.String path)

Returns true if the entry is a directory in the jar.

Parameters:

path - the path name inside the jar.

isFile

public boolean isFile(java.lang.String path)

Returns true if the entry is a file in the jar.

Parameters:

path - the path name inside the jar.

getLastModified

public long getLastModified(java.lang.String path)

Returns the length of the entry in the jar file.

Parameters:

path - full path to the jar entry

Returns:

the length of the entry

getLength

public long getLength(java.lang.String path)

Returns the length of the entry in the jar file.

Parameters:

path - full path to the jar entry

Returns:

the length of the entry

canRead

public boolean canRead(java.lang.String path)

Readable if the jar is readable and the path refers to a file.

canWrite

public boolean canWrite(java.lang.String path)

Can't write to jars.

list

public java.lang.String[] list(java.lang.String path)
                        throws java.io.IOException

Lists all the files in this directory.

Throws:

java.io.IOException

openReadImpl

public StreamImpl openReadImpl(Path path)
                        throws java.io.IOException

Opens a stream to an entry in the jar.

Parameters:

path - relative path into the jar.

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

clearCache

public void clearCache()

Clears any cached JarFile.

close

public void close()

removeEvent

public void removeEvent()

Specified by:

removeEvent in interface CacheListener

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

clearJarCache

public static void clearJarCache()

Clears all the cached files in the jar. Needed to avoid some windows NT issues.