类 ServletRequestUtils
- java.lang.Object
- org.springframework.web.bind.ServletRequestUtils
public abstract class ServletRequestUtils extends 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.
- 从以下版本开始:
- 2.0
- 作者:
- Juergen Hoeller, Keith Donald
构造器概要
构造器 构造器 说明 ServletRequestUtils()
方法概要
所有方法 静态方法 具体方法 修饰符和类型 方法 说明 static Boolean
getBooleanParameter(ServletRequest request, String name)
Get a Boolean parameter, ornull
if not present.static boolean
getBooleanParameter(ServletRequest request, String name, boolean defaultVal)
Get a boolean parameter, with a fallback value.static boolean[]
getBooleanParameters(ServletRequest request, String name)
Get an array of boolean parameters, return an empty array if not found.static Double
getDoubleParameter(ServletRequest request, String name)
Get a Double parameter, ornull
if not present.static double
getDoubleParameter(ServletRequest request, String name, double defaultVal)
Get a double parameter, with a fallback value.static double[]
getDoubleParameters(ServletRequest request, String name)
Get an array of double parameters, return an empty array if not found.static Float
getFloatParameter(ServletRequest request, String name)
Get a Float parameter, ornull
if not present.static float
getFloatParameter(ServletRequest request, String name, float defaultVal)
Get a float parameter, with a fallback value.static float[]
getFloatParameters(ServletRequest request, String name)
Get an array of float parameters, return an empty array if not found.static Integer
getIntParameter(ServletRequest request, String name)
Get an Integer parameter, ornull
if not present.static int
getIntParameter(ServletRequest request, String name, int defaultVal)
Get an int parameter, with a fallback value.static int[]
getIntParameters(ServletRequest request, String name)
Get an array of int parameters, return an empty array if not found.static Long
getLongParameter(ServletRequest request, String name)
Get a Long parameter, ornull
if not present.static long
getLongParameter(ServletRequest request, String name, long defaultVal)
Get a long parameter, with a fallback value.static long[]
getLongParameters(ServletRequest request, String name)
Get an array of long parameters, return an empty array if not found.static boolean
getRequiredBooleanParameter(ServletRequest request, String name)
Get a boolean parameter, throwing an exception if it isn't found or isn't a boolean.static boolean[]
getRequiredBooleanParameters(ServletRequest request, String name)
Get an array of boolean parameters, throwing an exception if not found or one isn't a boolean.static double
getRequiredDoubleParameter(ServletRequest request, String name)
Get a double parameter, throwing an exception if it isn't found or isn't a number.static double[]
getRequiredDoubleParameters(ServletRequest request, String name)
Get an array of double parameters, throwing an exception if not found or one is not a number.static float
getRequiredFloatParameter(ServletRequest request, String name)
Get a float parameter, throwing an exception if it isn't found or isn't a number.static float[]
getRequiredFloatParameters(ServletRequest request, String name)
Get an array of float parameters, throwing an exception if not found or one is not a number.static int
getRequiredIntParameter(ServletRequest request, String name)
Get an int parameter, throwing an exception if it isn't found or isn't a number.static int[]
getRequiredIntParameters(ServletRequest request, String name)
Get an array of int parameters, throwing an exception if not found or one is not a number..static long
getRequiredLongParameter(ServletRequest request, String name)
Get a long parameter, throwing an exception if it isn't found or isn't a number.static long[]
getRequiredLongParameters(ServletRequest request, String name)
Get an array of long parameters, throwing an exception if not found or one is not a number.static String
getRequiredStringParameter(ServletRequest request, String name)
Get a String parameter, throwing an exception if it isn't found.static String[]
getRequiredStringParameters(ServletRequest request, String name)
Get an array of String parameters, throwing an exception if not found.static String
getStringParameter(ServletRequest request, String name)
Get a String parameter, ornull
if not present.static String
getStringParameter(ServletRequest request, String name, String defaultVal)
Get a String parameter, with a fallback value.static String[]
getStringParameters(ServletRequest request, String name)
Get an array of String parameters, return an empty array if not found.
构造器详细资料
ServletRequestUtils
public ServletRequestUtils()
方法详细资料
getIntParameter
public static Integer getIntParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get an Integer parameter, ornull
if not present. Throws an exception if it the parameter value isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the Integer value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getIntParameter
public static int getIntParameter(ServletRequest request, 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.- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getIntParameters
public static int[] getIntParameters(ServletRequest request, String name)
Get an array of int parameters, return an empty array if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredIntParameter
public static int getRequiredIntParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get an int parameter, throwing an exception if it isn't found or isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredIntParameters
public static int[] getRequiredIntParameters(ServletRequest request, String name) throws ServletRequestBindingException
Get an array of int parameters, throwing an exception if not found or one is not a number..- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getLongParameter
public static Long getLongParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a Long parameter, ornull
if not present. Throws an exception if it the parameter value isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the Long value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getLongParameter
public static long getLongParameter(ServletRequest request, 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.- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getLongParameters
public static long[] getLongParameters(ServletRequest request, String name)
Get an array of long parameters, return an empty array if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredLongParameter
public static long getRequiredLongParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a long parameter, throwing an exception if it isn't found or isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredLongParameters
public static long[] getRequiredLongParameters(ServletRequest request, String name) throws ServletRequestBindingException
Get an array of long parameters, throwing an exception if not found or one is not a number.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getFloatParameter
public static Float getFloatParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a Float parameter, ornull
if not present. Throws an exception if it the parameter value isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the Float value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getFloatParameter
public static float getFloatParameter(ServletRequest request, 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.- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getFloatParameters
public static float[] getFloatParameters(ServletRequest request, String name)
Get an array of float parameters, return an empty array if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredFloatParameter
public static float getRequiredFloatParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a float parameter, throwing an exception if it isn't found or isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredFloatParameters
public static float[] getRequiredFloatParameters(ServletRequest request, String name) throws ServletRequestBindingException
Get an array of float parameters, throwing an exception if not found or one is not a number.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getDoubleParameter
public static Double getDoubleParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a Double parameter, ornull
if not present. Throws an exception if it the parameter value isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the Double value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getDoubleParameter
public static double getDoubleParameter(ServletRequest request, 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.- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getDoubleParameters
public static double[] getDoubleParameters(ServletRequest request, String name)
Get an array of double parameters, return an empty array if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredDoubleParameter
public static double getRequiredDoubleParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a double parameter, throwing an exception if it isn't found or isn't a number.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredDoubleParameters
public static double[] getRequiredDoubleParameters(ServletRequest request, String name) throws ServletRequestBindingException
Get an array of double parameters, throwing an exception if not found or one is not a number.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getBooleanParameter
public static Boolean getBooleanParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a Boolean parameter, ornull
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).
- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the Boolean value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getBooleanParameter
public static boolean getBooleanParameter(ServletRequest request, 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).
- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getBooleanParameters
public static boolean[] getBooleanParameters(ServletRequest request, 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).
- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredBooleanParameter
public static boolean getRequiredBooleanParameter(ServletRequest request, String name) throws ServletRequestBindingException
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).
- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredBooleanParameters
public static boolean[] getRequiredBooleanParameters(ServletRequest request, String name) throws ServletRequestBindingException
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).
- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getStringParameter
public static String getStringParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a String parameter, ornull
if not present.- 参数:
request
- current HTTP requestname
- the name of the parameter- 返回:
- the String value, or
null
if not present - 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getStringParameter
public static String getStringParameter(ServletRequest request, String name, 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.- 参数:
request
- current HTTP requestname
- the name of the parameterdefaultVal
- the default value to use as fallback
getStringParameters
public static String[] getStringParameters(ServletRequest request, String name)
Get an array of String parameters, return an empty array if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter with multiple possible values
getRequiredStringParameter
public static String getRequiredStringParameter(ServletRequest request, String name) throws ServletRequestBindingException
Get a String parameter, throwing an exception if it isn't found.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught
getRequiredStringParameters
public static String[] getRequiredStringParameters(ServletRequest request, String name) throws ServletRequestBindingException
Get an array of String parameters, throwing an exception if not found.- 参数:
request
- current HTTP requestname
- the name of the parameter- 抛出:
ServletRequestBindingException
- a subclass of ServletException, so it doesn't need to be caught