SpringMVC源码分析_1 SpringMVC启动和加载原理

                                                                                         1 SpringMVC容器启动和加载原理

 

                                                                                                                                                                                                                                                                                   作者：田超凡

                                                                                                                                                                                                                                                                                   版权所有，严禁复制转载

1 SpringMVC和Servlet的关系

Servlet是Sun公司提供的一门用于开发动态web资源的技术。

　　Sun公司在其API中提供了一个servlet接口(javax.servlet.Servlet)，用户若想用发一个动态web资源(即开发一个Java程序向浏览器输出数据)，需要完成以下2个步骤：

　　1、编写一个Java类，实现servlet接口(继承javax.servlet.HttpServlet，重写doGet()/doPost()方法处理GET、POST请求)

2、在web.xml中配置<servlet>和<servletMapping>，指定不同Servlet拦截不同格式的请求并处理，在SpringBoot中，如果需要集成servlet，可以不用在web.xml配置<servlet>，直接使用@WebServlet注解标注自定义Servlet即可，常用的servlet映射相关配置在这个注解里面已经帮我们封装好了，在启动类标注@ServletComponentScan即可扫描并注册自定义的servlet到SpringBoot容器中

3 Servlet是线程不安全的单例模式实现，每个Servlet都有自己的生命周期，总的来说，Servlet声明周期主要包括四个阶段：加载和实例化、初始化(init)、服务(service)、销毁(destroy)，每个Servlet都只会被初始化一次，每次请求都是交给service方法执行

4 常见Servlet继承关系：自定义Servlet -> HttpServlet -> GenericServlet -> Servlet

按照一种约定俗成的称呼习惯，通常我们也把实现了servlet接口的java程序，称之为Servlet

SpringMVC是Spring家族中的基于MVC Model II模式实现的一大视图层框架，SpringMVC底层核心控制器DispatcherServlet本质就是基于Servlet重新封装的，所以说，SpringMVC可以理解为是Spring对Servlet重新封装的一套功能更加齐全、使用方式更加灵活、和Spring完美契合的Web框架。

SpringMVC是依赖于Servlet容器和生命周期管理的。

 

2 Servlet核心初始化器ServletContainerInitializer

主要作用：监听Web容器启动，注册第三方组件

SpringMVC中的作用：

当Web容器启动时，注册SpringMVC核心控制器DispatcherServlet

在web容器启动时为提供给第三方组件机会做一些初始化的工作，例如注册servlet或者filtes等，servlet规范中通过ServletContainerInitializer实现此功能。

每个框架要使用ServletContainerInitializer就必须在对应的jar包的META-INF/services 目录创建一个名为javax.servlet.ServletContainerInitializer的文件，文件内容指定具体的ServletContainerInitializer实现类。

 

1. Servlet容器启动时会扫描当前应用里面每一个jar包META-INF/services/javax.servlet.ServletContainerInitializer文件中定义的ServletContainerInitializer的实现
2. 自定义ServletContainerInitializer的实现类，使用javax.servlet.annotation.@HandlesTypes声明
   必须绑定在META-INF/services/javax.servlet.ServletContainerInitializer中
   该文件的内容就是自定义ServletContainerInitializer实现类的全类名；

 

相关代码

