Spring Boot 开发 -- 静态资源配置详解

一、引言

在开发Web应用程序时,静态资源的管理和配置是一个重要的环节。Spring Boot框架为开发者提供了便捷的静态资源配置方式,使得我们可以轻松地管理如HTML、CSS、JavaScript、图片等静态资源。本文将详细介绍如何在Spring Boot项目中配置和管理静态资源。

二、Spring Boot 静态资源默认配置

Spring Boot 默认提供了静态资源的映射位置,主要包括以下几个目录:

  • /static
  • /public
  • /resources
  • /META-INF/resources
    当我们把静态资源文件放在这些目录下时,Spring Boot会自动为它们提供HTTP访问。例如,如果我们有一个名为index.html的文件放在/static目录下,那么我们就可以通过http://localhost:8080/index.html来访问它。

三、自定义静态资源位置

虽然Spring Boot提供了默认的静态资源位置,但有时候我们可能需要自定义静态资源的位置。这可以通过配置spring.resources.static-locations属性来实现。例如,我们可以在application.properties或application.yml文件中添加以下配置:

yaml 复制代码
# application.properties  
spring.resources.static-locations=classpath:/custom-static/

或者

yaml 复制代码
# application.yml  
spring:
  resources:
    static-locations: classpath:/custom-static/

这样,Spring Boot就会从custom-static目录(位于类路径下)加载静态资源。

四、添加资源处理器

对于更复杂的静态资源需求,我们可以使用Spring MVC的ResourceHandler和ResourceResolver来定制资源处理方式。例如,我们可以为特定的URL模式添加自定义的资源处理器:

java 复制代码
@Configuration
public class ResourcesConfig implements WebMvcConfigurer {

    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        /** swagger配置 */
        registry.addResourceHandler("swagger-ui.html")
        .addResourceLocations("classpath:/META-INF/resources/");
        // 配置Webjars资源位置  
        registry.addResourceHandler("/webjars/**").
        addResourceLocations("classpath:/META-INF/resources/webjars/");
        // 配置静态资源位置  
        registry.addResourceHandler("/static/**")  
                .addResourceLocations("classpath:/static/");  
        //自定义资源路径
        registry.addResourceHandler("/myresources/**")  
                .addResourceLocations("classpath:/my-custom-resources/");
    }

在上面的配置中,我们为以/myresources/开头的URL模式添加了一个资源处理器,它将从my-custom-resources目录(位于类路径下)加载静态资源。

五、注意事项

  1. 静态资源的访问路径是相对于应用的根路径(即/),而不是相对于静态资源所在的目录。
  2. 当有多个静态资源目录时,Spring Boot会按照默认配置的顺序(/static、/public、/resources、/META-INF/resources)来查找资源。如果找到了匹配的资源,就会立即返回该资源,不会继续查找其他目录。
  3. 如果需要访问Webjars中的资源(如jQuery、Bootstrap等),可以直接通过/webjars/**来访问。Spring Boot已经为Webjars提供了默认的支持。
相关推荐
舒一笑1 小时前
PandaCoder:致敬MyBatis Log Plugin,但我们做得更极致!
后端·程序员·intellij idea
毕设源码-赖学姐2 小时前
【开题答辩全过程】以 基于Android的校园快递互助APP为例,包含答辩的问题和答案
java·eclipse
damo012 小时前
stripe 支付对接
java·stripe
麦麦鸡腿堡3 小时前
Java的单例设计模式-饿汉式
java·开发语言·设计模式
简单点了3 小时前
go前后端项目的启动 、打包和部署
开发语言·后端·golang
假客套3 小时前
Request method ‘POST‘ not supported,问题分析和解决
java
傻童:CPU3 小时前
C语言需要掌握的基础知识点之前缀和
java·c语言·算法
爱吃山竹的大肚肚3 小时前
@Valid校验 -(Spring 默认不支持直接校验 List<@Valid Entity>,需用包装类或手动校验。)
java·开发语言
雨夜之寂4 小时前
mcp java实战 第一章-第一节-MCP协议简介.md
java·后端
摇滚侠4 小时前
Spring Boot 3零基础教程,WEB 开发 Thymeleaf 核心语法 笔记39
spring boot·笔记·后端·thymeleaf