SpringBoot之静态资源规则与定制化

2023-09-18 11:40:47

文章目录

前言

本文主要介绍关于SpringBoot中Web开发的简单功能。

一、静态资源访问

只要静态资源放在类路径下： called /static (or /public or /resources or /META-INF/resources
访问 ： 当前项目根路径/ + 静态资源名
原理： 静态映射/**。
请求进来，先去找Controller看能不能处理。不能处理的所有请求又都交给静态资源处理器。静态资源也找不到则响应404页面

也可以改变默认的静态资源路径，/static，/public,/resources, /META-INF/resources失效。

resources:
  static-locations: [classpath:/haha/]

在这里插入图片描述

现在访问当前工程目录+haha.jpg：（http://localhost:8080/haha.jpg）
在这里插入图片描述
访问当前工程目录+c.jpg：（http://localhost:8080/c.jpg）
在这里插入图片描述

可以访问到这个图片，且访问static文件夹下的资源却页面报错说明静态资源路径修改成功。
我们深入源码看一下：

@ConfigurationProperties(prefix = "spring.resources", ignoreUnknownFields = false)
public class ResourceProperties {

    private static final String[] CLASSPATH_RESOURCE_LOCATIONS = { "classpath:/META-INF/resources/",
            "classpath:/resources/", "classpath:/static/", "classpath:/public/" };

    /**
     * Locations of static resources. Defaults to classpath:[/META-INF/resources/,
     * /resources/, /static/, /public/].
     */
    private String[] staticLocations = CLASSPATH_RESOURCE_LOCATIONS;
    ...
}

发现底层源码就是与前缀为spring.resources配置绑定，然后默认lasspath:/META-INF/resources/","classpath:/resources/", "classpath:/static/", "classpath:/public/"等为静态资源路径。所以我们改变静态资源路径也应该从spring.resources.classpath修改，这就是上诉修改的原理。

二、静态资源访问前缀

