org.glassfish.grizzly.http.server
Class StaticHttpHandler

java.lang.Object
  org.glassfish.grizzly.http.server.HttpHandler
      org.glassfish.grizzly.http.server.StaticHttpHandler

public class StaticHttpHandler
extends HttpHandler

HttpHandler, which processes requests to a static resources.

Author:

Jeanfrancois Arcand, Alexey Stashok

Field Summary

protected ArraySet<File>

docRoots

Constructor Summary

StaticHttpHandler()
Create HttpHandler, which, by default, will handle requests to the static resources located in the current directory.

StaticHttpHandler(Set<String> docRoots)
Create a new instance which will look for static pages located under the docRoot.

StaticHttpHandler(String... docRoots)
Create a new instance which will look for static pages located under the docRoot.

Method Summary

void	addDocRoot(File docRoot) Add the directory to the list of directories where files will be serviced from.
File	addDocRoot(String docRoot) Add the directory to the list of directories where files will be serviced from.
boolean	addToFileCache(Request req, Response res, File resource)
File	getDefaultDocRoot() Return the default directory from where files will be serviced.
ArraySet<File>	getDocRoots() Return the list of directories where files will be serviced from.
protected String	getRelativeURI(Request request)
protected boolean	handle(String uri, Request request, Response response) Lookup a resource based on the request URI, and send it using send file.
boolean	isFileCacheEnabled() Returns true if this StaticHttpHandler has been configured to use file cache to serve static resources, or false otherwise.
protected void	onMissingResource(Request request, Response response) The method will be called, if the static resource requested by the Request wasn't found, so StaticHttpHandler implementation may try to workaround this situation.
void	removeDocRoot(File docRoot) Removes the directory from the list of directories where static files will be serviced from.
static void	sendFile(Response response, File file)
void	service(Request request, Response response) Based on the Request URI, try to map the file from the getDocRoots(), and send it back to a client.
void	setFileCacheEnabled(boolean isFileCacheEnabled) Set true to configure this StaticHttpHandler to use file cache to serve static resources, or false otherwise.

Methods inherited from class org.glassfish.grizzly.http.server.HttpHandler

customizedErrorPage, destroy, doHandle, getName, getRequestURIEncoding, isAllowCustomStatusMessage, isAllowEncodedSlash, sendAcknowledgment, setAllowCustomStatusMessage, setAllowEncodedSlash, setDecodeUrl, setDispatcherHelper, setRequestURIEncoding, setRequestURIEncoding, start, updatePaths

Methods inherited from class java.lang.Object

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

Field Detail

docRoots

protected final ArraySet<File> docRoots

Constructor Detail

StaticHttpHandler

public StaticHttpHandler()

Create HttpHandler, which, by default, will handle requests to the static resources located in the current directory.

StaticHttpHandler

public StaticHttpHandler(String... docRoots)

Create a new instance which will look for static pages located under the docRoot. If the docRoot is null - static pages won't be served by this HttpHandler

Parameters:

docRoots - the folder(s) where the static resource are located. If the docRoot is null - static pages won't be served by this HttpHandler

StaticHttpHandler

public StaticHttpHandler(Set<String> docRoots)

Create a new instance which will look for static pages located under the docRoot. If the docRoot is null - static pages won't be served by this HttpHandler

Parameters:

docRoots - the folders where the static resource are located. If the docRoot is empty - static pages won't be served by this HttpHandler

Method Detail

getDefaultDocRoot

public File getDefaultDocRoot()

Return the default directory from where files will be serviced.

Returns:

the default directory from where file will be serviced.

getDocRoots

public ArraySet<File> getDocRoots()

Return the list of directories where files will be serviced from.

Returns:

the list of directories where files will be serviced from.

addDocRoot

public final File addDocRoot(String docRoot)

Add the directory to the list of directories where files will be serviced from.

Parameters:

docRoot - the directory to be added to the list of directories where files will be serviced from.

Returns:

return the File representation of the passed docRoot.

addDocRoot

public final void addDocRoot(File docRoot)

Add the directory to the list of directories where files will be serviced from.

Parameters:

docRoot - the directory to be added to the list of directories where files will be serviced from.

removeDocRoot

public void removeDocRoot(File docRoot)

Removes the directory from the list of directories where static files will be serviced from.

Parameters:

docRoot - the directory to remove.

isFileCacheEnabled

public boolean isFileCacheEnabled()

Returns true if this StaticHttpHandler has been configured to use file cache to serve static resources, or false otherwise. Please note, even though this StaticHttpHandler might be configured to use file cache, file cache itself might be disabled FileCache.isEnabled(). In this case StaticHttpHandler will operate as if file cache was disabled.

Returns:

true if this StaticHttpHandler has been configured to use file cache to serve static resources, or false otherwise.

setFileCacheEnabled

public void setFileCacheEnabled(boolean isFileCacheEnabled)

Set true to configure this StaticHttpHandler to use file cache to serve static resources, or false otherwise. Please note, even though this StaticHttpHandler might be configured to use file cache, file cache itself might be disabled FileCache.isEnabled(). In this case StaticHttpHandler will operate as if file cache was disabled.

Parameters:

isFileCacheEnabled - true to configure this StaticHttpHandler to use file cache to serve static resources, or false otherwise.

sendFile

public static void sendFile(Response response,
                            File file)
                     throws IOException

Throws:

IOException

addToFileCache

public final boolean addToFileCache(Request req,
                                    Response res,
                                    File resource)

service

public void service(Request request,
                    Response response)
             throws Exception

Based on the Request URI, try to map the file from the getDocRoots(), and send it back to a client.

Specified by:

service in class HttpHandler

Parameters:

request - the Request

response - the Response

Throws:

Exception

getRelativeURI

protected String getRelativeURI(Request request)

onMissingResource

protected void onMissingResource(Request request,
                                 Response response)
                          throws Exception

The method will be called, if the static resource requested by the Request wasn't found, so StaticHttpHandler implementation may try to workaround this situation. The default implementation - sends a 404 response page by calling HttpHandler.customizedErrorPage(Request, Response).

Parameters:

request - the Request

response - the Response

Throws:

Exception

handle

protected boolean handle(String uri,
                         Request request,
                         Response response)
                  throws Exception

Lookup a resource based on the request URI, and send it using send file.

Parameters:

uri - The request URI

request - the Request

response - the Response

Throws:

Exception