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应用的性能和资源管理。