Spring MVC interceptor HandleInterceptorAdapter example

Sometimes you need to intercept incoming request and do some preprocessing or you need to do it after completion of request. It is very much similar to filters that we use with servlet.
There are two ways to use interceptor with Spring MVC.

Spring MVC tutorial:

HandlerInterceptor Interface :

We can implement HandlerInterceptor interface to use interceptor. It has three methods which we need to implement.

public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) : This method is executed before request is handed over to handler method.
If you notice it has boolean return type. If this method returns true, then it will go to other interceptors or to handler method. If this method returns false then this request is handled by interceptor only and we should use response object to send back to client.
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) : This method is called when handler method has completed its process but dispatcherServlet is yet process the view. This method can be use to add some model view objects that can be used in view. It can be done by adding object to modelAndView object.
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) :  This method is called after view is render and request is completely processed.

HandlerInterceptorAdapter class:

Issue with HandlerInterceptor is that you need to implement all the methods but if you extend to [abstract class](https://java2blog.com/abstract-class-java/ “abstract class”) called HandlerInterceptorAdapter, you can implement only those method which you want and other methods will have default implementation.

Lets implement custom interceptor example using HandlerInterceptorAdapter class.

Spring MVC interceptor example:

I am using Spring MVC hello world example here with small changes to it.

Spring MVC interceptor project structure

Adding Spring MVC dependency

Add spring dependency in pom.xml. We require spring core and spring mvc dependency here.
pom.xml 

  4.0.0
  com.arpit.java2blog
  SpringMVCHelloWorldExample
  war
  0.0.1-SNAPSHOT
  SpringMVCHelloWorldExample Maven Webapp
  http://maven.apache.org
  
    
      junit
      junit
      3.8.1
      test
    
   
     javax.servlet
     javax.servlet-api
     3.1.0
   

    
   org.springframework
   spring-core
   ${spring.version}
  
  
   org.springframework
   spring-webmvc
   ${spring.version}
  
  
  
    SpringMVCHelloWorldExample

    
        
        org.apache.maven.plugins
        maven-compiler-plugin
        3.1
        
            ${jdk.version}
            ${jdk.version}
        
    
    

  
   
  4.2.1.RELEASE
  1.7
   

Create Controller 

Create a package named “org.arpit.java2blog.springmvc.controller”
create a controller class named “HelloWorldController.java”

package org.arpit.java2blog.springmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.servlet.ModelAndView;

@Controller
public class HelloWorldController {

 @RequestMapping("/helloworld")
 public ModelAndView hello() {
      return new ModelAndView("hello");
 }
}

Create interceptor 

create interceptor class called SampleInterceptor.java
package org.arpit.java2blog.springmvc.interceptor;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

public class SampleInterceptor extends HandlerInterceptorAdapter {

 @Override
 public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
   throws Exception {
  request.setAttribute("blogName", "java2blog");
  return true;
 }

 @Override
 public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
   ModelAndView modelAndView) throws Exception {
  String blogName = (String) request.getAttribute("blogName");
  // We are adding some modelAndView objects here and will use it in view jsp.
  modelAndView.addObject("blogName",blogName);
  modelAndView.addObject("authorName", "Arpit");
 }

 @Override
 public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
   throws Exception {
  String blogName = (String) request.getAttribute("blogName");
  String authorName = (String) request.getAttribute("authorName");
  System.out.println("Request URL::" + request.getRequestURL().toString());
  System.out.println("Blog name : " + blogName);
  System.out.println("Author Name : " + authorName);
 }
}

Here I am setting request attribute(blogName) in preHandle method and we are getting it in postHandle method. We are also adding two objects to modelAndView which we will use in jsp.

Create view

Modify index.jsp as below

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>




HelloWorld


Click here to read hello message 

Create hello.jsp in /WEB-INF/ folder

<%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>




Hello


This is written by ${authorName} on ${blogName}

Configuring spring mvc application

 Now we need to configure two files “web.xml” and “springmvc-dispatcher-servlet.xml” We need to declare DispatcherServlet in web.xml for spring MVC. When DisplatcherServlet is initialized,spring tries to load application context from [servlet name]-servet.xml file. So in this case, it will be try to load springmvc-dispatcher-servlet.xml.

    Archetype Created Web Application
     
    index.jsp
  
    
  springmvc-dispatcher
  
   org.springframework.web.servlet.DispatcherServlet
        
  1
 

 
  springmvc-dispatcher
  /
 
    

create xml file named “springmvc-dispatcher-servlet.xml” in /WEB-INF folder as below.



 
 
  
  
 
 
  
   
   
  
 

create xml file named “springmvc-dispatcher-servlet.xml” in /WEB-INF folder as below.

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:beans="http://www.springframework.org/schema/beans"
 xmlns:context="http://www.springframework.org/schema/context"
 xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
  http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
  http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">

Here we have declared interceptor(SampleInterceptor) in above file which will intercept specific URL (/helloworld.html).

It ‘s time to do maven build.

Right click on project -> Run as -> Maven build
Provide goals as clean install (given below) and click on run

Run the application

Right click on project -> run as -> run on server
Select apache tomcat and click on finish

 You will see below screen:



When you click on above link, you will get below screen

We are done with Spring MVC interceptor example. If you are still facing any issue, please comment.

Download
click to begin20KB .zip
[social_share share_on="facebook,twitter,linkedin,whatsapp"][post_navigator in_same_term="true"]

Leave a Reply

Your email address will not be published. Required fields are marked *

Subscribe to our newletter

Get quality tutorials to your inbox. Subscribe now.