Package org.apache.myfaces.util
Class WebConfigParamUtils
- java.lang.Object
-
- org.apache.myfaces.util.WebConfigParamUtils
-
public final class WebConfigParamUtils extends Object
Utility class to handle web config parameters- Since:
- 2.0.10 (4.0.4 in shared, 1.0.1 in commons)
-
-
Constructor Summary
Constructors Constructor Description WebConfigParamUtils()
-
Method Summary
All Methods Static Methods Concrete Methods Modifier and Type Method Description static boolean
getBooleanInitParameter(ExternalContext context, String name)
Gets the boolean init parameter value from the specified context.static boolean
getBooleanInitParameter(ExternalContext context, String[] names)
Gets the boolean init parameter value from the specified context.static boolean
getBooleanInitParameter(ExternalContext context, String[] names, boolean defaultValue)
Gets the boolean init parameter value from the specified context.static boolean
getBooleanInitParameter(ExternalContext context, String[] names, boolean defaultValue, String[] valuesIgnoreCase, boolean returnOnValueEqualsIgnoreCase)
Gets the boolean init parameter value from the specified context.static boolean
getBooleanInitParameter(ExternalContext context, String name, boolean defaultValue)
Gets the boolean init parameter value from the specified context.static boolean
getBooleanInitParameter(ExternalContext context, String name, boolean defaultValue, String[] valuesIgnoreCase, boolean returnOnValueEqualsIgnoreCase)
Gets the boolean init parameter value from the specified context.static <T> T
getInstanceInitParameter(ExternalContext context, String name, String deprecatedName, T defaultValue)
Gets the init parameter value from the specified context and instanciate it.static int
getIntegerInitParameter(ExternalContext context, String name)
Gets the int init parameter value from the specified context.static int
getIntegerInitParameter(ExternalContext context, String[] names)
Gets the int init parameter value from the specified context.static int
getIntegerInitParameter(ExternalContext context, String[] names, int defaultValue)
Gets the int init parameter value from the specified context.static int
getIntegerInitParameter(ExternalContext context, String name, int defaultValue)
Gets the int init parameter value from the specified context.static long
getLongInitParameter(ExternalContext context, String name)
Gets the long init parameter value from the specified context.static long
getLongInitParameter(ExternalContext context, String[] names)
Gets the long init parameter value from the specified context.static long
getLongInitParameter(ExternalContext context, String[] names, long defaultValue)
Gets the long init parameter value from the specified context.static long
getLongInitParameter(ExternalContext context, String name, long defaultValue)
Gets the long init parameter value from the specified context.static String
getStringInitParameter(ExternalContext context, String name)
Gets the String init parameter value from the specified context.static String
getStringInitParameter(ExternalContext context, String[] names)
Gets the String init parameter value from the specified context.static String
getStringInitParameter(ExternalContext context, String[] names, String defaultValue)
Gets the String init parameter value from the specified context.static String
getStringInitParameter(ExternalContext context, String name, String defaultValue)
Gets the String init parameter value from the specified context.
-
-
-
Method Detail
-
getStringInitParameter
public static String getStringInitParameter(ExternalContext context, String name)
Gets the String init parameter value from the specified context. If the parameter is an empty String or a String containing only white space, this method returnsnull
- Parameters:
context
- the application's external contextname
- the init parameter's name- Returns:
- the parameter if it was specified and was not empty,
null
otherwise - Throws:
NullPointerException
- if context or name isnull
-
getStringInitParameter
public static String getStringInitParameter(ExternalContext context, String name, String defaultValue)
Gets the String init parameter value from the specified context. If the parameter is an empty String or a String containing only white space, this method returnsnull
- Parameters:
context
- the application's external contextname
- the init parameter's namedefaultValue
- the value by default if null or empty- Returns:
- the parameter if it was specified and was not empty,
null
otherwise - Throws:
NullPointerException
- if context or name isnull
-
getStringInitParameter
public static String getStringInitParameter(ExternalContext context, String[] names)
Gets the String init parameter value from the specified context. If the parameter is an empty String or a String containing only white space, this method returnsnull
- Parameters:
context
- the application's external contextnames
- the init parameter's names, the first one is scanned first. Usually used when a param has multiple aliases- Returns:
- the parameter if it was specified and was not empty,
null
otherwise - Throws:
NullPointerException
- if context or name isnull
-
getStringInitParameter
public static String getStringInitParameter(ExternalContext context, String[] names, String defaultValue)
Gets the String init parameter value from the specified context. If the parameter is an empty String or a String containing only white space, this method returnsnull
- Parameters:
context
- the application's external contextnames
- the init parameter's names, the first one is scanned first. Usually used when a param has multiple aliasesdefaultValue
- the value by default if null or empty- Returns:
- the parameter if it was specified and was not empty,
null
otherwise - Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String name)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's name- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String name, boolean defaultValue)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's namedefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String name, boolean defaultValue, String[] valuesIgnoreCase, boolean returnOnValueEqualsIgnoreCase)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's namedefaultValue
- the default value to return in case the parameter was not setvaluesIgnoreCase
- an array of valid values to matchreturnOnValueEqualsIgnoreCase
- the value to return in case the parameter match with valuesIgnoreCase- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String[] names)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's names- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String[] names, boolean defaultValue)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's namesdefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getBooleanInitParameter
public static boolean getBooleanInitParameter(ExternalContext context, String[] names, boolean defaultValue, String[] valuesIgnoreCase, boolean returnOnValueEqualsIgnoreCase)
Gets the boolean init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's namesdefaultValue
- the default value to return in case the parameter was not setvaluesIgnoreCase
- an array of valid values to matchreturnOnValueEqualsIgnoreCase
- the value to return in case the parameter match with valuesIgnoreCase- Returns:
- the init parameter value as a boolean
- Throws:
NullPointerException
- if context or name isnull
-
getIntegerInitParameter
public static int getIntegerInitParameter(ExternalContext context, String name)
Gets the int init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's name- Returns:
- the init parameter value as a int
- Throws:
NullPointerException
- if context or name isnull
-
getIntegerInitParameter
public static int getIntegerInitParameter(ExternalContext context, String name, int defaultValue)
Gets the int init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's namedefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a int
- Throws:
NullPointerException
- if context or name isnull
-
getIntegerInitParameter
public static int getIntegerInitParameter(ExternalContext context, String[] names)
Gets the int init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's names- Returns:
- the init parameter value as a int
- Throws:
NullPointerException
- if context or name isnull
-
getIntegerInitParameter
public static int getIntegerInitParameter(ExternalContext context, String[] names, int defaultValue)
Gets the int init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's namesdefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a int
- Throws:
NullPointerException
- if context or name isnull
-
getLongInitParameter
public static long getLongInitParameter(ExternalContext context, String name)
Gets the long init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's name- Returns:
- the init parameter value as a long
- Throws:
NullPointerException
- if context or name isnull
-
getLongInitParameter
public static long getLongInitParameter(ExternalContext context, String name, long defaultValue)
Gets the long init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's namedefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a long
- Throws:
NullPointerException
- if context or name isnull
-
getLongInitParameter
public static long getLongInitParameter(ExternalContext context, String[] names)
Gets the long init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's names- Returns:
- the init parameter value as a long
- Throws:
NullPointerException
- if context or name isnull
-
getLongInitParameter
public static long getLongInitParameter(ExternalContext context, String[] names, long defaultValue)
Gets the long init parameter value from the specified context. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextnames
- the init parameter's namesdefaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as a long
- Throws:
NullPointerException
- if context or name isnull
-
getInstanceInitParameter
public static <T> T getInstanceInitParameter(ExternalContext context, String name, String deprecatedName, T defaultValue)
Gets the init parameter value from the specified context and instanciate it. If the parameter was not specified, the default value is used instead.- Parameters:
context
- the application's external contextname
- the init parameter's namedeprecatedName
- the init parameter's deprecated name.defaultValue
- the default value to return in case the parameter was not set- Returns:
- the init parameter value as an object instance
- Throws:
NullPointerException
- if context or name isnull
-
-