SpringBoot中配置Web静态资源路径的方法

更新时间：2020年09月16日 09:57:39 作者：wangxin1949

这篇文章主要介绍了SpringBoot中配置Web静态资源路径的方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧

介绍：本文章主要针对web项目中的两个问题进行详细解析介绍：1- 页面跳转404，即controller转发无法跳转页面问题；2- 静态资源文件路径问题。

项目工具： Intelij Idea, JDK1.8, SpringBoot 2.1.3

正文：

准备工作：通过Idea创建一个SpringBoot-web项目，此过程不做赘述，创建完成后项目结构如下图：

1- 创建一个controller代码如下：

package com.example.webpractice.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class DemoController {

  @RequestMapping("demo")
  public String demo() {
    System.out.println("进入controller中的demo方法！");
    /*注意：这里返回值有后缀名，如何省略后缀名后面有介绍*/
    return "myPage.html";
  }
}

2- 在 web-practice\src\main\resources\templates\路径下创建html页面，取名“myPage”,代码如下：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
  <h1>Welcome to myPage!</h1>
</body>
</html>

此时运行项目，会发现报404问题，同时查看Idea控制台，打印显示进入controller方法。

3- spring.resources.static-location登场

打开application.yml文件，进行如下配置（默认项目中配置文件为application.properties,修改后缀名即可，因我个人喜欢使用yml文件）,重新运行项目并访问地址：localhost:8080/demo 会发现页面跳转成功。

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

原因分析：spring.resources.static-location参数指定了Spring Boot-web项目中静态文件存放地址，该参数默认设置为：classpath:/static,classpath:/public,classpath:/resources,classpath:/META-INF/resources,servlet context:/，可以发现这些地址中并没有/templates这个地址。当配置文件中配置此项后，默认配置失效，使用自定义设置。这里涉及到两个概念：

（1）classpath: 通俗来讲classpath对应的项目中：web-practice\src\main\resources 文件目录。如：“classpath: templates/” 即是将resources目录下的templates文件夹设置为静态文件目录。更深一步讲classpath路径为：文件编译后在target/classes目录下的文件。

（2）静态文件目录：通俗理解为存放包括：.html；.jsp；CSS；js；图片；文本文件等类型文件的目录。这些文件都可以通过浏览器url进行访问。同时controller中转发的文件目录也必须被设置为静态文件目录，这就是增加了该参数以后就可以正常访问的原因。

4- spring.mvc.view.prefix/suffix登场

现在页面已经可以正常转发，我们有了新的想法，我希望在templates文件夹中创建一个html文件夹用于专门存放页面文件，另外在每次使用controller进行转发是都要标明后缀名.html,这很麻烦，有没有统一处理的方案，答案当然是有！

修改后项目结构如下：

controller方法修改如下：

package com.example.webpractice.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class DemoController {

  @RequestMapping("demo")
  public String demo() {
    System.out.println("进入controller中的demo方法！");
    //如果不在appliation.yml文件中添加前后缀信息，此处返回语句为
    //return "html/myPage.html"
    return "myPage";
  }
}

application.yml文件修改如下：

spring:
 resources:
  static-locations: classpath:templates/
 mvc:
  view:
   prefix: html/
   suffix: .html

再次运行项目即可。通过测试得知prefix/suffix是在controller返回语句前后添加前后缀信息。

5- 配置多个静态文件路径：当我们在页面中添加图片，并且将图片存放在resources/static/pic路径下，如下图所示：

修改myPage.html如下：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
  <h1>Welcome to myPage!</h1>
  <img src="/pic/pig.jpg" height="1920" width="1080"/></body>
</html>

之后重启项目，会发现图片并没有成功加载！如下：

原因是之前我们配置的静态文件目录只包含classpath:templates/,static目录还不是合法的存储静态文件目录，我们只需要在后面追加上static目录即可。修改application.yml文件如下：

spring:
 resources:
  static-locations: classpath:templates/,classpath:static/
 mvc:
  view:
   prefix: html/
   suffix: .html

修改后重启项目刷新页面，一切正常！

6- 关于spring.mvc.view.static-path-pattern

