25、web场景-【源码分析】-静态资源原理
静态资源原理主要涉及Spring Boot如何管理和提供静态文件,如CSS、JavaScript、图片等。以下是详细的分析:
默认静态资源目录
Spring Boot默认将以下目录作为静态资源的存放位置:
-
`classpath:/META-INF/resources/`
-
`classpath:/resources/`
-
`classpath:/static/`
-
`classpath:/public/`
这意味着,只要将静态资源放在这些目录下的任意一个,就可以通过浏览器直接访问,例如:`http://localhost:8080/文件名\`。
静态资源访问原理
- **请求处理流程**
-
当收到HTTP请求时,Spring Boot首先检查是否有对应的Controller能够处理该请求。
-
如果Controller无法处理(例如,请求路径没有对应的`@RequestMapping`),则将请求交给静态资源处理器。
-
静态资源处理器按照默认的目录顺序查找匹配的静态资源。
-
如果找到,则返回该资源;如果未找到,则返回404错误。
- **静态资源映射**
- 静态资源处理器通过`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应用的性能和资源管理。