Class JstlView
- All Implemented Interfaces:
Aware
,BeanNameAware
,InitializingBean
,ApplicationContextAware
,ServletContextAware
,View
public class JstlView extends InternalResourceView
Specialization ofInternalResourceView
for JSTL pages, i.e. JSP pages that use the JSP Standard Tag Library.Exposes JSTL-specific request attributes specifying locale and resource bundle for JSTL's formatting and message tags, using Spring's locale and
MessageSource
.Typical usage with
InternalResourceViewResolver
would look as follows, from the perspective of the DispatcherServlet context definition:<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> <property name="prefix" value="/WEB-INF/jsp/"/> <property name="suffix" value=".jsp"/> </bean> <bean id="messageSource" class="org.springframework.context.support.ResourceBundleMessageSource"> <property name="basename" value="messages"/> </bean>
Every view name returned from a handler will be translated to a JSP resource (for example: "myView" -> "/WEB-INF/jsp/myView.jsp"), using this view class to enable explicit JSTL support.The specified MessageSource loads messages from "messages.properties" etc files in the class path. This will automatically be exposed to views as JSTL localization context, which the JSTL fmt tags (message etc) will use. Consider using Spring's ReloadableResourceBundleMessageSource instead of the standard ResourceBundleMessageSource for more sophistication. Of course, any other Spring components can share the same MessageSource.
This is a separate class mainly to avoid JSTL dependencies in
InternalResourceView
itself. JSTL has not been part of standard J2EE up until J2EE 1.4, so we can't assume the JSTL API jar to be available on the class path.Hint: Set the
AbstractView.setExposeContextBeansAsAttributes(boolean)
flag to "true" in order to make all Spring beans in the application context accessible within JSTL expressions (e.g. in ac:out
value expression). This will also make all such beans accessible in plain${...}
expressions in a JSP 2.0 page.- Since:
- 27.02.2003
- Author:
- Juergen Hoeller
- See Also:
JstlUtils.exposeLocalizationContext(javax.servlet.http.HttpServletRequest, org.springframework.context.MessageSource)
,InternalResourceViewResolver
,ResourceBundleMessageSource
,ReloadableResourceBundleMessageSource
Field Summary
Fields inherited from class org.springframework.web.servlet.view.AbstractView
DEFAULT_CONTENT_TYPE
Fields inherited from class org.springframework.context.support.ApplicationObjectSupport
logger
Fields inherited from interface org.springframework.web.servlet.View
PATH_VARIABLES, RESPONSE_STATUS_ATTRIBUTE, SELECTED_CONTENT_TYPE
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected void
exposeHelpers(HttpServletRequest request)
Exposes a JSTL LocalizationContext for Spring's locale and MessageSource.protected void
initServletContext(ServletContext servletContext)
Wraps the MessageSource with a JSTL-aware MessageSource that is aware of JSTL'sjavax.servlet.jsp.jstl.fmt.localizationContext
context-param.Methods inherited from class org.springframework.web.servlet.view.InternalResourceView
getRequestDispatcher, isContextRequired, prepareForRendering, renderMergedOutputModel, setAlwaysInclude, setPreventDispatchLoop, useInclude
Methods inherited from class org.springframework.web.servlet.view.AbstractUrlBasedView
afterPropertiesSet, checkResource, getUrl, isUrlRequired, setUrl, toString
Methods inherited from class org.springframework.web.servlet.view.AbstractView
addStaticAttribute, createMergedOutputModel, createRequestContext, createTemporaryOutputStream, exposeModelAsRequestAttributes, generatesDownloadContent, getAttributesMap, getBeanName, getContentType, getRequestContextAttribute, getRequestToExpose, getStaticAttributes, isExposePathVariables, prepareResponse, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setExposeContextBeansAsAttributes, setExposedContextBeanNames, setExposePathVariables, setRequestContextAttribute, setResponseContentType, writeToResponse
Methods inherited from class org.springframework.web.context.support.WebApplicationObjectSupport
getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, setServletContext
Methods inherited from class org.springframework.context.support.ApplicationObjectSupport
getApplicationContext, getMessageSourceAccessor, initApplicationContext, requiredContextClass, setApplicationContext
Constructor Detail
JstlView
public JstlView()
Constructor for use as a bean.
JstlView
public JstlView(String url)
Create a new JstlView with the given URL.- Parameters:
url
- the URL to forward to
JstlView
public JstlView(String url, MessageSource messageSource)
Create a new JstlView with the given URL.- Parameters:
url
- the URL to forward tomessageSource
- the MessageSource to expose to JSTL tags (will be wrapped with a JSTL-aware MessageSource that is aware of JSTL'sjavax.servlet.jsp.jstl.fmt.localizationContext
context-param)- See Also:
JstlUtils.getJstlAwareMessageSource(javax.servlet.ServletContext, org.springframework.context.MessageSource)
Method Detail
initServletContext
protected void initServletContext(ServletContext servletContext)
Wraps the MessageSource with a JSTL-aware MessageSource that is aware of JSTL'sjavax.servlet.jsp.jstl.fmt.localizationContext
context-param.- Overrides:
initServletContext
in classWebApplicationObjectSupport
- Parameters:
servletContext
- the ServletContext that this application object runs in (nevernull
)- See Also:
JstlUtils.getJstlAwareMessageSource(javax.servlet.ServletContext, org.springframework.context.MessageSource)
exposeHelpers
protected void exposeHelpers(HttpServletRequest request) throws Exception
Exposes a JSTL LocalizationContext for Spring's locale and MessageSource.- Overrides:
exposeHelpers
in classInternalResourceView
- Parameters:
request
- current HTTP request- Throws:
Exception
- if there's a fatal error while we're adding attributes- See Also:
JstlUtils.exposeLocalizationContext(javax.servlet.http.HttpServletRequest, org.springframework.context.MessageSource)