Spring Boot 静态资源处理方式-6ren

Spring Boot 静态资源处理方式

转载作者：qq735679552 更新时间：2022-09-28 22:32:09

CFSDN坚持开源创造价值，我们致力于搭建一个资源共享平台，让每一个IT人在这里找到属于你的精彩世界.

这篇CFSDN的博客文章Spring Boot 静态资源处理方式由作者收集整理，如果你对这篇文章有兴趣，记得点赞哟.

Spring Boot 默认为我们提供了静态资源处理，使用 WebMvcAutoConfiguration 中的配置各种属性.

建议大家使用Spring Boot的默认配置方式，如果需要特殊处理的再通过配置进行修改.

如果想要自己完全控制WebMVC，就需要在@Configuration注解的配置类上增加@EnableWebMvc（@SpringBootApplication 注解的程序入口类已经包含@Configuration），增加该注解以后WebMvcAutoConfiguration中配置就不会生效，你需要自己来配置需要的每一项。这种情况下的配置还是要多看一下WebMvcAutoConfiguration类.

我们既然是快速使用Spring Boot，并不想过多的自己再重新配置。本文还是主要针对Spring Boot的默认处理方式，部分配置在application 配置文件中（.properties 或 .yml）。

默认资源映射。

我们在启动应用的时候，可以在控制台中看到如下信息:

 
    ? 
   
         2016 
         - 
         01 
         - 
         08 
         09 
         : 
         29 
         : 
         30.362 
         INFO  
         24932 
         --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/webjars 
         /**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 
        
         2016-01-08 09:29:30.362 INFO 24932 --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**] onto handler of type [class org.springframework.web.servlet.resource.ResourceHttpRequestHandler] 
        
         2016-01-08 09:29:30.437 INFO 24932 --- [  main] o.s.w.s.handler.SimpleUrlHandlerMapping : Mapped URL path [/**/ 
         favicon.ico] onto handler of type [ 
         class 
         org.springframework.web.servlet.resource.ResourceHttpRequestHandler]

