Spring Boot中Servlet&Filter&Listener&Interceptor的使用
2017-04-19 14:09
886 查看
Web开发使用Controller基本上可以完成大部分需求，但是我们还可能会用到Servlet、Filter、Listener、Interceptor等等。
当使用Spring-Boot时，嵌入式Servlet容器通过扫描注解的方式注册Servlet、Filter和Servlet规范的所有监听器（如HttpSessionListener监听器）。
Spring boot的主Servlet为DispatcherServlet，其默认的url-pattern为"/"。也许我们在应用中还需要定义更多的Servlet，该如何使用SpringBoot来完成呢？
在spring boot中添加自己的Servlet有两种方法，代码注册Servlet和注解自动注册（Filter和Listener也是如此）。
一、代码注册通过ServletRegistrationBean、FilterRegistrationBean和ServletListenerRegistrationBean获得控制。
也可以通过实现ServletContextInitializer接口直接注册。
二、在SpringBootApplication上使用@ServletComponentScan注解后，Servlet、Filter、Listener可以直接通过@WebServlet、@WebFilter、@WebListener注解自动注册，无需其他代码。
通过代码注册Servlet示例代码：
在启动类中注册这个Servlet
使用注解注册Servlet示例代码
在启动类中进行扫描
访问：http://127.0.0.1:8080/myServlet
过滤器(Filter)和监听器(Listener)的注册方法和 Servlet 一样，使用@WebFilter和@WebListener的方式，完成一个Filter 和一个 Listener；使用注解@ServletComponentScan扫描相应的Servlet包;
过滤器(Filter)文件
ServletContext监听器(Listener)文件
ServletContext监听器(Listener)文件(HttpSessionListener)
注意不要忘记在启动类上添加@ServletComponentScan 注解。
使用FilterRegistrationBean和ServletListenerRegistrationBean这两个类可以实现代码的方式注册Filter和Listener。
过滤器属于Servlet范畴的API，与Spring 没什么关系。
Web开发中，我们除了使用 Filter 来过滤web请求外，还可以使用Spring提供的HandlerInterceptor（拦截器）。
HandlerInterceptor 的功能跟过滤器类似，但是提供更精细的的控制能力：在request被响应之前、request被响应之后、视图渲染之前以及request全部结束之后。我们不能通过拦截器修改request内容，但是可以通过抛出异常（或者返回false）来暂停request的执行。
配置拦截器也很简单，Spring 为什么提供了基础类WebMvcConfigurerAdapter ，我们只需要重写 addInterceptors 方法添加注册拦截器。
实现自定义拦截器只需要3步：
1、创建我们自己的拦截器类并实现 HandlerInterceptor 接口。
2、创建一个Java类继承WebMvcConfigurerAdapter，并重写 addInterceptors 方法。
2、实例化我们自定义的拦截器，然后将对像手动添加到拦截器链中（在addInterceptors方法中添加）。
定义两个拦截器
第二个拦截器
配置拦截器
然后在浏览器输入地址： http://localhost:8080/index 后，控制台的输出为：
根据输出可以了解拦截器链的执行顺序（具体原理介绍，大家找度娘一问便知）
最后强调一点：只有经过DispatcherServlet 的请求，才会走拦截器链，我们自定义的Servlet 请求是不会被拦截的，比如我们自定义的Servlet地址http://localhost:8080/myServlet 是不会被拦截器拦截的。并且不管是属于哪个Servlet 只要符合过滤器的过滤规则，过滤器都会拦截。
参考：http://412887952-qq-com.iteye.com
当使用Spring-Boot时，嵌入式Servlet容器通过扫描注解的方式注册Servlet、Filter和Servlet规范的所有监听器（如HttpSessionListener监听器）。
Spring boot的主Servlet为DispatcherServlet，其默认的url-pattern为"/"。也许我们在应用中还需要定义更多的Servlet，该如何使用SpringBoot来完成呢？
在spring boot中添加自己的Servlet有两种方法，代码注册Servlet和注解自动注册（Filter和Listener也是如此）。
一、代码注册通过ServletRegistrationBean、FilterRegistrationBean和ServletListenerRegistrationBean获得控制。
也可以通过实现ServletContextInitializer接口直接注册。
二、在SpringBootApplication上使用@ServletComponentScan注解后，Servlet、Filter、Listener可以直接通过@WebServlet、@WebFilter、@WebListener注解自动注册，无需其他代码。
通过代码注册Servlet示例代码：
import javax.servlet.ServletException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
public class MyServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println(">>>>>>>>>>doGet()<<<<<<<<<<<");
doPost(req, resp);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println(">>>>>>>>>>doPost()<<<<<<<<<<<");
resp.setContentType("text/html;charset=UTF-8");
PrintWriter out = resp.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Hello World</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>这是：MyServlet</h1>");
out.println("</body>");
out.println("</html>");
}
}在启动类中注册这个Servlet
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;
@SpringBootApplication
public class SiteConfig {
public static void main(String[] args) {
SpringApplication.run(SiteConfig.class, args);
}
@Bean
public ServletRegistrationBean MyServlet() {
return new ServletRegistrationBean(new MyServlet(), "/myServlet/*");
}
}使用注解注册Servlet示例代码
import javax.servlet.ServletException;
import javax.servlet.annotation.WebServlet;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.io.PrintWriter;
@WebServlet(urlPatterns="/myServlet/*", description="Servlet的说明")
public class MyServlet extends HttpServlet {
private static final long serialVersionUID = 1L;
@Override
protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println(">>>>>>>>>>doGet()<<<<<<<<<<<");
doPost(req, resp);
}
@Override
protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
System.out.println(">>>>>>>>>>doPost()<<<<<<<<<<<");
resp.setContentType("text/html;charset=UTF-8");
PrintWriter out = resp.getWriter();
out.println("<html>");
out.println("<head>");
out.println("<title>Hello World</title>");
out.println("</head>");
out.println("<body>");
out.println("<h1>这是：MyServlet</h1>");
out.println("</body>");
out.println("</html>");
}
}在启动类中进行扫描
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;
@SpringBootApplication
//这个就是扫描相应的Servlet包;
@ServletComponentScan
public class SiteConfig {
public static void main(String[] args) {
SpringApplication.run(SiteConfig.class, args);
}
}访问：http://127.0.0.1:8080/myServlet
过滤器(Filter)和监听器(Listener)的注册方法和 Servlet 一样，使用@WebFilter和@WebListener的方式，完成一个Filter 和一个 Listener；使用注解@ServletComponentScan扫描相应的Servlet包;
过滤器(Filter)文件
import javax.servlet.Filter;
import javax.servlet.FilterChain;
import javax.servlet.FilterConfig;
import javax.servlet.ServletException;
import javax.servlet.ServletRequest;
import javax.servlet.ServletResponse;
import javax.servlet.annotation.WebFilter;
import java.io.IOException;
/**
* 使用注解标注过滤器
* @WebFilter将一个实现了javax.servlet.Filter接口的类定义为过滤器
* 属性filterName声明过滤器的名称,可选
* 属性urlPatterns指定要过滤的URL模式,也可使用属性value来声明.(指定要过滤的URL模式是必选属性)
*/
@WebFilter(filterName = "myFilter", urlPatterns = "/*")
public class MyFilter implements Filter {
@Override
public void init(FilterConfig config) throws ServletException {
System.out.println("过滤器初始化");
}
@Override
public void doFilter(ServletRequest request, ServletResponse response,
FilterChain chain) throws IOException, ServletException {
System.out.println("执行过滤操作");
chain.doFilter(request, response);
}
@Override
public void destroy() {
System.out.println("过滤器销毁");
}
}ServletContext监听器(Listener)文件
import javax.servlet.ServletContextEvent;
import javax.servlet.ServletContextListener;
import javax.servlet.annotation.WebListener;
/**
* 使用@WebListener注解，实现ServletContextListener接口
*/
@WebListener
public class MyServletContextListener implements ServletContextListener {
@Override
public void contextDestroyed(ServletContextEvent arg0) {
System.out.println("ServletContex销毁");
}
@Override
public void contextInitialized(ServletContextEvent arg0) {
System.out.println("ServletContex初始化");
}
}ServletContext监听器(Listener)文件(HttpSessionListener)
import javax.servlet.annotation.WebListener;
import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;
@WebListener
public class MyHttpSessionListener implements HttpSessionListener {
@Override
public void sessionCreated(HttpSessionEvent se) {
System.out.println("Session 被创建");
}
@Override
public void sessionDestroyed(HttpSessionEvent se) {
System.out.println("ServletContex初始化");
}
}注意不要忘记在启动类上添加@ServletComponentScan 注解。
使用FilterRegistrationBean和ServletListenerRegistrationBean这两个类可以实现代码的方式注册Filter和Listener。
过滤器属于Servlet范畴的API，与Spring 没什么关系。
Web开发中，我们除了使用 Filter 来过滤web请求外，还可以使用Spring提供的HandlerInterceptor（拦截器）。
HandlerInterceptor 的功能跟过滤器类似，但是提供更精细的的控制能力：在request被响应之前、request被响应之后、视图渲染之前以及request全部结束之后。我们不能通过拦截器修改request内容，但是可以通过抛出异常（或者返回false）来暂停request的执行。
配置拦截器也很简单，Spring 为什么提供了基础类WebMvcConfigurerAdapter ，我们只需要重写 addInterceptors 方法添加注册拦截器。
实现自定义拦截器只需要3步：
1、创建我们自己的拦截器类并实现 HandlerInterceptor 接口。
2、创建一个Java类继承WebMvcConfigurerAdapter，并重写 addInterceptors 方法。
2、实例化我们自定义的拦截器，然后将对像手动添加到拦截器链中（在addInterceptors方法中添加）。
定义两个拦截器
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor1 implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
System.out.println("MyInterceptor1.preHandle()在请求处理之前进行调用(Controller方法调用之前)");
// 只有返回true才会继续向下执行，返回false取消当前请求
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
System.out.println("MyInterceptor1.postHandle()请求处理之后进行调用，但是在视图被渲染之前(Controller方法调用之后)");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
System.out.println("MyInterceptor1.afterCompletion()在整个请求结束之后被调用，也就是在DispatcherServlet渲染了对应的视图之后执行(主要是用于进行资源清理工作)");
}
}第二个拦截器
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class MyInterceptor2 implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
System.out.println("MyInterceptor2.preHandle()在请求处理之前进行调用（Controller方法调用之前）");
// 只有返回true才会继续向下执行，返回false取消当前请求
return true;
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
System.out.println("MyInterceptor2.postHandle()请求处理之后进行调用，但是在视图被渲染之前（Controller方法调用之后）");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
System.out.println("MyInterceptor2.afterCompletion()在整个请求结束之后被调用，也就是在DispatcherServlet 渲染了对应的视图之后执行（主要是用于进行资源清理工作）");
}
}配置拦截器
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
@Configuration
public class MyWebAppConfigurer extends WebMvcConfigurerAdapter {
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 多个拦截器组成一个拦截器链
// addPathPatterns 用于添加拦截规则
// excludePathPatterns 用户排除拦截
registry.addInterceptor(new MyInterceptor1()).addPathPatterns("/**");
registry.addInterceptor(new MyInterceptor2()).addPathPatterns("/**");
super.addInterceptors(registry);
}
}然后在浏览器输入地址： http://localhost:8080/index 后，控制台的输出为：
MyInterceptor1.preHandle()在请求处理之前进行调用(Controller方法调用之前) MyInterceptor2.preHandle()在请求处理之前进行调用（Controller方法调用之前） MyInterceptor2.postHandle()请求处理之后进行调用，但是在视图被渲染之前（Controller方法调用之后） MyInterceptor1.postHandle()请求处理之后进行调用，但是在视图被渲染之前(Controller方法调用之后) MyInterceptor2.afterCompletion()在整个请求结束之后被调用，也就是在DispatcherServlet 渲染了对应的视图之后执行（主要是用于进行资源清理工作） MyInterceptor1.afterCompletion()在整个请求结束之后被调用，也就是在DispatcherServlet渲染了对应的视图之后执行(主要是用于进行资源清理工作)
根据输出可以了解拦截器链的执行顺序（具体原理介绍，大家找度娘一问便知）
最后强调一点：只有经过DispatcherServlet 的请求，才会走拦截器链，我们自定义的Servlet 请求是不会被拦截的，比如我们自定义的Servlet地址http://localhost:8080/myServlet 是不会被拦截器拦截的。并且不管是属于哪个Servlet 只要符合过滤器的过滤规则，过滤器都会拦截。
参考：http://412887952-qq-com.iteye.com
内容来自用户分享和网络整理，不保证内容的准确性，如有侵权内容，可联系管理员处理 
相关文章推荐
- springboot 使用Servlet,Filter,Listener的方法
- Spring Boot使用Servlet、Filter或Listener的方式
- 在SpringBoot中使用 Servlet Filter Listener
- Spring Boot参考教程（六）Spring Boot配置Servlet，Filter，Listener，Interceptor
- Spring Boot 编写Servlet、Filter、Listener、Interceptor的方法
- spring boot (二) servlet listener filter interceptor
- SpringBoot中Servlet&Listener&Filter的应用
- springboot注册servlet,Filter,Listener
- 在Servlet(或者Filter，或者Listener)中使用spring的IOC容器
- SpringBoot初始教程之Servlet、Filter、Listener配置(七)
- ServletContextListener在Springboot中的使用
- 在Servlet(或者Filter，或者Listener)中使用spring的IOC容器
- springboot(五)filter/interceptor/listener
- 在servlet（或者filter或者listener）中使用spring的IOC容器
- SpringBoot初始教程之Servlet、Filter、Listener配置详解
- SpringBoot初始教程之Servlet、Filter、Listener配置
- (转)在Servlet(或者Filter，或者Listener)中使用spring的IOC容器
- servlet & filter & listener & interceptor
- 18.玩转Spring Boot 注册Servlet、Filter、Listener
- 在Servlet(或者Filter，或者Listener)中使用spring的IOC容器