Meyyappan has posted 101 posts at DZone. View Full User Profile

Struts 2 Interceptors Example

06.15.2012
| 81639 views |
  • submit to reddit

In this example you will see how the interceptors are invoked both before and after the execution of the action and how the results are rendered back to the user. Let's understand this with the help of the following diagram.

The following actions happen in a sequence when a request comes to the Struts 2 framework.

  • Framework first finds which Action class to invoke for this request and discovers the interceptors associated with the action mapping.
  • Now the Framework creates an instance of ActionInvocation and calls its invoke() method. At this point the Frameworks hands the control over to the ActionInvocation for further processing of the request.
  • ActionInvocation is the one which encapsulates the action and the associated intercteptors. ActionInvocation knows in which sequence the interceptors should be invoked.
  • ActionInvocation now invokes the intercept() method of the first interceptor in the stack. We will understand this with the help of an example. Our example is very simple it uses only one interceptor for logging details.
  • The LoggingInterceptor's intercept() method contains the following code.
public String intercept(ActionInvocation invocation) throws Exception
{
    //Pre processing
    logMessage(invocation, START_MESSAGE);

    String result = invocation.invoke();

    //Post processing
    logMessage(invocation, FINISH_MESSAGE);

    return result;
}
  • As you can see, first the logMessage() method is called and the message is logged, this is the pre processing done by the logger interceptor, then the invoke() method of the ActionInvocation is again called, this time the ActionInvocation will call the next intercetor in the stack and this cycle will continue till the last interceptor in the stack.
  • After the execution of all the interceptors the action class will be invoked. Finally a result string will be returned and the corresponding view will be rendered. This is the normal flow of events.
  • But what if an validation error occurs, in this case the request processing will be stopped. No further interceptors will be invoked. Action will not be executed. The control flow changes, now the interceptors executed so far will be invoked in the reverse order to do the post processing if any and finally the result will be rendered to the user.
  • Let's come back to the normal flow. In our case the logger interceptor is the only interceptor in the stack, so after logging the "START_MESSAGE", the ActionInvocation's invoke() method will invoke the action. Our action simply returns "success", then again the logger interceptor will be invoked to do the post processing, this time the "FINISH_MESSAGE" is logged and the result is returned. Based on the result the corresponding view will be rendered to the user.

We get the following benefits by using the interceptors.

  • Extremely flexiable.
  • Cleaner and focused Action classes.
  • Provides code readability and code reuse.
  • Testing process becomes easier.
  • We can add only the interceptors we need to the stack and customising the action processing for each request.

Now lets see the flow of the example. In the index.jsp page we forward the request to the "TestLogger" URL.

<META HTTP-EQUIV="Refresh" CONTENT="0;URL=TestLogger.action">

The TestLogger URL is mapped to the TestLoggerAction class in the struts.xml file.

<!DOCTYPE struts PUBLIC
"-//Apache Software Foundation//DTD Struts Configuration 2.0//EN"
"http://struts.apache.org/dtds/struts-2.0.dtd">

<struts>
    <package name="test" extends="struts-default">
        <action name="TestLogger" class="vaannila.TestLoggerAction">
            <interceptor-ref name="logger" />
            <result name="success">/success.jsp</result>
        </action>
    </package>
</struts>       

Based on the mapping in the XML configuration file the user will be forwarded to the success page.

The following log messages are logged in the console.

package vaannila;

public class TestLoggerAction {

    public String execute()
    {
        System.out.println("Inside Action");
        return "success";
    }
}

Hope you understood the concept of interceptors. You can download this example by clicking the Download link below.

Source :Download
Source + Lib :Download
Published at DZone with permission of its author, Meyyappan Muthuraman.

(Note: Opinions expressed in this article and its replies are the opinions of their respective authors and not those of DZone, Inc.)

Tags:

Comments

Manjula Ranathunga replied on Tue, 2012/07/03 - 8:57pm

it really help me to get start work on.

 

Saurabh Sharma replied on Wed, 2012/07/18 - 1:52am

help full ...!!!

Dipak Rathod replied on Wed, 2012/10/17 - 8:27am

helpfull...!!!!!!!

 

Ligz Anghao replied on Mon, 2013/08/19 - 4:58am

Helpful.

But I have a question. Would anyone please tell me why. I appreciate it very much.

I am a beginner. I downloaded the source and run it in eclipse, then in my console output looked like:

##################################################################
Inside Action
8 19, 2013 5:23:35 午後 com.opensymphony.xwork2.util.logging.jdk.JdkLogger info
INFO: Starting execution stack for action //TestLogger
8 19, 2013 5:23:35 午後 com.opensymphony.xwork2.util.logging.jdk.JdkLogger info
INFO: Finishing execution stack for action //TestLogger
##################################################################

The "Inside Action" is output before the "Starting"/"Finishing" statement, but what I expected is "Starting" then "Inside Action" then "Finishing".

I think ACTION is supposed to be invoked after the interceptors' pre processing and before the post processing. So could I consider the reason as that, "System.out.println" method outputs text immediately whilst log.info method just pushes the messages in a queue and flush them out later? Or is there any other reasons?

I have no idea if it is a right place to ask a question here and if not I am sorry.

Thanks a lot.

Irshad Mohamad replied on Mon, 2014/02/17 - 8:08am

i didn't find any download link here.Please help me to download

Comment viewing options

Select your preferred way to display the comments and click "Save settings" to activate your changes.