Class FileResource

java.lang.Object
org.eclipse.jetty.util.resource.Resource
org.eclipse.jetty.util.resource.FileResource
All Implemented Interfaces:
Closeable, AutoCloseable, ResourceFactory

@Deprecated public class FileResource extends Resource
Deprecated.
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 Details

    • LOG

      private static final Logger LOG
      Deprecated.
    • _file

      private final File _file
      Deprecated.
    • _uri

      private final URI _uri
      Deprecated.
    • _alias

      private final URI _alias
      Deprecated.
  • Constructor Details

  • Method Details

    • 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.
    • normalizeURI

      private static URI normalizeURI(File file, URI uri) throws URISyntaxException
      Deprecated.
      Throws:
      URISyntaxException
    • checkFileAlias

      private static URI checkFileAlias(URI uri, File file)
      Deprecated.
    • addPath

      public Resource addPath(String path) throws 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:
      path - The path segment to add, which is not encoded
      Returns:
      the Resource for the resolved path within this Resource.
      Throws:
      IOException - if unable to resolve the path
      MalformedURLException - if the resolution of the path fails because the input path parameter is malformed.
    • assertValidPath

      private void assertValidPath(String path)
      Deprecated.
    • getAlias

      public 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 String getName()
      Deprecated.
      Returns the name of the resource
      Specified by:
      getName in class Resource
      Returns:
      the name of the resource
    • getFile

      public 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 InputStream getInputStream() throws IOException
      Deprecated.
      Returns an input stream to the resource
      Specified by:
      getInputStream in class Resource
      Returns:
      an input stream to the resource
      Throws:
      IOException - if unable to open the input stream
    • getReadableByteChannel

      public ReadableByteChannel getReadableByteChannel() throws 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:
      IOException - if unable to open the readable bytechannel for the resource.
    • delete

      public boolean delete() throws 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:
      SecurityException - if unable to delete due to permissions
    • renameTo

      public boolean renameTo(Resource dest) throws 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:
      SecurityException - if unable to rename due to permissions
    • list

      public 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(Object o)
      Deprecated.
      Overrides:
      equals in class 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 Object
      Returns:
      the hashcode.
    • copyTo

      public void copyTo(File destination) throws 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:
      IOException - if unable to copy the resource
    • isContainedIn

      public boolean isContainedIn(Resource r) throws MalformedURLException
      Deprecated.
      Specified by:
      isContainedIn in class Resource
      Throws:
      MalformedURLException
    • close

      public void close()
      Deprecated.
      Description copied from class: Resource
      Release any temporary resources held by the resource.
      Specified by:
      close in interface AutoCloseable
      Specified by:
      close in interface Closeable
      Specified by:
      close in class Resource
    • getURL

      public 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
    • getURI

      public 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 String toString()
      Deprecated.
      Overrides:
      toString in class Object