RequestContext (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

The Spring Framework

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

org.springframework.web.servlet.support
Class RequestContext

java.lang.Object
  org.springframework.web.servlet.support.RequestContext

Direct Known Subclasses:: JspAwareRequestContext

public class RequestContext
extends Object
extends Object

Context holder for request-specific state, like current web application context, current locale, current theme, and potential binding errors. Provides easy access to localized messages and Errors instances.

Suitable for exposition to views, and usage within JSP's "useBean" tag, JSP scriptlets, JSTL EL, Velocity templates, etc. Necessary for views that do not have access to the servlet request, like Velocity templates.

Can be instantiated manually, or automatically exposed to views as model attribute via AbstractView's "requestContextAttribute" property.

Will also work outside DispatcherServlet requests, accessing the root WebApplicationContext and using an appropriate fallback for the locale (the JSTL locale if available, or the HttpServletRequest locale else).

Since:: 03.03.2003
Author:: Juergen Hoeller
See Also:: DispatcherServlet, AbstractView.setRequestContextAttribute(java.lang.String), UrlBasedViewResolver.setRequestContextAttribute(java.lang.String), getFallbackLocale()

Field Summary

protected static String APPLICATION_SCOPE_SUFFIX
          JSTL suffix for application-scoped attributes

static String DEFAULT_THEME_NAME
          Default theme name used if the RequestContext cannot find a ThemeResolver.

static String JSTL_LOCALE_ATTRIBUTE
          JSTL locale attribute, as used by JSTL implementations to expose their current locale.

protected static String REQUEST_SCOPE_SUFFIX
          JSTL suffix for request-scoped attributes

protected static String SESSION_SCOPE_SUFFIX
          JSTL suffix for session-scoped attributes

Constructor Summary

protected RequestContext()
          Default constructor for subclasses.

RequestContext(HttpServletRequest request)
          Create a new RequestContext for the given request, using the request attributes for Errors retrieval.

RequestContext(HttpServletRequest request, Map model)
          Create a new RequestContext for the given request, using the given model attributes for Errors retrieval.

RequestContext(HttpServletRequest request, ServletContext servletContext)
          Create a new RequestContext for the given request, using the request attributes for Errors retrieval.

RequestContext(HttpServletRequest request, ServletContext servletContext, Map model)
          Create a new RequestContext for the given request, using the given model attributes for Errors retrieval.

Method Summary

BindStatus getBindStatus(String path)
          Create a BindStatus for the given bind object, using the "defaultHtmlEscape" setting.

BindStatus getBindStatus(String path, boolean htmlEscape)
          Create a BindStatus for the given bind object, using the "defaultHtmlEscape" setting.

String getContextPath()
          Return the context path of the original request, that is, the path that indicates the current web application.

Errors getErrors(String name)
          Retrieve the Errors instance for the given bind object, using the "defaultHtmlEscape" setting.

Errors getErrors(String name, boolean htmlEscape)
          Retrieve the Errors instance for the given bind object.

protected Locale getFallbackLocale()
          Determine the fallback locale for this context.

protected Theme getFallbackTheme()
          Determine the fallback theme for this context.

Locale getLocale()
          Return the current locale.

String getMessage(MessageSourceResolvable resolvable)
          Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance), using the "defaultHtmlEscape" setting.

String getMessage(MessageSourceResolvable resolvable, boolean htmlEscape)
          Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance).

String getMessage(String code)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

String getMessage(String code, List args)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

String getMessage(String code, List args, String defaultMessage)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

String getMessage(String code, Object[] args)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

String getMessage(String code, Object[] args, boolean htmlEscape)
          Retrieve the message for the given code.

String getMessage(String code, Object[] args, String defaultMessage)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

String getMessage(String code, Object[] args, String defaultMessage, boolean htmlEscape)
          Retrieve the message for the given code.

String getMessage(String code, String defaultMessage)
          Retrieve the message for the given code, using the "defaultHtmlEscape" setting.

protected Object getModelObject(String modelName)
          Retrieve the model object for the given model name, either from the model or from the request attributes.

String getQueryString()
          Return the query string of the current request, that is, the part after the request path.

protected HttpServletRequest getRequest()
          Return the underlying HttpServletRequest.

String getRequestUri()
          Return the request URI of the original request, that is, the invoked URL without parameters.

protected ServletContext getServletContext()
          Return the underlying ServletContext.

Theme getTheme()
          Return the current theme.

String getThemeMessage(MessageSourceResolvable resolvable)
          Retrieve the given MessageSourceResolvable in the current theme.

