Class ResourceHandler

    • Constructor Detail

      • ResourceHandler

        public ResourceHandler​(ResourceService resourceService)
      • ResourceHandler

        public ResourceHandler()
    • Method Detail

      • getWelcomeFile

        public java.lang.String getWelcomeFile​(java.lang.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 java.lang.Exception
        Description copied from class: ContainerLifeCycle
        Starts the managed lifecycle beans in the order they were added.
        Overrides:
        doStart in class AbstractHandler
        Throws:
        java.lang.Exception
      • getBaseResource

        public Resource getBaseResource()
        Returns:
        Returns the resourceBase.
      • getCacheControl

        public java.lang.String getCacheControl()
        Returns:
        the cacheControl header to set on all static content.
      • getGzipEquivalentFileExtensions

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

        public MimeTypes getMimeTypes()
      • getMinAsyncContentLength

        @Deprecated
        public int getMinAsyncContentLength()
        Deprecated.
        Get the minimum content length for async handling.
        Returns:
        The minimum size in bytes of the content before asynchronous handling is used, or -1 for no async handling or 0 (default) for using ServletResponse.getBufferSize() as the minimum length.
      • getMinMemoryMappedContentLength

        @Deprecated
        public int getMinMemoryMappedContentLength()
        Deprecated.
        Get minimum memory mapped file content length.
        Returns:
        the minimum size in bytes of a file resource that will be served using a memory mapped buffer, or -1 (default) for no memory mapped buffers.
      • getResource

        public Resource getResource​(java.lang.String path)
        Description copied from interface: ResourceFactory
        Get a resource for a path.
        Specified by:
        getResource in interface ResourceFactory
        Parameters:
        path - The path to the resource
        Returns:
        The resource or null
      • getResourceBase

        public java.lang.String getResourceBase()
        Returns:
        Returns the base resource as a string.
      • getStylesheet

        public Resource getStylesheet()
        Returns:
        Returns the stylesheet as a Resource.
      • getDefaultStylesheet

        public static Resource getDefaultStylesheet()
      • getWelcomeFiles

        public java.lang.String[] getWelcomeFiles()
      • handle

        public void handle​(java.lang.String target,
                           Request baseRequest,
                           javax.servlet.http.HttpServletRequest request,
                           javax.servlet.http.HttpServletResponse response)
                    throws java.io.IOException,
                           javax.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. The HttpConnection.getCurrentConnection().getHttpChannel().getRequest() method can be used access the Request object if required.
        response - The response as the Response object or a wrapper of that request. The HttpConnection.getCurrentConnection().getHttpChannel().getResponse() method can be used access the Response object if required.
        Throws:
        java.io.IOException - if unable to handle the request or response processing
        javax.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
      • isGzip

        @Deprecated
        public boolean isGzip()
        Deprecated.
        Returns:
        If set to true, then static content will be served as gzip content encoded if a matching resource is found ending with ".gz"
      • 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.
      • setCacheControl

        public void setCacheControl​(java.lang.String cacheControl)
        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
      • setGzip

        @Deprecated
        public void setGzip​(boolean gzip)
        Deprecated.
        Parameters:
        gzip - If set to true, then static content will be served as gzip content encoded if a matching resource is found ending with ".gz"
      • setGzipEquivalentFileExtensions

        public void setGzipEquivalentFileExtensions​(java.util.List<java.lang.String> gzipEquivalentFileExtensions)
        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)
      • setMinAsyncContentLength

        @Deprecated
        public void setMinAsyncContentLength​(int minAsyncContentLength)
        Deprecated.
        Set the minimum content length for async handling.
        Parameters:
        minAsyncContentLength - The minimum size in bytes of the content before asynchronous handling is used, or -1 for no async handling or 0 for using ServletResponse.getBufferSize() as the minimum length.
      • setMinMemoryMappedContentLength

        @Deprecated
        public void setMinMemoryMappedContentLength​(int minMemoryMappedFileSize)
        Deprecated.
        Set minimum memory mapped file content length.
        Parameters:
        minMemoryMappedFileSize - the minimum size in bytes of a file resource that will be served using a memory mapped buffer, or -1 for no memory mapped buffers.
      • setPathInfoOnly

        public void setPathInfoOnly​(boolean pathInfoOnly)
        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

        public void setResourceBase​(java.lang.String resourceBase)
        Parameters:
        resourceBase - The base resource as a string.
      • setStylesheet

        public void setStylesheet​(java.lang.String stylesheet)
        Parameters:
        stylesheet - The location of the stylesheet to be used as a String.
      • setWelcomeFiles

        public void setWelcomeFiles​(java.lang.String[] welcomeFiles)