默认静态资源处理
Spring Boot 默认为我们提供了静态资源处理,使用 WebMvcAutoConfiguration 中的配置各种属性。
建议大家使用 Spring Boot 的默认配置方式,如果需要特殊处理的再通过配置进行修改。
如果想要自 己 完 全 控 制 WebMVC ,就需要在 @Configuration 注解的配置类上 增 加 @EnableWebMvc
( @SpringBootApplication 注解的程序入 口 类 已 经 包 含 @Configuration ), 增 加 该 注 解 以 后
WebMvcAutoConfiguration 中配置就不会生效,你需要自己来配置需要的每一项。这种情况下的配置还是要多看
一下 WebMvcAutoConfiguration 类。
我们既然是快速使用 Spring Boot,并不想过多的自己再重新配置。本文还是主要针对 Spring Boot 的默认处理方
式,部分配置在 application 配置文件中(.properties 或 .yml)
默认资源映射
我们在启动应用的时候,可以在控制台中看到如下信息:
2016-01-08 09:29:30.362 INFO 24932 ---[ main]o.s.w.s.handler.SimpleUrlHandlerMapping :
MappedURLpath[/webjars/**]ontohandleroftype[class
org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2016-01-08 09:29:30.362 INFO 24932 ---[ main]o.s.w.s.handler.SimpleUrlHandlerMapping :
MappedURLpath[/**]ontohandleroftype[class
org.springframework.web.servlet.resource.ResourceHttpRequestHandler]
2016-01-08 09:29:30.437 INFO 24932 ---[ main]o.s.w.s.handler.SimpleUrlHandlerMapping :
MappedURLpath[/**/favicon.ico]ont
其中默认配置的 /** 映射到 /static (或/public、/resources、/META-INF/resources)
其中默认配置的 /webjars/** 映射到 classpath:/META-INF/resources/webjars/
PS:上面的 static、public、resources 等目录都在 classpath: 下面(如 src/main/resources/static)。
如果我按如下结构存放相同名称的图片,那么 Spring Boot 读取图片的优先级是怎样的呢?
如下图:
当我们访问地址
http://localhost:8080/test.jpg
的时候,显示哪张图片?这里可以直接告诉大家,优先级顺序为:
META/resources > resources > static > public
(
已进行测试
)
如果我们想访问
test2.jpg
,请求地址
http://localhost:8080/img/test2.jpg
自定义静态资源处理
面我们介绍了
Spring Boot
的默认资源映射,一般够用了,那我们如何自定义目录?
这些资源都是打包在
jar
包中的,然后实际应用中,我们还有很多资源是在管理系统中动态维护的,并不可能在
程序包中,对于这种随意指定目录的资源,如何访问?
自定义目录
以增加 /myres/
*
映射到
classpath:/myres/*
为例的代码处理为:
实现类继承 WebMvcConfigurerAdapter 并重写方法 addResourceHandlers (对于访问 myres 文件夹中的
test.jpg 图片的地址为
http://localhost:8080/myres/test.jpg
package org
.springboot.sample.config
;
import org
.springboot.sample.interceptor.MyInterceptor
1
;
import org
.springboot.sample.interceptor.MyInterceptor
2
;
import org
.springframework.context.annotation.Configuration
;
import org
.springframework.web.servlet.config.annotation.InterceptorRegistry
;
import org
.springframework.web.servlet.config.annotation.ResourceHandlerRegistry
;
import org
.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter
;
@Configuration
public class MyWebAppConfigurer
extends WebMvcConfigurerAdapter {
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry
.addResourceHandler
(
"/myres/**"
)
.addResourceLocations
(
"classpath:/myres/"
)
;
super
.addResourceHandlers
(registry)
;
}
}
访问 myres 文件夹中的 test.jpg 图片的地址为
http://localhost:8080/myres/test.jpg
这样使用代码的方式自定义目录映射,并不影响 Spring Boot 的默认映射,可以同时使用。
如果我们将/myres/
*
修改为
/*
与默认的相同时,则会覆盖系统的配置,可以多次使用 addResourceLocations 添
加目录,优先级先添加的高于后添加的。
其 中 addResourceLocations 的 参 数 是 动 参 ,可以这 样 写 addResourceLocations(“classpath:/img1/”,
“classpath:/img2/”, “classpath:/img3/”);
使用外部目录
如果我们要指定一个绝对路径的文件夹(如 D:/data/api_files ),则只需要使用 addResourceLocations 指定即可。
//
可以直接使用
addResourceLocations
指定磁盘绝对路径,同样可以配置多个位置,注意路径写法需要
加上
file:
registry
.addResourceHandler
(
"/api_files/**"
)
.addResourceLocations
(
"file:D:/data/api_files"
)
;