Spring Boot 静态资源处理
Spring Boot 静态资源处理
Spring Boot 系列
Spring Boot 入门
Spring Boot 属性配置和使用
Spring Boot 集成MyBatis
Spring Boot 静态资源处理
Spring Boot - 配置排序依赖技巧
Spring Boot - DevTools 介绍
静态资源处理
Spring Boot 默认的处理方式就已经足够了,默认情况下Spring Boot 使用WebMvcAutoConfiguration
中配置的各种属性。
建议使用Spring Boot 默认处理方式,需要自己配置的地方可以通过配置文件修改。
但是如果你想完全控制Spring MVC,你可以在@Configuration
注解的配置类上增加@EnableWebMvc
,增加该注解以后WebMvcAutoConfiguration
中配置就不会生效,你需要自己来配置需要的每一项。这种情况下的配置方法建议参考WebMvcAutoConfiguration
类。
本文以下内容针对Spring Boot 默认的处理方式,部分配置通过在application.yml
配置文件中设置。
配置资源映射
Spring Boot 默认配置的/**
映射到/static
(或/public
,/resources
,/META-INF/resources
),/webjars/**
会映射到classpath:/META-INF/resources/webjars/
。
注意:上面的/static
等目录都是在classpath:
下面。
如果你想增加如/mystatic/**
映射到classpath:/mystatic/
,你可以让你的配置类继承WebMvcConfigurerAdapter
,然后重写如下方法:
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {registry.addResourceHandler("/mystatic/**").addResourceLocations("classpath:/mystatic/");
}
这种方式会在默认的基础上增加/mystatic/**
映射到classpath:/mystatic/
,不会影响默认的方式,可以同时使用。
静态资源映射还有一个配置选项,为了简单这里用.properties
方式书写:
spring.mvc.static-path-pattern=/** # Path pattern used for static resources.
这个配置会影响默认的/**
,例如修改为/static/**
后,只能映射如/static/js/sample.js
这样的请求(修改前是/js/sample.js
)。这个配置只能写一个值,不像大多数可以配置多个用逗号隔开的。
使用注意
例如有如下目录结构:
└─resources│ application.yml│├─static│ ├─css│ │ index.css│ ││ └─js│ index.js│└─templatesindex.ftl
在index.ftl
中该如何引用上面的静态资源呢?
如下写法:
<link rel="stylesheet" type="text/css" href="/css/index.css">
<script type="text/javascript" src="/js/index.js"></script>
注意:默认配置的/**
映射到/static
(或/public
,/resources
,/META-INF/resources
)
当请求/css/index.css
的时候,Spring MVC 会在/static/
目录下面找到。
如果配置为/static/css/index.css
,那么上面配置的几个目录下面都没有/static
目录,因此会找不到资源文件!
所以写静态资源位置的时候,不要带上映射的目录名(如/static/
,/public/
,/resources/
,/META-INF/resources/
)!
使用WebJars
WebJars:http://www.webjars.org/
例如使用jquery
,添加依赖:
<dependency><groupId>org.webjars</groupId><artifactId>jquery</artifactId><version>1.11.3</version>
</dependency>
然后可以如下使用:
<script type="text/javascript" src="/webjars/jquery/1.11.3/jquery.js"></script>
你可能注意到href
中的1.11.3
版本号了,如果仅仅这么使用,那么当我们切换版本号的时候还要手动修改href
,怪麻烦的,我们可以用如下方式解决。
先在pom.xml
中添加依赖:
<dependency><groupId>org.webjars</groupId><artifactId>webjars-locator</artifactId>
</dependency>
增加一个WebJarController
:
@Controller
public class WebJarController {private final WebJarAssetLocator assetLocator = new WebJarAssetLocator();@ResponseBody@RequestMapping("/webjarslocator/{webjar}/**")public ResponseEntity locateWebjarAsset(@PathVariable String webjar, HttpServletRequest request) {try {String mvcPrefix = "/webjarslocator/" + webjar + "/";String mvcPath = (String) request.getAttribute(HandlerMapping.PATH_WITHIN_HANDLER_MAPPING_ATTRIBUTE);String fullPath = assetLocator.getFullPath(webjar, mvcPath.substring(mvcPrefix.length()));return new ResponseEntity(new ClassPathResource(fullPath), HttpStatus.OK);} catch (Exception e) {return new ResponseEntity<>(HttpStatus.NOT_FOUND);}}
}
然后使用的时候按照如下方式:
<script type="text/javascript" src="/webjarslocator/jquery/jquery.js"></script>
注意:这里不需要在写版本号了,但是注意写url的时候,只是在原来url基础上去掉了版本号,其他的都不能少!
静态资源版本管理
Spring MVC 提供了静态资源版本映射的功能。
用途:当我们资源内容发生变化时,由于浏览器缓存,用户本地的静态资源还是旧的资源,为了防止这种情况导致的问题,我们可能会手动在请求url的时候加个版本号或者其他方式。
版本号如:
<script type="text/javascript" src="/js/sample.js?v=1.0.1"></script>
Spring MVC 提供的功能可以很容易的帮助我们解决类似问题。
Spring MVC 有两种解决方式。
注意:下面的配置方式针对freemarker
模板方式,其他的配置方式可以参考。
资源名-md5 方式
例如:
<link rel="stylesheet" type="text/css" href="/css/index-2b371326aa93ce4b611853a309b69b29.css">
Spring 会自动读取资源md5,然后添加到index.css
的名字后面,因此当资源内容发生变化的时候,文件名发生变化,就会更新本地资源。
配置方式:
在application.properties
中做如下配置:
spring.resources.chain.strategy.content.enabled=true
spring.resources.chain.strategy.content.paths=/**
这样配置后,所有/**
请求的静态资源都会被处理为上面例子的样子。
到这儿还没完,我们在写资源url的时候还要特殊处理。
首先增加如下配置:
@ControllerAdvice
public class ControllerConfig {@AutowiredResourceUrlProvider resourceUrlProvider;@ModelAttribute("urls")public ResourceUrlProvider urls() {return this.resourceUrlProvider;}}
然后在页面写的时候用下面的写法:
<link rel="stylesheet" type="text/css" href="${urls.getForLookupPath('/css/index.css')}">
使用urls.getForLookupPath('/css/index.css')
来得到处理后的资源名。
版本号 方式
在application.properties
中做如下配置:
spring.resources.chain.strategy.fixed.enabled=true
spring.resources.chain.strategy.fixed.paths=/js/**,/v1.0.0/**
spring.resources.chain.strategy.fixed.version=v1.0.0
这里配置需要特别注意,将version
的值配置在paths
中。原因我们在讲Spring MVC 处理逻辑的时候说。
在页面写的时候,写法如下:
<script type="text/javascript" src="${urls.getForLookupPath('/js/index.js')}"></script>
注意,这里仍然使用了urls.getForLookupPath
,urls
配置方式见上一种方式。
在请求的实际页面中,会显示为:
<script type="text/javascript" src="/v1.0.0/js/index.js"></script>
可以看到这里的地址是/v1.0.0/js/index.js
。
静态资源版本管理 处理过程
在Freemarker模板首先会调用urls.getForLookupPath
方法,返回一个/v1.0.0/js/index.js
或/css/index-2b371326aa93ce4b611853a309b69b29.css
。
这时页面上的内容就是处理后的资源地址。
这之后浏览器发起请求。
这里分开说。
第一种md5方式
请求/css/index-2b371326aa93ce4b611853a309b69b29.css
,我们md5配置的paths=/**
,所以Spring MVC 会尝试url中是否包含-
,如果包含会去掉后面这部分,然后去映射的目录(如/static/
)查找/css/index.css
文件,如果能找到就返回。
第二种版本方式
请求/v1.0.0/js/index.js
。
如果我们paths
中没有配置/v1.0.0
,那么上面这个请求地址就不会按版本方式来处理,因此会找不到上面的资源。
如果配置了/v1.0.0
,Spring 就会将/v1.0.0
去掉再去找/js/index.js
,最终会在/static/
下面找到。
本文参考
- http://docs.spring.io/spring-boot/docs/current/reference/html/boot-features-developing-web-applications.html
- http://www.webjars.org/documentation
- http://www.mscharhag.com/spring/resource-versioning-with-spring-mvc
- https://spring.io/blog/2014/07/24/spring-framework-4-1-handling-static-web-resources
如果你使用的JSP或者其他模板,你可以参考上面几个链接的内容。
最后
以上是Spring Boot 静态资源处理的内容,有些不全面的地方或者读者有更多疑问,可以查看Spring Boot完整文档或本文参考的内容。
关于Spring Boot更多的内容可以继续关注本博客。
Spring Boot 系列
由于我博客Spring Boot 系列文章还不够多,所以暂时不打算创建专栏,如果再多几篇我就建专栏。
Spring Boot 入门
Spring Boot 属性配置和使用
Spring Boot 集成MyBatis
Spring Boot 静态资源处理
Spring Boot 静态资源处理相关推荐
- Spring Boot 静态资源处理,妙!
点击上方"方志朋",选择"设为星标" 回复"666"获取新整理的面试资料 来源:cnblogs.com/paddix/p/8301331.h ...
- Spring Boot静态资源访问和配置全解析
在web开发中,静态资源的访问时必不可少的,比如image.css.js等.SpringBoot对静态资源访问提供了很好的支持,使用其提供的基本默认配置基本可以满足开发需求,同时,又支持开发人员进行自 ...
- Spring Boot 静态资源映射与上传文件路由配置
默认静态资源映射目录 默认映射路径 在平常的 web 开发中,避免不了需要访问静态资源,如常规的样式,JS,图片,上传文件等;Spring Boot 默认配置对静态资源映射提供了如下路径的映射 /st ...
- Spring Boot 静态资源处理,原来如此!
点击上方"朱小厮的博客",选择"设为星标" 后台回复"加群"加入公众号专属技术群 来源:rrd.me/faAmu 做web开发的时候,我们往 ...
- Spring Boot 静态资源访问原理解析
一.前言 springboot配置静态资源方式是多种多样,接下来我会介绍其中几种方式,并解析一下其中的原理. 二.使用properties属性进行配置 应该说 spring.mvc.static-pa ...
- Spring Boot静态资源映射规则
目录 理论 演示 理论 使用Spring Boot: 1. 创建Spring Boot应用,选中需要的模块: 2. Spring Boot已默认将这些场景配置好,只需要在配置文件中指定少量配置就可以运 ...
- spring boot静态资源文件的访问以及自定义
上一节出现的页面是不是很丑?我才不告诉你,我把背景都处理了, 相关的项目结构,如下 好吧.来看看最终的页面源码 <!DOCTYPE HTML> <html><head&g ...
- Spring Boot 静态资源修改立即生效
前两天在玩spring boot的时候,发现修改静态资源时总是不能立即生效,弄了好长时间,今天将解决方案分享给大家,希望对大家有所帮助,废话少说,直接上教程 第一步:项目maven中需要的maven包 ...
- Spring Boot静态资源映射
在 Web 应用中会涉及到大量的静态资源,例如 JS.CSS 和 HTML 等.我们知道,Spring MVC 导入静态资源文件时,需要配置静态资源的映射:但在 SpringBoot 中则不再需要进行 ...
- springboot的jsp应该放在哪_web项目jsp放在哪里 Spring Boot 静态资源处理(4)
Spring Boot 默认将 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ ,结合我们上面讲到的访问资源的规则,便可以得知我们在JSP ...
最新文章
- 【HDU 5834】Magic boy Bi Luo with his excited tree
- Best practice for JVM Tuning[转]
- [转载] 使用异步 I/O 大大提高应用程序的性能
- ExecutorService--线程池
- Linux之vi 文本编辑命令
- oracle取字段第三位字符,oracle截取字符串(截取某个字符前面的字符串)
- 九度 题目1183:守形数----------------我用的方法自创
- php计算时间差js,JS计算日期时间差
- Java接口配置框架magic-api
- 判断图有无环_数读湾区经济潜能:基于大数据分析的环杭州湾大湾区“一体化”发展潜能!...
- lol手游之任务进度条精准计算
- JQuery中append()方法的使用
- Pytorch深度学习笔记(四)梯度向下算法
- uniapp打包安卓apk增加推送UniPush工具hbuilder
- 35岁之后软件测试工程师靠什么养家?我还能继续做测试。
- C++校园疫情防控管理系统
- vscode 修改快捷键 (回到上一处光标位置,下一处光标位置)
- Vue3分割线(Divider)
- 智慧消防解决方案-全套大合集
- 家用计算机是什么时候开始流行,什么时候电脑在我国开始普及?好象是在近几年的事吧?...
热门文章
- linux 支持的中文字体,Linux 增加中文字体支持
- Matlab绘制隐式函数形成曲面的方法总结(转载)
- PTAM特征点法跟踪和建图 SLAM FAST Patch
- Excel多级下拉菜单的制作
- “双态IT”成就业务“互联网+”转型
- 全国职称计算机题库视频,全国职称计算机考试题库模拟训练—windowsXP
- 互联网晚报 | 10月16日 星期六 | 搜狗正式并入腾讯;宏光MINIEV累计销量破40万台;神舟十三号载人飞船成功发射...
- 半导体器件(一) 学习笔记
- 职高计算机专业c语言_重庆市职业高中计算机专业C语言试题
- 3dmax java,基于Java 3D与3DS MAX的虚拟校园设计