SpringApplication.run(xxx.class, args)背后的东东——实现原理
现在springboot已经成为web应用开发的事实标准,所以为了能更好的应用springboot特性,有必要深入研究下背后的实现原理。
在分析之前,先抛出几个问题,后续章节也是围绕解决这几个问题展开:
1、springboot是如何依赖几个注解就零配置启动spring容器?
2、springboot开发出来的jar,如何实现内嵌tomcat?
3、springboot开发经常用到的springmvc中的dispathservlet是如何关联到内嵌tomcat?
首先咱们直接从main方法上的 @SpringBootApplication 组合注解开始,里面实现零配置的注解就是 @EnableAutoConfiguration ,它利用 @Import 一个 AutoConfigurationImportSelector,该类主要利用类SPI的机制,获取META-INFO下面需要自动装配的 @Configuration,至于SPI后续将详细介绍。
说到这里,估计大家会有一个疑问,springboot如何一开始就知道这个重要 @Import 注解呢,肯定有个注解解析的地方,下面需要说的就是spring容器的启动(跟着main方法走):
context = this.createApplicationContext()
这里是创建重要的ApplicationContext,其实就是BeanFactory,不过springboot会自动推断创建针对servlet应用的 AnnotationConfigServletWebServerApplicationContext。
org.springframework.context.support.AbstractApplicationContext#refresh
熟悉spring源码的同学就会知道,这里就是刷新容器的地方,
org.springframework.context.support.AbstractApplicationContext#invokeBeanFactoryPostProcessors
org.springframework.context.annotation.ConfigurationClassParser#processImports
这个方法里面就有对 @Import 注解做解析
解析逻辑比较复杂,有兴趣可以自己看下,说白了就是开头讲的找到需要自动装配的 @Configuration 对应的类,这里列出来三个重要的如下:
@Configuration(proxyBeanMethods = false)
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
ValidationAutoConfiguration.class })
public class WebMvcAutoConfiguration {
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
@Configuration(proxyBeanMethods = false)
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass(DispatcherServlet.class)
@AutoConfigureAfter(ServletWebServerFactoryAutoConfiguration.class)
public class DispatcherServletAutoConfiguration {
@Configuration(proxyBeanMethods = false)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE)
@ConditionalOnClass(ServletRequest.class)
@ConditionalOnWebApplication(type = Type.SERVLET)
@EnableConfigurationProperties(ServerProperties.class)
@Import({ ServletWebServerFactoryAutoConfiguration.BeanPostProcessorsRegistrar.class,
ServletWebServerFactoryConfiguration.EmbeddedTomcat.class,
ServletWebServerFactoryConfiguration.EmbeddedJetty.class,
ServletWebServerFactoryConfiguration.EmbeddedUndertow.class })
public class ServletWebServerFactoryAutoConfiguration {
其实这三个都是通过 @AutoConfigureAfter 依赖关系加载的,加载这些的目的就是为了getBean时可以拿到具体的实例对象。
咱们再回到刷新spring器中的方法中
org.springframework.context.support.AbstractApplicationContext#onRefresh
该方法对应servlet的实现是
org.springframework.boot.web.servlet.context.ServletWebServerApplicationContext#onRefresh
里面就是创建WebServer,可以理解为就是咱们的tomcat,不过它是由工厂方法创建的
protected ServletWebServerFactory getWebServerFactory() {
String[] beanNames = this.getBeanFactory().getBeanNamesForType(ServletWebServerFactory.class);
核心代码来了,这里就会触发getBean,去拿到 ServletWebServerFactory的实例,也就会触发Bean的生命周期调用,
@Configuration(proxyBeanMethods = false)
class ServletWebServerFactoryConfiguration {
@Configuration(proxyBeanMethods = false)
@ConditionalOnClass({ Servlet.class, Tomcat.class, UpgradeProtocol.class })
@ConditionalOnMissingBean(value = ServletWebServerFactory.class, search = SearchStrategy.CURRENT)
static class EmbeddedTomcat {
@Bean
TomcatServletWebServerFactory tomcatServletWebServerFactory(
ObjectProvider<TomcatConnectorCustomizer> connectorCustomizers,
ObjectProvider<TomcatContextCustomizer> contextCustomizers,
ObjectProvider<TomcatProtocolHandlerCustomizer<?>> protocolHandlerCustomizers) {
TomcatServletWebServerFactory factory = new TomcatServletWebServerFactory();
factory.getTomcatConnectorCustomizers()
.addAll(connectorCustomizers.orderedStream().collect(Collectors.toList()));
factory.getTomcatContextCustomizers()
.addAll(contextCustomizers.orderedStream().collect(Collectors.toList()));
factory.getTomcatProtocolHandlerCustomizers()
.addAll(protocolHandlerCustomizers.orderedStream().collect(Collectors.toList()));
return factory;
}
}
其实就是到这里来获取 TomcatServletWebServerFactory 实例,这个也就是前面自动配置 @Import扫描出来的 ServletWebServerFactoryAutoConfiguration 导入的beandefinition
这个工厂实现了 ErrorPageRegistry 接口
org.springframework.boot.web.server.ErrorPageRegistry
而ServletWebServerFactory在getBean的生命周期中会触发BeanPostProcessor实现类的调用
public class ErrorPageRegistrarBeanPostProcessor implements BeanPostProcessor, BeanFactoryAware {
private ListableBeanFactory beanFactory;
private List<ErrorPageRegistrar> registrars;
@Override
public void setBeanFactory(BeanFactory beanFactory) {
Assert.isInstanceOf(ListableBeanFactory.class, beanFactory,
"ErrorPageRegistrarBeanPostProcessor can only be used with a ListableBeanFactory");
this.beanFactory = (ListableBeanFactory) beanFactory;
}
@Override
public Object postProcessBeforeInitialization(Object bean, String beanName) throws BeansException {
if (bean instanceof ErrorPageRegistry) {
postProcessBeforeInitialization((ErrorPageRegistry) bean);
}
return bean;
}
也就是实例化 TomcatServletWebServerFactory 之前,会去先实例化 ErrorPageRegistrar
private Collection<ErrorPageRegistrar> getRegistrars() {
if (this.registrars == null) {
// Look up does not include the parent context
this.registrars = new ArrayList<>(
this.beanFactory.getBeansOfType(ErrorPageRegistrar.class, false, false).values());
this.registrars.sort(AnnotationAwareOrderComparator.INSTANCE);
this.registrars = Collections.unmodifiableList(this.registrars);
}
return this.registrars;
}
跟着代码,实例化 ErrorPageRegistrar 又会先去实例化 DispatcherServletPath,它只有一个实现类 DispatcherServletRegistrationBean
protected ErrorPageCustomizer(ServerProperties properties, DispatcherServletPath dispatcherServletPath) {
this.properties = properties;
this.dispatcherServletPath = dispatcherServletPath;
}
public DispatcherServletRegistrationBean(DispatcherServlet servlet, String path) {
super(servlet);
Assert.notNull(path, "Path must not be null");
this.path = path;
super.addUrlMappings(getServletUrlMapping());
}
这里就看到熟悉的 DispatcherServlet了,有人可能会问,DispatcherServlet哪里来的?其实又要回到前面扫描处理的三个自动装配类中的 DispatcherServletAutoConfiguration
至此,我们终于通过spring容器的启动,将DispatcherServlet实例化出来了,同理负责创建tomcat容器的TomcatServletWebServerFactory也实例化出来了。
下面就是负责创建内嵌tomcat了,以及建立tomcat与DispatcherServlet实例的关联
org.springframework.boot.web.embedded.tomcat.TomcatServletWebServerFactory#getWebServer
tomcat容器启动后,因为它实现了servlet规范,内部会回调实现了所有实现了ServletContainerInitializer类的onStartup方法
javax.servlet.ServletContainerInitializer#onStartup
具体代码需要关联tomcat源码,这里只是简单记录下,后续再深入分析tomcat实现原理
org.apache.catalina.core.StandardContext#startInternal
while(var27.hasNext()) {
Entry entry = (Entry)var27.next();
try {
((ServletContainerInitializer)entry.getKey()).onStartup((Set)entry.getValue(), this.getServletContext());
} catch (ServletException var22) {
log.error(sm.getString("standardContext.sciFail"), var22);
ok = false;
break;
}
}
而TomcatStarter正好实现了ServletContainerInitializer接口,所以tomcat启动会触发这个方法的调用
org.springframework.boot.web.embedded.tomcat.TomcatStarter#onStartup
方法内部调用了spring中实现了ServletContextInitializer接口的类的onStartup方法,恰好又是DispatcherServletRegistrationBean,而它的父类RegistrationBean就将DispatcherServlet绑定到tomcat容器的ServletContext上了
org.springframework.boot.autoconfigure.web.servlet.DispatcherServletRegistrationBean
org.springframework.boot.web.servlet.RegistrationBean#onStartup
最后,tomcat容器启动了,spring容器也启动了,访问tomcat的请求也可以通过关联的DispatcherServlet进行分发处理了,咱们前面的三个问题也应该有答案了。

浙公网安备 33010602011771号