com.sibvisions.rad.server.http
Class ResourceServlet

java.lang.Object
  javax.servlet.GenericServlet
      javax.servlet.http.HttpServlet
          com.sibvisions.rad.server.http.ResourceServlet

All Implemented Interfaces:

java.io.Serializable, javax.servlet.Servlet, javax.servlet.ServletConfig

Direct Known Subclasses:

DownloadServlet, UploadServlet

public abstract class ResourceServlet
extends javax.servlet.http.HttpServlet

The ResourceServlet is a simple HttpServlet for accessing resource templates.

See Also:

Serialized Form

Field Summary

static java.lang.String	PARAM_APPLICATION the URL parameter for the application name.
static java.lang.String	PARAM_CANCELBUTTON the URL parameter for the upload button text.
static java.lang.String	PARAM_CONURL the connection URL from the client.
static java.lang.String	PARAM_INFOTEXT the URL parameter for the info text.
static java.lang.String	PARAM_KEY the URL parameter for accessing the ObjectCache.
static java.lang.String	PARAM_RESOURCE the URL parameter for accessing resource files.
static java.lang.String	PARAM_TITLE the URL parameter for the title.

Constructor Summary

ResourceServlet()

Method Summary

protected org.apache.commons.fileupload.FileItemStream	getFileItemStream(javax.servlet.http.HttpServletRequest pRequest) Gets the first FileItemStream inside a multipart upload.
protected java.lang.String	getFileName(java.lang.String pContentDisposition) Returns the given content-disposition headers file name.
protected java.lang.String	getRequestURI(javax.servlet.http.HttpServletRequest pRequest) Gets the request URI that was used from the client to communicate to the server.
protected abstract java.lang.String	getResourceDirectoryName() Gets the name of the resource directory.
protected void	sendFile(java.lang.String pApplication, java.lang.String pFile, java.util.Hashtable<java.lang.String,java.lang.String> pParams, javax.servlet.http.HttpServletResponse pResponse) Sends the content of a file to the client.

Methods inherited from class javax.servlet.http.HttpServlet

doDelete, doGet, doHead, doOptions, doPost, doPut, doTrace, getLastModified, service, 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 Detail

PARAM_KEY

public static final java.lang.String PARAM_KEY

the URL parameter for accessing the ObjectCache.

See Also:

Constant Field Values

PARAM_RESOURCE

public static final java.lang.String PARAM_RESOURCE

the URL parameter for accessing resource files.

See Also:

Constant Field Values

PARAM_CANCELBUTTON

public static final java.lang.String PARAM_CANCELBUTTON

the URL parameter for the upload button text.

See Also:

Constant Field Values

PARAM_APPLICATION

public static final java.lang.String PARAM_APPLICATION

the URL parameter for the application name.

See Also:

Constant Field Values

PARAM_TITLE

public static final java.lang.String PARAM_TITLE

the URL parameter for the title.

See Also:

Constant Field Values

PARAM_INFOTEXT

public static final java.lang.String PARAM_INFOTEXT

the URL parameter for the info text.

See Also:

Constant Field Values

PARAM_CONURL

public static final java.lang.String PARAM_CONURL

the connection URL from the client.

See Also:

Constant Field Values

Constructor Detail

ResourceServlet

public ResourceServlet()

Method Detail

getResourceDirectoryName

protected abstract java.lang.String getResourceDirectoryName()

Gets the name of the resource directory.

Returns:

the resource directory name

getFileName

protected java.lang.String getFileName(java.lang.String pContentDisposition)

Returns the given content-disposition headers file name.

Parameters:

pContentDisposition - The content-disposition headers value.

Returns:

The file name

getFileItemStream

protected org.apache.commons.fileupload.FileItemStream getFileItemStream(javax.servlet.http.HttpServletRequest pRequest)
                                                                  throws java.io.IOException

Gets the first FileItemStream inside a multipart upload.

Parameters:

pRequest - the HttpServletRequest

Returns:

the FileItemStream

Throws:

java.io.IOException - if an IOException occurs.

sendFile

protected void sendFile(java.lang.String pApplication,
                        java.lang.String pFile,
                        java.util.Hashtable<java.lang.String,java.lang.String> pParams,
                        javax.servlet.http.HttpServletResponse pResponse)
                 throws java.lang.Exception

Sends the content of a file to the client. If the file is a html file, then all found parameter-keys, e.g. [EID], from the file, will be replaced with the mapped parameters. If a parameter was not found the no replacement will be performed.

Parameters:

pApplication - the application name

pFile - the name of the file to send

pParams - the key/value mapping for parameter replacement

pResponse - the http response

Throws:

java.lang.Exception - if an error occurs during reading from the resource file, writing the response or accessing the configuration files

getRequestURI

protected java.lang.String getRequestURI(javax.servlet.http.HttpServletRequest pRequest)

Gets the request URI that was used from the client to communicate to the server. It's not always possible to use the request URL from the http request because if mod_proxy was used, the URL may be different to the URL used from the client application! This method takes care of such differences.

Parameters:

pRequest - the client request

Returns:

the connection URL