String getThemeMessage(String code)
          Retrieve the theme message for the given code.

String getThemeMessage(String code, List args)
          Retrieve the theme message for the given code.

String getThemeMessage(String code, List args, String defaultMessage)
          Retrieve the theme message for the given code.

String getThemeMessage(String code, Object[] args)
          Retrieve the theme message for the given code.

String getThemeMessage(String code, Object[] args, String defaultMessage)
          Retrieve the theme message for the given code.

String getThemeMessage(String code, String defaultMessage)
          Retrieve the theme message for the given code.

UrlPathHelper getUrlPathHelper()
          Return the UrlPathHelper used for context path and request URI decoding.

WebApplicationContext getWebApplicationContext()
          Return the current WebApplicationContext.

protected void initContext(HttpServletRequest request, ServletContext servletContext, Map model)
          Initialize this context with the given request, using the given model attributes for Errors retrieval.

boolean isDefaultHtmlEscape()
          Is default HTML escaping active?

void setDefaultHtmlEscape(boolean defaultHtmlEscape)
          (De)activate default HTML escaping for messages and errors, for the scope of this RequestContext.

void setUrlPathHelper(UrlPathHelper urlPathHelper)
          Set the UrlPathHelper to use for context path and request URI decoding.

Methods inherited from class java.lang.Object

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

Field Summary
`protected static String`	`APPLICATION_SCOPE_SUFFIX` JSTL suffix for application-scoped attributes
`static String`	`DEFAULT_THEME_NAME` Default theme name used if the RequestContext cannot find a ThemeResolver.
`static String`	`JSTL_LOCALE_ATTRIBUTE` JSTL locale attribute, as used by JSTL implementations to expose their current locale.
`protected static String`	`REQUEST_SCOPE_SUFFIX` JSTL suffix for request-scoped attributes
`protected static String`	`SESSION_SCOPE_SUFFIX` JSTL suffix for session-scoped attributes

Constructor Summary
`protected`	`RequestContext()` Default constructor for subclasses.
	`RequestContext(HttpServletRequest request)` Create a new RequestContext for the given request, using the request attributes for Errors retrieval.
	`RequestContext(HttpServletRequest request, Map model)` Create a new RequestContext for the given request, using the given model attributes for Errors retrieval.
	`RequestContext(HttpServletRequest request, ServletContext servletContext)` Create a new RequestContext for the given request, using the request attributes for Errors retrieval.
	`RequestContext(HttpServletRequest request, ServletContext servletContext, Map model)` Create a new RequestContext for the given request, using the given model attributes for Errors retrieval.

