org.springframework.web.portlet.bind

Class PortletRequestUtils

java.lang.Object

org.springframework.web.portlet.bind.PortletRequestUtils

public abstract class PortletRequestUtils
extends java.lang.Object

Parameter extraction methods, for an approach distinct from data binding, in which parameters of specific types are required.

This approach is very useful for simple submissions, where binding request parameters to a command object would be overkill.

Since:

2.0

Author:

Juergen Hoeller, Keith Donald, John A. Lewis

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
private static class	PortletRequestUtils.BooleanParser
private static class	PortletRequestUtils.DoubleParser
private static class	PortletRequestUtils.FloatParser
private static class	PortletRequestUtils.IntParser
private static class	PortletRequestUtils.LongParser
private static class	PortletRequestUtils.ParameterParser<T>
private static class	PortletRequestUtils.StringParser

Field Summary

Fields

Modifier and Type	Field and Description
private static PortletRequestUtils.BooleanParser	BOOLEAN_PARSER
private static PortletRequestUtils.DoubleParser	DOUBLE_PARSER
private static PortletRequestUtils.FloatParser	FLOAT_PARSER
private static PortletRequestUtils.IntParser	INT_PARSER
private static PortletRequestUtils.LongParser	LONG_PARSER
private static PortletRequestUtils.StringParser	STRING_PARSER

Constructor Summary

Constructors

Constructor and Description
PortletRequestUtils()

Method Summary

Modifier and Type	Method and Description
static java.lang.Boolean	getBooleanParameter(PortletRequest request, java.lang.String name) Get a Boolean parameter, or null if not present.
static boolean	getBooleanParameter(PortletRequest request, java.lang.String name, boolean defaultVal) Get a boolean parameter, with a fallback value.
static boolean[]	getBooleanParameters(PortletRequest request, java.lang.String name) Get an array of boolean parameters, return an empty array if not found.
static java.lang.Double	getDoubleParameter(PortletRequest request, java.lang.String name) Get a Double parameter, or null if not present.
static double	getDoubleParameter(PortletRequest request, java.lang.String name, double defaultVal) Get a double parameter, with a fallback value.
static double[]	getDoubleParameters(PortletRequest request, java.lang.String name) Get an array of double parameters, return an empty array if not found.
static java.lang.Float	getFloatParameter(PortletRequest request, java.lang.String name) Get a Float parameter, or null if not present.
static float	getFloatParameter(PortletRequest request, java.lang.String name, float defaultVal) Get a float parameter, with a fallback value.
static float[]	getFloatParameters(PortletRequest request, java.lang.String name) Get an array of float parameters, return an empty array if not found.
static java.lang.Integer	getIntParameter(PortletRequest request, java.lang.String name) Get an Integer parameter, or null if not present.
static int	getIntParameter(PortletRequest request, java.lang.String name, int defaultVal) Get an int parameter, with a fallback value.
static int[]	getIntParameters(PortletRequest request, java.lang.String name) Get an array of int parameters, return an empty array if not found.
static java.lang.Long	getLongParameter(PortletRequest request, java.lang.String name) Get a Long parameter, or null if not present.
static long	getLongParameter(PortletRequest request, java.lang.String name, long defaultVal) Get a long parameter, with a fallback value.
static long[]	getLongParameters(PortletRequest request, java.lang.String name) Get an array of long parameters, return an empty array if not found.
static boolean	getRequiredBooleanParameter(PortletRequest request, java.lang.String name) Get a boolean parameter, throwing an exception if it isn't found or isn't a boolean.
static boolean[]	getRequiredBooleanParameters(PortletRequest request, java.lang.String name) Get an array of boolean parameters, throwing an exception if not found or one isn't a boolean.
static double	getRequiredDoubleParameter(PortletRequest request, java.lang.String name) Get a double parameter, throwing an exception if it isn't found or isn't a number.
static double[]	getRequiredDoubleParameters(PortletRequest request, java.lang.String name) Get an array of double parameters, throwing an exception if not found or one is not a number.
static float	getRequiredFloatParameter(PortletRequest request, java.lang.String name) Get a float parameter, throwing an exception if it isn't found or isn't a number.
static float[]	getRequiredFloatParameters(PortletRequest request, java.lang.String name) Get an array of float parameters, throwing an exception if not found or one is not a number.
static int	getRequiredIntParameter(PortletRequest request, java.lang.String name) Get an int parameter, throwing an exception if it isn't found or isn't a number.
static int[]	getRequiredIntParameters(PortletRequest request, java.lang.String name) Get an array of int parameters, throwing an exception if not found or one is not a number..
static long	getRequiredLongParameter(PortletRequest request, java.lang.String name) Get a long parameter, throwing an exception if it isn't found or isn't a number.
static long[]	getRequiredLongParameters(PortletRequest request, java.lang.String name) Get an array of long parameters, throwing an exception if not found or one is not a number.
static java.lang.String	getRequiredStringParameter(PortletRequest request, java.lang.String name) Get a String parameter, throwing an exception if it isn't found or is empty.
static java.lang.String[]	getRequiredStringParameters(PortletRequest request, java.lang.String name) Get an array of String parameters, throwing an exception if not found or one is empty.
static java.lang.String	getStringParameter(PortletRequest request, java.lang.String name) Get a String parameter, or null if not present.
static java.lang.String	getStringParameter(PortletRequest request, java.lang.String name, java.lang.String defaultVal) Get a String parameter, with a fallback value.
static java.lang.String[]	getStringParameters(PortletRequest request, java.lang.String name) Get an array of String parameters, return an empty array if not found.

