Class ResourceHandler

java.lang.Object
org.eclipse.jetty.util.component.AbstractLifeCycle
org.eclipse.jetty.util.component.ContainerLifeCycle
org.eclipse.jetty.ee9.nested.AbstractHandler
org.eclipse.jetty.ee9.nested.AbstractHandlerContainer
org.eclipse.jetty.ee9.nested.HandlerWrapper
org.eclipse.jetty.ee9.nested.ResourceHandler
All Implemented Interfaces:
Handler, HandlerContainer, ResourceService.WelcomeFactory, Container, Destroyable, Dumpable, Dumpable.DumpableContainer, LifeCycle
public class ResourceHandler extends HandlerWrapper implements ResourceService.WelcomeFactory
Resource Handler. This handle will serve static content and handle If-Modified-Since headers. No caching is done. Requests for resources that do not exist are let pass (Eg no 404's).

  • Constructor Details

    • ResourceHandler

      public ResourceHandler(ResourceService resourceService)

    • ResourceHandler

      public ResourceHandler()

  • Method Details

    • getWelcomeFile

      public String getWelcomeFile(String pathInContext)
      Description copied from interface: ResourceService.WelcomeFactory
      Finds a matching welcome file for the supplied Resource.
      Specified by:
      getWelcomeFile in interface ResourceService.WelcomeFactory
      Parameters:
      pathInContext - the path of the request
      Returns:
      The path of the matching welcome file in context or null.

    • doStart

      public void doStart() throws Exception
      Description copied from class: ContainerLifeCycle
      Starts the managed lifecycle beans in the order they were added.
      Overrides:
      doStart in class AbstractHandler
      Throws:
      Exception - If there was a problem starting. Will cause a transition to FAILED state

    • getHttpContentFactory

      public HttpContent.Factory getHttpContentFactory()

    • newHttpContentFactory

      protected HttpContent.Factory newHttpContentFactory()

    • getBaseResource

      public Resource getBaseResource()
      Returns:
      Returns the resourceBase.

    • getCacheControl

      public String getCacheControl()
      Get the cacheControl header to set on all static content..
      Returns:
      the cacheControl header to set on all static content.

    • getGzipEquivalentFileExtensions

      public List<String> getGzipEquivalentFileExtensions()
      Returns:
      file extensions that signify that a file is gzip compressed. Eg ".svgz"

    • getMimeTypes

      public MimeTypes getMimeTypes()

    • getResourceBase

      @Deprecated public String getResourceBase()
      Deprecated.
      Returns:
      Returns the base resource as a string.

    • getStyleSheet

      public Resource getStyleSheet()
      Returns:
      Returns the stylesheet as a Resource.

    • getWelcomeFiles

      public String[] getWelcomeFiles()

    • handle

      public void handle(String target, Request baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response) throws IOException, jakarta.servlet.ServletException
      Description copied from interface: Handler
      Handle a request.
      Specified by:
      handle in interface Handler
      Overrides:
      handle in class HandlerWrapper
      Parameters:
      target - The target of the request - either a URI or a name.
      baseRequest - The original unwrapped request object.
      request - The request either as the Request object or a wrapper of that request.
      response - The response as the Response object or a wrapper of that request.
      Throws:
      IOException - if unable to handle the request or response processing
      jakarta.servlet.ServletException - if unable to handle the request or response due to underlying servlet issue

    • isAcceptRanges

      public boolean isAcceptRanges()
      Returns:
      If true, range requests and responses are supported

    • isDirAllowed

      public boolean isDirAllowed()
      Returns:
      If true, directory listings are returned if no welcome file is found. Else 403 Forbidden.

    • isDirectoriesListed

      public boolean isDirectoriesListed()
      Get the directory option.
      Returns:
      true if directories are listed.

    • isEtags

      public boolean isEtags()
      Returns:
      True if ETag processing is done

    • getPrecompressedFormats

      public CompressedContentFormat[] getPrecompressedFormats()
      Returns:
      Precompressed resources formats that can be used to serve compressed variant of resources.

    • isPathInfoOnly

      public boolean isPathInfoOnly()
      Returns:
      true, only the path info will be applied to the resourceBase

    • isRedirectWelcome

      public boolean isRedirectWelcome()
      Returns:
      If true, welcome files are redirected rather than forwarded to.

    • setAcceptRanges

      public void setAcceptRanges(boolean acceptRanges)
      Parameters:
      acceptRanges - If true, range requests and responses are supported

    • setBaseResource

      public void setBaseResource(Resource base)
      Parameters:
      base - The resourceBase to server content from. If null the context resource base is used.

    • setBaseResource

      public void setBaseResource(Path basePath)
      Parameters:
      basePath - The resourceBase to server content from. If null the context resource base is used.

    • setCacheControl

      public void setCacheControl(String cacheControl)
      Set the cacheControl header to set on all static content..
      Parameters:
      cacheControl - the cacheControl header to set on all static content.

    • setDirAllowed

      public void setDirAllowed(boolean dirAllowed)
      Parameters:
      dirAllowed - If true, directory listings are returned if no welcome file is found. Else 403 Forbidden.

    • setDirectoriesListed

      public void setDirectoriesListed(boolean directory)
      Set the directory.
      Parameters:
      directory - true if directories are listed.

    • setEtags

      public void setEtags(boolean etags)
      Parameters:
      etags - True if ETag processing is done

    • setGzipEquivalentFileExtensions

      public void setGzipEquivalentFileExtensions(List<String> gzipEquivalentFileExtensions)
      Set file extensions that signify that a file is gzip compressed. Eg ".svgz".
      Parameters:
      gzipEquivalentFileExtensions - file extensions that signify that a file is gzip compressed. Eg ".svgz"

    • setPrecompressedFormats

      public void setPrecompressedFormats(CompressedContentFormat[] precompressedFormats)
      Parameters:
      precompressedFormats - The list of precompresed formats to serve in encoded format if matching resource found. For example serve gzip encoded file if ".gz" suffixed resource is found.

    • setMimeTypes

      public void setMimeTypes(MimeTypes mimeTypes)

    • setPathInfoOnly

      public void setPathInfoOnly(boolean pathInfoOnly)
      Set true, only the path info will be applied to the resourceBase.
      Parameters:
      pathInfoOnly - true, only the path info will be applied to the resourceBase

    • setRedirectWelcome

      public void setRedirectWelcome(boolean redirectWelcome)
      Parameters:
      redirectWelcome - If true, welcome files are redirected rather than forwarded to. redirection is always used if the ResourceHandler is not scoped by a ContextHandler

    • setResourceBase

      @Deprecated public void setResourceBase(String resourceBase)
      Deprecated.
      use setBaseResource(Resource)
      Parameters:
      resourceBase - The base resource as a string.

    • setBaseResourceAsString

      @Deprecated public void setBaseResourceAsString(String baseResource)
      Deprecated.
      use setBaseResource(Resource)
      Parameters:
      baseResource - The base resource as a string.

    • setStyleSheet

      public void setStyleSheet(String styleSheet)
      Parameters:
      styleSheet - The location of the style sheet to be used as a String.

    • setWelcomeFiles

      public void setWelcomeFiles(String[] welcomeFiles)