org.eclipse.jetty.server.handler

Class ResourceHandler

java.lang.Object

org.eclipse.jetty.util.component.AbstractLifeCycle

org.eclipse.jetty.util.component.ContainerLifeCycle

org.eclipse.jetty.server.handler.AbstractHandler

org.eclipse.jetty.server.handler.AbstractHandlerContainer

org.eclipse.jetty.server.handler.HandlerWrapper

org.eclipse.jetty.server.handler.ResourceHandler

All Implemented Interfaces:

Handler, HandlerContainer, Container, Destroyable, Dumpable, LifeCycle, ResourceFactory

public class ResourceHandler
extends HandlerWrapper
implements ResourceFactory

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.util.component.AbstractLifeCycle

AbstractLifeCycle.AbstractLifeCycleListener

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

LifeCycle.Listener

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

Container.InheritedListener, Container.Listener

Field Summary

Fields inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

_handler

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

FAILED, RUNNING, STARTED, STARTING, STOP_ON_FAILURE, STOPPED, STOPPING

Constructor Summary

Constructors

Constructor and Description
ResourceHandler()

Method Summary

Modifier and Type	Method and Description
protected void	doDirectory(HttpServletRequest request, HttpServletResponse response, Resource resource)
protected void	doResponseHeaders(HttpServletResponse response, Resource resource, String mimeType) Set the response headers.
void	doStart()
Resource	getBaseResource()
String	getCacheControl()
MimeTypes	getMimeTypes()
int	getMinAsyncContentLength() Get the minimum content length for async handling.
int	getMinMemoryMappedContentLength() Get minimum memory mapped file content length.
protected Resource	getResource(HttpServletRequest request)
Resource	getResource(String path)
String	getResourceBase()
Resource	getStylesheet()
protected Resource	getWelcome(Resource directory)
String[]	getWelcomeFiles()
void	handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) Handle a request.
boolean	isDirectoriesListed() Get the directory option.
boolean	isEtags()
void	setBaseResource(Resource base)
void	setCacheControl(String cacheControl)
void	setDirectoriesListed(boolean directory) Set the directory.
void	setEtags(boolean etags)
void	setMimeTypes(MimeTypes mimeTypes)
void	setMinAsyncContentLength(int minAsyncContentLength) Set the minimum content length for async handling.
void	setMinMemoryMappedContentLength(int minMemoryMappedFileSize) Set minimum memory mapped file content length.
void	setResourceBase(String resourceBase)
void	setStylesheet(String stylesheet)
void	setWelcomeFiles(String[] welcomeFiles)

Methods inherited from class org.eclipse.jetty.server.handler.HandlerWrapper

destroy, expandChildren, getHandler, getHandlers, insertHandler, setHandler

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandlerContainer

expandHandler, findContainerOf, getChildHandlerByClass, getChildHandlers, getChildHandlersByClass, setServer

Methods inherited from class org.eclipse.jetty.server.handler.AbstractHandler

doStop, dumpThis, getServer

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

addBean, addBean, addBean, addEventListener, addManaged, contains, dump, dump, dump, dump, dump, dumpBeans, dumpObject, dumpStdErr, getBean, getBeans, getBeans, isManaged, manage, removeBean, removeBeans, removeEventListener, setBeans, setStopTimeout, start, stop, unmanage, updateBean, updateBean, updateBeans

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

addLifeCycleListener, getState, getState, getStopTimeout, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Methods inherited from class java.lang.Object

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

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

addLifeCycleListener, isFailed, isRunning, isStarted, isStarting, isStopped, isStopping, removeLifeCycleListener, start, stop

Constructor Detail

ResourceHandler

public ResourceHandler()

Method Detail

getMimeTypes

public MimeTypes getMimeTypes()

setMimeTypes

public void setMimeTypes(MimeTypes mimeTypes)

isDirectoriesListed

public boolean isDirectoriesListed()

Get the directory option.

Returns:

true if directories are listed.

setDirectoriesListed

public void setDirectoriesListed(boolean directory)

Set the directory.

Parameters:

directory - true if directories are listed.

getMinMemoryMappedContentLength

public int getMinMemoryMappedContentLength()

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.

setMinMemoryMappedContentLength

public void setMinMemoryMappedContentLength(int minMemoryMappedFileSize)

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.

getMinAsyncContentLength

public int getMinAsyncContentLength()

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.

setMinAsyncContentLength

public void setMinAsyncContentLength(int minAsyncContentLength)

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.

isEtags

public boolean isEtags()

Returns:

True if ETag processing is done

setEtags

public void setEtags(boolean etags)

Parameters:

etags - True if ETag processing is done

doStart

public void doStart()
             throws Exception

Overrides:

doStart in class AbstractHandler

Throws:

Exception

getBaseResource

public Resource getBaseResource()

Returns:

Returns the resourceBase.

getResourceBase

public String getResourceBase()

Returns:

Returns the base resource as a string.

setBaseResource

public void setBaseResource(Resource base)

Parameters:

base - The resourceBase to set.

setResourceBase

public void setResourceBase(String resourceBase)

Parameters:

resourceBase - The base resource as a string.

getStylesheet

public Resource getStylesheet()

Returns:

Returns the stylesheet as a Resource.

setStylesheet

public void setStylesheet(String stylesheet)

Parameters:

stylesheet - The location of the stylesheet to be used as a String.

getCacheControl

public String getCacheControl()

Returns:

the cacheControl header to set on all static content.

setCacheControl

public void setCacheControl(String cacheControl)

Parameters:

cacheControl - the cacheControl header to set on all static content.

getResource

public Resource getResource(String path)

Specified by:

getResource in interface ResourceFactory

getResource

protected Resource getResource(HttpServletRequest request)
                        throws MalformedURLException

Throws:

MalformedURLException

getWelcomeFiles

public String[] getWelcomeFiles()

setWelcomeFiles

public void setWelcomeFiles(String[] welcomeFiles)

getWelcome

protected Resource getWelcome(Resource directory)
                       throws MalformedURLException,
                              IOException

Throws:

MalformedURLException

IOException

handle

public void handle(String target,
                   Request baseRequest,
                   HttpServletRequest request,
                   HttpServletResponse response)
            throws IOException,
                   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:

IOException - if unable to handle the request or response processing

ServletException - if unable to handle the request or response due to underlying servlet issue

doDirectory

protected void doDirectory(HttpServletRequest request,
                           HttpServletResponse response,
                           Resource resource)
                    throws IOException

Throws:

IOException

doResponseHeaders

protected void doResponseHeaders(HttpServletResponse response,
                                 Resource resource,
                                 String mimeType)

Set the response headers. This method is called to set the response headers such as content type and content length. May be extended to add additional headers.

Parameters:

response - the http response

resource - the resource

mimeType - the mime type