写在前面:
使用Spring-Boot时,嵌入式Servlet容器可以通过扫描注解(@ServletComponentScan)的方式注册Servlet、Filter和Servlet规范的所有监听器(如HttpSessionListener监听器)。
Spring boot 的主 Servlet 为 DispatcherServlet,其默认的url-pattern为“/”。一般情况系统默认的Servlet就够用了,如果需要自定义Servlet,可以继承系统抽象类HttpServlet,重写方法来实现自己的Servlet。关于Servlet、过滤器、拦截器、监听器可以参考:(转)servlet、filter、listener、interceptor之间的区别和联系
Spring-Boot有两种方法注册Servlet、Filter和Listener :
1、代码注册:通过ServletRegistrationBean、 FilterRegistrationBean 和 ServletListenerRegistrationBean 获得控制。
2、在 SpringBootApplication 上使用@ServletComponentScan 注解后,Servlet、Filter、Listener 可以直接通过 @WebServlet、@WebFilter、@WebListener 注解自动注册,无需其他代码。
一、Servlet
Servlet匹配规则:匹配的优先级是从精确到模糊,复合条件的Servlet并不会都执行。
1、通过@ServletComponentScan自动扫描
a、springboot的启动入口添加注解:@ServletComponentScan;
@SpringBootApplication @ServletComponentScan public class ApplicationMain { public static void main(String[] args) { SpringApplication.run(ApplicationMain.class, args); } }
b、@WebServlet 自定义Servlet,配置处理请求路径 /demo/myServlet
@WebServlet(name = "myServletDemo1",urlPatterns = "/demo/myServlet",description = "自定义的servlet") public class MyServletDemo1 extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { System.out.println("==========myServletDemo Get Method=========="); resp.getWriter().println("my myServletDemo1 process request"); super.doGet(req, resp); } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { System.out.println("==========myServletDemo1 POST Method=========="); super.doPost(req, resp); } }
2、使用@ServletRegistrationBean注解
a、@ServletRegistrationBean注入自定义的Servlet,配置处理的路径为 /demo/servletDemo2
@Configuration public class ServletConfiguration { /** * 代码注入 */ @Bean public ServletRegistrationBean myServletDemo() { return new ServletRegistrationBean(new MyServletDemo2(), "/demo/servletDemo2"); } }
b、自定义的Servlet
public class MyServletDemo2 extends HttpServlet { @Override protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { System.out.println("==========myServletDemo2 Get Method=========="); resp.getWriter().println("my myServletDemo2 process request"); super.doGet(req, resp); } @Override protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException { System.out.println("==========myServletDemo2 POST Method=========="); super.doPost(req, resp); } }
二、Filter
完整的流程是:Filter对用户请求进行预处理,接着将请求交给Servlet进行处理并生成响应,最后Filter再对服务器响应进行后处理。
Filter有如下几个用处。
- 在HttpServletRequest到达Servlet之前,拦截客户的HttpServletRequest。
- 根据需要检查HttpServletRequest,也可以修改HttpServletRequest头和数据。
- 在HttpServletResponse到达客户端之前,拦截HttpServletResponse。
- 根据需要检查HttpServletResponse,也可以修改HttpServletResponse头和数据。
多个FIlter可以组成过滤器调用链,按设置的顺序逐一进行处理,形成Filter调用链。
1、通过@ServletComponentScan自动扫描
a、springboot的启动入口添加注解:@ServletComponentScan;
b、@WebFilter 配置处理全部url的Filter
@WebFilter(filterName = "myFilter",urlPatterns = "/*") public class MyFilter implements Filter { public void init(FilterConfig filterConfig) throws ServletException { System.out.println(">>>>>>myFilter init ……"); } public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { System.out.println(">>>>>>执行过滤操作"); filterChain.doFilter(servletRequest, servletResponse); } public void destroy() { System.out.println(">>>>>>myFilter destroy ……"); } }
* doFilter()方法是过滤器的核心方法,实现该方法就可实现对用户请求进行预处理,也可实现对服务器响应进行后处理——它们的分界线为是否调用了filterChain.doFilter(),执行该方法之前,即对用户请求进行预处理;执行该方法之后,即对服务器响应进行后处理。
2、通过@FilterRegistrationBean注册
a、@Bean注入自定义的Filter
@Configuration public class ServletConfiguration { @Bean public FilterRegistrationBean myFilterDemo(){ FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setFilter(new MyFilter2()); registration.addUrlPatterns("/demo/myFilter2"); registration.addInitParameter("paramName", "paramValue"); registration.setName("myFilter2"); registration.setOrder(2);//指定filter的顺序 return registration; } }
b、自定义的Filter
public class MyFilter2 implements Filter { public void init(FilterConfig filterConfig) throws ServletException { System.out.println("======MyFilter2 init ……"); } public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { System.out.println("======MyFilter2执行过滤操作"); filterChain.doFilter(servletRequest, servletResponse); } public void destroy() { System.out.println("======MyFilter2 destroy ……"); } }
三、Listener
目前 Servlet 中提供了 6 种两类事件的观察者接口,它们分别是:4 个 EventListeners 类型的,ServletContextAttributeListener、ServletRequestAttributeListener、ServletRequestListener、HttpSessionAttributeListener 和 2 个 LifecycleListeners 类型的,ServletContextListener、HttpSessionListener。
- ServletContextAttributeListener监听对ServletContext属性的操作,比如增加、删除、修改属性。
- ServletContextListener监听ServletContext。当创建ServletContext时,激发contextInitialized(ServletContextEvent sce)方法;当销毁ServletContext时,激发contextDestroyed(ServletContextEvent sce)方法。
- HttpSessionListener监听HttpSession的操作。当创建一个Session时,激发session Created(HttpSessionEvent se)方法;当销毁一个Session时,激发sessionDestroyed (HttpSessionEvent se)方法。
- HttpSessionAttributeListener监听HttpSession中的属性的操作。当在Session增加一个属性时,激发attributeAdded(HttpSessionBindingEvent se) 方法;当在Session删除一个属性时,激发attributeRemoved(HttpSessionBindingEvent se)方法;当在Session属性被重新设置时,激发attributeReplaced(HttpSessionBindingEvent se) 方法。
1、通过@ServletComponentScan自动扫描
a、ServletListenerRegistrationBean 注入自定义的Listener;
b、自定义的Listener
@WebListener public class MyLisener implements ServletContextListener { public void contextInitialized(ServletContextEvent servletContextEvent) { System.out.println("MyLisener contextInitialized method"); } public void contextDestroyed(ServletContextEvent servletContextEvent) { System.out.println("MyLisener contextDestroyed method"); } }
2、通过@ServletListenerRegistrationBean 注册
a、@Bean注入自定义的Listener;
@Configuration public class ServletConfiguration { @Bean public ServletListenerRegistrationBean myListener(){ return new ServletListenerRegistrationBean(new MyLisener()); } }
b、自定义的Listener
public class MyLisener implements ServletContextListener { public void contextInitialized(ServletContextEvent servletContextEvent) { System.out.println("MyLisener contextInitialized method"); } public void contextDestroyed(ServletContextEvent servletContextEvent) { System.out.println("MyLisener contextDestroyed method"); } }
四、验证servlet、filter、listener的顺序
a、使用MyServletDemo2、MyFilter2、MyFilter3、MyLisener做测试;
b、设置servlet处理url格式为 /demo/*;设置MyFilter2顺序为2;MyFilter3的顺序为3;
@Configuration public class ServletConfiguration { /**代码注入*/ @Bean public ServletRegistrationBean myServletDemo(){ return new ServletRegistrationBean(new MyServletDemo2(),"/demo/*"); } @Bean public FilterRegistrationBean myFilterDemo(){ FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setFilter(new MyFilter2()); registration.addUrlPatterns("/demo/myFilter"); registration.addInitParameter("paramName", "paramValue"); registration.setName("myFilter2"); registration.setOrder(2);//指定filter的顺序 return registration; } @Bean public FilterRegistrationBean myFilterDemo2(){ FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setFilter(new MyFilter3()); registration.addUrlPatterns("/demo/*"); registration.addInitParameter("paramName", "paramValue"); registration.setName("myFilter3"); registration.setOrder(1); return registration; } @Bean public ServletListenerRegistrationBean myListener(){ return new ServletListenerRegistrationBean(new MyLisener()); } }