org.eclipse.jetty.util.resource

Class FileResource

java.lang.Object

org.eclipse.jetty.util.resource.Resource

org.eclipse.jetty.util.resource.FileResource

All Implemented Interfaces:

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

Deprecated.

Use PathResource

@Deprecated
public class FileResource
extends Resource

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, or it can be controlled by calling the static method @see FileResource#setCheckAliases(boolean)

Field Summary

Fields

Modifier and Type	Field and Description
private java.net.URI	_alias Deprecated.
private java.io.File	_file Deprecated.
private java.net.URI	_uri Deprecated.
private static Logger	LOG Deprecated.

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

__defaultUseCaches, _associate

Constructor Summary

Constructors

Constructor and Description
FileResource(java.io.File file) Deprecated.
FileResource(java.io.File base, java.lang.String childPath) Deprecated.
FileResource(java.net.URI uri) Deprecated.
FileResource(java.net.URL url) Deprecated.

Method Summary

Modifier and Type	Method and Description
Resource	addPath(java.lang.String path) Deprecated. Returns the resource contained inside the current resource with the given name.
private void	assertValidPath(java.lang.String path) Deprecated.
private static java.net.URI	checkFileAlias(java.net.URI uri, java.io.File file) Deprecated.
void	close() Deprecated. Release any temporary resources held by the resource.
void	copyTo(java.io.File destination) Deprecated. Copy the Resource to the new destination file.
boolean	delete() Deprecated. Deletes the given resource
boolean	equals(java.lang.Object o) Deprecated.
boolean	exists() Deprecated. Returns true if the resource exists.
java.net.URI	getAlias() Deprecated.
java.io.File	getFile() Deprecated. Returns an File representing the given resource or NULL if this is not possible.
java.io.InputStream	getInputStream() Deprecated. Returns an input stream to the resource
java.lang.String	getName() Deprecated. Returns the name of the resource
java.nio.channels.ReadableByteChannel	getReadableByteChannel() Deprecated. Readable ByteChannel for the resource.
java.net.URI	getURI() Deprecated. URI representing the resource.
java.net.URL	getURL() Deprecated. URL representing the resource.
int	hashCode() Deprecated.
boolean	isContainedIn(Resource r) Deprecated.
boolean	isDirectory() Deprecated. Returns true if the resource is a container/directory.
long	lastModified() Deprecated. Returns the last modified time
long	length() Deprecated. Return the length of the resource
java.lang.String[]	list() Deprecated. Returns a list of resources contained in the given resource
private static java.net.URI	normalizeURI(java.io.File file, java.net.URI uri) Deprecated.
boolean	renameTo(Resource dest) Deprecated. Rename the given resource
java.lang.String	toString() Deprecated.

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

encode, finalize, getAllResources, getAssociate, getDefaultUseCaches, getListHTML, getResource, 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

Deprecated.

_file

private final java.io.File _file

Deprecated.

_uri

private final java.net.URI _uri

Deprecated.

_alias

private final java.net.URI _alias

Deprecated.

Constructor Detail

FileResource

public FileResource(java.net.URL url)
             throws java.io.IOException,
                    java.net.URISyntaxException

Deprecated.

Throws:

java.io.IOException

java.net.URISyntaxException

FileResource

public FileResource(java.net.URI uri)

Deprecated.

FileResource

public FileResource(java.io.File file)

Deprecated.

FileResource

public FileResource(java.io.File base,
                    java.lang.String childPath)

Deprecated.

Method Detail

normalizeURI

private static java.net.URI normalizeURI(java.io.File file,
                                         java.net.URI uri)
                                  throws java.net.URISyntaxException

Deprecated.

Throws:

java.net.URISyntaxException

checkFileAlias

private static java.net.URI checkFileAlias(java.net.URI uri,
                                           java.io.File file)

Deprecated.

addPath

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

Deprecated.

Description copied from class: Resource

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 is not encoded

Returns:

the Resource for the resolved path within this Resource.

