Package org.eclipse.jetty.util.resource

Class PathResource

java.lang.Object

org.eclipse.jetty.util.resource.Resource

org.eclipse.jetty.util.resource.PathResource

All Implemented Interfaces:

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

@Deprecated(since="2021-05-27")
public class PathResource
extends Resource

Deprecated.

The Eclipse Jetty and Apache Felix Http Jetty packages are no longer supported.

Java NIO Path equivalent of FileResource.

Field Summary

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

__defaultUseCaches

Constructor Summary

Constructors

Constructor	Description
PathResource(java.io.File file)	Deprecated. Construct a new PathResource from a File object.
PathResource(java.net.URI uri)	Deprecated. Construct a new PathResource from a URI object.
PathResource(java.net.URL url)	Deprecated. Create a new PathResource from a provided URL object.
PathResource(java.nio.file.Path path)	Deprecated. Construct a new PathResource from a Path object.

Method Summary

Modifier and Type	Method	Description
Resource	addPath(java.lang.String subPath)	Deprecated. Returns the resource contained inside the current resource with the given name.
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 obj)	Deprecated.
boolean	exists()	Deprecated.
java.net.URI	getAlias()	Deprecated.
java.nio.file.Path	getAliasPath()	Deprecated. The Alias as a Path.
java.io.File	getFile()	Deprecated. File representing the given resource.
java.io.InputStream	getInputStream()	Deprecated. Input stream to the resource
java.lang.String	getName()	Deprecated. The name of the resource.
java.nio.file.Path	getPath()	Deprecated.
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	isAlias()	Deprecated.
boolean	isContainedIn(Resource r)	Deprecated.
boolean	isDirectory()	Deprecated.
boolean	isSame(Resource resource)	Deprecated. Return true if the passed Resource represents the same resource as the Resource.
static boolean	isSameName(java.nio.file.Path pathA, java.nio.file.Path pathB)	Deprecated. Test if the paths are the same name.
long	lastModified()	Deprecated. Time resource was last modified.
long	length()	Deprecated. Length of the resource.
java.lang.String[]	list()	Deprecated. list of resource names contained in the given resource.
java.nio.channels.SeekableByteChannel	newSeekableByteChannel()	Deprecated.
boolean	renameTo(Resource dest)	Deprecated. Rename the given resource
java.lang.String	toString()	Deprecated.
void	writeTo(java.io.OutputStream outputStream, long start, long count)	Deprecated.

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

encode, getAllResources, getAssociate, getDefaultUseCaches, getListHTML, getListHTML, getResource, getWeakETag, getWeakETag, isContainedIn, newClassPathResource, newClassPathResource, newResource, newResource, newResource, newResource, newResource, newResource, newSystemResource, release, setAssociate, setDefaultUseCaches, toURL

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PathResource

public PathResource(java.io.File file)

Deprecated.

Construct a new PathResource from a File object.

An invocation of this convenience constructor of the form.

 new PathResource(file);
 

behaves in exactly the same way as the expression

 new PathResource(file.toPath());
 

Parameters:

file - the file to use

PathResource

public PathResource(java.nio.file.Path path)

Deprecated.

Construct a new PathResource from a Path object.

Parameters:

path - the path to use

PathResource

public PathResource(java.net.URI uri)
             throws java.io.IOException

Deprecated.

Construct a new PathResource from a URI object.

Must be an absolute URI using the file scheme.

Parameters:

uri - the URI to build this PathResource from.

Throws:

java.io.IOException - if unable to construct the PathResource from the URI.

PathResource

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

Deprecated.

Create a new PathResource from a provided URL object.

An invocation of this convenience constructor of the form.

 new PathResource(url);
 

behaves in exactly the same way as the expression

 new PathResource(url.toURI());
 

Parameters:

url - the url to attempt to create PathResource from

Throws:

java.io.IOException - if URL doesn't point to a location that can be transformed to a PathResource

java.net.URISyntaxException - if the provided URL was malformed

Method Detail

isSameName

public static boolean isSameName(java.nio.file.Path pathA,
                                 java.nio.file.Path pathB)

Deprecated.

Test if the paths are the same name.

If the real path is not the same as the absolute path then we know that the real path is the alias for the provided path.

For OS's that are case insensitive, this should return the real (on-disk / case correct) version of the path.

We have to be careful on Windows and OSX.

Assume we have the following scenario:

   Path a = new File("foo").toPath();
   Files.createFile(a);
   Path b = new File("FOO").toPath();
 

