Module org.eclipse.jetty.ee9.nested

Package org.eclipse.jetty.ee9.nested

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, org.eclipse.jetty.util.component.Container, org.eclipse.jetty.util.component.Destroyable, org.eclipse.jetty.util.component.Dumpable, org.eclipse.jetty.util.component.Dumpable.DumpableContainer, org.eclipse.jetty.util.component.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).

Nested Class Summary

Nested classes/interfaces inherited from class org.eclipse.jetty.ee9.nested.AbstractHandler

AbstractHandler.ErrorDispatchHandler

Nested classes/interfaces inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.AbstractLifeCycle.AbstractLifeCycleListener, org.eclipse.jetty.util.component.AbstractLifeCycle.StopException

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Container

org.eclipse.jetty.util.component.Container.InheritedListener, org.eclipse.jetty.util.component.Container.Listener

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.Dumpable

org.eclipse.jetty.util.component.Dumpable.DumpableContainer

Nested classes/interfaces inherited from interface org.eclipse.jetty.util.component.LifeCycle

org.eclipse.jetty.util.component.LifeCycle.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.ee9.nested.HandlerWrapper

_handler

Fields inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

FAILED, STARTED, STARTING, STOPPED, STOPPING

Fields inherited from interface org.eclipse.jetty.util.component.Dumpable

KEY

Constructor Summary

Constructors

Constructor	Description
ResourceHandler()
ResourceHandler(ResourceService resourceService)

Method Summary

Modifier and Type	Method	Description
void	doStart()
org.eclipse.jetty.util.resource.Resource	getBaseResource()
String	getCacheControl()	Get the cacheControl header to set on all static content..
List<String>	getGzipEquivalentFileExtensions()
org.eclipse.jetty.http.content.HttpContent.Factory	getHttpContentFactory()
org.eclipse.jetty.http.MimeTypes	getMimeTypes()
org.eclipse.jetty.http.CompressedContentFormat[]	getPrecompressedFormats()
String	getResourceBase()	Deprecated.
org.eclipse.jetty.util.resource.Resource	getStyleSheet()
String	getWelcomeFile(String pathInContext)	Finds a matching welcome file for the supplied Resource.
String[]	getWelcomeFiles()
void	handle(String target, Request baseRequest, jakarta.servlet.http.HttpServletRequest request, jakarta.servlet.http.HttpServletResponse response)	Handle a request.
boolean	isAcceptRanges()
boolean	isDirAllowed()
boolean	isDirectoriesListed()	Get the directory option.
boolean	isEtags()
boolean	isPathInfoOnly()
boolean	isRedirectWelcome()
protected org.eclipse.jetty.http.content.HttpContent.Factory	newHttpContentFactory()
void	setAcceptRanges(boolean acceptRanges)
void	setBaseResource(Path basePath)
void	setBaseResource(org.eclipse.jetty.util.resource.Resource base)
void	setBaseResourceAsString(String baseResource)	Deprecated. use setBaseResource(Resource)
void	setCacheControl(String cacheControl)	Set the cacheControl header to set on all static content..
void	setDirAllowed(boolean dirAllowed)
void	setDirectoriesListed(boolean directory)	Set the directory.
void	setEtags(boolean etags)
void	setGzipEquivalentFileExtensions(List<String> gzipEquivalentFileExtensions)	Set file extensions that signify that a file is gzip compressed.
void	setMimeTypes(org.eclipse.jetty.http.MimeTypes mimeTypes)
void	setPathInfoOnly(boolean pathInfoOnly)	Set true, only the path info will be applied to the resourceBase.
void	setPrecompressedFormats(org.eclipse.jetty.http.CompressedContentFormat[] precompressedFormats)
void	setRedirectWelcome(boolean redirectWelcome)
void	setResourceBase(String resourceBase)	Deprecated. use setBaseResource(Resource)
void	setStyleSheet(String styleSheet)
void	setWelcomeFiles(String[] welcomeFiles)

Methods inherited from class org.eclipse.jetty.ee9.nested.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, getTail, insertHandler, setAsParent, setHandler

Methods inherited from class org.eclipse.jetty.ee9.nested.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass, setServer

Methods inherited from class org.eclipse.jetty.ee9.nested.AbstractHandler

doError, doStop, getServer

Methods inherited from class org.eclipse.jetty.util.component.ContainerLifeCycle

addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dumpObjects, dumpStdErr, getBean, getBeans, getBeans, getContainedBeans, getContainedBeans, installBean, installBean, isAuto, isManaged, isUnmanaged, manage, removeBean, removeBeans, removeEventListener, setBeans, start, stop, unmanage, updateBean, updateBean, updateBeans, updateBeans

Methods inherited from class org.eclipse.jetty.util.component.AbstractLifeCycle

getEventListeners, getState, getState, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, setEventListeners, start, stop, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.eclipse.jetty.util.component.Container

getCachedBeans, getEventListeners

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable

dumpSelf

Methods inherited from interface org.eclipse.jetty.util.component.Dumpable.DumpableContainer

isDumpable

Methods inherited from interface org.eclipse.jetty.util.component.LifeCycle

addEventListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeEventListener, start, stop

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

Overrides:

doStart in class AbstractHandler

Throws:

Exception

getHttpContentFactory

public org.eclipse.jetty.http.content.HttpContent.Factory getHttpContentFactory()

newHttpContentFactory

protected org.eclipse.jetty.http.content.HttpContent.Factory newHttpContentFactory()

getBaseResource

public org.eclipse.jetty.util.resource.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 org.eclipse.jetty.http.MimeTypes getMimeTypes()

getResourceBase

@Deprecated
public String getResourceBase()

Deprecated.

Returns:

Returns the base resource as a string.

getStyleSheet

public org.eclipse.jetty.util.resource.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 org.eclipse.jetty.http.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(org.eclipse.jetty.util.resource.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(org.eclipse.jetty.http.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(org.eclipse.jetty.http.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)