org.opencms.util
Class CmsRequestUtil

java.lang.Object
  org.opencms.util.CmsRequestUtil

public final class CmsRequestUtil
extends Object

Provides utility functions for dealing with values a HttpServletRequest.

Since:

6.0.0

Version:

$Revision: 1.17 $

Author:

Alexander Kandzior

Field Summary

static String	ATTRIBUTE_ERRORCODE Request attribute that contains the original error code.
static String	HEADER_ACCEPT_CHARSET HTTP Accept-Charset Header for internal requests used during static export.
static String	HEADER_ACCEPT_LANGUAGE HTTP Accept-Language Header for internal requests used during static export.
static String	HEADER_CACHE_CONTROL HTTP Header "Cache-Control".
static String	HEADER_CONTENT_DISPOSITION The "Content-Disposition" http header.
static String	HEADER_CONTENT_TYPE The "Content-Type" http header.
static String	HEADER_EXPIRES HTTP Header "Expires".
static String	HEADER_IF_MODIFIED_SINCE HTTP Header "If-Modified-Since".
static String	HEADER_JSESSIONID The Header that stores the session id (used by OpenCms upload applet).
static String	HEADER_LAST_MODIFIED HTTP Header "Last-Modified".
static String	HEADER_OPENCMS_EXPORT HTTP Header for internal requests used during static export.
static String	HEADER_PRAGMA HTTP Header "Pragma".
static String	HEADER_SERVER HTTP Header "Server".
static String	HEADER_USER_AGENT HTTP Header "user-agent".
static String	HEADER_VALUE_MAX_AGE HTTP Header value "max-age=" (for "Cache-Control").
static String	HEADER_VALUE_MUST_REVALIDATE HTTP Header value "must-revalidate" (for "Cache-Control").
static String	HEADER_VALUE_NO_CACHE HTTP Header value "no-cache" (for "Cache-Control").
static String	HEADER_WWW_AUTHENTICATE HTTP Header "WWW-Authenticate".
static String	HEADER_X_FORWARDED_FOR Identifier for x-forwarded-for (i.e.

Method Summary

static String	appendParameter(String url, String paramName, String paramValue) Appends a request parameter to the given URL.
static String	appendParameters(String url, Map params, boolean encode) Appends a map of request parameters to the given URL.
static Map	createParameterMap(Map params) Creates a valid request parameter map from the given map, most notably changing the values form String to String[] if required.
static Map	createParameterMap(String query) Parses the parameters of the given request query part and creaes a parameter map out of them.
static String	encodeParams(HttpServletRequest req) Returns all parameters of the given request as a request parameter URL String, that is in the form key1=value1&key2=value2 etc.
static String	encodeParamsWithUri(String uri, HttpServletRequest req) Encodes the given uri, with all parameters from the given request appended.
static void	forwardRequest(String target, HttpServletRequest req, HttpServletResponse res) Forwards the response to the given target, which may contain parameters appended like for example ?a=b&c=d.
static void	forwardRequest(String target, Map params, HttpServletRequest req, HttpServletResponse res) Forwards the response to the given target, with the provided parameter map.
static String	getNotEmptyDecodedParameter(HttpServletRequest request, String paramName) Reads value from the request parameters, will return null if the value is not available or only white space.
static String	getNotEmptyParameter(HttpServletRequest request, String paramName) Reads value from the request parameters, will return null if the value is not available or only white space.
static List	readMultipartFileItems(HttpServletRequest request) Parses a request of the form multipart/form-data.
static Map	readParameterMapFromMultiPart(String encoding, List multiPartFileItems) Creates a "standard" request parameter map from the values of a multipart/form-data request.
static void	setNoCacheHeaders(HttpServletResponse res) Sets headers to the given response to prevent client side caching.

Methods inherited from class java.lang.Object

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

Field Detail

ATTRIBUTE_ERRORCODE

public static final String ATTRIBUTE_ERRORCODE

Request attribute that contains the original error code.

See Also:

Constant Field Values

HEADER_ACCEPT_CHARSET

public static final String HEADER_ACCEPT_CHARSET

HTTP Accept-Charset Header for internal requests used during static export.

See Also:

Constant Field Values

HEADER_ACCEPT_LANGUAGE

public static final String HEADER_ACCEPT_LANGUAGE

HTTP Accept-Language Header for internal requests used during static export.

See Also:

Constant Field Values

HEADER_CACHE_CONTROL

public static final String HEADER_CACHE_CONTROL

HTTP Header "Cache-Control".

See Also:

Constant Field Values

HEADER_CONTENT_DISPOSITION

public static final String HEADER_CONTENT_DISPOSITION

The "Content-Disposition" http header.

See Also:

Constant Field Values

HEADER_CONTENT_TYPE

public static final String HEADER_CONTENT_TYPE

The "Content-Type" http header.

See Also:

Constant Field Values

HEADER_EXPIRES

public static final String HEADER_EXPIRES

HTTP Header "Expires".

See Also:

Constant Field Values

HEADER_IF_MODIFIED_SINCE

public static final String HEADER_IF_MODIFIED_SINCE

HTTP Header "If-Modified-Since".

See Also:

Constant Field Values

HEADER_JSESSIONID

public static final String HEADER_JSESSIONID

The Header that stores the session id (used by OpenCms upload applet).

See Also:

Constant Field Values

HEADER_LAST_MODIFIED

public static final String HEADER_LAST_MODIFIED

HTTP Header "Last-Modified".

See Also:

Constant Field Values

HEADER_OPENCMS_EXPORT

public static final String HEADER_OPENCMS_EXPORT

HTTP Header for internal requests used during static export.

See Also:

Constant Field Values

HEADER_PRAGMA

public static final String HEADER_PRAGMA

HTTP Header "Pragma".

See Also:

Constant Field Values

HEADER_SERVER

public static final String HEADER_SERVER

HTTP Header "Server".

See Also:

Constant Field Values

HEADER_USER_AGENT

public static final String HEADER_USER_AGENT

HTTP Header "user-agent".

See Also:

Constant Field Values

HEADER_VALUE_MAX_AGE

public static final String HEADER_VALUE_MAX_AGE

HTTP Header value "max-age=" (for "Cache-Control").

See Also:

Constant Field Values

HEADER_VALUE_MUST_REVALIDATE

public static final String HEADER_VALUE_MUST_REVALIDATE

HTTP Header value "must-revalidate" (for "Cache-Control").

See Also:

Constant Field Values

HEADER_VALUE_NO_CACHE

public static final String HEADER_VALUE_NO_CACHE

HTTP Header value "no-cache" (for "Cache-Control").

See Also:

Constant Field Values

HEADER_WWW_AUTHENTICATE

public static final String HEADER_WWW_AUTHENTICATE

HTTP Header "WWW-Authenticate".

See Also:

Constant Field Values

HEADER_X_FORWARDED_FOR

public static final String HEADER_X_FORWARDED_FOR

Identifier for x-forwarded-for (i.e. proxied) request headers.

See Also:

Constant Field Values

Method Detail

appendParameter

public static String appendParameter(String url,
                                     String paramName,
                                     String paramValue)

Appends a request parameter to the given URL.

This method takes care about the adding the parameter as an additional parameter (appending ¶m=value) or as the first parameter (appending ?param=value).

Parameters:

url - the URL where to append the parameter to

paramName - the paramter name to append

paramValue - the parameter value to append

Returns:

the URL with the given parameter appended

appendParameters

public static String appendParameters(String url,
                                      Map params,
                                      boolean encode)

Appends a map of request parameters to the given URL.

The map can cointains values of String[] or simple String values.

This method takes care about the adding the parameter as an additional parameter (appending ¶m=value) or as the first parameter (appending ?param=value).

Parameters:

url - the URL where to append the parameter to

params - the paramters to append

encode - if true, the parameter values are encoded before they are appended

Returns:

the URL with the given parameter appended

createParameterMap

public static Map createParameterMap(Map params)

Creates a valid request parameter map from the given map, most notably changing the values form String to String[] if required.

If the given parameter map is null, then null is returned.

Parameters:

params - the map of parameters to create a parameter map from

Returns:

the created parameter map, all values will be instances of String[]

createParameterMap

public static Map createParameterMap(String query)

Parses the parameters of the given request query part and creaes a parameter map out of them.

Please note: This does not parse a full request URI/URL, only the query part that starts after the "?". For example, in the URI /system/index.html?a=b&c=d, the query part is a=b&c=d.

If the given String is empty, an empty map is returned.

Parameters:

query - the query to parse

Returns:

the parameter map created from the query

encodeParams

public static String encodeParams(HttpServletRequest req)

Returns all parameters of the given request as a request parameter URL String, that is in the form key1=value1&key2=value2 etc. The result will be encoded using the CmsEncoder.encode(String) function.

Parameters:

req - the request to read the parameters from

Returns:

all initialized parameters of the given request as request parameter URL String

encodeParamsWithUri

public static String encodeParamsWithUri(String uri,
                                         HttpServletRequest req)

Encodes the given uri, with all parameters from the given request appended.

The result will be encoded using the CmsEncoder.encode(String) function.

Parameters:

req - the request where to read the parameters from

uri - the uri to encode

Returns:

the encoded uri, with all parameters from the given request appended

forwardRequest

public static void forwardRequest(String target,
                                  HttpServletRequest req,
                                  HttpServletResponse res)
                           throws IOException,
                                  ServletException

Forwards the response to the given target, which may contain parameters appended like for example ?a=b&c=d.

Please note: If possible, use forwardRequest(String, Map, HttpServletRequest, HttpServletResponse) where the parameters are passed as a map, since the parsing of the parameters may introduce issues with encoding and is in general much less effective.

The parsing of parameters will likley fail for "large values" (e.g. full blown web forms with <textarea> elements etc. Use this method only if you know that the target will just contain up to 3 parameters which are relativly short and have no encoding or linebreak issues.

Parameters:

target - the target to forward to (may contain parameters like ?a=b&c=d)

req - the request to forward

res - the response to forward

Throws:

IOException - in case the forwarding fails

ServletException - in case the forwarding fails

forwardRequest

public static void forwardRequest(String target,
                                  Map params,
                                  HttpServletRequest req,
                                  HttpServletResponse res)
                           throws IOException,
                                  ServletException

Forwards the response to the given target, with the provided parameter map.

The target uri must NOT have parameters appended like for example ?a=b&c=d. The values in the provided map must be of type String[]. If required, use createParameterMap(Map) before calling this method to make sure all values are actually of the required array type.

Parameters:

target - the target to forward to (may NOT contain parameters like ?a=b&c=d)

params - the parameter map (the values must be of type String[]

req - the request to forward

res - the response to forward

Throws:

IOException - in case the forwarding fails

ServletException - in case the forwarding fails

getNotEmptyDecodedParameter

public static String getNotEmptyDecodedParameter(HttpServletRequest request,
                                                 String paramName)

Reads value from the request parameters, will return null if the value is not available or only white space.

The value of the request will also be decoded using CmsEncoder.decode(String) and also trimmed using String.trim().

Parameters:

request - the request to read the parameter from

paramName - the parameter name to read

Returns:

the request parameter value for the given parameter

getNotEmptyParameter

public static String getNotEmptyParameter(HttpServletRequest request,
                                          String paramName)

Reads value from the request parameters, will return null if the value is not available or only white space.

Parameters:

request - the request to read the parameter from

paramName - the parameter name to read

Returns:

the request parameter value for the given parameter

readMultipartFileItems

public static List readMultipartFileItems(HttpServletRequest request)

Parses a request of the form multipart/form-data. The result list will contain items of type FileItem. If the request is not of type multipart/form-data, then null is returned.

Parameters:

request - the HTTP servlet request to parse

Returns:

the list of FileItem extracted from the multipart request, or null if the request was not of type multipart/form-data

readParameterMapFromMultiPart

public static Map readParameterMapFromMultiPart(String encoding,
                                                List multiPartFileItems)

Creates a "standard" request parameter map from the values of a multipart/form-data request.

Parameters:

encoding - the encoding to use when creating the values

multiPartFileItems - the list of parsed multi part file items

Returns:

a map containing all non-file request parameters

See Also:

readMultipartFileItems(HttpServletRequest)

setNoCacheHeaders

public static void setNoCacheHeaders(HttpServletResponse res)

Sets headers to the given response to prevent client side caching.

The following headers are set:

Cache-Control: max-age=0
Cache-Control: must-revalidate
Pragma: no-cache

Parameters:

res - the request where to set the no-cache headers