Methods inherited from class java.lang.Object

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

Field Detail

INT_PARSER

private static final PortletRequestUtils.IntParser INT_PARSER

LONG_PARSER

private static final PortletRequestUtils.LongParser LONG_PARSER

FLOAT_PARSER

private static final PortletRequestUtils.FloatParser FLOAT_PARSER

DOUBLE_PARSER

private static final PortletRequestUtils.DoubleParser DOUBLE_PARSER

BOOLEAN_PARSER

private static final PortletRequestUtils.BooleanParser BOOLEAN_PARSER

STRING_PARSER

private static final PortletRequestUtils.StringParser STRING_PARSER

Constructor Detail

PortletRequestUtils

public PortletRequestUtils()

Method Detail

getIntParameter

public static java.lang.Integer getIntParameter(PortletRequest request,
                                                java.lang.String name)
                                         throws PortletRequestBindingException

Get an Integer parameter, or null if not present. Throws an exception if it the parameter value isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the Integer value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getIntParameter

public static int getIntParameter(PortletRequest request,
                                  java.lang.String name,
                                  int defaultVal)

Get an int parameter, with a fallback value. Never throws an exception. Can pass a distinguished value as default to enable checks of whether it was supplied.

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getIntParameters

public static int[] getIntParameters(PortletRequest request,
                                     java.lang.String name)

Get an array of int parameters, return an empty array if not found.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredIntParameter

public static int getRequiredIntParameter(PortletRequest request,
                                          java.lang.String name)
                                   throws PortletRequestBindingException

Get an int parameter, throwing an exception if it isn't found or isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredIntParameters

public static int[] getRequiredIntParameters(PortletRequest request,
                                             java.lang.String name)
                                      throws PortletRequestBindingException

Get an array of int parameters, throwing an exception if not found or one is not a number..

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getLongParameter

public static java.lang.Long getLongParameter(PortletRequest request,
                                              java.lang.String name)
                                       throws PortletRequestBindingException

Get a Long parameter, or null if not present. Throws an exception if it the parameter value isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the Long value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getLongParameter

public static long getLongParameter(PortletRequest request,
                                    java.lang.String name,
                                    long defaultVal)

Get a long parameter, with a fallback value. Never throws an exception. Can pass a distinguished value as default to enable checks of whether it was supplied.

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getLongParameters

public static long[] getLongParameters(PortletRequest request,
                                       java.lang.String name)

Get an array of long parameters, return an empty array if not found.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredLongParameter

public static long getRequiredLongParameter(PortletRequest request,
                                            java.lang.String name)
                                     throws PortletRequestBindingException

Get a long parameter, throwing an exception if it isn't found or isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredLongParameters

public static long[] getRequiredLongParameters(PortletRequest request,
                                               java.lang.String name)
                                        throws PortletRequestBindingException

Get an array of long parameters, throwing an exception if not found or one is not a number.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getFloatParameter

public static java.lang.Float getFloatParameter(PortletRequest request,
                                                java.lang.String name)
                                         throws PortletRequestBindingException

Get a Float parameter, or null if not present. Throws an exception if it the parameter value isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the Float value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getFloatParameter

public static float getFloatParameter(PortletRequest request,
                                      java.lang.String name,
                                      float defaultVal)

Get a float parameter, with a fallback value. Never throws an exception. Can pass a distinguished value as default to enable checks of whether it was supplied.

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getFloatParameters

public static float[] getFloatParameters(PortletRequest request,
                                         java.lang.String name)

Get an array of float parameters, return an empty array if not found.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredFloatParameter

public static float getRequiredFloatParameter(PortletRequest request,
                                              java.lang.String name)
                                       throws PortletRequestBindingException

Get a float parameter, throwing an exception if it isn't found or isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredFloatParameters

public static float[] getRequiredFloatParameters(PortletRequest request,
                                                 java.lang.String name)
                                          throws PortletRequestBindingException

