25、web场景-【源码分析】-静态资源原理
25、web场景-【源码分析】-静态资源原理
静态资源原理主要涉及Spring Boot如何管理和提供静态文件,如CSS、JavaScript、图片等。以下是详细的分析:
#### 默认静态资源目录
Spring Boot默认将以下目录作为静态资源的存放位置:
- `classpath:/META-INF/resources/`
- `classpath:/resources/`
- `classpath:/static/`
- `classpath:/public/`
这意味着,只要将静态资源放在这些目录下的任意一个,就可以通过浏览器直接访问,例如:`http://localhost:8080/文件名`。
#### 静态资源访问原理
1. **请求处理流程**
- 当收到HTTP请求时,Spring Boot首先检查是否有对应的Controller能够处理该请求。
- 如果Controller无法处理(例如,请求路径没有对应的`@RequestMapping`),则将请求交给静态资源处理器。
- 静态资源处理器按照默认的目录顺序查找匹配的静态资源。
- 如果找到,则返回该资源;如果未找到,则返回404错误。
2. **静态资源映射**
- 静态资源处理器通过`ResourceHttpRequestHandler`实现,其映射路径为`/**`,即匹配所有未被Controller处理的请求。
#### 自定义静态资源配置
可以通过`application.properties`或`application.yml`配置文件修改静态资源的配置:
- **修改访问路径**
```yaml
spring.mvc.static-path-pattern: /res/**
```
配置后,访问静态资源需加上`/res`前缀,如:`http://localhost:8080/res/文件名`。
- **添加自定义资源目录**
```yaml
spring.resources.static-locations: classpath:/myresources/
```
新增`classpath:/myresources/`目录作为静态资源查找路径。
#### WebJars支持
Spring Boot支持通过WebJars以jar包形式管理前端库:
- **引入依赖**
```xml
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.5.1</version>
</dependency>
```
- **访问资源**
访问路径为`/webjars/库名/版本号/资源路径`,例如:`http://localhost:8080/webjars/jquery/3.5.1/jquery.js`。
#### 欢迎页与Favicon
- **欢迎页**
- 在静态资源目录下放置`index.html`,访问根路径时会自动显示该页面。
- **Favicon**
- 将`favicon.ico`放在任意静态资源目录下,浏览器会自动加载。
#### 禁用默认静态资源处理
可以通过配置禁用Spring Boot的默认静态资源处理:
- **配置方式**
```yaml
spring.web.resources.add-mappings: false
```
禁用后,需要自行实现静态资源的处理逻辑。
#### 总结
- Spring Boot通过默认配置简化了静态资源的管理,自动映射到指定目录。
- 可以通过配置灵活调整静态资源的访问路径和存储位置。
- 支持WebJars,方便管理前端库。
- 理解静态资源的处理原理有助于优化Web应用的性能和资源管理。