javax.servlet.jsp.jstl.core

Class Config

public class Config extends Object

Class supporting access to configuration settings.
Field Summary
static StringFMT_FALLBACK_LOCALE
Name of configuration setting for fallback locale
static StringFMT_LOCALE
Name of configuration setting for application- (as opposed to browser-) based preferred locale
static StringFMT_LOCALIZATION_CONTEXT
Name of configuration setting for i18n localization context
static StringFMT_TIME_ZONE
Name of localization setting for time zone
static StringSQL_DATA_SOURCE
Name of configuration setting for SQL data source
static StringSQL_MAX_ROWS
Name of configuration setting for maximum number of rows to be included in SQL query result
Method Summary
static Objectfind(PageContext pc, String name)
Finds the value associated with a specific configuration setting identified by its context initialization parameter name.
static Objectget(PageContext pc, String name, int scope)
Looks up a configuration variable in the given scope.
static Objectget(ServletRequest request, String name)
Looks up a configuration variable in the "request" scope.
static Objectget(HttpSession session, String name)
Looks up a configuration variable in the "session" scope.
static Objectget(ServletContext context, String name)
Looks up a configuration variable in the "application" scope.
static voidremove(PageContext pc, String name, int scope)
Removes a configuration variable from the given scope.
static voidremove(ServletRequest request, String name)
Removes a configuration variable from the "request" scope.
static voidremove(HttpSession session, String name)
Removes a configuration variable from the "session" scope.
static voidremove(ServletContext context, String name)
Removes a configuration variable from the "application" scope.
static voidset(PageContext pc, String name, Object value, int scope)
Sets the value of a configuration variable in the given scope.
static voidset(ServletRequest request, String name, Object value)
Sets the value of a configuration variable in the "request" scope.
static voidset(HttpSession session, String name, Object value)
Sets the value of a configuration variable in the "session" scope.
static voidset(ServletContext context, String name, Object value)
Sets the value of a configuration variable in the "application" scope.

Field Detail

FMT_FALLBACK_LOCALE

public static final String FMT_FALLBACK_LOCALE
Name of configuration setting for fallback locale

FMT_LOCALE

public static final String FMT_LOCALE
Name of configuration setting for application- (as opposed to browser-) based preferred locale

FMT_LOCALIZATION_CONTEXT

public static final String FMT_LOCALIZATION_CONTEXT
Name of configuration setting for i18n localization context

FMT_TIME_ZONE

public static final String FMT_TIME_ZONE
Name of localization setting for time zone

SQL_DATA_SOURCE

public static final String SQL_DATA_SOURCE
Name of configuration setting for SQL data source

SQL_MAX_ROWS

public static final String SQL_MAX_ROWS
Name of configuration setting for maximum number of rows to be included in SQL query result

Method Detail

find

public static Object find(PageContext pc, String name)
Finds the value associated with a specific configuration setting identified by its context initialization parameter name.

For each of the JSP scopes (page, request, session, application), get the value of the configuration variable identified by name using method get(). Return as soon as a non-null value is found. If no value is found, get the value of the context initialization parameter identified by name.

Parameters: pc Page context in which the configuration setting is to be searched name Context initialization parameter name of the configuration setting

Returns: The java.lang.Object associated with the configuration setting identified by name, or null if it is not defined.

get

public static Object get(PageContext pc, String name, int scope)
Looks up a configuration variable in the given scope.

The lookup of configuration variables is performed as if each scope had its own name space, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: pc Page context in which the configuration variable is to be looked up name Configuration variable name scope Scope in which the configuration variable is to be looked up

Returns: The java.lang.Object associated with the configuration variable, or null if it is not defined.

get

public static Object get(ServletRequest request, String name)
Looks up a configuration variable in the "request" scope.

The lookup of configuration variables is performed as if each scope had its own name space, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: request Request object in which the configuration variable is to be looked up name Configuration variable name

Returns: The java.lang.Object associated with the configuration variable, or null if it is not defined.

get

public static Object get(HttpSession session, String name)
Looks up a configuration variable in the "session" scope.

The lookup of configuration variables is performed as if each scope had its own name space, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: session Session object in which the configuration variable is to be looked up name Configuration variable name

Returns: The java.lang.Object associated with the configuration variable, or null if it is not defined, if session is null, or if the session is invalidated.

get

public static Object get(ServletContext context, String name)
Looks up a configuration variable in the "application" scope.

The lookup of configuration variables is performed as if each scope had its own name space, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: context Servlet context in which the configuration variable is to be looked up name Configuration variable name

Returns: The java.lang.Object associated with the configuration variable, or null if it is not defined.

remove

public static void remove(PageContext pc, String name, int scope)
Removes a configuration variable from the given scope.

Removing a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not impact one stored in a different scope.

Parameters: pc Page context from which the configuration variable is to be removed name Configuration variable name scope Scope from which the configuration variable is to be removed

remove

public static void remove(ServletRequest request, String name)
Removes a configuration variable from the "request" scope.

Removing a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not impact one stored in a different scope.

Parameters: request Request object from which the configuration variable is to be removed name Configuration variable name

remove

public static void remove(HttpSession session, String name)
Removes a configuration variable from the "session" scope.

Removing a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not impact one stored in a different scope.

Parameters: session Session object from which the configuration variable is to be removed name Configuration variable name

remove

public static void remove(ServletContext context, String name)
Removes a configuration variable from the "application" scope.

Removing a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not impact one stored in a different scope.

Parameters: context Servlet context from which the configuration variable is to be removed name Configuration variable name

set

public static void set(PageContext pc, String name, Object value, int scope)
Sets the value of a configuration variable in the given scope.

Setting the value of a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: pc Page context in which the configuration variable is to be set name Configuration variable name value Configuration variable value scope Scope in which the configuration variable is to be set

set

public static void set(ServletRequest request, String name, Object value)
Sets the value of a configuration variable in the "request" scope.

Setting the value of a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: request Request object in which the configuration variable is to be set name Configuration variable name value Configuration variable value

set

public static void set(HttpSession session, String name, Object value)
Sets the value of a configuration variable in the "session" scope.

Setting the value of a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: session Session object in which the configuration variable is to be set name Configuration variable name value Configuration variable value

set

public static void set(ServletContext context, String name, Object value)
Sets the value of a configuration variable in the "application" scope.

Setting the value of a configuration variable is performed as if each scope had its own namespace, that is, the same configuration variable name in one scope does not replace one stored in a different scope.

Parameters: context Servlet context in which the configuration variable is to be set name Configuration variable name value Configuration variable value

Copyright 2003 Sun Microsystems, Inc. All Rights Reserved.