Spring Boot靜態資源處理機制

Spring Boot 是一個用于簡化 Spring 應用程序開發的框架，它提供了許多自動配置和約定優于配置的特性。在 Spring Boot 中，靜態資源處理機制非常靈活，可以根據項目需求進行定制。

1. 靜態資源目錄結構

Spring Boot 默認將靜態資源文件存儲在以下目錄中：

• /static
• /public
• /resources
• /META-INF/resources

這些目錄下的文件可以直接通過 URL 訪問。例如，如果你的靜態資源文件位于 /static 目錄下，你可以通過 http://localhost:8080/your-file-name 訪問它。

2. 自定義靜態資源目錄

如果你需要將靜態資源文件存儲在其他目錄中，可以在 application.properties 或 application.yml 文件中配置靜態資源目錄的路徑。例如：

# application.properties
spring.resources.static-locations=classpath:/custom-static/,file:/custom-static/

# application.yml
spring:
  resources:
    static-locations: classpath:/custom-static/,file:/custom-static/

這樣，你就可以將靜態資源文件存儲在 /custom-static 目錄下，并通過相同的 URL 訪問它們。

3. 靜態資源處理器

Spring Boot 提供了一個名為 ResourceHandler 的接口，用于處理靜態資源請求。你可以自定義一個 ResourceHandler 實現類，以處理特定的靜態資源請求。例如：

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("/custom/**")
                .addResourceLocations("classpath:/custom-static/")
                .resourceChain(true)
                .addResolver(new PathResourceResolver() {
                    @Override
                    protected Resource getResource(String resourcePath, Resource location) throws IOException {
                        if (resourcePath.startsWith("/custom/")) {
                            return new UrlResource(location.getURL().toURI().toURL());
                        }
                        return null;
                    }
                });
    }
}

在這個例子中，我們為 /custom/** 路徑下的靜態資源請求添加了一個自定義的 ResourceHandler。當請求匹配到這個路徑時，它將首先嘗試從 /custom-static/ 目錄下查找資源。如果找到了資源，它將使用 UrlResource 將資源轉換為 URL，然后返回給客戶端。

4. 靜態資源緩存控制

為了提高性能，你可以為靜態資源設置緩存控制頭。在 application.properties 或 application.yml 文件中配置緩存控制頭，例如：

# application.properties
spring.mvc.static-path-pattern=/static/**
spring.resources.cache.cachecontrol.max-age=3600

# application.yml
spring:
  mvc:
    static-path-pattern: /static/**
  resources:
    cache:
      cachecontrol:
        max-age: 3600

這將使得所有 /static/** 路徑下的靜態資源具有 1 小時的緩存控制頭。

總之，Spring Boot 的靜態資源處理機制非常靈活，可以根據項目需求進行定制。你可以通過配置靜態資源目錄、自定義靜態資源處理器以及設置緩存控制頭等方法，來滿足不同的靜態資源處理需求。