@HandlesTypes(value = MyHandlesType.class) public class MyServletContainerInitializer implements ServletContainerInitializer {     /**      * @param set 感兴趣类型 也就是MyHandlesType 所有子类型      * @param servletContext      * @throws ServletException      */     public void onStartup(Set<Class<?>> set, ServletContext servletContext) throws ServletException {         // 1.打印所有感兴趣的类型         for (Class<?> c : set) {             System.out.println(c);         }         // 2.servletContext 手动注册过滤器、servlet、监听器         ServletRegistration.Dynamic payServlet = servletContext.addServlet("testServlet", new TestServlet());         payServlet.addMapping("/test");     } }

 

 

3 基于注解方式无xml启动SpringMVC

核心思想：

1. 监听 Web容器启动，实现WebApplicationContext接口，重写onStartup()
2. 在监听到Web容器启动时，先初始化SpringMVC注解驱动上下文AnnotationConfigWebApplicationContext，注册SpringMVC核心配置类。
3. 创建SpringMVC核心控制器DispatcherServlet并注册到ServletContext容器上下文中，作用域是整个SpringMVC容器全局共享

 

定义SpringMVC核心配置类，作用等效于SpringMVC核心配置文件springmvc.xml

开启SpringMVC使配置生效的方式有两种，只能任选其一，不能同时配置：

1. 核心配置类使用@EnableWebMvc标注启用SpringMVC
2. 核心配置类继承WebMvcConfigurationSupport

原理：

@EnableWebMvc注解中通过ImportSelector引入了DelegatingWebMvcConfiguration核心配置类，它也继承了WebMvcConfigurationSupport

所以如果核心配置类继承了WebMvcConfigurationSupport又同时标注@EnableWebMvc的话，自定义的SpringMVC配置可能会被覆盖掉，因为SpringMVC容器在加载配置类的时候，会优先加载@EnableWebMvc注解中引入的配置类中的配置项(DelegatingWebMvcConfiguration)作为SpringMVC生效的配置项

@Configuration @EnableWebMvc @ComponentScan("com.mayikt.controller") public class MyMvcConfig { }

 

 

监听Web容器启动，定义DispatcherServlet初始化器，在容器启动时创建DispatcherServlet并注册到ServletContext上下文中

SpringMVC注解驱动上下文AnnotationConfigWebApplicationContext和SpringIOC上下文ApplicationContext的关系：

AnnotationConfigWebApplicationContext

• AbstractRefreshableWebApplicationContext
• ConfigurableWebApplicationContext
• WebApplicationContext
• ApplicationContext

因此总的来说，SpringMVC容器可以看做是SpringIOC容器的子容器

 

 

自定义SpringMVC初始化器，初始化SpringMVC上下文，创建核心控制器DispatcherServlet

public class WebInitializer implements WebApplicationInitializer {     public void onStartup(javax.servlet.ServletContext servletContext) throws ServletException {         // 1.   创建SpringMVC容器         AnnotationConfigWebApplicationContext app = new AnnotationConfigWebApplicationContext();         // 2. 注册我们的配置文件         app.register(MyMvcConfig.class);         // 注册我们的         DispatcherServlet dispatcherServlet = new DispatcherServlet(app);         ServletRegistration.Dynamic dynamic = servletContext.addServlet("dispatcherServlet", dispatcherServlet);         dynamic.addMapping("/");         dynamic.setLoadOnStartup(1);// 最优先启动     } }

 

 

4 SpringMVC拦截器使用

拦截器(Interceptor)与过滤器(Filter)区别

拦截器和过滤器都是基于SpringAOP实现，能够对请求执行之前和之后实现拦截。

过滤器是基于Servlet容器实现，对Web请求之前和之后实现拦截

拦截器不需要依赖于Servlet、不仅可以实现Web请求还有其他方法拦截等。

 

过滤器和拦截器的区别：

1 过滤器是Tomcat自带的，拦截器是SpringMVC自带的

2 过滤器只能拦截Web请求，过滤器不仅能够拦截Web请求，还可以拦截方法执行

3 过滤器和拦截器同时生效的情况下，过滤器会优先执行

 

1. 自定义拦截器需要实现HandlerInterceptor拦截器接口，DispatcherServlet在拦截到请求之后会基于作用链调用HandlerInterceptor所有子拦截器的拦截方法，统一和HandlerMethod一起封装到了HandlerExecutionChain作用链中

HandlerInterceptor预定义了三种类型的拦截方法：

1. preHandle在业务处理器处理请求之前被调用;
2. postHandle在业务处理器处理请求执行完成后,生成视图之前执行;
3. afterCompletion在DispatcherServlet完全处理完请求后被调用(生成视图之后执行),可用于清理资源等。

注意：afterCompletion除了作为最终拦截在请求方法执行完毕且视图渲染完毕之后执行，在前置拦截不通过、请求方法执行过程中出现异常，都会在返回响应前调用afterCompletion完成对当前请求的最终拦截处理

 

自定义Token验证拦截器UserTokenInterceptor

public class TokenInterceptor implements HandlerInterceptor {     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {         System.out.println(">>>preHandle<<<");         String token = request.getParameter("token");         if (StringUtils.isEmpty(token)) {             response.getWriter().print("not find token");             return false;         }         return true;     }     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {         System.out.println(">>>>>postHandle<<<<<<<<<");     }     public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {         System.out.println(">>>afterCompletion<<<");     } }

在SpringMVC核心配置类中注入自定义拦截器，继承WebMvcConfigurationSupport并重写addInterceptors方法把自定义的拦截器加入到SpringMVC容器中

注意：

如果需要自定义SpringMVC配置，最好直接继承WebMvcConfigurationSupport，不要使用@EnableWebMvc注解(该注解表示使用默认的SpringMVC配置DelegatingWebMvcConfiguration来初始化SpringMVC容器)，否则会覆盖自定义的配置项导致无法生效，包括拦截器配置。

@Configuration @ComponentScan("com.mayikt.controller") //@EnableWebMvc public class SpringMvcConfig extends WebMvcConfigurationSupport {     @Bean     public ViewResolver viewResolver() {         InternalResourceViewResolver internalResourceViewResolver = new InternalResourceViewResolver();         // 前缀         internalResourceViewResolver.setPrefix("/WEB-INF/view/");         // 后缀         internalResourceViewResolver.setSuffix(".jsp");         return internalResourceViewResolver;     }     @Bean     public TokenInterceptor tokenInterceptor() {         return new TokenInterceptor();     }     /**      * 注册拦截器      *      * @param registry      */     public void addInterceptors(InterceptorRegistry registry) {         super.addInterceptors(registry);         registry.addInterceptor(tokenInterceptor()).addPathPatterns("/**");     }     public void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {     } }

 

注意：使用拦截器一定要关闭@EnableWebMvc 否则拦截器不会生效。

原理：

1 @EnableWebMvc表示采用默认的SpringMVC初始化配置(DelegatingWebMvcConfiguration)来启动SpringMVC容器

2 @EnableWebMvc底层会通过@Import(DelegatingWebMvcConfiguration)加载DelegatingWebMvcConfiguration这个委托配置类

此处DelegatingWebMvcConfguration也继承了WebMvcConfigurationSupport，会覆盖掉我们自定义的SpringMVC配置，这是因为SpringIOC容器在加载配置类的时候会优先加载注解定义的基于ImportSelector引入的类

 

5 SpringMVC多线程异步处理

1. 使用异步注解@EnableAsync
2. Servlet上下文开启异步支持dynamic.setAsyncSupported(true);
3. 基于Callable创建线程实现异步操作

@RequestMapping("/pay") public String pay() {     System.out.println(">>>1.开始调用pay<<<<<<< ThradName:" + Thread.currentThread().getName());     payServie.pay();     System.out.println(">>>3.结束调用pay<<<<<<< ThradName:" + Thread.currentThread().getName());     return "pay"; }

 

使用异步Callable 带返回结果

@RequestMapping(value = "/asyncPay") @ResponseBody public Callable<String> asyncPay() {     System.out.println(">>>1.开始调用pay<<<<<<< ThradName:" + Thread.currentThread().getName());     Callable callable=  new Callable<String>() {         public String call() throws Exception {             payServie.pay();             return "success";         }     };     System.out.println(">>>3.结束调用pay<<<<<<< ThradName:" + Thread.currentThread().getName());     return callable; }

dynamic.setAsyncSupported(true); 开启异步处理请求

 

6 SpringMVC容器启动和加载原理图

 

 

 

 

 

 

7 SpringMVC容器启动和加载源码分析

1. 自定义SpringMVC容器初始化器，实现WebApplicationInitializer，

WebApplicationInitializer是Web容器初始化的监听器，作用等效于ServletContainerInitializer

在监听方法onStartup中初始化SpringMVC注解驱动上下文AnnotationConfigWebApplicationContext

根据OOP继承原则，多级继承关系下构造函数的执行顺序是先执行父类构造函数，再执行子类构造函数。

此处SpringMVC注解驱动上下文AnnotationConfigWebApplicationContext继承链和构造函数执行顺序(自底向上)如下：

AnnotationConfigWebApplicationContext继承关系

• AbstractRefreshableWebApplicationContext –2 setDisplayName()
• AbstractRefreshableConfigApplicationContext
• AbstractRefreshableApplicationContext
• AbstractApplicationContext –1 PathMatchingResourcePatternResolver
• ConfigurableApplicationContext
• ApplicationContext

 

AbstractRefreshableWebAppliationContext实现的接口

• ConfigurableWebApplicationContext
• WebApplicationContext
• ApplicationContext

 

1. AnnotationConfigWebApplicationContext创建完成后，调用register()注册SpringMVC核心配置类，使SpringMVC核心配置生效

AnnotationConfigWebApplicationContext中的全局变量componentClasses存放的是需要在Web容器初始化时加载到SpringIOC容器中的SpringMVC核心配置类

 

 

1. 创建SpringMVC核心控制器DispatcherServlet，将创建好的SpringMVC注解驱动上下文AnnotationConfigWebApplicationContext传入给FrameworkServlet，注入到WebApplicationContext中

 

 

 

标记当前DispatcherServlet作为统一拦截HTTP请求并调用doService()处理请求的Servlet

 

1. 将创建好的DispatcherServlet注册到ServletContext上下文中

调用addMapping绑定拦截URL规则是默认拦截所有请求

调用setLoadOnStartup(1)标识DispatcherServlet作为优先级最高的Servlet，永远最先执行拦截。

setAsyncSupported(true)表示启用Servlet对异步处理的支持，等效于@EnableAsync

 

1. 开始执行DispatcherServlet的初始化操作，DispatcherServlet本质就是一个Servlet，依据Servlet生命周期的定义，加载和实例化都已经执行完毕，接下来开始初始化DispatcherServlet，调用init()实现初始化

DispatcherServlet在Servlet中的继承关系如下：

DispatcherServlet

• FrameworkServlet
• HttpServlet
• GenericServlet
• Servlet

 

8 DispatcherServlet初始化流程源码分析

GenericServlet init()

 

-> HttpServletBean init()

 

-> FrameworkServlet initServletBean()

 

-> initWebApplicationContext()

(1) configureAndRefreshWebApplicationContext() 加载SpringMVC核心配置类到SpringIOC容器中

加载SpringMVC核心配置类到SpringIOC容器的实现步骤：

FrameworkServlet initWebApplicationContext()

-> configureAndRefreshWebApplicationContext()

-> AbstractApplicationContext refresh()

-> obtainFreshBeanFactory()

-> AbstractRefreshableApplicationContext refreshBeanFactory()

-> AnnotationConfigWebApplicationContext loadBeanDefinitions()

-> 将注册到AnnotationConfigWebApplicationContext中的SpringMVC核心配置类componentClasses批量加载到SpringIOC容器中

AnnotatedBeanDefinitionReader regist() / ClassPathBeanDefinitionScanner scan()

 

(2) onRefresh() -> initStrategies()初始化DispatcherServlet

 

 

 

-> DispatcherServlet onRefresh()

-> initStrategies()

 

-> HandlerMapping、HandlerAdapter、HandlerExceptionResolver、ViewResolver等DispatcherServlet处理请求流程中的核心接口和类进行初始化

注意：在初始化这些DispatcherServlet处理请求过程中的核心类和接口时，会默认先从spring-webmvc包中的DispatcherServlet.properties加载对应类型指定的所有需要被加载的类，把加载后的类存放到对应集合中，如handlerMappings、handlerAdapters、viewResolvers、handlerExceptionResolvers等