org.openqa.jetty.util
Class FileResource

java.lang.Object
  org.openqa.jetty.util.Resource
      org.openqa.jetty.util.URLResource
          org.openqa.jetty.util.FileResource

All Implemented Interfaces:

java.io.Serializable

public class FileResource
extends URLResource

File Resource. Handle resources of implied or explicit file type. This class can check for aliasing in the filesystem (eg case insensitivity). By default this is turned on if the platform does not have the "/" path separator, or it can be controlled with the "org.openqa.jetty.util.FileResource.checkAliases" system parameter. If alias checking is turned on, then aliased resources are treated as if they do not exist, nor can they be created.

Version:

$Revision: 1.31 $

Author:

Greg Wilkins (gregw)

See Also:

Serialized Form

Field Summary

Fields inherited from class org.openqa.jetty.util.URLResource

_connection, _in, _url, _urlString

Method Summary

Resource	addPath(java.lang.String path) Returns the resource contained inside the current resource with the given name
boolean	delete() Deletes the given resource
java.lang.String	encode(java.lang.String uri) Encode according to this resource type.
boolean	equals(java.lang.Object o)
boolean	exists() Returns true if the resource exists.
java.net.URL	getAlias()
static boolean	getCheckAliases() getCheckAliases.
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
int	hashCode()
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 resources contained in the given resource
boolean	renameTo(Resource dest) Rename the given resource
static void	setCheckAliases(boolean checkAliases) setCheckAliases.

Methods inherited from class org.openqa.jetty.util.URLResource

checkConnection, getURL, release, toString

Methods inherited from class org.openqa.jetty.util.Resource

cache, finalize, getAssociate, getListHTML, newResource, newResource, newSystemResource, setAssociate, writeTo

Methods inherited from class java.lang.Object

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

Method Detail

setCheckAliases

public static void setCheckAliases(boolean checkAliases)

setCheckAliases.

Parameters:

checkAliases - True of resource aliases are to be checked for (eg case insensitivity or 8.3 short names) and treated as not found.

getCheckAliases

public static boolean getCheckAliases()

getCheckAliases.

Returns:

True of resource aliases are to be checked for (eg case insensitivity or 8.3 short names) and treated as not found.

addPath

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

Description copied from class: URLResource

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

Overrides:

addPath in class URLResource

Parameters:

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

Throws:

java.io.IOException

java.net.MalformedURLException

getAlias

public java.net.URL getAlias()

Overrides:

getAlias in class Resource

Returns:

The canonical Alias of this resource or null if none.

exists

public boolean exists()

Returns true if the resource exists.

Overrides:

exists in class URLResource

lastModified

public long lastModified()

Returns the last modified time

Overrides:

lastModified in class URLResource

isDirectory

public boolean isDirectory()

Returns true if the respresenetd resource is a container/directory.

Overrides:

isDirectory in class URLResource

length

public long length()

Return the length of the resource

Overrides:

length in class URLResource

getName

public java.lang.String getName()

Returns the name of the resource

Overrides:

getName in class URLResource

getFile

public java.io.File getFile()

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

Overrides:

getFile in class URLResource

getInputStream

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

Returns an input stream to the resource

Overrides:

getInputStream in class URLResource

Throws:

java.io.IOException

getOutputStream

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

Returns an output stream to the resource

Overrides:

getOutputStream in class URLResource

Throws:

java.io.IOException

java.lang.SecurityException

delete

public boolean delete()
               throws java.lang.SecurityException

Deletes the given resource

Overrides:

delete in class URLResource

Throws:

java.lang.SecurityException

renameTo

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

Rename the given resource

Overrides:

renameTo in class URLResource

Throws:

java.lang.SecurityException

list

public java.lang.String[] list()

Returns a list of resources contained in the given resource

Overrides:

list in class URLResource

encode

public java.lang.String encode(java.lang.String uri)

Encode according to this resource type. File URIs are encoded.

Overrides:

encode in class Resource

Parameters:

uri - URI to encode.

Returns:

The uri unchanged.

equals

public boolean equals(java.lang.Object o)

Overrides:

equals in class URLResource

Parameters:

o -

Returns:

hashCode

public int hashCode()

Overrides:

hashCode in class URLResource

Returns:

the hashcode.