Throws:

java.io.IOException - if unable to resolve the path

java.net.MalformedURLException - if the resolution of the path fails because the input path parameter is malformed.

assertValidPath

private void assertValidPath(java.lang.String path)

Deprecated.

getAlias

public java.net.URI getAlias()

Deprecated.

Overrides:

getAlias in class Resource

Returns:

The canonical Alias of this resource or null if none.

exists

public boolean exists()

Deprecated.

Returns true if the resource exists.

Specified by:

exists in class Resource

Returns:

true if the represented resource exists.

lastModified

public long lastModified()

Deprecated.

Returns the last modified time

Specified by:

lastModified in class Resource

Returns:

the last modified time as milliseconds since unix epoch

isDirectory

public boolean isDirectory()

Deprecated.

Returns true if the resource is a container/directory.

Specified by:

isDirectory in class Resource

Returns:

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

length

public long length()

Deprecated.

Return the length of the resource

Specified by:

length in class Resource

Returns:

the length of the resource

getName

public java.lang.String getName()

Deprecated.

Returns the name of the resource

Specified by:

getName in class Resource

Returns:

the name of the resource

getFile

public java.io.File getFile()

Deprecated.

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

Specified by:

getFile in class Resource

Returns:

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

getInputStream

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

Deprecated.

Returns an input stream to the resource

Specified by:

getInputStream in class Resource

Returns:

an input stream to the resource

Throws:

java.io.IOException - if unable to open the input stream

getReadableByteChannel

public java.nio.channels.ReadableByteChannel getReadableByteChannel()
                                                             throws java.io.IOException

Deprecated.

Description copied from class: Resource

Readable ByteChannel for the resource.

Specified by:

getReadableByteChannel in class Resource

Returns:

an readable bytechannel to the resource or null if one is not available.

Throws:

java.io.IOException - if unable to open the readable bytechannel for the resource.

delete

public boolean delete()
               throws java.lang.SecurityException

Deprecated.

Deletes the given resource

Specified by:

delete in class Resource

Returns:

true if resource was found and successfully deleted, false if resource didn't exist or was unable to be deleted.

Throws:

java.lang.SecurityException - if unable to delete due to permissions

renameTo

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

Deprecated.

Rename the given resource

Specified by:

renameTo in class Resource

Parameters:

dest - the destination name for the resource

Returns:

true if the resource was renamed, false if the resource didn't exist or was unable to be renamed.

Throws:

java.lang.SecurityException - if unable to rename due to permissions

list

public java.lang.String[] list()

Deprecated.

Returns a list of resources contained in the given resource

Specified by:

list in class Resource

Returns:

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

equals

public boolean equals(java.lang.Object o)

Deprecated.

Overrides:

equals in class java.lang.Object

Parameters:

o - the object to compare against this instance

Returns:

true of the object o is a FileResource pointing to the same file as this resource.

hashCode

public int hashCode()

Deprecated.

Overrides:

hashCode in class java.lang.Object

Returns:

the hashcode.

copyTo

public void copyTo(java.io.File destination)
            throws java.io.IOException

Deprecated.

Description copied from class: Resource

Copy the Resource to the new destination file.

Will not replace existing destination file.

Overrides:

copyTo in class Resource

Parameters:

destination - the destination file to create

Throws:

java.io.IOException - if unable to copy the resource

isContainedIn

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

Deprecated.

Specified by:

isContainedIn in class Resource

Throws:

java.net.MalformedURLException

close

public void close()

Deprecated.

Description copied from class: Resource

Release any temporary resources held by the resource.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in class Resource

getURL

public java.net.URL getURL()

Deprecated.

Description copied from class: Resource

URL representing the resource.

Specified by:

getURL in class Resource

Returns:

an URL representing the given resource

getURI

public java.net.URI getURI()

Deprecated.

Description copied from class: Resource

URI representing the resource.

Overrides:

getURI in class Resource

Returns:

an URI representing the given resource

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object