public abstract class AbstractTemplateView extends AbstractUrlBasedView
JSP/JSTL and other view technologies automatically have access to the HttpServletRequest object and thereby the request/session attributes for the current user. Furthermore, they are able to create and cache helper objects as request attributes themselves.
AbstractTemplateViewResolver
,
VelocityView
,
FreeMarkerView
Modifier and Type | Field and Description |
---|---|
private boolean |
allowRequestOverride |
private boolean |
allowSessionOverride |
private boolean |
exposeRequestAttributes |
private boolean |
exposeSessionAttributes |
private boolean |
exposeSpringMacroHelpers |
static java.lang.String |
SPRING_MACRO_REQUEST_CONTEXT_ATTRIBUTE
Variable name of the RequestContext instance in the template model,
available to Spring's macros: e.g.
|
DEFAULT_CONTENT_TYPE
logger
PATH_VARIABLES, RESPONSE_STATUS_ATTRIBUTE, SELECTED_CONTENT_TYPE
Constructor and Description |
---|
AbstractTemplateView() |
Modifier and Type | Method and Description |
---|---|
protected void |
applyContentType(HttpServletResponse response)
Apply this view's content type as specified in the "contentType"
bean property to the given response.
|
protected void |
renderMergedOutputModel(java.util.Map<java.lang.String,java.lang.Object> model,
HttpServletRequest request,
HttpServletResponse response)
Subclasses must implement this method to actually render the view.
|
protected abstract void |
renderMergedTemplateModel(java.util.Map<java.lang.String,java.lang.Object> model,
HttpServletRequest request,
HttpServletResponse response)
Subclasses must implement this method to actually render the view.
|
void |
setAllowRequestOverride(boolean allowRequestOverride)
Set whether HttpServletRequest attributes are allowed to override (hide)
controller generated model attributes of the same name.
|
void |
setAllowSessionOverride(boolean allowSessionOverride)
Set whether HttpSession attributes are allowed to override (hide)
controller generated model attributes of the same name.
|
void |
setExposeRequestAttributes(boolean exposeRequestAttributes)
Set whether all request attributes should be added to the
model prior to merging with the template.
|
void |
setExposeSessionAttributes(boolean exposeSessionAttributes)
Set whether all HttpSession attributes should be added to the
model prior to merging with the template.
|
void |
setExposeSpringMacroHelpers(boolean exposeSpringMacroHelpers)
Set whether to expose a RequestContext for use by Spring's macro library,
under the name "springMacroRequestContext".
|
afterPropertiesSet, checkResource, getUrl, isUrlRequired, setUrl, toString
addStaticAttribute, createMergedOutputModel, createRequestContext, createTemporaryOutputStream, exposeModelAsRequestAttributes, generatesDownloadContent, getAttributesMap, getBeanName, getContentType, getRequestContextAttribute, getStaticAttributes, isExposePathVariables, prepareResponse, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setExposePathVariables, setRequestContextAttribute, setResponseContentType, writeToResponse
getServletContext, getTempDir, getWebApplicationContext, initApplicationContext, initServletContext, isContextRequired, setServletContext
getApplicationContext, getMessageSourceAccessor, initApplicationContext, requiredContextClass, setApplicationContext
public static final java.lang.String SPRING_MACRO_REQUEST_CONTEXT_ATTRIBUTE
private boolean exposeRequestAttributes
private boolean allowRequestOverride
private boolean exposeSessionAttributes
private boolean allowSessionOverride
private boolean exposeSpringMacroHelpers
public void setExposeRequestAttributes(boolean exposeRequestAttributes)
public void setAllowRequestOverride(boolean allowRequestOverride)
public void setExposeSessionAttributes(boolean exposeSessionAttributes)
public void setAllowSessionOverride(boolean allowSessionOverride)
public void setExposeSpringMacroHelpers(boolean exposeSpringMacroHelpers)
Currently needed for Spring's Velocity and FreeMarker default macros. Note that this is not required for templates that use HTML forms unless you wish to take advantage of the Spring helper macros.
protected final void renderMergedOutputModel(java.util.Map<java.lang.String,java.lang.Object> model, HttpServletRequest request, HttpServletResponse response) throws java.lang.Exception
AbstractView
The first step will be preparing the request: In the JSP case, this would mean setting model objects as request attributes. The second step will be the actual rendering of the view, for example including the JSP via a RequestDispatcher.
renderMergedOutputModel
in class AbstractView
model
- combined output Map (never null
),
with dynamic values taking precedence over static attributesrequest
- current HTTP requestresponse
- current HTTP responsejava.lang.Exception
- if rendering failedprotected void applyContentType(HttpServletResponse response)
When running on Servlet 2.4, only applies the view's contentType if no content type has been set on the response before. This allows handlers to override the default content type beforehand.
response
- current HTTP responseAbstractView.setContentType(java.lang.String)
protected abstract void renderMergedTemplateModel(java.util.Map<java.lang.String,java.lang.Object> model, HttpServletRequest request, HttpServletResponse response) throws java.lang.Exception
model
- combined output Map, with request attributes and
session attributes merged into it if requiredrequest
- current HTTP requestresponse
- current HTTP responsejava.lang.Exception
- if rendering failed