ForwardAction in Struts
By: Daniel Malcolm in Struts Tutorials on 2007-10-01
ForwardAction is the one of the most frequently used built-in Action classes. The primary reason behind this is that ForwardAction allows you to adhere to MVC paradigm when designing JSP navigation. Most of the times you will perform some processing when you navigate from one page to another. In Struts, this processing is encapsulated in the Action instances. There are times however when all you want to do is navigate from one page to another without performing any processing. You would be tempted to add a hyperlink on the first page for direct navigation to the second. Watch out! In Model 2 paradigm, a straight JSP invocation from another JSP is discouraged, although not prohibited. For instance, suppose you want to go from PageA.jsp to PageB.jsp in your Struts application. The easy way of achieving this is to add a hyperlink in PageA.jsp as follows:
<a href="PageB.jsp">Go to Page B</a>
or even better, as follows:
<html:link page="/PageB.jsp">Go to Page B</html:link>
However this violates the MVC spirit by directly accessing the JSP. In Model 2 applications, it is the responsibility of the Controller to select and dispatch to the next view. In Struts, ActionServlet and Action classes together form the controller. They are supposed to select and dispatch to the next view. Moreover the ActionServlet is responsible for intercepting your request and providing appropriate attributes such as Message Resource Bundles. If you bypass this step, then the behavior of the Struts tags may become unpredictable.
MVC compliant usage of LinkTag
Struts provides a built-in Action class called ForwardAction to address this issue. With ForwardAction, the Struts Controller is still in the loop while navigating from PageA to PageB. There are two steps involved in using the ForwardAction. They are:
First, declare the PageA hyperlink that takes you to PageB as follows:
<html:link page="/gotoPageB.do">Go to Page B</html:link>
Next, add an ActionMapping in the Struts Config file as follows:
<action path="/gotoPageB"
parameter="/PageB.jsp"
type="org.apache.struts.actions.ForwardAction" />
The PageA.jsp hyperlink now points to "/gotoPageB.do" instead of "PageB.jsp". This ensures that the controller is still in the loop. The three attributes shown above are mandatory in a ForwardAction. The type attribute is always org.apache.struts.actions.ForwardAction instead of a custom Action of yours. The path attribute identifies the URL path, as any other ActionMapping. The parameter attribute in the above definition is the URL for the next JSP.
In the above ActionMapping you might have noticed there is no ActionForm. The Struts Config file DTD specifies that the Form bean is optional in an ActionMapping. Logically speaking ActionForm makes sense only where is data to be collected from the HTML request. In situations like this where there is no HTML data involved in the navigation, there is no need for ActionForm.
Using LinkTag's action attribute
The LinkTag (<html:link>) has several variations. It can be used in a variety of ways in conjunction with ForwardAction. You just saw one usage of the LinkTag. A second way of using the this tag is as follows:
First, declare the PageA hyperlink that takes you to PageB as follows:< /p>
<html:link action="gotoPageB">Go to Page B</html:link>
Next, add the ActionMapping for /gotoPageB in the Struts Config file
same way as before:
<action path="/gotoPageB"
parameter="/PageB.jsp"
type="org.apache.struts.actions.ForwardAction" />
When you use the action attribute instead of the page attribute in <html:link>, you need not specify the ".do" explicitly.
Using LinkTag's forward attribute
There is yet another way to use <html:link>. In this approach you use the forward attribute of the <html:link> tag instead of the action. There are two steps involved in this approach.
First, declare the PageA hyperlink that takes you to PageB as follows:
<html:link forward="pageBForward">Go to Page B</html:link>
Add a Global Forward for "pageBForward" as follows in the globalforwards section:
<global-forwards>
<forward name="pageBForward" path="/PageB.jsp" />
</global-forwards>
When used in this manner, the <html:link> gets transformed into the following HTML Link.
<a href="App1/PageB.jsp">Go to Page B</a>
Oops, that doesn't seem right. The HTML Link is now displaying the actual JSP name directly in the browser. Ideally you would love to hide the JSP name from the user. And with a slight twist you can! First, define an ActionMapping as follows:
<action path="/gotoPageB"
parameter="/PageB.jsp"
type="org.apache.struts.actions.ForwardAction" />
Next, modify the global forward itself to point to the above ActionMapping.
<global-forwards>
<forward name="pageBForward" path="/gotoPageB.do" />
</global-forwards>
When used in this manner, the <html:link> gets transformed into the following HTML Link.
<a href="App1/gotoPageB.do">Go to Page B</a>
There you go! The generated HTML is not displaying the JSP name anymore. From a design perspective this seems to be the best way of using the <html:link> tag since the link is completely decoupled from the associated ActionMapping, thanks to the global-forward. The <html:link> points to the global-forward and the global-forward points to the ForwardAction. The extra level of indirection, although looks confusing in the beginning, is a good design decision due to the following reason:
As is true with any application, requirements change and it might just become necessary to do some processing during the navigation from PageA to PageB. A conversion from ForwardAction to a custom Action will be easier to manage with the extra level of indirection.
Using ForwardAction for Integration
In general, the ForwardAction's parameter attribute specifies the resource to be forwarded to. It can be the physical page like PageB.jsp or it can be a URL pattern handled by another controller, maybe somewhere outside Struts. For instance, consider the following ForwardAction.
<action path="/gotoPageB"
parameter="/xoom/AppB"
type="org.apache.struts.actions.ForwardAction" />
In the snippet above, the value of the parameter is not a physical page. It is a logical resource that might be mapped to another Servlet totally outside the control of Struts. Yet from PageA's perspective, you are still dealing with a Struts URL. This is the second use of ForwardAction. You can integrate Struts applications transparently with already existing non-Struts applications.
NOTE: Even with the ForwardAction, you cannot prevent a nosy user from accessing the JSP directly. See the section Protecting JSPs from direct access for techniques to protect your JSPs from direct access.
ForwardAction Hands-on
Think of index.jsp as PageA and CustomerDetails.jsp as PageB. The <html:link> in index.jsp will look as follows: <html:link forward="CustomerDetailsPage">Customer Form</a> The following Global Forward and ForwardAction are added to the Struts Config file.
<global-forwards>
..
<forward name="CustomerDetailsPage"
path="/gotoCustomerDetails.do" />
</global-forwards>
<action-mappings>
..
<action path="/gotoCustomerDetails"
parameter="/CustomerDetails.jsp"
type="org.apache.struts.actions.ForwardAction" />
</action-mappings>
Add Comment
This policy contains information about your privacy. By posting, you are declaring that you understand this policy:
- Your name, rating, website address, town, country, state and comment will be publicly displayed if entered.
- Aside from the data entered into these form fields, other stored data about your comment will include:
- Your IP address (not displayed)
- The time/date of your submission (displayed)
- Your email address will not be shared. It is collected for only two reasons:
- Administrative purposes, should a need to contact you arise.
- To inform you of new comments, should you subscribe to receive notifications.
- A cookie may be set on your computer. This is used to remember your inputs. It will expire by itself.
This policy is subject to change at any time and without notice.
These terms and conditions contain rules about posting comments. By submitting a comment, you are declaring that you agree with these rules:
- Although the administrator will attempt to moderate comments, it is impossible for every comment to have been moderated at any given time.
- You acknowledge that all comments express the views and opinions of the original author and not those of the administrator.
- You agree not to post any material which is knowingly false, obscene, hateful, threatening, harassing or invasive of a person's privacy.
- The administrator has the right to edit, move or remove any comment for any reason and without notice.
Failure to comply with these rules may result in being banned from submitting further comments.
These terms and conditions are subject to change at any time and without notice.
- Data Science
- Android
- React Native
- AJAX
- ASP.net
- C
- C++
- C#
- Cocoa
- Cloud Computing
- HTML5
- Java
- Javascript
- JSF
- JSP
- J2ME
- Java Beans
- EJB
- JDBC
- Linux
- Mac OS X
- iPhone
- MySQL
- Office 365
- Perl
- PHP
- Python
- Ruby
- VB.net
- Hibernate
- Struts
- SAP
- Trends
- Tech Reviews
- WebServices
- XML
- Certification
- Interview
categories
Related Tutorials
Handling Duplicate Form Submissions in Struts
Guidelines for Struts Application Development
Configuring JDBC DataSources in Struts
When is the best time to validate input in Struts
Simple example of using the requiredif Validator rule in Struts
How to prepopulate a form in Struts
Using JavaScript to submit a form in Struts
FAQ: Why are my checkboxes not being set from ON to OFF?
FAQ: Why was reload removed from Struts (since 1.1)?
Comments