There now exists a file called foo on disk. Using Windows or OSX, with a Path reference of FOO, Foo, fOO, etc.. means the following

                        |  OSX    |  Windows   |  Linux
 -----------------------+---------+------------+---------
 Files.exists(a)        |  True   |  True      |  True
 Files.exists(b)        |  True   |  True      |  False
 Files.isSameFile(a,b)  |  True   |  True      |  False
 a.equals(b)            |  False  |  True      |  False
 

See the javadoc for Path.equals() for details about this FileSystem behavior difference

We also cannot rely on a.compareTo(b) as this is roughly equivalent in implementation to a.equals(b)

isSame

public boolean isSame(Resource resource)

Deprecated.

Description copied from class: Resource

Return true if the passed Resource represents the same resource as the Resource. For many resource types, this is equivalent to Object.equals(Object), however for resources types that support aliasing, this maybe some other check (e.g. Files.isSameFile(Path, Path)).

Overrides:

isSame in class Resource

Parameters:

resource - The resource to check

Returns:

true if the passed resource represents the same resource.

addPath

public Resource addPath(java.lang.String subPath)
                 throws java.io.IOException

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:

subPath - The path segment to add, which is not encoded. The path may be non canonical, but if so then the resulting Resource will return true from Resource.isAlias().

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, or a relative path attempts to access above the root resource.

close

public void close()

Deprecated.

Description copied from class: Resource

Release any temporary resources held by the resource.

Specified by:

close in interface java.lang.AutoCloseable

Specified by:

close in interface java.io.Closeable

Specified by:

close in class Resource

delete

public boolean delete()
               throws java.lang.SecurityException

Deprecated.

Description copied from class: Resource

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

equals

public boolean equals(java.lang.Object obj)

Deprecated.

Overrides:

equals in class java.lang.Object

exists

public boolean exists()

Deprecated.

Specified by:

exists in class Resource

Returns:

true if the represented resource exists.

getFile

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

Deprecated.

Description copied from class: Resource

File representing the given resource.

Specified by:

getFile in class Resource

Returns:

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

Throws:

java.io.IOException - if unable to get the resource due to permissions

getPath

public java.nio.file.Path getPath()

Deprecated.

Returns:

the Path of the resource

getInputStream

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

Deprecated.

Description copied from class: Resource

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

getName

public java.lang.String getName()

Deprecated.

Description copied from class: Resource

The name of the resource.

Specified by:

getName in class Resource

Returns:

the name of the resource

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.

newSeekableByteChannel

public java.nio.channels.SeekableByteChannel newSeekableByteChannel()
                                                             throws java.io.IOException

Deprecated.

Throws:

java.io.IOException

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

getURL

public java.net.URL getURL()

Deprecated.

Description copied from class: Resource

URL representing the resource.

Specified by:

getURL in class Resource

Returns:

a URL representing the given resource

hashCode

public int hashCode()

Deprecated.

Overrides:

hashCode in class java.lang.Object

isContainedIn

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

Deprecated.

Specified by:

isContainedIn in class Resource

Throws:

java.net.MalformedURLException

isDirectory

public boolean isDirectory()

Deprecated.

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.

lastModified

public long lastModified()

Deprecated.

Description copied from class: Resource

Time resource was last modified.

Specified by:

lastModified in class Resource

Returns:

the last modified time as milliseconds since unix epoch

length

public long length()

Deprecated.

Description copied from class: Resource

Length of the resource.

Specified by:

length in class Resource

Returns:

the length of the resource

isAlias

public boolean isAlias()

Deprecated.

Overrides:

isAlias in class Resource

Returns:

true if this Resource is an alias to another real Resource

getAliasPath

public java.nio.file.Path getAliasPath()

Deprecated.

The Alias as a Path.

Note: this cannot return the alias as a DIFFERENT path in 100% of situations, due to Java's internal Path/File normalization.

Returns:

the alias as a path.

getAlias

public java.net.URI getAlias()

Deprecated.

Overrides:

getAlias in class Resource

Returns:

The canonical Alias of this resource or null if none.

list

public java.lang.String[] list()

Deprecated.

Description copied from class: Resource

list of resource names contained in the given resource. Ordering is unspecified, so callers may wish to sort the return value to ensure deterministic behavior.

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.

renameTo

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

Deprecated.

Description copied from class: Resource

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

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

writeTo

public void writeTo(java.io.OutputStream outputStream,
                    long start,
                    long count)
             throws java.io.IOException

Deprecated.

Overrides:

writeTo in class Resource

Parameters:

outputStream - the output stream to write to

start - First byte to write

count - Bytes to write or -1 for all of them.

Throws:

java.io.IOException - if unable to copy the Resource to the output

toString

public java.lang.String toString()

Deprecated.

Overrides:

toString in class java.lang.Object