org.eclipse.jetty.util.resource

Class JarFileResource

java.lang.Object

org.eclipse.jetty.util.resource.Resource

org.eclipse.jetty.util.resource.URLResource

org.eclipse.jetty.util.resource.JarResource

org.eclipse.jetty.util.resource.JarFileResource

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable, ResourceFactory

public class JarFileResource
extends JarResource

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	_directory
private java.util.jar.JarEntry	_entry
private boolean	_exists
private java.io.File	_file
private java.util.jar.JarFile	_jarFile
private java.lang.String	_jarUrl
private java.lang.String[]	_list
private java.lang.String	_path
private static Logger	LOG

Fields inherited from class org.eclipse.jetty.util.resource.JarResource

_jarConnection

Fields inherited from class org.eclipse.jetty.util.resource.URLResource

_connection, _in, _url, _urlString, _useCaches

Fields inherited from class org.eclipse.jetty.util.resource.Resource

__defaultUseCaches, _associate

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	JarFileResource(java.net.URL url)
protected	JarFileResource(java.net.URL url, boolean useCaches)

Method Summary

Modifier and Type	Method and Description
protected boolean	checkConnection()
void	close() Release any resources held by the resource.
boolean	exists() Returns true if the represented resource exists.
static Resource	getNonCachingResource(Resource resource) Take a Resource that possibly might use URLConnection caching and turn it into one that doesn't.
boolean	isContainedIn(Resource resource) Check if this jar:file: resource is contained in the named resource.
boolean	isDirectory() Returns true if the represented resource is a container/directory.
long	lastModified() Returns the last modified time
long	length() Return the length of the resource
java.lang.String[]	list() Returns a list of resource names contained in the given resource
private java.util.List<java.lang.String>	listEntries()
protected void	newConnection()

Methods inherited from class org.eclipse.jetty.util.resource.JarResource

copyTo, getFile, getInputStream, newJarResource

Methods inherited from class org.eclipse.jetty.util.resource.URLResource

addPath, delete, equals, getInputStream, getName, getReadableByteChannel, getURL, getUseCaches, hashCode, renameTo, toString

Methods inherited from class org.eclipse.jetty.util.resource.Resource

encode, finalize, getAlias, getAllResources, getAssociate, getDefaultUseCaches, getListHTML, getResource, getURI, getWeakETag, getWeakETag, isAlias, isContainedIn, newClassPathResource, newClassPathResource, newResource, newResource, newResource, newResource, newResource, newResource, newSystemResource, release, setAssociate, setDefaultUseCaches, toURL, writeTo

Methods inherited from class java.lang.Object

clone, getClass, notify, notifyAll, wait, wait, wait

Field Detail

LOG

private static final Logger LOG

_jarFile

private java.util.jar.JarFile _jarFile

_file

private java.io.File _file

_list

private java.lang.String[] _list

_entry

private java.util.jar.JarEntry _entry

_directory

private boolean _directory

_jarUrl

private java.lang.String _jarUrl

_path

private java.lang.String _path

_exists

private boolean _exists

Constructor Detail

JarFileResource

protected JarFileResource(java.net.URL url)

JarFileResource

protected JarFileResource(java.net.URL url,
                          boolean useCaches)

Method Detail

close

public void close()

Description copied from class: URLResource

Release any resources held by the resource.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Overrides:

close in class JarResource

checkConnection

protected boolean checkConnection()

Overrides:

checkConnection in class JarResource

newConnection

protected void newConnection()
                      throws java.io.IOException

Overrides:

newConnection in class JarResource

Throws:

java.io.IOException - Sub-classes of JarResource may throw an IOException (or subclass)

exists

public boolean exists()

Returns true if the represented resource exists.

Overrides:

exists in class JarResource

Returns:

true if the represented resource exists.

isDirectory

public boolean isDirectory()

Returns true if the represented resource is a container/directory. If the resource is not a file, resources ending with "/" are considered directories.

Overrides:

isDirectory in class URLResource

Returns:

true if the represented resource is a container/directory. if the resource is not a file, resources ending with "/" are considered directories.

lastModified

public long lastModified()

Returns the last modified time

Overrides:

lastModified in class URLResource

Returns:

the last modified time as milliseconds since unix epoch

list

public java.lang.String[] list()

Description copied from class: URLResource

Returns a list of resource names contained in the given resource

Overrides:

list in class URLResource

Returns:

a list of resource names contained in the given resource, or null. Note: The resource names are not URL encoded.

listEntries

private java.util.List<java.lang.String> listEntries()

length

public long length()

Return the length of the resource

Overrides:

length in class URLResource

Returns:

the length of the resource

getNonCachingResource

public static Resource getNonCachingResource(Resource resource)

Take a Resource that possibly might use URLConnection caching and turn it into one that doesn't.

Parameters:

resource - the JarFileResource to obtain without URLConnection caching.

Returns:

the non-caching resource

isContainedIn

public boolean isContainedIn(Resource resource)
                      throws java.net.MalformedURLException

Check if this jar:file: resource is contained in the named resource. Eg jar:file:///a/b/c/foo.jar!/x.html isContainedIn file:///a/b/c/foo.jar

Overrides:

isContainedIn in class URLResource

Parameters:

resource - the resource to test for

Returns:

true if resource is contained in the named resource

Throws:

java.net.MalformedURLException - if unable to process is contained due to invalid URL format