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
```
public class PathResource
extends Resource
```
Java NIO Path equivalent of FileResource.

Field Summary

Fields
Modifier and Type	Field and Description
`private java.nio.file.Path`	`alias`
`private boolean`	`belongsToDefaultFileSystem`
`private static java.nio.file.LinkOption[]`	`FOLLOW_LINKS`
`private static Logger`	`LOG`
`private static java.nio.file.LinkOption[]`	`NO_FOLLOW_LINKS`
`private java.nio.file.Path`	`path`
`private java.net.URI`	`uri`

Fields inherited from class org.eclipse.jetty.util.resource.Resource
__defaultUseCaches, _associate

Constructor Summary

Constructors
Modifier	Constructor and Description
	`PathResource(java.io.File file)` Construct a new PathResource from a File object.
	`PathResource(java.nio.file.Path path)` Construct a new PathResource from a Path object.
`private`	`PathResource(PathResource parent, java.lang.String childPath)` Construct a new PathResource from a parent PathResource and child sub path
	`PathResource(java.net.URI uri)` Construct a new PathResource from a URI object.
	`PathResource(java.net.URL url)` Create a new PathResource from a provided URL object.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Resource`	`addPath(java.lang.String subpath)` Returns the resource contained inside the current resource with the given name.
`private void`	`assertValidPath(java.nio.file.Path path)`
`private java.nio.file.Path`	`checkAliasPath()`
`void`	`close()` Release any temporary resources held by the resource.
`void`	`copyTo(java.io.File destination)` Copy the Resource to the new destination file.
`boolean`	`delete()` Deletes the given resource
`boolean`	`equals(java.lang.Object obj)`
`boolean`	`exists()`
`java.net.URI`	`getAlias()`
`java.nio.file.Path`	`getAliasPath()` The Alias as a Path.
`java.io.File`	`getFile()` File representing the given resource.
`java.io.InputStream`	`getInputStream()` Input stream to the resource
`java.lang.String`	`getName()` The name of the resource.
`java.nio.file.Path`	`getPath()`
`java.nio.channels.ReadableByteChannel`	`getReadableByteChannel()` Readable ByteChannel for the resource.
`java.net.URI`	`getURI()` URI representing the resource.
`java.net.URL`	`getURL()` URL representing the resource.
`int`	`hashCode()`
`boolean`	`isAlias()`
`boolean`	`isContainedIn(Resource r)`
`boolean`	`isDirectory()`
`static boolean`	`isSameName(java.nio.file.Path pathA, java.nio.file.Path pathB)` Test if the paths are the same name.
`long`	`lastModified()` Time resource was last modified.
`long`	`length()` Length of the resource.
`java.lang.String[]`	`list()` list of resource names contained in the given resource.
`java.nio.channels.SeekableByteChannel`	`newSeekableByteChannel()`
`boolean`	`renameTo(Resource dest)` Rename the given resource
`private void`	`skipTo(java.nio.channels.SeekableByteChannel channel, java.nio.ByteBuffer buffer, long skipTo)`
`java.lang.String`	`toString()`
`void`	`writeTo(java.io.OutputStream outputStream, long start, long count)`

Methods inherited from class org.eclipse.jetty.util.resource.Resource
encode, finalize, getAllResources, getAssociate, getDefaultUseCaches, getListHTML, getListHTML, getResource, getWeakETag, getWeakETag, isContainedIn, newClassPathResource, newClassPathResource, newResource, newResource, newResource, newResource, newResource, newResource, newResource, newSystemResource, release, setAssociate, setDefaultUseCaches, toURL

Methods inherited from class java.lang.Object
clone, getClass, notify, notifyAll, wait, wait, wait

- Field Detail
  - LOG
```
private static final Logger LOG
```
  - NO_FOLLOW_LINKS
```
private static final java.nio.file.LinkOption[] NO_FOLLOW_LINKS
```
  - FOLLOW_LINKS
```
private static final java.nio.file.LinkOption[] FOLLOW_LINKS
```
  - path
```
private final java.nio.file.Path path
```
  - alias
```
private final java.nio.file.Path alias
```
  - uri
```
private final java.net.URI uri
```
  - belongsToDefaultFileSystem
```
private final boolean belongsToDefaultFileSystem
```
- Constructor Detail
  - PathResource
```
public PathResource(java.io.File file)
```
    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)
```
    Construct a new PathResource from a Path object.
    
    Parameters:
    
    path - the path to use
  - PathResource
```
private PathResource(PathResource parent,
                     java.lang.String childPath)
```
    Construct a new PathResource from a parent PathResource and child sub path
    
    Parameters:
    
    parent - the parent path resource
    
    childPath - the child sub path
  - PathResource
```
public PathResource(java.net.URI uri)
             throws java.io.IOException
```
    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
```
    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
  - checkAliasPath
```
private final java.nio.file.Path checkAliasPath()
```
  - isSameName
```
public static boolean isSameName(java.nio.file.Path pathA,
                                 java.nio.file.Path pathB)
```
    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)
  - addPath
```
public Resource addPath(java.lang.String subpath)
                 throws java.io.IOException
```
    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
    
    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.nio.file.Path path)
```
  - close
```
public void close()
```
    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
  - delete
```
public boolean delete()
               throws java.lang.SecurityException
```
    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)
```
    Overrides:
    
    equals in class java.lang.Object
  - exists
```
public boolean exists()
```
    Specified by:
    
    exists in class Resource
    
    Returns:
    
    true if the represented resource exists.
  - getFile
```
public java.io.File getFile()
                     throws java.io.IOException
```
    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()
```
    Returns:
    
    the Path of the resource
  - getInputStream
```
public java.io.InputStream getInputStream()
                                   throws java.io.IOException
```
    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()
```
    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
```
    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
```
    Throws:
    
    java.io.IOException
  - getURI
```
public java.net.URI getURI()
```
    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()
```
    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()
```
    Overrides:
    
    hashCode in class java.lang.Object
  - isContainedIn
```
public boolean isContainedIn(Resource r)
                      throws java.net.MalformedURLException
```
    Specified by:
    
    isContainedIn in class Resource
    
    Throws:
    
    java.net.MalformedURLException
  - isDirectory
```
public boolean isDirectory()
```
    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()
```
    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()
```
    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()
```
    Overrides:
    
    isAlias in class Resource
    
    Returns:
    
    true if this Resource is an alias to another real Resource
  - getAliasPath
```
public java.nio.file.Path getAliasPath()
```
    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()
```
    Overrides:
    
    getAlias in class Resource
    
    Returns:
    
    The canonical Alias of this resource or null if none.
  - list
```
public java.lang.String[] list()
```
    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
```
    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
```
    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
```
    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
  - skipTo
```
private void skipTo(java.nio.channels.SeekableByteChannel channel,
                    java.nio.ByteBuffer buffer,
                    long skipTo)
             throws java.io.IOException
```
    Throws:
    
    java.io.IOException
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object

Class PathResource

Field Summary

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

Constructor Summary

Method Summary

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

Methods inherited from class java.lang.Object

Field Detail

LOG

NO_FOLLOW_LINKS

FOLLOW_LINKS

path

alias

uri

belongsToDefaultFileSystem

Constructor Detail

PathResource

PathResource

PathResource

PathResource

PathResource

Method Detail

checkAliasPath

isSameName

addPath

assertValidPath

close

delete

equals

exists

getFile

getPath

getInputStream

getName

getReadableByteChannel

newSeekableByteChannel

getURI

getURL

hashCode

isContainedIn

isDirectory

lastModified

length

isAlias

getAliasPath

getAlias

list

renameTo

copyTo

writeTo

skipTo

toString