在springboot 中配置使用servlet

1.前言

还记得，说到web项目，最早接触的就是servlet，实际上SSH项目，也是依赖于servlet，在web.xml文件中进行配置。那么使用了springboot之后，不仅有一个疑问，虽然SpringMVC已经帮我们很容易的实现了spring web项目的使用，只需要@Controller就能搞定。但是我们需要使用servlet该如何做呢？虽然这种需求非常少，但是在springboot的官方文档对servlet的使用有过描述。下面我们来看看在springboot中如何使用和配置servlet。

2.servlet

在com.dhb.servlet包中定义一个myservlet类。通过@webServlet注解定义其name和urlPatterns。
同时继承父类HttpServlet的doGet和doPost方法。这样就是我们之前经常使用的Servlet了。

package com.dhb.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;

@WebServlet(name = "myServlet",urlPatterns = "/srv")
public class MyServlet extends HttpServlet {

	@Override
	protected void doGet(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		System.out.println("servlet doGet method called...");
		resp.getWriter().println("doGet method called url is ["+req.getRequestURL()+"] time is ["+System.currentTimeMillis()+"]");
		resp.getWriter().flush();
		resp.getWriter().close();
	}

	@Override
	protected void doPost(HttpServletRequest req, HttpServletResponse resp) throws ServletException, IOException {
		System.out.println("servlet doPost method called...");
		resp.getWriter().println("doPost method called url is ["+req.getRequestURL()+"] time is ["+System.currentTimeMillis()+"]");
		resp.getWriter().flush();
		resp.getWriter().close();
	}
}

这个Servlet配置完成之后，我们要如何让其生效呢，下一步就是配置springboot的启动类。

3.springboot配置

在包com.dhb中定义一个Bean。
需要注意的是，由于使用了@ServletComponentScan，这个注解中没有指定具体的package,那么就需要确保被扫描的类位于该类所在的子目录中。也就是在本文中，其所在的package 在com.dhb中。

package com.dhb;

import com.dhb.servlet.MyServlet;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.boot.web.servlet.ServletComponentScan;
import org.springframework.boot.web.servlet.ServletRegistrationBean;
import org.springframework.context.annotation.Bean;

@SpringBootApplication
@ServletComponentScan
public class MySpringBootApplication {

	public static void main(String[] args) {
		SpringApplication.run(MySpringBootApplication.class, args);
	}

	//将servlet 添加到springboot容器中
	@Bean
	public ServletRegistrationBean<MyServlet> webServletRegistrationBean() {
		ServletRegistrationBean<MyServlet> bean = new ServletRegistrationBean<>(new MyServlet());
		bean.setLoadOnStartup(1);
		return bean;
	}
}

4.启动项目

在上一篇中介绍了jrebel，现在就通过jribel启动：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-UkkSc7KV-1614049960768)(https://upload-images.jianshu.io/upload_images/3237432-6786c290ad477285.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

然后我们通过postman访问：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-FKxXktVE-1614049960774)(https://upload-images.jianshu.io/upload_images/3237432-ff9bbef1c81b544e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

可以看到收到了预期的响应。

5.UrlMapping设置

在springboot的启动类中定义了的Bean里面，可以设置urlMapping。但是需要注意的是，这样一来，Servlet设置的urlPatterns将不再生效。
我们将代码改为如下：

ServletRegistrationBean<MyServlet> bean = new ServletRegistrationBean<>(new MyServlet(),"/s2");

之后重启，由于使用了Jrebel，则不需要重启，系统会自动加载。
可以看到http://127.0.0.1:8084/s2访问成功：
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-45Uju4wm-1614049960776)(https://upload-images.jianshu.io/upload_images/3237432-4f8f6254900a066b.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

但是之前的http://127.0.0.1:8084/srv则返回了404错误。
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-eaNxLBHb-1614049960779)(https://upload-images.jianshu.io/upload_images/3237432-16aa7b6c670ad33e.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

6.Filter

Filter的使用也很简单，建立一个package com.dhb.servlet.filter 。

package com.dhb.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(filterName = "MyFilter",urlPatterns = "/s2")
public class MyFilter implements Filter {

	@Override
	public void init(FilterConfig filterConfig) throws ServletException {
		System.out.println("Filter init ...");
	}
	
	@Override
	public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
		System.out.println("do Filter ...");
		chain.doFilter(request,response);
	}

	@Override
	public void destroy() {
		System.out.println("destroy ... ");
	}
}

然后我们重启服务，可以看到filter已经被初始化：

2021-02-22 19:41:51.512  INFO 11532 --- [           main] org.apache.catalina.core.StandardEngine  : Starting Servlet engine: [Apache Tomcat/9.0.41]
2021-02-22 19:41:51.620  INFO 11532 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2021-02-22 19:41:51.620  INFO 11532 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1289 ms
2021-02-22 19:41:51.682  INFO 11532 --- [           main] o.s.boot.web.servlet.RegistrationBean    : Servlet myServlet was not registered (possibly already registered?)
Filter init ...
2021-02-22 19:41:52.018  INFO 11532 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Initializing ExecutorService 'applicationTaskExecutor'
2021-02-22 19:41:52.365  INFO 11532 --- [           main] o.s.b.d.a.OptionalLiveReloadServer       : LiveReload server is running on port 35729
2021-02-22 19:41:52.397  INFO 11532 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8084 (http) with context path ''
2021-02-22 19:41:52.406  INFO 11532 --- [           main] com.dhb.MySpringBootApplication          : Started MySpringBootApplication in 2.904 seconds (JVM running for 6.273)

