Springboot 使用外部 Tomcat
- 修改 pom.xml皱埠,改為打 war 包
<packaging>war</packaging>
- 將 Springboot 內(nèi)置 tomcat 作用域改為
provided
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-tomcat</artifactId>
<scope>provided</scope>
</dependency>
- 重寫 SpringBootServletInitializer
@SpringBootApplication
public class Bootstrap extends SpringBootServletInitializer {
public static void main(String[] args) {
SpringApplication.run(Bootstrap.class, args);
}
@Override
protected SpringApplicationBuilder configure(SpringApplicationBuilder builder) {
return builder.sources(Bootstrap.class);
}
}
- maven 打包出 war 包后,放到 tomcat 的 webapps 目錄下即可愧哟。
如果要訪問該 war 包的接口,默認(rèn)需要在 url 加項目名作為前綴,例如:http://localhost:8080/{項目名}/users/123456
原理分析
ServletContainerInitializer
Servlet 容器啟動時,會掃描當(dāng)前應(yīng)用每個 jar 包路徑META-INF\services
下的文件javax.servlet.ServletContainerInitializer
拾并,其文件內(nèi)容就是 ServletContainerInitializer 的實現(xiàn)類全類名,并調(diào)用其 onStartup() 方法。比如嗅义,在 Spring-web 包下个榕,該文件內(nèi)容就是org.springframework.web.SpringServletContainerInitializer
,其源碼如下:
// 容器啟動時芥喇,將 WebApplicationInitializer 的所有子類傳遞至 webAppInitializerClasses
@HandlesTypes(WebApplicationInitializer.class)
public class SpringServletContainerInitializer implements ServletContainerInitializer {
/**
* @param webAppInitializerClasses @HandlesTypes 導(dǎo)入的類
* @param servletContext 當(dāng)前 web 應(yīng)用 servlet 上下文
*/
@Override
public void onStartup(@Nullable Set<Class<?>> webAppInitializerClasses, ServletContext servletContext) throws ServletException {
List<WebApplicationInitializer> initializers = new LinkedList<>();
for (Class<?> waiClass : webAppInitializerClasses) {
// 過濾出可用的 WebApplicationInitializer
if (!waiClass.isInterface() && !Modifier.isAbstract(waiClass.getModifiers()) && WebApplicationInitializer.class.isAssignableFrom(waiClass)) {
initializers.add((WebApplicationInitializer)ReflectionUtils.accessibleConstructor(waiClass).newInstance());
}
}
for (WebApplicationInitializer initializer : initializers) {
initializer.onStartup(servletContext);
}
}
}
容器啟動時,執(zhí)行 SpringServletContainerInitializer.onStartup() 方法凰萨,@HandlesTypes 注解聲明了 WebApplicationInitializer 的所有子類(在前面的示例中继控,啟動類 Bootstrap 實現(xiàn)的 SpringBootServletInitializer 就是它的一個實現(xiàn))會被傳遞給方法的參數(shù) webAppInitializerClasses。
onStartup() 方法會過濾出 webAppInitializerClasses 中可用的 WebApplicationInitializer 子類 Bootstrap胖眷,然后回調(diào) SpringBootServletInitializer 的 onStartup() 方法武通,其源碼如下:
public void onStartup(ServletContext servletContext) throws ServletException {
WebApplicationContext rootAppContext = createRootApplicationContext(servletContext);
}
protected WebApplicationContext createRootApplicationContext(ServletContext servletContext) {
SpringApplicationBuilder builder = createSpringApplicationBuilder();
// 指定主類 Bootstrap
builder.main(getClass());
// 回調(diào) Bootstrap 重寫的方法
builder = configure(builder);
return run(builder.build());
}
這個方法會配置當(dāng)前 web 應(yīng)用程序上下文環(huán)境:指定主類、注冊 servletContext珊搀、調(diào)用 configure()冶忱、run 運(yùn)行。
由于 Bootstrap 重寫了 configure()境析,所以會執(zhí)行重寫的方法來指定主類囚枪,最后通過 run 來完成啟動 Springboot 應(yīng)用。