public class XSLTResult extends Object implements Result
<xsl:template match="/result"> <result/> </xsl:template>
Xalan would still iterate through every property of your action and all its descendants.
If you had double-linked objects, Xalan would work forever analysing an infinite object tree. Even if your stylesheet was not constructed to process them all. It's because the current Xalan eagerly and extensively converts everything to its internal DTM model before further processing.
That's why there's a loop eliminator added that works by indexing every object-property combination during processing. If it notices that some object's property was already walked through, it doesn't go any deeper. Say you have two objects, x and y, with the following properties set (pseudocode):
x.y = y; and y.x = x; action.x=x;
Due to that modification, the resulting XML document based on x would be:
<result>
<x>
<y/>
</x>
</result>
Without it there would be endless x/y/x/y/x/y/... elements.
The XSLTResult code tries also to deal with the fact that DTM model is built in a manner that children are processed before siblings. The result is that if there is object x that is both set in action's x property, and very deeply under action's a property then it would only appear under a, not under x. That's not what we expect, and that's why XSLTResult allows objects to repeat in various places to some extent.
Sometimes the object mesh is still very dense and you may notice that even though you have a relatively simple stylesheet, execution takes a tremendous amount of time. To help you to deal with that obstacle of Xalan, you may attach regexp filters to elements paths (xpath).
Note: In your .xsl file the root match must be named result.
This example will output the username by using getUsername on your
action class:
<xsl:template match="result"> <html> <body> Hello <xsl:value-of select="username"/> how are you? </body> </html> </xsl:template>
In the following example the XSLT result would only walk through action's properties without their childs. It would also skip every property that has "hugeCollection" in their name. Element's path is first compared to excludingPattern - if it matches it's no longer processed. Then it is compared to matchingPattern and processed only if there's a match.
<result name="success" type="xslt"> <param name="location">foo.xslt</param> <param name="matchingPattern">^/result/[^/*]$</param> <param name="excludingPattern">.*(hugeCollection).*</param> </result>
In the following example the XSLT result would use the action's user property instead of the action as it's base document and walk through it's properties. The exposedValue uses an ognl expression to derive it's value.
<result name="success" type="xslt"> <param name="location">foo.xslt</param> <param name="exposedValue">user$</param> </result>* This result type takes the following parameters:
struts.properties related configuration:
<result name="success" type="xslt">foo.xslt</result>
| Modifier and Type | Field and Description |
|---|---|
static String |
DEFAULT_PARAM
'stylesheetLocation' parameter.
|
protected boolean |
noCache
Determines whether or not the result should allow caching.
|
| Constructor and Description |
|---|
XSLTResult() |
XSLTResult(String stylesheetLocation) |
| Modifier and Type | Method and Description |
|---|---|
void |
execute(ActionInvocation invocation) |
protected AdapterFactory |
getAdapterFactory() |
protected Source |
getDOMSourceForStack(Object value) |
String |
getEncoding() |
String |
getExcludingPattern()
Deprecated.
Since 2.1.1
|
String |
getExposedValue() |
String |
getMatchingPattern()
Deprecated.
Since 2.1.1
|
String |
getStatus() |
String |
getStylesheetLocation() |
protected Templates |
getTemplates(String path) |
protected URIResolver |
getURIResolver()
Get the URI Resolver to be called by the processor when it encounters an xsl:include, xsl:import, or document()
function.
|
protected void |
setAdapterFactory(AdapterFactory adapterFactory) |
void |
setEncoding(String encoding) |
void |
setExcludingPattern(String excludingPattern)
Deprecated.
Since 2.1.1
|
void |
setExposedValue(String exposedValue) |
void |
setLocation(String location)
Deprecated.
Use #setStylesheetLocation(String)
|
void |
setMatchingPattern(String matchingPattern)
Deprecated.
Since 2.1.1
|
void |
setNoCache(String val) |
void |
setParse(boolean parse)
If true, parse the stylesheet location for OGNL expressions.
|
void |
setStatus(String status) |
void |
setStylesheetLocation(String location) |
public static final String DEFAULT_PARAM
protected boolean noCache
public XSLTResult()
public XSLTResult(String stylesheetLocation)
public void setNoCache(String val)
public void setLocation(String location)
public void setStylesheetLocation(String location)
public String getStylesheetLocation()
public String getExposedValue()
public void setExposedValue(String exposedValue)
public String getMatchingPattern()
public void setMatchingPattern(String matchingPattern)
public String getExcludingPattern()
public void setExcludingPattern(String excludingPattern)
public String getStatus()
public void setStatus(String status)
public String getEncoding()
public void setEncoding(String encoding)
public void setParse(boolean parse)
parse - public void execute(ActionInvocation invocation) throws Exception
protected AdapterFactory getAdapterFactory()
protected void setAdapterFactory(AdapterFactory adapterFactory)
protected URIResolver getURIResolver()
protected Templates getTemplates(String path) throws TransformerException, IOException
TransformerExceptionIOExceptionprotected Source getDOMSourceForStack(Object value) throws IllegalAccessException, InstantiationException
Copyright © 2000-2015 Apache Software Foundation. All Rights Reserved.