Class XsltView
- All Implemented Interfaces:
Aware
,BeanNameAware
,InitializingBean
,ApplicationContextAware
,ServletContextAware
,View
The XSLT Source object is supplied as a parameter in the model and then
detected
during response rendering. Users can either specify
a specific entry in the model via the sourceKey
property or
have Spring locate the Source object. This class also provides basic conversion
of objects into Source implementations. See here
for more details.
All model parameters are passed to the XSLT Transformer as parameters.
In addition the user can configure output properties
to be passed to the Transformer.
- Since:
- 2.0
- Author:
- Rob Harrop, Juergen Hoeller
-
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
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionprotected final void
configureIndentation
(Transformer transformer) Configure the indentation settings for the suppliedTransformer
.protected void
configureResponse
(Map<String, Object> model, HttpServletResponse response, Transformer transformer) Configure the suppliedHttpServletResponse
.protected void
configureTransformer
(Map<String, Object> model, HttpServletResponse response, Transformer transformer) Configure the suppliedTransformer
instance.protected Source
convertSource
(Object sourceObject) protected final void
copyModelParameters
(Map<String, Object> model, Transformer transformer) Copy all entries from the supplied Map into theparameter set
of the suppliedTransformer
.protected final void
copyOutputProperties
(Transformer transformer) Copy the configured outputProperties
, if any, into theoutput property set
of the suppliedTransformer
.protected Result
createResult
(HttpServletResponse response) Create the XSLTResult
used to render the result of the transformation.protected Transformer
createTransformer
(Templates templates) Create theTransformer
instance used to prefer the XSLT transformation.protected Class<?>[]
protected Source
Get the XSLTSource
for the XSLT template under theconfigured URL
.protected final TransformerFactory
Return the TransformerFactory that this XsltView uses.protected void
Initialize this XsltView's TransformerFactory.protected Source
locateSource
(Map<String, Object> model) Locate theSource
object in the supplied model, converting objects as required.protected TransformerFactory
newTransformerFactory
(Class<? extends TransformerFactory> transformerFactoryClass) Instantiate a new TransformerFactory for this view.protected void
renderMergedOutputModel
(Map<String, Object> model, HttpServletRequest request, HttpServletResponse response) Subclasses must implement this method to actually render the view.void
setCacheTemplates
(boolean cacheTemplates) Turn on/off the caching of the XSLTTemplates
instance.void
setErrorListener
(ErrorListener errorListener) Set an implementation of theErrorListener
interface for custom handling of transformation errors and warnings.void
setIndent
(boolean indent) Set whether the XSLT transformer may add additional whitespace when outputting the result tree.void
setOutputProperties
(Properties outputProperties) Set arbitrary transformer output properties to be applied to the stylesheet.void
setSourceKey
(String sourceKey) Set the name of the model attribute that represents the XSLT Source.void
setTransformerFactoryClass
(Class<? extends TransformerFactory> transformerFactoryClass) Specify the XSLT TransformerFactory class to use.void
setUriResolver
(URIResolver uriResolver) Set the URIResolver used in the transform.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, formatViewName, 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, initServletContext, isContextRequired, setServletContext
Methods inherited from class org.springframework.context.support.ApplicationObjectSupport
getApplicationContext, getMessageSourceAccessor, obtainApplicationContext, requiredContextClass, setApplicationContext
-
Constructor Details
-
XsltView
public XsltView()
-
-
Method Details
-
setTransformerFactoryClass
Specify the XSLT TransformerFactory class to use.The default constructor of the specified class will be called to build the TransformerFactory for this view.
-
setSourceKey
-
setUriResolver
Set the URIResolver used in the transform.The URIResolver handles calls to the XSLT
document()
function. -
setErrorListener
Set an implementation of theErrorListener
interface for custom handling of transformation errors and warnings.If not set, a default
SimpleTransformErrorListener
is used that simply logs warnings using the logger instance of the view class, and rethrows errors to discontinue the XML transformation.- See Also:
-
setIndent
public void setIndent(boolean indent) Set whether the XSLT transformer may add additional whitespace when outputting the result tree.Default is
true
(on); set this tofalse
(off) to not specify an "indent" key, leaving the choice up to the stylesheet.- See Also:
-
setOutputProperties
Set arbitrary transformer output properties to be applied to the stylesheet.Any values specified here will override defaults that this view sets programmatically.
-
setCacheTemplates
public void setCacheTemplates(boolean cacheTemplates) Turn on/off the caching of the XSLTTemplates
instance.The default value is "true". Only set this to "false" in development, where caching does not seriously impact performance.
-
initApplicationContext
Initialize this XsltView's TransformerFactory.- Overrides:
initApplicationContext
in classApplicationObjectSupport
- Throws:
ApplicationContextException
- in case of initialization errorsBeansException
- if thrown by ApplicationContext methods- See Also:
-
newTransformerFactory
protected TransformerFactory newTransformerFactory(@Nullable Class<? extends TransformerFactory> transformerFactoryClass) Instantiate a new TransformerFactory for this view.The default implementation simply calls
TransformerFactory.newInstance()
. If a"transformerFactoryClass"
has been specified explicitly, the default constructor of the specified class will be called instead.Can be overridden in subclasses.
- Parameters:
transformerFactoryClass
- the specified factory class (if any)- Returns:
- the new TransactionFactory instance
- See Also:
-
getTransformerFactory
Return the TransformerFactory that this XsltView uses.- Returns:
- the TransformerFactory (never
null
)
-
renderMergedOutputModel
protected void renderMergedOutputModel(Map<String, Object> model, HttpServletRequest request, HttpServletResponse response) throws ExceptionDescription copied from class:AbstractView
Subclasses must implement this method to actually render the view.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.
- Specified by:
renderMergedOutputModel
in classAbstractView
- Parameters:
model
- combined output Map (nevernull
), with dynamic values taking precedence over static attributesrequest
- current HTTP requestresponse
- current HTTP response- Throws:
Exception
- if rendering failed
-
createResult
Create the XSLTResult
used to render the result of the transformation.The default implementation creates a
StreamResult
wrapping the supplied HttpServletResponse'sOutputStream
.- Parameters:
response
- current HTTP response- Returns:
- the XSLT Result to use
- Throws:
Exception
- if the Result cannot be built
-
locateSource
Locate the
Source
object in the supplied model, converting objects as required. The default implementation first attempts to look under the configuredsource key
, if any, before attempting to locate an object ofsupported type
.- Parameters:
model
- the merged model Map- Returns:
- the XSLT Source object (or
null
if none found) - Throws:
Exception
- if an error occurred during locating the source- See Also:
-
getSourceTypes
Return the array ofClasses
that are supported when converting to an XSLTSource
.Currently supports
Source
,Document
,Node
,Reader
,InputStream
andResource
.- Returns:
- the supported source types
-
convertSource
- Parameters:
sourceObject
- the original source object- Returns:
- the adapted XSLT Source
- Throws:
IllegalArgumentException
- if the given Object is not of a supported typeException
-
configureTransformer
protected void configureTransformer(Map<String, Object> model, HttpServletResponse response, Transformer transformer) Configure the suppliedTransformer
instance.The default implementation copies parameters from the model into the Transformer's
parameter set
. This implementation also copies theoutput properties
into theTransformer
output properties
. Indentation properties are set as well.- Parameters:
model
- merged output Map (nevernull
)response
- current HTTP responsetransformer
- the target transformer- See Also:
-
configureIndentation
Configure the indentation settings for the suppliedTransformer
.- Parameters:
transformer
- the target transformer- See Also:
-
copyOutputProperties
Copy the configured outputProperties
, if any, into theoutput property set
of the suppliedTransformer
.- Parameters:
transformer
- the target transformer
-
copyModelParameters
Copy all entries from the supplied Map into theparameter set
of the suppliedTransformer
.- Parameters:
model
- merged output Map (nevernull
)transformer
- the target transformer
-
configureResponse
protected void configureResponse(Map<String, Object> model, HttpServletResponse response, Transformer transformer) Configure the suppliedHttpServletResponse
.The default implementation of this method sets the
content type
andencoding
from the "media-type" and "encoding" output properties specified in theTransformer
.- Parameters:
model
- merged output Map (nevernull
)response
- current HTTP responsetransformer
- the target transformer
-
createTransformer
protected Transformer createTransformer(Templates templates) throws TransformerConfigurationException Create theTransformer
instance used to prefer the XSLT transformation.The default implementation simply calls
Templates.newTransformer()
, and configures theTransformer
with the customURIResolver
if specified.- Parameters:
templates
- the XSLT Templates instance to create a Transformer for- Returns:
- the Transformer object
- Throws:
TransformerConfigurationException
- in case of creation failure
-
getStylesheetSource
Get the XSLTSource
for the XSLT template under theconfigured URL
.- Returns:
- the Source object
-