该参数用来规定访问静态文件的路径格式,该参数默认值为：“/**” 表示所有路径，现将该参数修改为:“/static/**” 观察现象

spring:
 resources:
  static-locations: classpath:templates/,classpath:static/
 mvc:
  view:
   prefix: html/
   suffix: .html
  static-path-pattern: /static/**

重启项目，发现页面不能加载404错误！

要解决该问题需要修改两个地方：

（1）修改spring.mvc.view.prefix参数值为：static/html/ ；该修改为了controller转发时可以找到文件路径；

（2）修改myPage页面的图片地址如下：

<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8">
  <title>Title</title>
</head>
<body>
  <h1>Welcome to myPage!</h1>
  <img src="/static/pic/pig.jpg" height="1920" width="1080"/></body>
</html>

原因分析：static-path-pattern规定的时访问静态页面的路径类型，这里规定访问静态页面必须为：localhost:8080/static/***的方式才能访问到静态资源。static-path-pattern并不是规定实际的静态文件访问路径，而是规定了一种url标记，只有遵循该标记的规则才能访问静态文件。

扩展：

1- spring.resources.static-locations参数除了规定classpath:路径下的文件目录为静态文件目录，还可以规定项目以外的位置，如设置：E：/test文件夹目录为静态文件存储目录，如下：

spring:
 resources:
  static-locations: classpath:templates/,classpath:static/,file:E:/test

2- 页面访问过程如下：

浏览器发送请求，先匹配SpringMVC中RequestMapping列表，匹配到后根据controller返回值定位静态资源目录，并返回给客户；如果RequestMapping中未匹配到，则判断是不是静态文件目录，如果是的话直接到静态文件目录对应路径下查询文件，查询到返回，未查询到不返回。

3- static-location配置的目录列表都被视为根目录，如果两个目录中相同文件目录下存储了同名同类型文件，返回在static-locations配置靠前的根目录下的内容。

4- static-path-pattern参数规定了静态文件存储路径，在controller的RequestMapping中应该避免设置该路径相同的访问路径。

到此这篇关于SpringBoot中配置Web静态资源路径的方法的文章就介绍到这了,更多相关SpringBoot配置Web静态资源路径内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

java 常见位逻辑运算符梳理
这篇文章主要介绍了java常见位逻辑运算符梳理，文章围绕主题展开详细的内容介绍，具有一定的参考价值，感兴趣的小伙伴可以参一下下面文章详细内容
2022-08-08
SpringBoot整合Groovy脚本实现动态编程详解
这篇文章主要为大家介绍了SpringBoot整合Groovy脚本实现动态编程详解，有需要的朋友可以借鉴参考下，希望能够有所帮助，祝大家多多进步，早日升职加薪
2022-09-09
Java中从JSON转Java实体的多种方法详解
在现在的日常开发中不管前端还是后端,JSON 格式的数据是用得比较多的,甚至可以说无处不在,这篇文章主要给大家介绍了关于Java中从JSON转Java实体的多种方法,需要的朋友可以参考下
2023-12-12
Jenkins一键打包部署SpringBoot应用的方法步骤
本文主要介绍了使用Jenkins一键打包部署SpringBoot应用的方法步骤，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-12-12
maven环境变量配置讲解
这篇文章主要介绍了maven环境变量配置讲解,本篇文章通过简要的案例,讲解了该项技术的了解与使用,以下就是详细内容,需要的朋友可以参考下
2021-08-08
解决Jenkins集成SonarQube遇到的报错问题
本文给大家分享Jenkins集成SonarQube遇到的报错问题及解决方法，本文通过图文并茂的形式给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友参考下吧
2021-07-07
利用Java的Struts框架实现电子邮件发送功能
这篇文章主要介绍了利用Java的Struts框架实现电子邮件发送功能,Struts框架是Java的SSH三大web开发框架之一,需要的朋友可以参考下
2015-12-12
Java利用POI实现导入导出Excel表格示例代码
最近工作中遇到一个需求，是需要导出数据到Excel表格里，所以写个Demo测试一下，还是比较简单的，现在分享给大家，有需要的朋友们可以参考借鉴，下面来一起看看吧。
2016-10-10
MyBatis中#{}和${}有哪些区别
大家好，本篇文章主要讲的是MyBatis中#{}和${}区别，感兴趣的同学赶快来看一看，对你有帮助的话记得收藏一下，方向下次浏览
2021-12-12
Java微信公众平台之自定义菜单
这篇文章主要为大家详细介绍了Java微信公众平台之自定义菜单，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2018-05-05

SpringBoot中配置Web静态资源路径的方法

相关文章

最新评论

大家感兴趣的内容

最近更新的内容

常用在线小工具