- 使用springboot的步骤
- 创建一个springboot应用,选择需要的模块,springboot会默认将需要的模块自动配置好
- 手动在配置文件中配置部分配置项目便可运行
- 专注编写业务代码,不需要像以前一样考虑一大堆配置
要熟悉掌握开发,之前学的自动配置的原理一定要搞懂。
- 想容器中自动配置组建 * Autoconfiguration
- 自动配置类,封装配置文件的内容 *Properties
静态资源处理
静态资源映射规则
- 写请求十分简单,要引入前端资源,项目中有许多的静态资源,比如css,js等文件,springboot中是怎么处理的?
如果是一个web应用,main下会有一个webapp,之前的开发都是将所有的页面导在webapp下,但是pom组织依赖打包是jar的方式,springboot对于静态资源防止的位置,是有规定的。
上源码
springboot中,springMvc的web配置都在WebMvcConfiguration 这个配置类里面,WebMvcConfigurationAdapter中有很多配置方法
有一个方法为 addResourceHandler 见名知意,添加资源处理
@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));
}
}
读源码可知:比如所有的 /webjars/** 都要去classpath:/META-INF/resource/webjars/ 找对应的资源
什么是webjars呢?
Webjars本质就是以jar包的方式引入静态资源,以前需要导入一个静态资源文件,直接导入即可
- 使用springboot需要使用webjars,可以搜索一下:
要使用jQuery ,只需要引入jQuery对应版本的pom依赖即可
<dependency>
<groupId>org.webjars</groupId>
<artifactId>jquery</artifactId>
<version>3.4.1</version>
</dependency>
导入完毕,查看webjars目录结构,并访问Jquery.js文件!
- 访问:只要是静态资源,SpringBoot就会去对应的路径寻找资源,我们这里访问:http://localhost:8080/webjars/jquery/3.4.1/jquery.js
第二种资源映射规则
- 项目中要使用自己的静态资源如何进行导入?
再次回到源码,staticPathPattern发现第二种映射规则: /** 访问当前项目的任意资源都会去找 resourceProperties 这个类,点进去进一步阅读源码
// 进入方法
public String[] getStaticLocations() {
return this.staticLocations;
}
// 找到对应的值
private String[] staticLocations = CLASSPATH_RESOURCE_LOCATIONS;
// 找到路径
private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
"classpath:/META-INF/resources/",
"classpath:/resources/",
"classpath:/static/",
"classpath:/public/"
};
会发现 ResourceProperties 可以设置和静态资源有关的参数,这里面指向了会去寻找资源的文件夹,即上面数组的内容。得到结论,上面四个目录存放的静态资源可以被识别,访问到。
- 我们可以在resources根目录下新建对应的文件夹,都可以存放我们的静态文件;
比如访问 localhost:8080/1.js 就会去对应的文件夹中寻找相应的静态资源文件。
自定义静态资源路径
既然有 xxxProperties 文件存在,就说明也可以进行自定义配置指定静态文件存放地,在application.properties中进行配置 ```java spring.resources.static-locations=classpath:/coding/,classpath:/kuang/
- 而一旦自定义了静态文件存放路径,原来的自动配置就会失效
<a name="Slcxq"></a>
# 首页处理
- 静态资源文件看完了之后,继续向下看源码,可以看到一个欢迎页的映射,就是首页。
```java
@Bean
public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext,
FormattingConversionService mvcConversionService,
ResourceUrlProvider mvcResourceUrlProvider) {
WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(
new TemplateAvailabilityProviders(applicationContext), applicationContext, getWelcomePage(), // getWelcomePage 获得欢迎页
this.mvcProperties.getStaticPathPattern());
welcomePageHandlerMapping.setInterceptors(getInterceptors(mvcConversionService, mvcResourceUrlProvider));
return welcomePageHandlerMapping;
}
getWelcomePage() 点进去继续看
private Optional<Resource> getWelcomePage() {
String[] locations = getResourceLocations(this.resourceProperties.getStaticLocations());
// ::是java8 中新引入的运算符
// Class::function的时候function是属于Class的,应该是静态方法。
// this::function的funtion是属于这个对象的。
// 简而言之,就是一种语法糖而已,是一种简写
return Arrays.stream(locations).map(this::getIndexHtml).filter(this::isReadable).findFirst();
}
// 欢迎页就是一个location下的的 index.html 而已
private Resource getIndexHtml(String location) {
return this.resourceLoader.getResource(location + "index.html");
}
欢迎页,静态资源文件夹的所有 index.html 页面,被 /** 映射
比如访问 localhost:8080/ 就会去找到静态资源文件夹下的 index.html
关于网站图标
与其他静态资源一样,springboot在配置的静态内容位置中查找 favicon.ico 如果存在这样的文件,将被自动拿来用作网页的icon关闭springboot默认图标
#关闭默认图标
spring.mvc.favicon.enabled=false
比如做一个图标放在 /public/下,重新启动项目,图标已经生效