SpringBoot简明教程之视图层(一):静态资源映射规则及WebJars的使用

项目创建

SpringBoot项目的创建过程已经在:

SpringBoot简明教程之快速创建第一个SpringBoot应用

中进行了详细的介绍,这里就不再进行赘述。

静态资源映射规则

我们在org/springframework/boot/autoconfigure/web/ResourceProperties.class中看到了如下的代码:

也就意味SpringBoot在查找任何资源时,都会在下面的文件夹中去找到相应的映射文件:

静态资源映射优先级

例如,我们在static文件夹中创建index.html

启动SpringBoot项目,并访问:http://localhost:8080/

浏览器返回:

访问成功。

在classpath目录(即为:SpringBoot下的resources目录)中创建resources文件夹,并创建如下的index.html

再次启动SpringBoot项目,并访问:http://localhost:8080/

浏览器返回:

可见,我们重新编写的index.html文件覆盖了static中的index.html。另外几种情况就不再一一展示,我们可以得出结论,静态映射文件的优先级关系:

"classpath:/META-INF/resources/">"classpath:/resources/">"classpath:/static/">"classpath:/public/"

我们之前使用的都是默认的欢迎页(index.html),所以我们无需在访问的时候指定具体的资源名字也可以正确的映射到,因为如果我们没有指定具体的资源信息,SpringBoot会自动到每个文件夹中寻找命名为index.html的的资源。

例如:我们在classpath:/resources/resources下创建test文件夹,并创建test.html

启动项目,如果我们输入:http://localhost:8080/test

就会发现浏览器报错:

这是因为,当我们输入http://localhost:8080/test时,SpringBoot无法在test目录下找到默认的资源,就会报404。这时我们就需要访问:http://localhost:8080/test/test.html才能正确的获取资源信息了,浏览器返回:

Favicon图标的修改

正常情况下,当我们访问网页时,我们发现SpringBoot页面的图标为:

如果我们想要更改前面的小图标,我们应该怎么做呢?其实很简单,我们只需要将我们的图标命名为favicon.ico,并放在我们默认的静态文件夹下,例如:

启动项目,然后再次访问http://localhost:8080/test/test.html

发现图标已经更改成功:

修改默认的静态文件夹

如果我们想自定义SpringBoot的静态文件夹的地址,我们应该如何进行配置呢?

我们在application.yml中进行如下配置:

我们就将默认的文件夹指向了resources下的test文件夹,我们再访问:http://localhost:8080/,就会发现报错404:

我们在test文件夹中创建index.html:

启动项目,访问:http://localhost:8080/

浏览器返回:

默认的静态文件夹修改成功!

WebJars

WebJars简介

Webjars的官网是这样介绍它的:

WebJars是打包到JAR(Java Archive)文件中的客户端Web库(例如jQuery和Bootstrap)。

大致的意思是,WebJars是将我们在视图层中所需要的大多数例如:jQuery的和Bootstrap等资源打成的JAR包,以便对资源进行统一依赖管理,WebJars的JAR包部署在Maven的中央仓库上。

WebJars示例

接下来,将我们演示如何导入Bootstrap资源到项目中。

首先,我们先到WebJars的官网,找到我们想要使用的资源版本:

然后我们将对应的配置加入到pom.xml的配置文件中:

然后我们就会发现:我们导入的依赖的目录结构,跟我们之前介绍的静态资源映射规则是一致的。

然后,我们重新编写test文件夹下的index.html的文件:

访问:http://localhost:8080/

浏览器返回:

导入Bootstrap资源成功!对于其他资源的导入,基本都是大同小异的过程,这里就不再展示。

总结

我们介绍了有关SpringBoot中关于静态资源加载的一些规则,以及如何根据项目的实际需要去更改默认的静态文件夹,最后我们介绍了Webjars的使用,webjars极大的方便了我们对于一些网络资源的管理。

源码地址

https://github.com/cquptrhw/Spring-boot-learning

联系作者

  • 发表于:
  • 原文链接https://kuaibao.qq.com/s/20181025G1Z09Y00?refer=cp_1026
  • 腾讯「云+社区」是腾讯内容开放平台帐号(企鹅号)传播渠道之一,根据《腾讯内容开放平台服务协议》转载发布内容。
  • 如有侵权,请联系 yunjia_community@tencent.com 删除。

扫码关注云+社区

领取腾讯云代金券