|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectorg.springframework.context.support.ApplicationObjectSupport
org.springframework.web.context.support.WebApplicationObjectSupport
org.springframework.web.servlet.view.AbstractView
org.springframework.web.servlet.view.AbstractUrlBasedView
org.springframework.web.servlet.view.xslt.XsltView
public class XsltView
XSLT-driven View that allows for response context to be rendered as the result of an XSLT transformation.
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.
Field Summary | |
---|---|
private javax.xml.transform.Templates |
cachedTemplates
|
private boolean |
cacheTemplates
|
private javax.xml.transform.ErrorListener |
errorListener
|
private boolean |
indent
|
private java.util.Properties |
outputProperties
|
private java.lang.String |
sourceKey
|
private javax.xml.transform.TransformerFactory |
transformerFactory
|
private java.lang.Class |
transformerFactoryClass
|
private javax.xml.transform.URIResolver |
uriResolver
|
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 |
Constructor Summary | |
---|---|
XsltView()
|
Method Summary | |
---|---|
private void |
closeSourceIfNecessary(javax.xml.transform.Source source)
Close the underlying resource managed by the supplied Source if applicable. |
protected void |
configureIndentation(javax.xml.transform.Transformer transformer)
Configure the indentation settings for the supplied Transformer . |
protected void |
configureResponse(java.util.Map<java.lang.String,java.lang.Object> model,
HttpServletResponse response,
javax.xml.transform.Transformer transformer)
Configure the supplied HttpServletResponse . |
protected void |
configureTransformer(java.util.Map<java.lang.String,java.lang.Object> model,
HttpServletResponse response,
javax.xml.transform.Transformer transformer)
Configure the supplied Transformer instance. |
protected javax.xml.transform.Source |
convertSource(java.lang.Object source)
Convert the supplied Object into an XSLT Source if the
Object type is supported . |
protected void |
copyModelParameters(java.util.Map<java.lang.String,java.lang.Object> model,
javax.xml.transform.Transformer transformer)
Copy all entries from the supplied Map into the parameter set
of the supplied Transformer . |
protected void |
copyOutputProperties(javax.xml.transform.Transformer transformer)
Copy the configured output Properties , if any, into the
output property set of the supplied
Transformer . |
protected javax.xml.transform.Result |
createResult(HttpServletResponse response)
Create the XSLT Result used to render the result of the transformation. |
protected javax.xml.transform.Transformer |
createTransformer(javax.xml.transform.Templates templates)
Create the Transformer instance used to prefer the XSLT transformation. |
protected java.lang.Class[] |
getSourceTypes()
Return the array of Classes that are supported when converting to an
XSLT Source . |
protected javax.xml.transform.Source |
getStylesheetSource()
Get the XSLT Source for the XSLT template under the configured URL . |
protected javax.xml.transform.TransformerFactory |
getTransformerFactory()
Return the TransformerFactory that this XsltView uses. |
protected void |
initApplicationContext()
Initialize this XsltView's TransformerFactory. |
private javax.xml.transform.Templates |
loadTemplates()
Load the Templates instance for the stylesheet at the configured location. |
protected javax.xml.transform.Source |
locateSource(java.util.Map<java.lang.String,java.lang.Object> model)
Locate the Source object in the supplied model,
converting objects as required. |
protected javax.xml.transform.TransformerFactory |
newTransformerFactory(java.lang.Class transformerFactoryClass)
Instantiate a new TransformerFactory for this view. |
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. |
void |
setCacheTemplates(boolean cacheTemplates)
Turn on/off the caching of the XSLT Templates instance. |
void |
setErrorListener(javax.xml.transform.ErrorListener errorListener)
Set an implementation of the ErrorListener
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(java.util.Properties outputProperties)
Set arbitrary transformer output properties to be applied to the stylesheet. |
void |
setSourceKey(java.lang.String sourceKey)
Set the name of the model attribute that represents the XSLT Source. |
void |
setTransformerFactoryClass(java.lang.Class transformerFactoryClass)
Specify the XSLT TransformerFactory class to use. |
void |
setUriResolver(javax.xml.transform.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, generatesDownloadContent, getAttributesMap, getBeanName, getContentType, getRequestContextAttribute, getStaticAttributes, isExposePathVariables, prepareResponse, render, setAttributes, setAttributesCSV, setAttributesMap, setBeanName, setContentType, setExposePathVariables, setRequestContextAttribute, 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, requiredContextClass, setApplicationContext |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
private java.lang.Class transformerFactoryClass
private java.lang.String sourceKey
private javax.xml.transform.URIResolver uriResolver
private javax.xml.transform.ErrorListener errorListener
private boolean indent
private java.util.Properties outputProperties
private boolean cacheTemplates
private javax.xml.transform.TransformerFactory transformerFactory
private javax.xml.transform.Templates cachedTemplates
Constructor Detail |
---|
public XsltView()
Method Detail |
---|
public void setTransformerFactoryClass(java.lang.Class transformerFactoryClass)
The default constructor of the specified class will be called to build the TransformerFactory for this view.
public void setSourceKey(java.lang.String sourceKey)
The following source types are supported out of the box:
Source
, Document
, Node
, Reader
,
InputStream
and Resource
.
getSourceTypes()
,
convertSource(java.lang.Object)
public void setUriResolver(javax.xml.transform.URIResolver uriResolver)
The URIResolver handles calls to the XSLT document()
function.
public void setErrorListener(javax.xml.transform.ErrorListener errorListener)
ErrorListener
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.
SimpleTransformErrorListener
public void setIndent(boolean indent)
Default is true
(on); set this to false
(off)
to not specify an "indent" key, leaving the choice up to the stylesheet.
OutputKeys.INDENT
public void setOutputProperties(java.util.Properties outputProperties)
Any values specified here will override defaults that this view sets programmatically.
Transformer.setOutputProperty(java.lang.String, java.lang.String)
public void setCacheTemplates(boolean cacheTemplates)
Templates
instance.
The default value is "true". Only set this to "false" in development, where caching does not seriously impact performance.
protected void initApplicationContext() throws BeansException
initApplicationContext
in class ApplicationObjectSupport
ApplicationContextException
- in case of initialization errors
BeansException
- if thrown by ApplicationContext methodsApplicationObjectSupport.setApplicationContext(org.springframework.context.ApplicationContext)
protected javax.xml.transform.TransformerFactory newTransformerFactory(java.lang.Class transformerFactoryClass)
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.
transformerFactoryClass
- the specified factory class (if any)
setTransformerFactoryClass(java.lang.Class)
,
getTransformerFactory()
protected final javax.xml.transform.TransformerFactory getTransformerFactory()
null
)protected 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 response
java.lang.Exception
- if rendering failedprotected javax.xml.transform.Result createResult(HttpServletResponse response) throws java.lang.Exception
Result
used to render the result of the transformation.
The default implementation creates a StreamResult
wrapping the supplied
HttpServletResponse's OutputStream
.
response
- current HTTP response
java.lang.Exception
- if the Result cannot be builtprotected javax.xml.transform.Source locateSource(java.util.Map<java.lang.String,java.lang.Object> model) throws java.lang.Exception
Locate the Source
object in the supplied model,
converting objects as required.
The default implementation first attempts to look under the configured
source key
, if any, before attempting to locate
an object of supported type
.
model
- the merged model Map
null
if none found)
java.lang.Exception
- if an error occured during locating the sourcesetSourceKey(java.lang.String)
,
convertSource(java.lang.Object)
protected java.lang.Class[] getSourceTypes()
Classes
that are supported when converting to an
XSLT Source
.
Currently supports Source
, Document
, Node
,
Reader
, InputStream
and Resource
.
protected javax.xml.transform.Source convertSource(java.lang.Object source) throws java.lang.Exception
Object
into an XSLT Source
if the
Object
type is supported
.
source
- the original source object
java.lang.IllegalArgumentException
- if the given Object is not of a supported type
java.lang.Exception
protected void configureTransformer(java.util.Map<java.lang.String,java.lang.Object> model, HttpServletResponse response, javax.xml.transform.Transformer transformer)
Transformer
instance.
The default implementation copies parameters from the model into the
Transformer's parameter set
.
This implementation also copies the output properties
into the Transformer
output properties
.
Indentation properties are set as well.
model
- merged output Map (never null
)response
- current HTTP responsetransformer
- the target transformercopyModelParameters(Map, Transformer)
,
copyOutputProperties(Transformer)
,
configureIndentation(Transformer)
protected final void configureIndentation(javax.xml.transform.Transformer transformer)
Transformer
.
transformer
- the target transformerTransformerUtils.enableIndenting(javax.xml.transform.Transformer)
,
TransformerUtils.disableIndenting(javax.xml.transform.Transformer)
protected final void copyOutputProperties(javax.xml.transform.Transformer transformer)
Properties
, if any, into the
output property set
of the supplied
Transformer
.
transformer
- the target transformerprotected final void copyModelParameters(java.util.Map<java.lang.String,java.lang.Object> model, javax.xml.transform.Transformer transformer)
parameter set
of the supplied Transformer
.
model
- merged output Map (never null
)transformer
- the target transformerprotected void configureResponse(java.util.Map<java.lang.String,java.lang.Object> model, HttpServletResponse response, javax.xml.transform.Transformer transformer)
HttpServletResponse
.
The default implementation of this method sets the
content type
and
encoding
from the "media-type" and "encoding" output properties
specified in the Transformer
.
model
- merged output Map (never null
)response
- current HTTP responsetransformer
- the target transformerprivate javax.xml.transform.Templates loadTemplates() throws ApplicationContextException
Templates
instance for the stylesheet at the configured location.
ApplicationContextException
protected javax.xml.transform.Transformer createTransformer(javax.xml.transform.Templates templates) throws javax.xml.transform.TransformerConfigurationException
Transformer
instance used to prefer the XSLT transformation.
The default implementation simply calls Templates.newTransformer()
, and
configures the Transformer
with the custom URIResolver
if specified.
templates
- the XSLT Templates instance to create a Transformer for
javax.xml.transform.TransformerConfigurationException
- in case of creation failureprotected javax.xml.transform.Source getStylesheetSource()
Source
for the XSLT template under the configured URL
.
private void closeSourceIfNecessary(javax.xml.transform.Source source)
Source
if applicable.
Only works for StreamSources
.
source
- the XSLT Source to close (may be null
)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |