Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Webwork provides several implementations of the com.opensymphony.xwork.Result interface to make web-based interactions with your actions simple. These results result types include:

Result Type

name

class

#Dispatcher

dispatcher

com.opensymphony.webwork.dispatcher.ServletDispatcherResult

#Redirect

redirect

com.opensymphony.webwork.dispatcher.ServletRedirectResult

#Action Chaining

chain

com.opensymphony.xwork.ActionChainResult

#Velocity

velocity

com.opensymphony.webwork.dispatcher.VelocityResult

#FreeMarker

freemarker

com.opensymphony.webwork.views.freemarker.FreemarkerResult

#JasperReports

jasper

com.opensymphony.webwork.views.jasperreports.JasperReportsResult

#XML/XSL

xslt

com.opensymphony.webwork.views.xslt.XSLTResult

Results are specified in xwork.xml nested inside actions. The "location" param is the default parameter, meaning you can specify the location two ways:

...

Includes or forwards a view (usually a jsp)

Parameters

Required

Description

location

yes

the location to go to after execution (ex. jsp)

parse

no

true by default. If set to false, the location param will not be parsed for Ognl expressions

Code Block
<result name="success" type="dispatcher">
    <param name="location">foo.jsp</param>
</result>

...


The response is told to redirect the browser to the specified location. The consequence of doing this means that the action that was just executed is lost or no longer available. This is because actions are built on a single-thread model.
NOTE: You may want to set the parse attribute to false so the location is not parsed for Ognl expressions.

Parameters

Required

Description

location

yes

the location to go to after execution

parse

no

true by default. If set to false, the location param will not be parsed for Ognl expressions

Code Block
<result name="success" type="redirect">
    <param name="location">foo.jsp</param>
    <param name="parse">false</param>
</result>

...


A special kind of view that invokes GenericDispatch (using the previously existing ActionContext) and executes another action. This is useful if you need to execute one action immediately after another.

Parameters

Required

Description

actionName

yes

the name of the action that will be chained to

...


This result mocks a JSP execution environment and then displays a Velocity template that will be streamed directly to the servlet output.

Parameters

Required

Description

location

yes

the location to go to after execution

parse

no

true by default. If set to false, the location param will not be parsed for Ognl expressions

Code Block
<result name="success" type="velocity">
    <param name="location">foo.vm</param>
</result>

...

FreeMarker
Anchor
FreeMarker
FreeMarker


Parameters

Required

Description

location

yes

the location to go to after execution

parse

no

true by default. If set to false, the location param will not be parsed for Ognl expressions

contentType

no

defaults to "text/html" unless specified

...


Generates a JasperReports report using the specified format or PDF if no format is specified.

Parameters

Required

Description

location

yes

the location to go to after execution

parse

no

true by default. If set to false, the location param will not be parsed for Ognl expressions

dataSource

yes

the Ognl expression used to retrieve the datasource from the value stack (usually a List)

format

no

the format in which the report should be generated, defaults to pdf

...


Interfaces with xml transformations.

Parameters

Required

Description

location

yes

the location to go to after execution

parse ?

no

Defaults to false. If set to true, the location will be parsed for Ognl expressions ? looks to be false unless specified

Code Block
<result name="success" type="xslt">foo.xslt</result>