SpringBoot：web静态资源配置

待我称王封你为后i 2022-12-16 03:53 219阅读 0赞

> 引言：  
> SpringBoot web项目开发中往往会涉及到一些静态资源的使用，比如说图片，css样式，js等等，今天我们来讲讲这些常见的静态资源应该放在哪个位置，怎么放在自己想放的位置。

**1、 项目创建**

我们先创建一个空的项目，项目的依赖配置为starter-web依赖，创建好的项目下面有一个resources文件夹，里面有一些空的默认的文件夹，然后有一个配置文件。  
![在这里插入图片描述][20201018142629479.png_pic_center]  
templates文件下面一般是放置模板页面的，比如html，jsp之类的，static文件一般是是放置静态资源，比如说，图片，文件等等。

我们放置了文件或者是图片就需要访问这个文件，看看怎么才能有效的实现访问这些静态资源文件，以及自己访问自己定义好的资源访问路径。

**2、资源文件访问与配置**

一般来说，我们是做前后端分离的，Springboot就作为后端，但是Springboot依然支持有html文件等，实现前后端在一个项目里面。也就是Springboot web项目。

首先，我们在templates文件夹下面创建一个名为index的html5页面，然后随便写一点东西，然后在配置文件中，配置一个项目启动端口。

html5文件  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center]  
配置文件端口配置不再讲解，前一期里面有配置文件详解，不会的可以回去看看。  
启动项目，浏览器输入：localhost:8088/index.html  
你会发现页面是404，这时候我们是访问不了这个页面的。然后你可能会说localhost:8088/templates/index.html，你会发现都不行都不行！

因为Springboot的默认资源配置里面没有这个templates路径，但是有static路径。

**（1）Springboot中默认的静态资源路径：**

1.  classpath:/static；
2.  classpath:/public；
3.  classpath:/resources；
4.  classpath:/META-INF/resources

classpath 在项目中就相当于src/main/resources文件夹.

就是说如果你把html文件直接放在static路径下面是可以直接访问的，有两种访问方式。

当你添加了start-web的依赖，resources下面是会默认生成一个static文件夹以及templates文件夹。

**（2）自定义静态资源路径。**

spring.resources.static-locations=classpath:templates/

我们配置了静态资源路径映射之后，我们只能访问这个路径下面的资源，也就是相当于自定义了静态资源路径，就是说默认的静态资源路径都会失效。

**（3）两种访问静态资源的方式**

一种是直接通过特定的URL访问：我们配置好后，启动项目，浏览器输入：localhost:8088/index.html 就可以正常访问我们的静态资源了。  
效果图如下：  
![在这里插入图片描述][20201018143227749.jpg_pic_center]  
然后还有一种访问资源的方法。是使用代码是实现的。

我们在和启动文件同级目录下面创建一个controller文件夹，然后创建一个Testcontroller,代码如下：

/** * @author 全栈学习笔记 * @date 2020/4/12 12:20 * @description */
    @Controller
    public class TestController { 
        @RequestMapping("/getHtml")
        public String getHtml(){ 
            return "index.html";
        }
    }

> 说明：这个@Controller ，意思标记这个类为控制类，或者说他是一个Springmvc controller对象，标记之后，默认这个类的所有方法返回的是一个页面。然后这个@RequestMapping的注解是一个用来处理请求地址映射的注解，可用于类或方法上。用于方法之上时，你可以通过URL直接访问这个方法。想要更多SpringBoot的学习资料，或者需要其他方面的Java学习资料的，可以[点击进入，暗号：cshh][cshh]，免费提供！

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]

到这里，我们就可以利用自定义URL访问静态资源了。在浏览器里面输入：localhost:8088/getHtml 也能正常访问静态资源。图片也是一样的。

**3、其他静态资源路径配置方式**

**（1）继承WebMvcConfigurerAdapter**

我们通过重写这个类的addResourceHandlers方法，定义资源路径

/** * @author 全栈学习笔记 * @date 2020/4/12 15:46 * @description */
    @Configuration
    public class WebConfig extends WebMvcConfigurerAdapter { 
        @Override
        public void addResourceHandlers(ResourceHandlerRegistry registry) { 
            registry.addResourceHandler("/**").addResourceLocations("/","classpath:templates/");
            super.addResourceHandlers(registry);
        }
    }

**（2）优化配置**

你会看到之前的那种利用代码的URL路径访问静态资源文件的写法，我们需要在返回的地方写上文件的名称以及文件的后缀名，当我们要返回某一类型的文件时，这样写就相对比较麻烦，所以我们可以通过以下配置来解决这个问题。

#加前缀
    spring.mvc.view.prefix=/
    #加后缀
    spring.mvc.view.suffix=.html

通过以上的配置，我们之前的controller里面的方法返回就可以写成这样。

@RequestMapping("/getHtml")
        public String getHtml(){ 
            return "index";
        }

**总结：**

静态资源配置路径的两种常用方式： 一种是默认配置，一种是自定义配置，自定义配置可以是代码配置，可以是配置文件里面配置。这两种配置方式都会使原来默认的配置方式失效。

静态资源的访问方式有两种：一种是自己用代码定义路径，然后访问，一种是直接利用特定的URL方式访问静态资源。

> 这还有大量的就Java学习资料以及面试资料，有需要的可以[点击进入，暗号：cshh][cshh 1]，都可以免费领取！

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center 1]  
祝大家都能工作顺利哦！

[20201018142629479.png_pic_center]: /images/20221123/0c927759620e45eb8c99bdd0863c3086.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center]: /images/20221123/a3777952c8f4407db974fd26b815bcc7.png
[20201018143227749.jpg_pic_center]: /images/20221123/1e33d1ffca064c2e9f4133428e16b7d5.png
[cshh]: https://jq.qq.com/?_wv=1027&k=haDxkyFi
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_16_color_FFFFFF_t_70_pic_center]: /images/20221123/7926ad66a7d845eb9b02a880594b6792.png
[cshh 1]: https://jq.qq.com/?_wv=1027&k=9SuU2CLr
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L20wXzQ1MjcwNjY3_size_1_color_FFFFFF_t_70_pic_center 1]: /images/20221123/b67dc8097001406e826f4b1b5d4b6436.png