spring:
  mvc:
    static-path-pattern: /res/**

此时的静态资源访问就是：当前项目 + static-path-pattern + 静态资源名 = 静态资源文件夹下找
例：http://localhost:8080/res/a.jpg

三、webjar

可用jar方式添加css，js等资源文件。
webjar官网

例如，添加jquery

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>jquery</artifactId>
    <version>3.6.4</version>
</dependency>

项目启动后，访问地址：http://localhost:8080/webjars/jquery/3.5.1/jquery.js
后面地址要按照依赖里面的包路径。（你们可能不是）
在这里插入图片描述

资源处理的默认规则

@Override
		public void addResourceHandlers(ResourceHandlerRegistry registry) {
			if (!this.resourceProperties.isAddMappings()) {
				logger.debug("Default resource handling disabled");
				return;
			}
			Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
			CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();
			//webjars的规则
            if (!registry.hasMappingForPattern("/webjars/**")) {
				customizeResourceHandlerRegistration(registry.addResourceHandler("/webjars/**")
						.addResourceLocations("classpath:/META-INF/resources/webjars/")
						.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
			}
            
            //
			String staticPathPattern = this.mvcProperties.getStaticPathPattern();
			if (!registry.hasMappingForPattern(staticPathPattern)) {
				customizeResourceHandlerRegistration(registry.addResourceHandler(staticPathPattern)
						.addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations()))
						.setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
			}
		}

根据上述代码，我们可以同过配置禁止所有静态资源规则：

spring:
#  mvc:
#    static-path-pattern: /res/**

  resources:
    add-mappings: false   # 禁用所有静态资源规则

四、welcome与favicon功能

1.欢迎页支持

  • 静态资源路径下 index.html。（项目启动后，默认访问项目路径就自动加载静态资源文件夹下的index.html）
    在这里插入图片描述
    • 可以配置静态资源路径
    • 但是不可以配置静态资源的访问前缀。否则导致 index.html不能被默认访问
spring:
#  mvc:
#    static-path-pattern: /res/**   这个会导致welcome page功能失效
  resources:
    static-locations: [classpath:/haha/]
  • controller能处理/index。

欢迎页处理规则

	HandlerMapping：处理器映射。保存了每一个Handler能处理哪些请求。	

	@Bean
		public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext,
				FormattingConversionService mvcConversionService, ResourceUrlProvider mvcResourceUrlProvider) {
			WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(
					new TemplateAvailabilityProviders(applicationContext), applicationContext, getWelcomePage(),
					this.mvcProperties.getStaticPathPattern());
			welcomePageHandlerMapping.setInterceptors(getInterceptors(mvcConversionService, mvcResourceUrlProvider));
			welcomePageHandlerMapping.setCorsConfigurations(getCorsConfigurations());
			return welcomePageHandlerMapping;
		}


//WelcomePageHandlerMapping的构造方法如下：
	WelcomePageHandlerMapping(TemplateAvailabilityProviders templateAvailabilityProviders,
			ApplicationContext applicationContext, Optional<Resource> welcomePage, String staticPathPattern) {
		if (welcomePage.isPresent() && "/**".equals(staticPathPattern)) {
            //要用欢迎页功能，必须是/**路径
			logger.info("Adding welcome page: " + welcomePage.get());
			setRootViewName("forward:index.html");
		}
		else if (welcomeTemplateExists(templateAvailabilityProviders, applicationContext)) {
            // 调用Controller  /index
			logger.info("Adding welcome page template: index");
			setRootViewName("index");
		}
	}

从构造方法中可以看出欢迎页效果必须满足路径是/**，这也就是为什么设置静态资源前缀后，欢迎页失效的原因：底层要求路径是/**，设置静态资源前缀后，路径变成/static-path-pattern/**。

2.自定义Favicon

就是网页标签上的小图标

在这里插入图片描述
favicon.ico 放在静态资源目录下即可。

spring:
#  mvc:
#    static-path-pattern: /res/**   这个会导致 Favicon 功能失效

在这里插入图片描述

五、补充

  • SpringBoot启动默认加载 xxxAutoConfiguration 类（自动配置类）
  • SpringMVC功能的自动配置类WebMvcAutoConfiguration，生效
@Configuration(proxyBeanMethods = false)
@ConditionalOnWebApplication(type = Type.SERVLET)
@ConditionalOnClass({ Servlet.class, DispatcherServlet.class, WebMvcConfigurer.class })
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
@AutoConfigureOrder(Ordered.HIGHEST_PRECEDENCE + 10)
@AutoConfigureAfter({ DispatcherServletAutoConfiguration.class, TaskExecutionAutoConfiguration.class,
		ValidationAutoConfiguration.class })
public class WebMvcAutoConfiguration {
    ...
}
  • 给容器中配置的内容：
    • 配置文件的相关属性的绑定：WebMvcProperties==spring.mvc、ResourceProperties==spring.resources
@Configuration(proxyBeanMethods = false)
@Import(EnableWebMvcConfiguration.class)
@EnableConfigurationProperties({ WebMvcProperties.class, ResourceProperties.class })
@Order(0)
public static class WebMvcAutoConfigurationAdapter implements WebMvcConfigurer {
    ...
}

配置类只有一个有参构造器

有参构造器所有参数的值都会从容器中确定
public WebMvcAutoConfigurationAdapter(WebProperties webProperties, WebMvcProperties mvcProperties,
		ListableBeanFactory beanFactory, ObjectProvider<HttpMessageConverters> messageConvertersProvider,
		ObjectProvider<ResourceHandlerRegistrationCustomizer> resourceHandlerRegistrationCustomizerProvider,
		ObjectProvider<DispatcherServletPath> dispatcherServletPath,
		ObjectProvider<ServletRegistrationBean<?>> servletRegistrations) {
	this.mvcProperties = mvcProperties;
	this.beanFactory = beanFactory;
	this.messageConvertersProvider = messageConvertersProvider;
	this.resourceHandlerRegistrationCustomizer = resourceHandlerRegistrationCustomizerProvider.getIfAvailable();
	this.dispatcherServletPath = dispatcherServletPath;
	this.servletRegistrations = servletRegistrations;
	this.mvcProperties.checkConfiguration();
}
  • ResourceProperties resourceProperties；获取和spring.resources绑定的所有的值的对象
  • WebMvcProperties mvcProperties 获取和spring.mvc绑定的所有的值的对象
  • ListableBeanFactory beanFactory Spring的beanFactory
  • HttpMessageConverters 找到所有的HttpMessageConverters
  • ResourceHandlerRegistrationCustomizer 找到 资源处理器的自定义器。
  • DispatcherServletPath
  • ServletRegistrationBean 给应用注册Servlet、Filter…

总结

以上就是SpringBoot关于web开发的一些静态资源讲解。

更多推荐

PX4 固件常用 QGroundControl 参数设置

一、安全检查1.CBRK_USB_CHK（USB连接检查）检查USB连接飞控，若连接则不允许解锁，默认情况下有USB连接时是无法解锁的，如果需要插USB解锁，需要设置为1978482.CBRK_IO_SAFETY（安全开关检查）检查安全开关，安全开关未打开则不允许解锁，默认情况下需要打开安全开关才能解锁，如果需要禁用安

centos7安装安装python3.11，安装Home Assistant

一，下载并编译安装python3.111、python源码地址：https://www.python.org/ftp/python/3.11.4/Python-3.11.4.tgz2、准备编译环境yumupdate-yyum-ygroupinstall"Developmenttools"yum-yinstallbzip

java基础-并发编程-CountDownLatch（JDK1.8）源码学习

CountDownLatch方法调用与类关系图一、初始化：publicCountDownLatch(intcount)publicCountDownLatch(intcount){if(count<0)thrownewIllegalArgumentException("count<0");this.sync=newSy

LVS负载均衡群集——LVS-NAT模式搭建和LVS-DR模式搭建

目录lvs工作模式1、NAT模式（VS-NAT）2、直接路由模式（VS-DR）3、IP隧道模式（VS-TUN）LVS调度算法LVS群集类型1）负载均衡群集LB2）高可用群集HA3）高性能运输群集HPCLVS-NAT模式搭建1、NFS部署2、web服务器部署（节点服务器）3、负载调度器配置4、使用客户端测试LVS-DR模

pod调度

定向调度通过标签选择器定向调度到node上此调度方式是硬性现在如果匹配不上会调度失败#在node上加标签klabelnodesdev4-workerzone=north#查看kgetnodedev4-worker--show-labels创建pod的yaml文件#通过标签选择器定向调度到指定nodeapiVersion

java运行以jar包的形式运行和tomcat运行的区别和联系？

Java运行以JAR包形式和Tomcat运行之间存在一些区别和联系：区别：部署方式：JAR包形式的Java应用可以作为独立的进程运行，通过命令行或脚本启动。而Tomcat是一个Web服务器和Servlet容器，需要将应用程序打包成WAR文件并部署到Tomcat中。架构：JAR包形式的应用通常是简单的独立应用，将所有的依

web自动化测试 —— cypress测试框架

一、cypress简介基于JavaScript的前端测试工具可以对浏览器中运行的任何内容进行快速、简单、可靠的测试对每一步操作都支持回看覆盖了测试金字塔模型的所有测试类型【界面测试，集成测试，单元测试】底层协议不采用WebDriver>Cypress官网：https://www.cypress.io/二、cypress

随机抽样一致RANSAC

文章目录RANSAC简介RANSAC算法Ransac在3D视觉中的用法直线拟合单应性矩阵拟合RANSAC的优缺点RANSAC的优点RANSAC的缺点RANSAC在弯曲场景中的缺点：RANSAC适用场景RANSAC简介RANSAC是RANdomSAmpleConsensus的缩写，中文翻译叫随机采样一致。它可以从一组观测

嵌入式开发环境Vscode开发STM32单片机程序

STM32单片机非常强大，大多数教程都是使用keil编译器，keil是收费的而gcc是开源免费的。这里介绍一些使用gcc+vscode开发单片机程序的经验。（这里不解释gcc是什么）。​第一：环境准备gccARM开发者官网https://developer.arm.com/我有个习惯：尽量使用免安装版软件，直接解压到软

华为云云耀云服务器L实例评测-搭建基于hexo的个人博客

1、演示访问地址：演示传送门开头先来一个效果图。2、准备服务器前面有介绍了一下华为云云耀云服务器L实例评测以及简单的配置用法，具体可以看上篇的博客。https://blog.csdn.net/yongqing_/article/details/132867889我这里用的是华为云云耀云服务器L实例，2核2G的配置。然后

Python 数独求解器

文章目录使用回溯算法在Python中解决数独总结Sudoku（数独）是一种基于逻辑的数字填充谜题游戏，最受喜爱的是那些热爱逻辑和推理的人。解决数独谜题有助于提高集中注意力和逻辑思维能力。本文介绍了如何使用Python解决数独谜题。使用回溯算法在Python中解决数独在寻找计算问题的解决方案时，我们经常使用回溯算法。在解

热文推荐
  1. linux ssh 禁止指定用户通过ssh登录

    Linux禁止用户或IP通过SSH登录限制用户SSH登录1.只允许指定用户进行登录（白名单）：在/etc/ssh/sshd_config配置文件中设置AllowUsers选项，（配置完成需要重启SSHD服务）格式如下：AllowUsersaliyuntest@192.168.1.1#允许aliyun和从192.168.

  2. 洞察2023：中国心室辅助装置行业竞争格局及市场份额

    本文核心数据：代表性企业排名;代表性企业优势分析等1、中国心室辅助装置行业竞争梯队人工心脏(ArtificialHeart,AH)是机械辅助类器械的代表，用于替代或辅助心脏泵血功能。按照功能可分为心室辅助装置(VentricularAssistDevice，VAD)、全人工心脏(TotalArtificialHeart

  3. Linux系统之安装uptime-kuma服务器监控面板

    Linux系统之安装uptime-kuma服务器监控面板一、uptime-kuma介绍1.1uptime-kuma简介1.2uptime-kuma特点二、本次实践环境介绍2.1环境规划2.2本次实践介绍2.3环境要求三、检查本地环境3.1检查本地操作系统版本3.2检查系统内核版本3.3检查系统是否安装Node.js四、

  4. 【计算机网络】IP协议第二讲（Mac帧、IP地址、碰撞检测、ARP协议介绍）

    IP协议第二讲1.IP和Mac帧2.碰撞检测2.1介绍2.2如何减少碰撞发生2.3MTU2.4一些补充3.ARP协议3.1协议介绍3.2报文格式分析1.IP和Mac帧IP（InternetProtocol）和MAC（MediaAccessControl）帧是计算机网络中两个不同层次的概念，它们在网络通信中扮演不同的角色

  5. sed简单使用

    sed(StreamEditor)流编辑器，对标准输出或文件逐行进行处理语法格式第一种形式:stdout|sed[option]"patterncommand"第二种形式:sed[option]"patterncommand"filesed的选项选项含义-n只打印模式匹配行-e直接在命令行进行sed编辑，默认选项-f编

  6. 质数距离（C++筛素数模板题）

    给定两个整数L和U，你需要在闭区间[L,U]内找到距离最接近的两个相邻质数C1和C2（即C2−C1是最小的），如果存在相同距离的其他相邻质数对，则输出第一对。同时，你还需要找到距离最远的两个相邻质数D1和D2（即D1−D2是最大的），如果存在相同距离的其他相邻质数对，则输出第一对。输入格式每行输入两个整数L和U，其中L

  7. JavaScript速成课--面向对象程序设计

    目录一.类的定义和实例化1.类的定义2.类的实例化二.访问和添加对象的属性和方法1.访问对象的属性和方法2.向对象添加对象属性和方法三.继承1.原型实现继承2.构造函数实现继承3.重新定义继承父类的方法一.类的定义和实例化在JavaScript中没有声明类的关键字，也没有对类访问的权限控制，JavaScript中使用函

  8. 力扣刷题：正则表达式匹配、

    今日刷题一、正则表达式匹配题目链接：https://leetcode.cn/problems/regular-expression-matching/给你一个字符串s和一个字符规律p，请你来实现一个支持‘.’和‘*’的正则表达式匹配。‘.’匹配任意单个字符‘*’匹配零个或多个前面的那一个元素所谓匹配，是要涵盖整个字符串

  9. B树的插入和删除

    1.B树的插入1.核心要求对m阶B树——除根节点外，结点关键字个数[m/2]−1≤n≤m−1[m/2]-1≤n≤m-1[m/2]−1≤n≤m−1子树0<关键字1<子树1<关键字2<子树2<…新元素一定是插入到最底层“终端节点”，用“查找”来确定插入位置.2.具体步骤若插入后结点关键字个数未超过上限，则无需做其他处理.在