其中默认配置的 /** 映射到 /static （或/public、/resources、/META-INF/resources）。

其中默认配置的 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ 。

PS：上面的 static、public、resources 等目录都在 classpath: 下面（如 src/main/resources/static）.

如果我按如下结构存放相同名称的图片，那么Spring Boot 读取图片的优先级是怎样的呢？。

如下图:

Spring Boot 静态资源处理方式

当我们访问地址 http://localhost:8080/fengjing.jpg 的时候，显示哪张图片？这里博主可以直接告诉大家，优先级顺序为：META/resources > resources > static > public 。

如果我们想访问pic2.jpg，请求地址 http://localhost:8080/img/pic2.jpg 。

自定义资源映射。

上面我们介绍了Spring Boot 的默认资源映射，一般够用了，那我们如何自定义目录？。

这些资源都是打包在jar包中的，然后实际应用中，我们还有很多资源是在管理系统中动态维护的，并不可能在程序包中，对于这种随意指定目录的资源，如何访问?

自定义目录。

以增加 /myres/* 映射到 classpath:/myres/* 为例的代码处理为：。

实现类继承 WebMvcConfigurerAdapter 并重写方法 addResourceHandlers （对于 WebMvcConfigurerAdapter 上篇介绍拦截器的文章中已经有提到）。

 
    ? 
   
         package 
         org.springboot.sample.config; 
        
         import 
         org.springboot.sample.interceptor.MyInterceptor1; 
        
         import 
         org.springboot.sample.interceptor.MyInterceptor2; 
        
         import 
         org.springframework.context.annotation.Configuration; 
        
         import 
         org.springframework.web.servlet.config.annotation.InterceptorRegistry; 
        
         import 
         org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; 
        
         import 
         org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter; 
        
         @Configuration 
        
         public 
         class 
         MyWebAppConfigurer  
        
         extends 
         WebMvcConfigurerAdapter { 
        
         @Override 
        
         public 
         void 
         addResourceHandlers(ResourceHandlerRegistry registry) { 
        
         registry.addResourceHandler( 
         "/myres/**" 
         ).addResourceLocations( 
         "classpath:/myres/" 
         ); 
        
         super 
         .addResourceHandlers(registry); 
        
         } 
        
         }

访问myres 文件夹中的fengjing.jpg 图片的地址为 http://localhost:8080/myres/fengjing.jpg 。

这样使用代码的方式自定义目录映射，并不影响Spring Boot的默认映射，可以同时使用.

如果我们将/myres/* 修改为 /* 与默认的相同时，则会覆盖系统的配置，可以多次使用 addResourceLocations 添加目录，优先级先添加的高于后添加的.

 
    ? 
   
         // 访问myres根目录下的fengjing.jpg 的URL为 http://localhost:8080/fengjing.jpg （/** 会覆盖系统默认的配置） 
        
         // registry.addResourceHandler("/**").addResourceLocations("classpath:/myres/").addResourceLocations("classpath:/static/");

其中 addResourceLocations 的参数是动参，可以这样写 addResourceLocations(“classpath:/img1/”, “classpath:/img2/”, “classpath:/img3/”),

使用外部目录。

如果我们要指定一个绝对路径的文件夹（如 H:/myimgs/ ），则只需要使用 addResourceLocations 指定即可.

 
    ? 
   
         // 可以直接使用addResourceLocations 指定磁盘绝对路径，同样可以配置多个位置，注意路径写法需要加上file: 
        
         registry.addResourceHandler( 
         "/myimgs/**" 
         ).addResourceLocations( 
         "file:H:/myimgs/" 
         );

通过配置文件配置。

上面是使用代码来定义静态资源的映射，其实Spring Boot也为我们提供了可以直接在 application.properties（或.yml）中配置的方法。。

配置方法如下:

 
    ? 
   
         # 默认值为 /** 
        
         spring.mvc. 
         static 
         -path-pattern= 
        
         # 默认值为 classpath:/META-INF/resources/,classpath:/resources/,classpath:/ 
         static 
         /,classpath:/ 
         public 
         /  
        
         spring.resources. 
         static 
         -locations=这里设置要指向的路径，多个使用英文逗号隔开，

使用 spring.mvc.static-path-pattern 可以重新定义pattern，如修改为 /myres/** ，则访问static 等目录下的fengjing.jpg文件应该为 http://localhost:8080/myres/fengjing.jpg ，修改之前为 http://localhost:8080/fengjing.jpg 使用 spring.resources.static-locations 可以重新定义 pattern 所指向的路径，支持 classpath: 和 file: （上面已经做过说明）。

注意 spring.mvc.static-path-pattern 只可以定义一个，目前不支持多个逗号分割的方式.

页面中使用。

上面几个例子中也已经说明了怎么访问静态资源，其实在页面中使用不管是jsp还是freemarker，并没有什么特殊之处，也我们平时开发web项目一样即可。。

下面是我的index.jsp:

<body>

<img alt="读取默认配置中的图片" src="${pageContext.request.contextPath }/pic.jpg">

<br/>

<img alt="读取自定义配置myres中的图片" src="${pageContext.request.contextPath }/myres/fengjing.jpg">

</body>

使用webjars 。

先说一下什么是webjars？我们在Web开发中，前端页面中用了越来越多的JS或CSS，如jQuery等等，平时我们是将这些Web资源拷贝到Java的目录下，这种通过人工方式拷贝可能会产生版本误差，拷贝版本错误，前端页面就无法正确展示。 WebJars 就是为了解决这种问题衍生的，将这些Web前端资源打包成Java的Jar包，然后借助Maven这些依赖库的管理，保证这些Web资源版本唯一性.

WebJars 就是将js, css 等资源文件放到 classpath:/META-INF/resources/webjars/ 中，然后打包成jar 发布到maven仓库中.

简单应用。

以jQuery为例，文件存放结构为:

META-INF/resources/webjars/jquery/2.1.4/jquery.js META-INF/resources/webjars/jquery/2.1.4/jquery.min.js META-INF/resources/webjars/jquery/2.1.4/jquery.min.map META-INF/resources/webjars/jquery/2.1.4/webjars-requirejs.js 。

Spring Boot 默认将 /webjars/** 映射到 classpath:/META-INF/resources/webjars/ ，结合我们上面讲到的访问资源的规则，便可以得知我们在JSP页面中引入jquery.js的方法为:

 
    ? 
   
         <script type= 
         "text/javascript" 
         src= 
         "${pageContext.request.contextPath }/webjars/jquery/2.1.4/jquery.js" 
         ></script>

想实现这样，我们只需要在pom.xml 文件中添加jquery的webjars 依赖即可，如下:

 
    ? 
   
         <dependency> 
        
         <groupId>org.webjars</groupId> 
        
         <artifactId>jquery</artifactId> 
        
         <version> 
         2.1 
         . 
         4 
         </version> 
        
         </dependency>

版本号统一管理。

但是我们实际开发中，可能会遇到升级版本号的情况，如果我们有100多个页面，几乎每个页面上都有按上面引入jquery.js 那么我们要把版本号更换为3.0.0，一个一个替换显然不是最好的办法。。

如何来解决？按如下方法处理即可.

首先在pom.xml 中添加依赖:

 
    ? 
   
         <dependency> 
        
         <groupId>org.webjars</groupId> 
        
         <artifactId>webjars-locator</artifactId> 
        
         </dependency>

然后增加一个WebJarsController:

 
    ? 
   
         package 
         org.springboot.sample.controller; 
        
         import 
         javax.servlet.http.HttpServletRequest; 
        
         import 
         org.springframework.core.io.ClassPathResource; 
        
         import 
         org.springframework.http.HttpStatus; 
        
         import 
         org.springframework.http.ResponseEntity; 
        
         import 
         org.springframework.stereotype.Controller; 
        
         import 
         org.springframework.web.bind.annotation.PathVariable; 
        
         import 
         org.springframework.web.bind.annotation.RequestMapping; 
        
         import 
         org.springframework.web.bind.annotation.ResponseBody; 
        
         import 
         org.springframework.web.servlet.HandlerMapping; 
        
         import 
         org.webjars.WebJarAssetLocator; 
        
         /** 
        
         * 处理WebJars，自动读取版本号 
        
         * 
        
         * @author 单红宇(365384722) 
        
         * @myblog http://blog.csdn.net/catoop/ 
        
         * @create 2016年1月8日 
        
         */ 
        
         @Controller 
        
         public 
         class 
         WebJarsController { 
        
         private 
         final 
         WebJarAssetLocator assetLocator =  
         new 
         WebJarAssetLocator(); 
        
         @ResponseBody 
        
         @RequestMapping 
         ( 
         "/webjarslocator/{webjar}/**" 
         ) 
        
         public 
         ResponseEntity<Object> locateWebjarAsset( 
         @PathVariable 
         String webjar, HttpServletRequest request) { 
        
         try 
         { 
        
         String mvcPrefix =  
         "/webjarslocator/" 
         + webjar +  
         "/" 
         ;  
         // This prefix must match the mapping path! 
        
         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= 
         "${pageContext.request.contextPath }/webjarslocator/jquery/jquery.js" 
         ></script>

静态资源版本管理。

Spring 默认提供了静态资源版本映射的支持。。

当我们的资源内容发生改变时，由于浏览器缓存，用户本地的资源还是旧资源，为了防止这种情况发生导致的问题。我们可能会选择在资源文件后面加上参数“版本号”或其他方式.

使用版本号参数，如:

 
    ? 
   
         <script type= 
         "text/javascript" 
         src= 
         "${pageContext.request.contextPath }/js/common.js?v=1.0.1" 
         ></script>

使用这种方式，当我们文件修改后，手工修改版本号来达到URL文件不被浏览器缓存的目的。同样也存在很多文件都需要修改的问题。或者有的人会增加时间戳的方式，这样我认为是最不可取的，每次浏览器都要请求为服务器增加了不必要的压力.

然而Spring在解决这种问题方面，提供了2种解决方式.

* 资源名称md5方式 * 。

1. 修改 application.properties 配置文件（或.yml）。

 
    ? 
   
         spring.resources.chain.strategy.content.enabled= 
         true 
        
         spring.resources.chain.strategy.content.paths=/**

所有 /** 请求的静态资源都会被处理.

1.创建 ResourceUrlProviderController 文件。

 
    ? 
   
         package 
         org.springboot.sample.config; 
        
         import 
         org.springframework.beans.factory.annotation.Autowired; 
        
         import 
         org.springframework.web.bind.annotation.ControllerAdvice; 
        
         import 
         org.springframework.web.bind.annotation.ModelAttribute; 
        
         import 
         org.springframework.web.servlet.resource.ResourceUrlProvider; 
        
         /** 
        
         * 处理静态资源URL 
        
         * 
        
         * @author 单红宇(365384722) 
        
         * @myblog http://blog.csdn.net/catoop/ 
        
         * @create 2016年1月8日 
        
         */ 
        
         @ControllerAdvice 
        
         public 
         class 
         ResourceUrlProviderController { 
        
         @Autowired 
        
         private 
         ResourceUrlProvider resourceUrlProvider; 
        
         @ModelAttribute 
         ( 
         "urls" 
         ) 
        
         public 
         ResourceUrlProvider urls() { 
        
         return 
         this 
         .resourceUrlProvider; 
        
         } 
        
         }

1.在页面中使用的写法。

 
    ? 
   
         <script type= 
         "text/javascript" 
         src= 
         "${pageContext.request.contextPath }${urls.getForLookupPath('/js/common.js') }" 
         ></script>

当我们访问页面后，HTML中实际生成的代码为:

 
    ? 
   
         <script type= 
         "text/javascript" 
         src= 
         "/myspringboot/js/common-c6b7da8fffc9be141b48c073e39c7340.js" 
         ></script>

其中 /myspringboot 为我这个项目的 contextPath 。

* 资源版本号方式 * 。

该方式本人觉得并无多大意义，也不做详细说明，这是对所有资源的统一版本控制，不像上面一个md5是针对文件的。除了在 application.properties（或.yml）中的配置有所区别，页面使用和md5的一样.

 
    ? 
   
         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

这样配置后，以上面 common.js 为例，实际页面中生成的HTML代码为:

 
    ? 
   
         <script type= 
         "text/javascript" 
         src= 
         "/myspringboot/v1.0.0/js/common.js" 
         ></script>

* md5与版本号方式的处理原理 * 。

页面中首先会调用urls.getForLookupPath方法，返回一个/v1.0.0/js/common.js或/css/common-c6b7da8fffc9be141b48c073e39c7340.js 。

然后浏览器发起请求。。

当请求的地址为md5方式时，会尝试url中的文件名中是否包含-，如果包含会去掉后面这部分，然后去映射的目录（如/static/）查找/js/common.js文件，如果能找到就返回.

当请求的地址为版本号方式时，会在url中判断是否存在/v1.0.0 ，如果存在，则先从URL中把 /v1.0.0 去掉，然后再去映射目录查找对应文件，找到就返回.

总结。

有这么多方式来管理我们的资源文件，然而在实际应用中虽然也都有可能用到（存在就有存在的道理嘛），但是凭借个人经验来说.

1. 我们使用第三方的库时，建议使用webjars的方式，通过动态版本号（webjars-locator 的方式）来使用（因为第三方库在项目开发中变动频率很小，即便是变动也是版本号的修改）。 2. 我们使用自己存放在静态资源映射目录中的资源的时候，建议使用md5 资源文件名的方式来使用（项目开发中一些css、js文件会经常修改）。 3. 项目素材文件建议放到 classpath:/static （或其他）目录中，打包在项目中，通过CMS维护的一些图片和资源，我们使用配置引用到具体的磁盘绝对路径来使用。 4. 注意使用md5文件名方式的时候，Spring 是有缓存机制的，也就是说，在服务不重启的情况下，你去变动修改这些资源文件，其文件名的md5值并不会改变，只有重启服务再次访问才会生效。如果需要每次都获取实际文件的md5值，需要重写相关类来实现，我们不建议这样做，因为一直去计算文件md5值是需要性能代价的.

总结。

以上所述是小编给大家介绍的Spring Boot 静态资源处理，希望对大家有所帮助，如果大家有任何疑问请给我留言，小编会及时回复大家的。在此也非常感谢大家对我网站的支持！。

原文链接：https://blog.csdn.net/catoop/article/details/50501706 。

最后此篇关于Spring Boot 静态资源处理方式的文章就讲到这里了,如果你想了解更多关于Spring Boot 静态资源处理方式的内容请搜索CFSDN的文章或继续浏览相关文章，希望大家以后支持我的博客！。

文章推荐：摩尔庄园法师、牧师、战士怎么加点？摩尔庄园战士法师牧师加点攻略

文章推荐： pytorch Dropout过拟合的操作

文章推荐：摩尔庄园哒哒鸟有什么用？在哪？摩尔庄园哒哒鸟怎么抓？怎么获得？

文章推荐：浅谈pytorch中的dropout的概率p

c - 在英特尔 x64 汇编中执行函数的最快(CPU 方式)方式？
我一直在阅读有关汇编函数的内容，但对于是使用进入和退出还是仅使用调用/返回指令来快速执行，我感到很困惑。一种方式快而另一种方式更小吗？例如，在不内联函数的情况下，在汇编中执行此操作的最快(stdcal
解析元组的 Pythonic 方式
我正在处理一个元组列表，如下所示: res = [('stori', 'JJ'), ('man', 'NN'), ('unnatur', 'JJ'), ('feel', 'NN'), ('pig',
使用线程的 Pythonic 方式
最近我一直在做很多网络或 IO 绑定(bind)操作，使用线程有助于加快代码速度。我注意到我一直在一遍又一遍地编写这样的代码: threads = [] for machine, user, data
请求资源子集的 RESTful 方式
假设我有一个名为 user_stats 的资源，其中包含用户拥有的帖子、评论、喜欢和关注者的数量。是否有一种 RESTful 方式只询问该统计数据的一部分(即，对于 user_stats/3，请告诉我
接受选择的 RESTful 方式
我有一个简单的 api，它的工作原理是这样的: 用户创建一个请求 ( POST /requests ) 另一个用户检索所有请求 ( GET /requests ) 然后向请求添加报价 ( POST /
扩展构建器模式的 Pythonic 方式
考虑以下 CDK Python 中的示例(对于这个问题，不需要 AWS 知识，这应该对基本上任何构建器模式都有效，我只是在这个示例中使用 CDK，因为我使用这个库遇到了这个问题。): from aws
用于管理对象池的 Scala 方式
Scala 中管理对象池的首选方法是什么？我需要单线程创建和删除大规模对象(不需要同步)。在 C++ 中，我使用了静态对象数组。在 Scala 中处理它的惯用和有效方法是什么？最佳答案我会把它
将多个类方法应用于对象列表的 Pythonic 方式
我有一个带有一些内置方法的类。这是该类的抽象示例: class Foo: def __init__(self): self.a = 0 self.b = 0
返回和检查方法执行的 Pythonic 方式
返回和检查方法执行的 Pythonic 方式我目前在 python 代码中使用 golang 编码风格，决定移动 pythonic 方式例子: import sys from typing imp
处理丢失数据的 RESTful 方式
我正在开发一个 RESTful API。其中一个 URL 允许调用者通过 id 请求特定人员的记录。返回该 id 不存在的记录的常规值是什么？服务器是否应该发回一个空对象或者一个 404，或者其他什
加载具有相似文件名的文件的 Pythonic 方式
我正在使用 pathlib.Path() 检查文件是否存在，并使用 rasterio 将其作为图像打开. filename = pathlib.Path("./my_file-name.tif") 但
创建嵌套字典的 Pythonic 方式
我正在寻找一种 Pythonic 方式来从列表和字典创建嵌套字典。以下两个语句产生相同的结果: a = [3, 4] b = {'a': 1, 'b': 2} c = dict(zip(b, a))
处理异常后恢复的 Pythonic 方式
我有一个正在操裁剪理设备的脚本。设备有时会发生物理故障，当它发生时，我想重置设备并继续执行脚本。我有这个: while True: do_device_control() device
做组合别名的 Pythonic 方式
做组合别名的最pythonic和正确的方法是什么？这是一个假设的场景: class House: def cleanup(self, arg1, arg2, kwarg1=False):
在一个请求中创建多个项目的 RESTful 方式
我正在开发一个小型客户端服务器程序来收集订单。我想以“REST(ful)方式”来做到这一点。我想做的是: 收集所有订单行(产品和数量)并将完整订单发送到服务器目前我看到有两种选择: 将每个订单行发
动态调用静态方法的 Groovy 方式
我知道在 Groovy 中您可以使用字符串调用类/对象上的方法。例如: Foo."get"(1) /* or */ String meth = "get" Foo."$meth"(1) 有没有办法
复制没有不同属性的字典的 Pythonic 方式
在 ECMAScript6 中，您可以使用扩展运算符来解构这样的对象 const {a, ...rest} = obj; 它将 obj 浅拷贝到 rest，不带属性 a。有没有一种干净的方法可以在
函数中条件返回的 Pythonic 方式
我有几个函数返回数字或None。我希望我的包装函数返回第一个不是 None 的结果。除了下面的方法之外，还有其他方法吗？ def func1(): return None def func2(
处理资源之间双向关系的 RESTful 方式
假设我想设计一个 REST api 来讨论歌曲、专辑和艺术家(实际上我就是这样做的，就像我之前的 1312414 个人一样)。歌曲资源始终与其所属专辑相关联。相反，专辑资源与其包含的所有歌曲相关联。
有条件地使用上下文管理器的 Pythonic 方式
这是我认为必须经常出现的问题，但我一直无法找到一个好的解决方案。假设我有一个函数，它可以作为参数传递一个开放资源(如文件或数据库连接对象)，或者需要自己创建一个。如果函数需要自己打开文件，最佳实践通常

qq735679552

个人简介

我是一名优秀的程序员,十分优秀！

作者热门文章

滴滴打车优惠券免费领取

全站热门文章

首页

博学

6Ren·AI

商城

Spring Boot 静态资源处理方式