Package org.openremote.container.web.file

Class FileServlet

java.lang.Object

javax.servlet.GenericServlet

javax.servlet.http.HttpServlet

org.openremote.container.web.file.AbstractFileServlet

org.openremote.container.web.file.FileServlet

All Implemented Interfaces:

Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

public class FileServlet
extends AbstractFileServlet

See Also:

• Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.openremote.container.web.file.AbstractFileServlet

AbstractFileServlet.Range, AbstractFileServlet.RedirectException, AbstractFileServlet.Resource

Field Summary

Fields

Modifier and Type	Field	Description
protected final String[]	alreadyZippedExtensions
protected final File	base
static final long	DEFAULT_EXPIRE_SECONDS
protected final boolean	devMode
static final long	EXPIRES_SECONDS_CACHE_JS
protected final Map<String,String>	mimeTypes
protected final Map<String,Integer>	mimeTypesExpireSeconds
protected final String[]	requiredRoles
protected final File	unsecuredIndex

Constructor Summary

Constructors

Constructor	Description
FileServlet(boolean devMode, File base, String[] requiredRoles, Map<String,String> mimeTypes, Map<String,Integer> mimeTypesExpireSeconds, String[] alreadyZippedExtensions)

Method Summary

Modifier and Type	Method	Description
protected String	getContentType(javax.servlet.http.HttpServletRequest request, File file)	Returns the content type associated with the given HTTP servlet request and file.
protected long	getExpireTime(javax.servlet.http.HttpServletRequest request, File file)	Returns how long the resource may be cached by the client before it expires, in seconds.
protected String	getExtension(String fileName)
protected File	getFile(javax.servlet.http.HttpServletRequest request)	Returns the file associated with the given HTTP servlet request.
boolean	isSecured()
protected void	service(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response)
protected String	setContentHeaders(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, AbstractFileServlet.Resource resource, List<AbstractFileServlet.Range> ranges)	Set content headers.

Methods inherited from class org.openremote.container.web.file.AbstractFileServlet

coalesce, doGet, doHead, encodeURI, encodeURL, handleFileNotFound, setCacheHeaders, setNoCacheHeaders, startsWithOneOf, stream, stream

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doOptions, doPost, doPut, doTrace, getLastModified, service

Methods inherited from class javax.servlet.GenericServlet

destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init, init, log, log

Methods inherited from class java.lang.Object

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

Field Details

DEFAULT_EXPIRE_SECONDS

public static final long DEFAULT_EXPIRE_SECONDS

See Also:

• Constant Field Values

EXPIRES_SECONDS_CACHE_JS

public static final long EXPIRES_SECONDS_CACHE_JS

See Also:

• Constant Field Values

devMode

protected final boolean devMode

base

protected final File base

unsecuredIndex

protected final File unsecuredIndex

requiredRoles

protected final String[] requiredRoles

mimeTypes

protected final Map<String,String> mimeTypes

mimeTypesExpireSeconds

protected final Map<String,Integer> mimeTypesExpireSeconds

alreadyZippedExtensions

protected final String[] alreadyZippedExtensions

Constructor Details

FileServlet

public FileServlet(boolean devMode,
 File base,
 String[] requiredRoles,
 Map<String,String> mimeTypes,
 Map<String,Integer> mimeTypesExpireSeconds,
 String[] alreadyZippedExtensions)

Method Details

isSecured

public boolean isSecured()

service

protected void service(javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response)
                throws javax.servlet.ServletException,
IOException

Overrides:

service in class javax.servlet.http.HttpServlet

Throws:

javax.servlet.ServletException

IOException

getFile

protected File getFile(javax.servlet.http.HttpServletRequest request)
                throws AbstractFileServlet.RedirectException

Description copied from class: AbstractFileServlet

Returns the file associated with the given HTTP servlet request. If this method throws IllegalArgumentException, then the servlet will return a HTTP 400 error. If this method returns null, or if File.isFile() returns false, then the servlet will invoke AbstractFileServlet.handleFileNotFound(HttpServletRequest, HttpServletResponse).

Specified by:

getFile in class AbstractFileServlet

Parameters:

request - The involved HTTP servlet request.

Returns:

The file associated with the given HTTP servlet request.

Throws:

AbstractFileServlet.RedirectException

getExpireTime

protected long getExpireTime(javax.servlet.http.HttpServletRequest request,
 File file)

Description copied from class: AbstractFileServlet

Returns how long the resource may be cached by the client before it expires, in seconds.

The default implementation returns 30 days in seconds.

Overrides:

getExpireTime in class AbstractFileServlet

Parameters:

request - The involved HTTP servlet request.

file - The involved file.

Returns:

The client cache expire time in seconds (not milliseconds!).

getContentType

protected String getContentType(javax.servlet.http.HttpServletRequest request,
 File file)

Description copied from class: AbstractFileServlet

Returns the content type associated with the given HTTP servlet request and file.

The default implementation delegates File.getName() to ServletContext.getMimeType(String) with a fallback default value of application/octet-stream.

Overrides:

getContentType in class AbstractFileServlet

Parameters:

request - The involved HTTP servlet request.

file - The involved file.

Returns:

The content type associated with the given HTTP servlet request and file.

setContentHeaders

protected String setContentHeaders(javax.servlet.http.HttpServletRequest request,
 javax.servlet.http.HttpServletResponse response,
 AbstractFileServlet.Resource resource,
 List<AbstractFileServlet.Range> ranges)

Description copied from class: AbstractFileServlet

Set content headers.

Overrides:

setContentHeaders in class AbstractFileServlet

getExtension

protected String getExtension(String fileName)