org.eclipse.jetty.util.resource

Class URLResource

java.lang.Object

org.eclipse.jetty.util.resource.Resource

org.eclipse.jetty.util.resource.URLResource

All Implemented Interfaces:

ResourceFactory

Direct Known Subclasses:

FileResource, JarResource

public class URLResource
extends Resource

Abstract resource class.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.net.URLConnection	_connection
protected java.io.InputStream	_in
protected java.net.URL	_url
protected java.lang.String	_urlString

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

__defaultUseCaches

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	URLResource(java.net.URL url, java.net.URLConnection connection)
protected	URLResource(java.net.URL url, java.net.URLConnection connection, boolean useCaches)

Method Summary

Methods

Modifier and Type	Method and Description
Resource	addPath(java.lang.String path) Returns the resource contained inside the current resource with the given name
protected boolean	checkConnection()
boolean	delete() Deletes the given resource
boolean	equals(java.lang.Object o)
boolean	exists() Returns true if the represented resource exists.
java.io.File	getFile() Returns an File representing the given resource or NULL if this is not possible.
java.io.InputStream	getInputStream() Returns an input stream to the resource
java.lang.String	getName() Returns the name of the resource
java.io.OutputStream	getOutputStream() Returns an output stream to the resource
java.net.URL	getURL() Returns an URL representing the given resource
boolean	getUseCaches()
int	hashCode()
boolean	isContainedIn(Resource containingResource)
boolean	isDirectory() Returns true if the respresenetd 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
void	release() Release any resources held by the resource.
boolean	renameTo(Resource dest) Rename the given resource
java.lang.String	toString()

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

copyTo, encode, finalize, getAlias, getAssociate, getDefaultUseCaches, getListHTML, getResource, getURI, isContainedIn, newClassPathResource, newClassPathResource, newResource, newResource, newResource, newResource, newResource, newSystemResource, setAssociate, setDefaultUseCaches, toURL, writeTo

Methods inherited from class java.lang.Object

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

Field Detail

_url

protected java.net.URL _url

_urlString

protected java.lang.String _urlString

_connection

protected java.net.URLConnection _connection

_in

protected java.io.InputStream _in

Constructor Detail

URLResource

protected URLResource(java.net.URL url,
           java.net.URLConnection connection)

URLResource

protected URLResource(java.net.URL url,
           java.net.URLConnection connection,
           boolean useCaches)

Method Detail

checkConnection

protected boolean checkConnection()

release

public void release()

Release any resources held by the resource.

Specified by:

release in class Resource

exists

public boolean exists()

Returns true if the represented resource exists.

Specified by:

exists in class Resource

isDirectory

public boolean isDirectory()

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

Specified by:

isDirectory in class Resource

lastModified

public long lastModified()

Returns the last modified time

Specified by:

lastModified in class Resource

length

public long length()

Return the length of the resource

Specified by:

length in class Resource

getURL

public java.net.URL getURL()

Returns an URL representing the given resource

Specified by:

getURL in class Resource

getFile

public java.io.File getFile()
                     throws java.io.IOException

Returns an File representing the given resource or NULL if this is not possible.

Specified by:

getFile in class Resource

Throws:

java.io.IOException

getName

public java.lang.String getName()

Returns the name of the resource

Specified by:

getName in class Resource

getInputStream

public java.io.InputStream getInputStream()
                                   throws java.io.IOException

Returns an input stream to the resource

Specified by:

getInputStream in class Resource

Throws:

java.io.IOException

getOutputStream

public java.io.OutputStream getOutputStream()
                                     throws java.io.IOException,
                                            java.lang.SecurityException

Returns an output stream to the resource

Specified by:

getOutputStream in class Resource

Throws:

java.io.IOException

java.lang.SecurityException

delete

public boolean delete()
               throws java.lang.SecurityException

Deletes the given resource

Specified by:

delete in class Resource

Throws:

java.lang.SecurityException

renameTo

public boolean renameTo(Resource dest)
                 throws java.lang.SecurityException

Rename the given resource

Specified by:

renameTo in class Resource

Throws:

java.lang.SecurityException

list

public java.lang.String[] list()

Returns a list of resource names contained in the given resource

Specified by:

list in class Resource

addPath

public Resource addPath(java.lang.String path)
                 throws java.io.IOException,
                        java.net.MalformedURLException

Returns the resource contained inside the current resource with the given name

Specified by:

addPath in class Resource

Parameters:

path - The path segment to add, which should be encoded by the encode method.

Throws:

java.io.IOException

java.net.MalformedURLException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class java.lang.Object

getUseCaches

public boolean getUseCaches()

isContainedIn

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

Specified by:

isContainedIn in class Resource

Throws:

java.net.MalformedURLException