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静态资源路径内容请搜索我们以前的文章或继续浏览下面的相关文章希望大家以后多多支持我们！

赞 (0)

相关推荐

  • 基于Springboot2.3访问本地路径下静态资源的方法(解决报错：Not allowed to load local resource)

    最近在做的一个项目中有一个比较奇葩的需求: 要在springboot中,上传本地的图片进行展示 我的第一反应是,直接在数据库字段加一个存储本地路径的字段,然后用thymeleaf的th:src渲染到前端就好了嘛! 理想很丰满,但现实却很骨感~ 前端报了这样的错误Not allowed to load local resource 于是我想到了可以使用IO将图片先上传到static/images目录下,这样就不会出现禁止访问本地路径的问题了 但是这样实现,问题又来了:上传后的图片必须重启sprin

  • SpringBoot静态资源路径配置及主页显示

    静态资源路径 静态资源支持放在以下路径中,访问优先级从上到下: classpath:/META-INF/resources/ classpath:/resources/ classpath:/static/ # 默认路径 classpath:/public/ 其中 classpath 为 src/main/resources 目录. 请求地址为:http://localhost:8080/xx.js 首页 文件位置: classpath:/static/favicon.ico classpath

  • springboot如何获取相对路径文件夹下静态资源的方法

    springboot如何获取相对路径文件夹下静态资源的方法

    今日遇到一个问题:springboot需要获取到一个自定义名称文件夹下的静态资源(图片等),并且文件夹的路径不在classPath下面,而是一个相对路径. 一开始使用修改配置文件的方式: # 配置静态资源访问前缀 spring.mvc.static-path-pattern=*/** # 配置静态资源路径,默认配置失效 spring.resources.static-locations=../upload 发现并不行,无法解析出相对路径. 后面通过自定义静态资源映射配置类实现了: @Config

  • 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; i

  • 在SpringBoot中配置Thymeleaf的模板路径方式

    目录 配置Thymeleaf的模板路径 关于thymeleaf配置说明 配置Thymeleaf的模板路径 众所周知,Thymeleaf的模板文件默认是在项目文件夹的src\main\resources\templates目录下的. 不过出于特殊需要,要修改其路径怎么办呢? 在我们的项目配置文件application.properties中,添加如下配置: #Thymeleaf配置 spring.thymeleaf.prefix=自定义的Thymeleaf的模板位置,jar内部以classpath

  • springboot操作静态资源文件的方法

    默认静态资源供 SpringBoot有几个默认的静态资源目录,当然也可配置,默认配置的/**映射到/static(或/public ,/resources,/META-INF/resources),自定义配置方式如下: spring.mvc.static-path-pattern=/** # Path pattern used for static resources. 前端如果需要访问默认的静态资源,下面有点要注意,考虑下面的目录结构: └─resources │ application.ym

  • 基于SpringBoot启动类静态资源路径问题

    基于SpringBoot启动类静态资源路径问题

    目录 SpringBoot启动类静态资源路径 SpringBoot核心配置类 分别是一下四个静态资源路径 静态文件存放位置设置 默认配置 自定义位置 SpringBoot启动类静态资源路径 SpringBoot核心配置类 SpringBoot核心JAR包-->spring-boot-autoconfigure-2.2.6.RELEASE.jar 其下面有-->org.springframework.boot.autoconfigure.web 其中有类-->ResourcePropert

  • SpringBoot web静态资源映射实现步骤详解

    目录 静态资源映射规则 自定义静态资源映射规则 静态资源映射规则 “/**” 访问当前项目任何资源,全部找静态资源的文件夹进行映射 静态资源的文件夹包括: "classpath:/META-INF/resources/","classpath:/resources/","classpath:/static/", "classpath:/public/" 静态资源路径下的文件,可以通过地址栏直接访问. 例如:我们在在static

  • Spring boot 默认静态资源路径与手动配置访问路径的方法

    在application.propertis中配置 ##端口号 server.port=8081 ##默认前缀 spring.mvc.view.prefix=/ ## 响应页面默认后缀 spring.mvc.view.suffix=.html # 默认值为 /** spring.mvc.static-path-pattern=/** # 这里设置要指向的路径,多个使用英文逗号隔开,默认值为 classpath:/META-INF/resources/,classpath:/resources/,

  • 关于SpringBoot静态资源路径管理问题

    关于SpringBoot静态资源路径管理问题

    目录 一.默认静态资源路径 二.增加静态资源路径前缀 一.默认静态资源路径 类路径下: static public resources 这几个目录为默认静态资源访问的目录 二.增加静态资源路径前缀 动态资源和静态资源路径重复时会优先访问动态资源,为了避免路径重复,可以为静态资源路径增加前缀 1.目录结构 2.配置文件 spring: mvc: static-path-pattern: /static_path/** 3.访问结果 到此这篇关于SpringBoot静态资源路径管理的文章就介绍到这了

  • 解决Springboot整合shiro时静态资源被拦截的问题

    解决Springboot整合shiro时静态资源被拦截的问题

    目录结构如下 在自己配置的ShiroConfig中已经放行了 filterChainDefinitionMap.put("/static/**", "anon"); login.ftl也引用了静态资源 <link rel="stylesheet" type="text/css" href="/logins/css/normalize.css" rel="external nofollow&q

  • SpringBoot静态资源的访问方法详细介绍

    SpringBoot静态资源的访问方法详细介绍

    目录 一. 静态资源 二. 静态资源访问目标 三. 静态资源访问前缀 1. 默认访问路径为 / 2. 配置访问前缀 3. 配置静态资源默认访问位置 四. 欢迎页及网页图标设置 1. 欢迎页的设置 2. 网页图标的设置 分析源码 一. 静态资源 在web场景中的静态图片.html网页等 二. 静态资源访问目标 在SpringBoot中,静态资源访问目标有 resources文件下的 public.resources.static 以及 META-INF 文件夹下的 recources 如下图所示:

随机推荐