之后请求设置的路径。
http://127.0.0.1:8084/s2
可以看到输出：

2021-02-22 19:41:52.365  INFO 11532 --- [           main] o.s.b.d.a.OptionalLiveReloadServer       : LiveReload server is running on port 35729
2021-02-22 19:41:52.397  INFO 11532 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8084 (http) with context path ''
2021-02-22 19:41:52.406  INFO 11532 --- [           main] com.dhb.MySpringBootApplication          : Started MySpringBootApplication in 2.904 seconds (JVM running for 6.273)
do Filter ...
servlet doPost method called...

需要注意的是，我们在filter中的chain.doFilter(request,response);这就是责任链模式，request链条上的filter执行完毕之后，再回过来按照逆序执行response上的filter。

7.Listener

Listener是servlet规范中的一中特殊类，用于监听servletContext,HttpSession和ServletRequest等域对象的创建和销毁事件。监听域对象的属性发生修改的事件，用于在事件的发生前，发生后做一些必要的处理，可用于如下场景：

• 1.统计在线人数和在线用户数
• 2.系统启动时加载初始化信心
• 3.统计网站访问信心
• 4.记录用户访问路径

我们来创建一个Listener如下：

package com.dhb.servlet.listener;

import javax.servlet.http.HttpSessionEvent;
import javax.servlet.http.HttpSessionListener;

public class MyHttpSessionListener implements HttpSessionListener {
	
	public static int online = 0;

	@Override
	public void sessionCreated(HttpSessionEvent se) {
		System.out.println("创建session id is ["+se.getSession().getId()+"]");
		online ++;
		System.out.println("当前session总数：["+online+"]");
	}

	@Override
	public void sessionDestroyed(HttpSessionEvent se) {
		System.out.println("销毁session id is ["+se.getSession().getId()+"]");
		online --;
		System.out.println("当前session总数：["+online+"]");
	}
}

同样，需要在MySpringBootApplication中配置一个bean

@Bean
public ServletListenerRegistrationBean listenerRegistrationBean() {
	ServletListenerRegistrationBean srb = new ServletListenerRegistrationBean();
	srb.setListener(new MyHttpSessionListener());
	System.out.println("listener 创建成功");
	return srb;
}

官方文档建议Listener和Filter都用@Bean 注释方法的方式来创建。这样可以更加灵活控制。
启动Jrebel:

2021-02-23 10:46:38.126  INFO 18368 --- [           main] o.a.c.c.C.[Tomcat].[localhost].[/]       : Initializing Spring embedded WebApplicationContext
2021-02-23 10:46:38.126  INFO 18368 --- [           main] w.s.c.ServletWebServerApplicationContext : Root WebApplicationContext: initialization completed in 1218 ms
listener 创建成功
2021-02-23 10:46:38.201  INFO 18368 --- [           main] o.s.boot.web.servlet.RegistrationBean    : Servlet myServlet was not registered (possibly already registered?)
Filter init ...
2021-02-23 10:46:38.442  INFO 18368 --- [           main] o.s.s.concurrent.ThreadPoolTaskExecutor  : Initializing ExecutorService 'applicationTaskExecutor'
2021-02-23 10:46:38.774  INFO 18368 --- [           main] o.s.b.d.a.OptionalLiveReloadServer       : LiveReload server is running on port 35729
2021-02-23 10:46:38.815  INFO 18368 --- [           main] o.s.b.w.embedded.tomcat.TomcatWebServer  : Tomcat started on port(s): 8084 (http) with context path ''
2021-02-23 10:46:38.825  INFO 18368 --- [           main] com.dhb.MySpringBootApplication          : Started MySpringBootApplication in 2.696 seconds (JVM running for 6.132)

可以看到，Listener实际上在Filter之前被初始化。
但是此时我们需要注意的是，请求任意url，session并没有增加。这是因为我们需要在请求后面增加session的操作。
修改Controller中的代码：

@Controller
public class HelloController {

	@RequestMapping("/hello")
	@ResponseBody
	public String hello(HttpSession session) {
		session.setAttribute("aa","aa");
		return "hello";
	}

}

现在再来请求http://127.0.0.1:8084/hello,通过不同浏览器可以看到输出：

创建session id is [06327B8BE718B12F0B3CAA829160B162]
当前session总数：[1]
创建session id is [BC09536518EB4ED9F94D2290E6578DD9]
当前session总数：[2]

这样监听器就配置成功了。

8.总结

在SpringBoot中使用servlet是很少见的，毕竟SpringMVC使用起来非常方便，几乎没有直接使用servlet的必要。但是这并不意味着我们可以忽略servlet的存在。毕竟SpringMVC也是通过servlet演化而来。对于servlet规范中的filter和listener，我们可能使用的场景会非常多。特别是Listener，用在初始化数据的load等操作上。