在springboot项目中,对静态资源的映射规则, 可通过分析 WebMvcAutoConfiguration(这个类是SpringBoot的底层类,位于:package org.springframework.boot.autoconfigure.web.servlet;) 自动配置类得到
webjars资源映射
WebMvcAuotConfiguration.addResourceHandlers() 分析webjars 资源映射
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
if (!this.resourceProperties.isAddMappings()) {
logger.debug("Default resource handling disabled");
return;
}
Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
CacheControl cacheControl = this.resourceProperties.getCache()
.getCachecontrol().toHttpCacheControl();
if (!registry.hasMappingForPattern("/webjars/**")) {
//这里表示:当项目收到 /webjars/** 请求后,会去 classpath:/MATE-INF/resources/webjars/ 下去查找资源文件
customizeResourceHandlerRegistration(registry
.addResourceHandler("/webjars/**")
.addResourceLocations("classpath:/META-INF/resources/webjars/")
.setCachePeriod(getSeconds(cachePeriod))
.setCacheControl(cacheControl));
}
String staticPathPattern = this.mvcProperties.getStaticPathPattern();
if (!registry.hasMappingForPattern(staticPathPattern)) {
customizeResourceHandlerRegistration(
registry.addResourceHandler(staticPathPattern)
.addResourceLocations(getResourceLocations(
this.resourceProperties.getStaticLocations()))
.setCachePeriod(getSeconds(cachePeriod))
.setCacheControl(cacheControl));
}
}
所以,所有 /webjars/** 请求,都去 classpath:/META-INF/resources/webjars/ 目录找对应资源文件,webjars是以jar包的方式来引入静态资源,例如:
<!--引入 jquery3.3.1 webjars -->
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.3.1</version>
</dependency>
添加上面的依赖之后,就会引入一个 jquery-3.3.1 的jar包,在jar包的
MATE-INF/resources/webjars/jquery/3.3.1/ 下面有一个jquery.js文件,此时可以直接通过访问项目:localhost:8080/webjars/jquery/3.3.1/jquery.js 来访问jquery.js文件,因为是通过webjars方式来映射资源,所以 /webjars/** 请求就相当于 /META-INF/resources/webjars/
其他静态资源映射
在springboot项目中,当接收到 /** 请求访问资源时,会被映射到下面的4个类路径下的静态资源目录下查找:
classpath:/META-INF/resources/
classpath:/resources/
classpath:/static/
classpath:/public/
查找顺序从上往下查找,查找到就返回,查找不到就返回 404,例如,在 classpath:/static/ 文件夹下添加style.css,启动项目后就可以直接访问:localhost:8080/style.css
欢迎页映射
springboot项目,会从 4个静态资源目录 + 根路径 / 中 查找 index.html 页面作为欢迎页(**注意:**一定是index.html)
classpath:/META-INF/resources/
classpath:/resources/
classpath:/static/
classpath:/public/
/: 当前项目根路径下
会在 静态资源目录下 与 根路径查找 (按该顺序) index.html页面;
请求映射访问 localhost:8080/ 会在上面5个目录中查找 index.html 页面(因为/也属于 /** )
图标映射
Spring Boot 会在静态资源目录下 与 根路径(按该顺序) 查找 favicon.ico (注意:名称一定要是 favicon.ico)
classpath:/META-INF/resources/
classpath:/resources/
classpath:/static/
classpath:/public/
/: 当前项目根路径下
在哪个文件夹中找到了,就会直接返回