Interceptor. Перехват запросов в Spring MVC

В Spring MVC есть возможность производить некие действия перед обработкой запроса, сразу после его обработки и перед отправкой ответа клиенту. Всё это можно сделать с помощью так называемых Interceptor'ов.

Эти перехватчики (Interceptor) позволяют выполнять задачи, которые являются общими для каждого запроса или набора запросов, без необходимости копировать код в каждом методе контроллера. Например, можно выполнять аутентификацию пользователя прежде, чем запрос достигнет Вашего контроллера и, в случае успеха, получить некоторые дополнительные данные о пользователе из базы данных, добавив их в объект HttpServletRequest. С другой стороны, если запрос не прошел установленную Вами проверку (например, входит в список "опасных" запросов, похожих на хакерские) Вы можете перенаправить пользователя на другую страницу.

Приступим к практике. Для начала создадим класс, обрабатывающий упомянутые выше действия:

package com.seostella.spring.interceptor;

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

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

public class StatsInterceptor extends HandlerInterceptorAdapter {

	private static final Logger logger = LoggerFactory.getLogger(StatsInterceptor.class);
	
	@Override
	public boolean preHandle(HttpServletRequest request,
			HttpServletResponse response, Object handler) throws Exception {
		
		logger.info("Client User-Agent: " + request.getHeader("User-Agent"));
		
		return super.preHandle(request, response, handler);
	}
	
	@Override
	public void postHandle(HttpServletRequest request,
			HttpServletResponse response, Object handler,
			ModelAndView modelAndView) throws Exception {
		super.postHandle(request, response, handler, modelAndView);
	}
	
	@Override
	public void afterCompletion(HttpServletRequest request,
			HttpServletResponse response, Object handler, Exception ex)
			throws Exception {
		super.afterCompletion(request, response, handler, ex);
	}
}

Метод preHandle вызывается перед тем как Front-контроллер передает управление контроллеру. Если метод возвращает значение true, обработка передается контроллеру, ответственному за этот запрос. Если возвращает false - выполнение прерывается. Следующим кодом мы прерываем выполнения обработки запроса и перенаправляем клиента на адрес google.com:

response.sendRedirect("http://google.com/");
return false;

Метод postHandle вызывается после того как контроллер отработал и вернул результат.

Метод afterCompletion вызывается после того как ответ сформирован.

Теперь нам надо зарегистрировать этот Interseptor. Делается это в контексте сервлета добавлением следующих строк:

<interceptors>
	<beans:bean class="com.seostella.spring.interceptor.StatsInterceptor" />
</interceptors>

Также есть возможность "ловить" не все запросы, а ограничиться лишь некоторыми. Делается это так:

<interceptors>
	<interceptor>
		<mapping path="/weather/*" />
		<beans:bean
			class="com.seostella.spring.interceptor.ExecutionTimeInterceptor" />
	</interceptor>
</interceptors>

Перехватчик ExecutionTimeInterceptor будет "ловить" только запросы, URI которых начинается с /weather/

Исходный код ExecutionTimeInterceptor представлен ниже

package com.seostella.spring.interceptor;

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

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;
import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.handler.HandlerInterceptorAdapter;

public class ExecutionTimeInterceptor extends HandlerInterceptorAdapter {

	private static final Logger logger = LoggerFactory.getLogger(ExecutionTimeInterceptor.class);
	
	@Override
	public boolean preHandle(HttpServletRequest request,
			HttpServletResponse response, Object handler) throws Exception {
		
		request.setAttribute("startRequestTime", new Long( System.currentTimeMillis() ) );
		
		return super.preHandle(request, response, handler);
	}
	
	@Override
	public void postHandle(HttpServletRequest request,
			HttpServletResponse response, Object handler,
			ModelAndView modelAndView) throws Exception {
		
		logger.info( " execution time of " + request.getRequestURI() + ": "
				+ ( System.currentTimeMillis() - ((Long)request.getAttribute("startRequestTime")).longValue() ) 
				+ " ms" );
		
		super.postHandle(request, response, handler, modelAndView);
	}
}

Файл конфигурации контекста сервлета:

<?xml version="1.0" encoding="UTF-8"?>
<beans:beans xmlns="http://www.springframework.org/schema/mvc"
	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-3.0.xsd
		http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.0.xsd
		http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-3.0.xsd">

	<!-- DispatcherServlet Context: defines this servlet's request-processing 
		infrastructure -->

	<!-- Enables the Spring MVC @Controller programming model -->
	<annotation-driven />

	<!-- Handles HTTP GET requests for /resources/** by efficiently serving 
		up static resources in the ${webappRoot}/resources directory -->
	<resources mapping="/resources/**" location="/resources/" />

	<!-- Resolves views selected for rendering by @Controllers to .jsp resources 
		in the /WEB-INF/views directory -->
	<beans:bean
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<beans:property name="prefix" value="/WEB-INF/views/" />
		<beans:property name="suffix" value=".jsp" />
	</beans:bean>

	<interceptors>
		<beans:bean
			class="com.seostella.spring.interceptor.StatsInterceptor" />

		<interceptor>
			<mapping path="/weather/*" />
			<beans:bean
				class="com.seostella.spring.interceptor.ExecutionTimeInterceptor" />
		</interceptor>
	</interceptors>

	<context:component-scan base-package="com.seostella.spring" />

</beans:beans>

Исходный код приложения, демонстрирующее работу Interceptor'ов Вы можете скачать по следующей ссылке - Скачать spring-interceptors.zip