Get an array of float parameters, throwing an exception if not found or one is not a number.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getDoubleParameter

public static java.lang.Double getDoubleParameter(PortletRequest request,
                                                  java.lang.String name)
                                           throws PortletRequestBindingException

Get a Double parameter, or null if not present. Throws an exception if it the parameter value isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the Double value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getDoubleParameter

public static double getDoubleParameter(PortletRequest request,
                                        java.lang.String name,
                                        double defaultVal)

Get a double parameter, with a fallback value. Never throws an exception. Can pass a distinguished value as default to enable checks of whether it was supplied.

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getDoubleParameters

public static double[] getDoubleParameters(PortletRequest request,
                                           java.lang.String name)

Get an array of double parameters, return an empty array if not found.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredDoubleParameter

public static double getRequiredDoubleParameter(PortletRequest request,
                                                java.lang.String name)
                                         throws PortletRequestBindingException

Get a double parameter, throwing an exception if it isn't found or isn't a number.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredDoubleParameters

public static double[] getRequiredDoubleParameters(PortletRequest request,
                                                   java.lang.String name)
                                            throws PortletRequestBindingException

Get an array of double parameters, throwing an exception if not found or one is not a number.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getBooleanParameter

public static java.lang.Boolean getBooleanParameter(PortletRequest request,
                                                    java.lang.String name)
                                             throws PortletRequestBindingException

Get a Boolean parameter, or null if not present. Throws an exception if it the parameter value isn't a boolean.

Accepts "true", "on", "yes" (any case) and "1" as values for true; treats every other non-empty value as false (i.e. parses leniently).

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the Boolean value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getBooleanParameter

public static boolean getBooleanParameter(PortletRequest request,
                                          java.lang.String name,
                                          boolean defaultVal)

Get a boolean parameter, with a fallback value. Never throws an exception. Can pass a distinguished value as default to enable checks of whether it was supplied.

Accepts "true", "on", "yes" (any case) and "1" as values for true; treats every other non-empty value as false (i.e. parses leniently).

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getBooleanParameters

public static boolean[] getBooleanParameters(PortletRequest request,
                                             java.lang.String name)

Get an array of boolean parameters, return an empty array if not found.

Accepts "true", "on", "yes" (any case) and "1" as values for true; treats every other non-empty value as false (i.e. parses leniently).

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredBooleanParameter

public static boolean getRequiredBooleanParameter(PortletRequest request,
                                                  java.lang.String name)
                                           throws PortletRequestBindingException

Get a boolean parameter, throwing an exception if it isn't found or isn't a boolean.

Accepts "true", "on", "yes" (any case) and "1" as values for true; treats every other non-empty value as false (i.e. parses leniently).

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredBooleanParameters

public static boolean[] getRequiredBooleanParameters(PortletRequest request,
                                                     java.lang.String name)
                                              throws PortletRequestBindingException

Get an array of boolean parameters, throwing an exception if not found or one isn't a boolean.

Accepts "true", "on", "yes" (any case) and "1" as values for true; treats every other non-empty value as false (i.e. parses leniently).

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getStringParameter

public static java.lang.String getStringParameter(PortletRequest request,
                                                  java.lang.String name)
                                           throws PortletRequestBindingException

Get a String parameter, or null if not present. Throws an exception if it the parameter value is empty.

Parameters:

request - current portlet request

name - the name of the parameter

Returns:

the String value, or null if not present

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getStringParameter

public static java.lang.String getStringParameter(PortletRequest request,
                                                  java.lang.String name,
                                                  java.lang.String defaultVal)

Get a String parameter, with a fallback value. Never throws an exception. Can pass a distinguished value to default to enable checks of whether it was supplied.

Parameters:

request - current portlet request

name - the name of the parameter

defaultVal - the default value to use as fallback

getStringParameters

public static java.lang.String[] getStringParameters(PortletRequest request,
                                                     java.lang.String name)

Get an array of String parameters, return an empty array if not found.

Parameters:

request - current portlet request

name - the name of the parameter with multiple possible values

getRequiredStringParameter

public static java.lang.String getRequiredStringParameter(PortletRequest request,
                                                          java.lang.String name)
                                                   throws PortletRequestBindingException

Get a String parameter, throwing an exception if it isn't found or is empty.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught

getRequiredStringParameters

public static java.lang.String[] getRequiredStringParameters(PortletRequest request,
                                                             java.lang.String name)
                                                      throws PortletRequestBindingException

Get an array of String parameters, throwing an exception if not found or one is empty.

Parameters:

request - current portlet request

name - the name of the parameter

Throws:

PortletRequestBindingException - a subclass of PortletException, so it doesn't need to be caught