Method Summary
`BindStatus`	`getBindStatus(String path)` Create a BindStatus for the given bind object, using the "defaultHtmlEscape" setting.
`BindStatus`	`getBindStatus(String path, boolean htmlEscape)` Create a BindStatus for the given bind object, using the "defaultHtmlEscape" setting.
`String`	`getContextPath()` Return the context path of the original request, that is, the path that indicates the current web application.
`Errors`	`getErrors(String name)` Retrieve the Errors instance for the given bind object, using the "defaultHtmlEscape" setting.
`Errors`	`getErrors(String name, boolean htmlEscape)` Retrieve the Errors instance for the given bind object.
`protected Locale`	`getFallbackLocale()` Determine the fallback locale for this context.
`protected Theme`	`getFallbackTheme()` Determine the fallback theme for this context.
`Locale`	`getLocale()` Return the current locale.
`String`	`getMessage(MessageSourceResolvable resolvable)` Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance), using the "defaultHtmlEscape" setting.
`String`	`getMessage(MessageSourceResolvable resolvable, boolean htmlEscape)` Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance).
`String`	`getMessage(String code)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`String`	`getMessage(String code, List args)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`String`	`getMessage(String code, List args, String defaultMessage)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`String`	`getMessage(String code, Object[] args)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`String`	`getMessage(String code, Object[] args, boolean htmlEscape)` Retrieve the message for the given code.
`String`	`getMessage(String code, Object[] args, String defaultMessage)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`String`	`getMessage(String code, Object[] args, String defaultMessage, boolean htmlEscape)` Retrieve the message for the given code.
`String`	`getMessage(String code, String defaultMessage)` Retrieve the message for the given code, using the "defaultHtmlEscape" setting.
`protected Object`	`getModelObject(String modelName)` Retrieve the model object for the given model name, either from the model or from the request attributes.
`String`	`getQueryString()` Return the query string of the current request, that is, the part after the request path.
`protected HttpServletRequest`	`getRequest()` Return the underlying HttpServletRequest.
`String`	`getRequestUri()` Return the request URI of the original request, that is, the invoked URL without parameters.
`protected ServletContext`	`getServletContext()` Return the underlying ServletContext.
`Theme`	`getTheme()` Return the current theme.
`String`	`getThemeMessage(MessageSourceResolvable resolvable)` Retrieve the given MessageSourceResolvable in the current theme.
`String`	`getThemeMessage(String code)` Retrieve the theme message for the given code.
`String`	`getThemeMessage(String code, List args)` Retrieve the theme message for the given code.
`String`	`getThemeMessage(String code, List args, String defaultMessage)` Retrieve the theme message for the given code.
`String`	`getThemeMessage(String code, Object[] args)` Retrieve the theme message for the given code.
`String`	`getThemeMessage(String code, Object[] args, String defaultMessage)` Retrieve the theme message for the given code.
`String`	`getThemeMessage(String code, String defaultMessage)` Retrieve the theme message for the given code.
`UrlPathHelper`	`getUrlPathHelper()` Return the UrlPathHelper used for context path and request URI decoding.
`WebApplicationContext`	`getWebApplicationContext()` Return the current WebApplicationContext.
`protected void`	`initContext(HttpServletRequest request, ServletContext servletContext, Map model)` Initialize this context with the given request, using the given model attributes for Errors retrieval.
`boolean`	`isDefaultHtmlEscape()` Is default HTML escaping active?
`void`	`setDefaultHtmlEscape(boolean defaultHtmlEscape)` (De)activate default HTML escaping for messages and errors, for the scope of this RequestContext.
`void`	`setUrlPathHelper(UrlPathHelper urlPathHelper)` Set the UrlPathHelper to use for context path and request URI decoding.

Methods inherited from class java.lang.Object
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

Field Detail

DEFAULT_THEME_NAME

public static final String DEFAULT_THEME_NAME

Default theme name used if the RequestContext cannot find a ThemeResolver. Only applies to non-DispatcherServlet requests.

Same as AbstractThemeResolver's default, but not linked in here to avoid package interdependencies.

See Also:: AbstractThemeResolver.ORIGINAL_DEFAULT_THEME_NAME, Constant Field Values

JSTL_LOCALE_ATTRIBUTE

public static final String JSTL_LOCALE_ATTRIBUTE

JSTL locale attribute, as used by JSTL implementations to expose their current locale. Used as fallback in non-DispatcherServlet requests; if not available, the accept-header locale is used (

request.getLocaleSame as the FMT_LOCALE constant in JSTL's Config class, but not linked
 in here to avoid a hard-coded dependency on JSTL. RequestContext does not
 depend on JSTL except for this fallback check of JSTL's locale attribute.


See Also:
Config.FMT_LOCALE, 
ServletRequest.getLocale(), 
Constant Field Values





REQUEST_SCOPE_SUFFIX
protected static final String REQUEST_SCOPE_SUFFIX

JSTL suffix for request-scoped attributes


See Also:
Constant Field Values




SESSION_SCOPE_SUFFIX
protected static final String SESSION_SCOPE_SUFFIX

JSTL suffix for session-scoped attributes


See Also:
Constant Field Values




APPLICATION_SCOPE_SUFFIX
protected static final String APPLICATION_SCOPE_SUFFIX

JSTL suffix for application-scoped attributes


See Also:
Constant Field Values








Constructor Detail




RequestContext
public RequestContext(HttpServletRequest request)

Create a new RequestContext for the given request,
 using the request attributes for Errors retrieval.
 This only works with InternalResourceViews, as Errors instances
 are part of the model and not normally exposed as request attributes.
 It will typically be used within JSPs or custom tags.
 
Will only work within a DispatcherServlet request. Pass in a
 ServletContext to be able to fallback to the root WebApplicationContext.


Parameters:
request - current HTTP request
See Also:
DispatcherServlet, 
RequestContext(javax.servlet.http.HttpServletRequest, javax.servlet.ServletContext)




RequestContext
public RequestContext(HttpServletRequest request,
                      ServletContext servletContext)

Create a new RequestContext for the given request,
 using the request attributes for Errors retrieval.
 This only works with InternalResourceViews, as Errors instances
 are part of the model and not normally exposed as request attributes.
 It will typically be used within JSPs or custom tags.
 
If a ServletContext is specified, the RequestContext will also
 work with the root WebApplicationContext (outside a DispatcherServlet).


Parameters:
request - current HTTP request
servletContext - the servlet context of the web application
 (can be null; necessary for fallback to root WebApplicationContext)
See Also:
WebApplicationContext, 
DispatcherServlet




RequestContext
public RequestContext(HttpServletRequest request,
                      Map model)

Create a new RequestContext for the given request,
 using the given model attributes for Errors retrieval.
 This works with all View implementations.
 It will typically be used by View implementations.
 
Will only work within a DispatcherServlet request. Pass in a
 ServletContext to be able to fallback to the root WebApplicationContext.


Parameters:
request - current HTTP request
model - the model attributes for the current view
 (can be null, using the request attributes for Errors retrieval)
See Also:
DispatcherServlet, 
RequestContext(javax.servlet.http.HttpServletRequest, javax.servlet.ServletContext, Map)




RequestContext
public RequestContext(HttpServletRequest request,
                      ServletContext servletContext,
                      Map model)

Create a new RequestContext for the given request,
 using the given model attributes for Errors retrieval.
 This works with all View implementations.
 It will typically be used by View implementations.
 
If a ServletContext is specified, the RequestContext will also
 work with a root WebApplicationContext (outside a DispatcherServlet).


Parameters:
request - current HTTP request
servletContext - the servlet context of the web application
 (can be null; necessary for fallback to root WebApplicationContext)
model - the model attributes for the current view
 (can be null, using the request attributes for Errors retrieval)
See Also:
WebApplicationContext, 
DispatcherServlet




RequestContext
protected RequestContext()

Default constructor for subclasses.









Method Detail




initContext
protected void initContext(HttpServletRequest request,
                           ServletContext servletContext,
                           Map model)

Initialize this context with the given request,
 using the given model attributes for Errors retrieval.
 Delegates to getFallbackLocale and getFallbackTheme
 for determining the fallback locale and theme, respectively, if no LocaleResolver
 and/or ThemeResolver can be found in the request.


Parameters:
request - current HTTP request
servletContext - the servlet context of the web application
 (can be null; necessary for fallback to root WebApplicationContext)
model - the model attributes for the current view
 (can be null, using the request attributes for Errors retrieval)
See Also:
getFallbackLocale(), 
getFallbackTheme(), 
DispatcherServlet.LOCALE_RESOLVER_ATTRIBUTE, 
DispatcherServlet.THEME_RESOLVER_ATTRIBUTE





getFallbackLocale
protected Locale getFallbackLocale()

Determine the fallback locale for this context.
 Default implementation checks for a JSTL locale attribute
 in request, session or application scope; if not found,
 returns the HttpServletRequest.getLocale().



Returns:
the fallback locale (never null)
See Also:
ServletRequest.getLocale()





getFallbackTheme
protected Theme getFallbackTheme()

Determine the fallback theme for this context.
 Default implementation returns the default theme (with name "theme").



Returns:
the fallback theme, or null






getRequest
protected final HttpServletRequest getRequest()

Return the underlying HttpServletRequest.
 Only intended for cooperating classes in this package.








getWebApplicationContext
public final WebApplicationContext getWebApplicationContext()

Return the current WebApplicationContext.








getServletContext
protected final ServletContext getServletContext()

Return the underlying ServletContext.
 Only intended for cooperating classes in this package.








getLocale
public final Locale getLocale()

Return the current locale.








getTheme
public final Theme getTheme()

Return the current theme.








setDefaultHtmlEscape
public void setDefaultHtmlEscape(boolean defaultHtmlEscape)

(De)activate default HTML escaping for messages and errors, for the scope
 of this RequestContext. The default is the application-wide setting
 (the "defaultHtmlEscape" context-param in web.xml).


See Also:
WebUtils.isDefaultHtmlEscape(javax.servlet.ServletContext)





isDefaultHtmlEscape
public boolean isDefaultHtmlEscape()

Is default HTML escaping active?








setUrlPathHelper
public void setUrlPathHelper(UrlPathHelper urlPathHelper)

Set the UrlPathHelper to use for context path and request URI decoding.
 Can be used to pass a shared UrlPathHelper instance in.
 A default UrlPathHelper is always available.








getUrlPathHelper
public UrlPathHelper getUrlPathHelper()

Return the UrlPathHelper used for context path and request URI decoding.
 Can be used to configure the current UrlPathHelper.
 A default UrlPathHelper is always available.








getContextPath
public String getContextPath()

Return the context path of the original request,
 that is, the path that indicates the current web application.
 This is useful for building links to other resources within the application.
 Delegates to the UrlPathHelper for decoding.


See Also:
HttpServletRequest.getContextPath(), 
getUrlPathHelper()





getRequestUri
public String getRequestUri()

Return the request URI of the original request, that is, the invoked URL
 without parameters. This is particularly useful as HTML form action target,
 possibly in combination with the original query string.
 Note this implementation will correctly resolve to the URI of any
 originating root request in the presence of a forwarded request. However, this
 can only work when the Servlet 2.4 'forward' request attributes are present.
 For use in a Servlet 2.3- environment, you can rely on
 InternalResourceView
 to add these prior to dispatching the request.
 
Delegates to the UrlPathHelper for decoding.


See Also:
getQueryString(), 
UrlPathHelper.getOriginatingRequestUri(javax.servlet.http.HttpServletRequest), 
getUrlPathHelper()





getQueryString
public String getQueryString()

Return the query string of the current request, that is, the part after
 the request path. This is particularly useful for building an HTML form
 action target in combination with the original request URI.
 Note this implementation will correctly resolve to the query string of any
 originating root request in the presence of a forwarded request. However, this
 can only work when the Servlet 2.4 'forward' request attributes are present.
 For use in a Servlet 2.3- environment, you can rely on
 InternalResourceView
 to add these prior to dispatching the request.
 
Delegates to the UrlPathHelper for decoding.


See Also:
getRequestUri(), 
UrlPathHelper.getOriginatingQueryString(javax.servlet.http.HttpServletRequest), 
getUrlPathHelper()





getMessage
public String getMessage(String code,
                         String defaultMessage)

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
defaultMessage - String to return if the lookup fails
Returns:
the message





getMessage
public String getMessage(String code,
                         Object[] args,
                         String defaultMessage)

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
args - arguments for the message, or null if none
defaultMessage - String to return if the lookup fails
Returns:
the message





getMessage
public String getMessage(String code,
                         List args,
                         String defaultMessage)

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
args - arguments for the message as a List, or null if none
defaultMessage - String to return if the lookup fails
Returns:
the message





getMessage
public String getMessage(String code,
                         Object[] args,
                         String defaultMessage,
                         boolean htmlEscape)

Retrieve the message for the given code.


Parameters:
code - code of the message
args - arguments for the message, or null if none
defaultMessage - String to return if the lookup fails
htmlEscape - HTML escape the message?
Returns:
the message





getMessage
public String getMessage(String code)
                  throws NoSuchMessageException

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
Returns:
the message
Throws:
NoSuchMessageException - if not found





getMessage
public String getMessage(String code,
                         Object[] args)
                  throws NoSuchMessageException

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
args - arguments for the message, or null if none
Returns:
the message
Throws:
NoSuchMessageException - if not found





getMessage
public String getMessage(String code,
                         List args)
                  throws NoSuchMessageException

Retrieve the message for the given code, using the "defaultHtmlEscape" setting.


Parameters:
code - code of the message
args - arguments for the message as a List, or null if none
Returns:
the message
Throws:
NoSuchMessageException - if not found





getMessage
public String getMessage(String code,
                         Object[] args,
                         boolean htmlEscape)
                  throws NoSuchMessageException

Retrieve the message for the given code.


Parameters:
code - code of the message
args - arguments for the message, or null if none
htmlEscape - HTML escape the message?
Returns:
the message
Throws:
NoSuchMessageException - if not found





getMessage
public String getMessage(MessageSourceResolvable resolvable)
                  throws NoSuchMessageException

Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance),
 using the "defaultHtmlEscape" setting.


Parameters:
resolvable - the MessageSourceResolvable
Returns:
the message
Throws:
NoSuchMessageException - if not found





getMessage
public String getMessage(MessageSourceResolvable resolvable,
                         boolean htmlEscape)
                  throws NoSuchMessageException

Retrieve the given MessageSourceResolvable (e.g. an ObjectError instance).


Parameters:
resolvable - the MessageSourceResolvable
htmlEscape - HTML escape the message?
Returns:
the message
Throws:
NoSuchMessageException - if not found





getThemeMessage
public String getThemeMessage(String code,
                              String defaultMessage)

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
defaultMessage - String to return if the lookup fails
Returns:
the message





getThemeMessage
public String getThemeMessage(String code,
                              Object[] args,
                              String defaultMessage)

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
args - arguments for the message, or null if none
defaultMessage - String to return if the lookup fails
Returns:
the message





getThemeMessage
public String getThemeMessage(String code,
                              List args,
                              String defaultMessage)

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
args - arguments for the message as a List, or null if none
defaultMessage - String to return if the lookup fails
Returns:
the message





getThemeMessage
public String getThemeMessage(String code)
                       throws NoSuchMessageException

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
Returns:
the message
Throws:
NoSuchMessageException - if not found





getThemeMessage
public String getThemeMessage(String code,
                              Object[] args)
                       throws NoSuchMessageException

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
args - arguments for the message, or null if none
Returns:
the message
Throws:
NoSuchMessageException - if not found





getThemeMessage
public String getThemeMessage(String code,
                              List args)
                       throws NoSuchMessageException

Retrieve the theme message for the given code.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
code - code of the message
args - arguments for the message as a List, or null if none
Returns:
the message
Throws:
NoSuchMessageException - if not found





getThemeMessage
public String getThemeMessage(MessageSourceResolvable resolvable)
                       throws NoSuchMessageException

Retrieve the given MessageSourceResolvable in the current theme.
 Note that theme messages are never HTML-escaped, as they typically
 denote theme-specific resource paths and not client-visible messages.


Parameters:
resolvable - the MessageSourceResolvable
Returns:
the message
Throws:
NoSuchMessageException - if not found





getErrors
public Errors getErrors(String name)

Retrieve the Errors instance for the given bind object,
 using the "defaultHtmlEscape" setting.


Parameters:
name - name of the bind object
Returns:
the Errors instance, or null if not found





getErrors
public Errors getErrors(String name,
                        boolean htmlEscape)

Retrieve the Errors instance for the given bind object.


Parameters:
name - name of the bind object
htmlEscape - create an Errors instance with automatic HTML escaping?
Returns:
the Errors instance, or null if not found





getModelObject
protected Object getModelObject(String modelName)

Retrieve the model object for the given model name,
 either from the model or from the request attributes.


Parameters:
modelName - the name of the model object
Returns:
the model object





getBindStatus
public BindStatus getBindStatus(String path)
                         throws IllegalStateException

Create a BindStatus for the given bind object,
 using the "defaultHtmlEscape" setting.


Parameters:
path - the bean and property path for which values and errors
 will be resolved (e.g. "person.age")
Returns:
the new BindStatus instance
Throws:
IllegalStateException - if no corresponding Errors object found





getBindStatus
public BindStatus getBindStatus(String path,
                                boolean htmlEscape)
                         throws IllegalStateException

Create a BindStatus for the given bind object,
 using the "defaultHtmlEscape" setting.


Parameters:
path - the bean and property path for which values and errors
 will be resolved (e.g. "person.age")
htmlEscape - create a BindStatus with automatic HTML escaping?
Returns:
the new BindStatus instance
Throws:
IllegalStateException - if no corresponding Errors object found














  
      Overview 
      Package 
    Class 
      Use 
      Tree 
      Deprecated 
      Index 
      Help 
  



The Spring Framework





 PREV CLASS 
 NEXT CLASS

  FRAMES   
 NO FRAMES   
 







  SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD






Copyright © 2002-2007 The Spring Framework.


 
 

 

首页 | 
全站 Sitemap | 
联系我们 | 
设为首页 | 
收藏本站 

版权所有 Copyright © 2006-2007, Java 编程资料牛鼻站, All rights reserved

RequestContext (Spring Framework API 2.1) - Spring Framework 2.1.0 API 文档英文版

org.springframework.web.servlet.support Class RequestContext

DEFAULT_THEME_NAME

JSTL_LOCALE_ATTRIBUTE

REQUEST_SCOPE_SUFFIX

SESSION_SCOPE_SUFFIX

APPLICATION_SCOPE_SUFFIX

RequestContext

RequestContext

RequestContext

RequestContext

RequestContext

initContext

getFallbackLocale

getFallbackTheme

getRequest

getWebApplicationContext

getServletContext

getLocale

getTheme

setDefaultHtmlEscape

isDefaultHtmlEscape

setUrlPathHelper

getUrlPathHelper

getContextPath

getRequestUri

getQueryString

getMessage

getMessage

getMessage

getMessage

getMessage

getMessage

getMessage

getMessage

getMessage

getMessage

getThemeMessage

getThemeMessage

getThemeMessage

getThemeMessage

getThemeMessage

getThemeMessage

getThemeMessage

getErrors

getErrors

getModelObject

getBindStatus

getBindStatus

org.springframework.web.servlet.support
Class RequestContext