• 使用springboot的步骤
    • 创建一个springboot应用,选择需要的模块,springboot会默认将需要的模块自动配置好
    • 手动在配置文件中配置部分配置项目便可运行
    • 专注编写业务代码,不需要像以前一样考虑一大堆配置

要熟悉掌握开发,之前学的自动配置的原理一定要搞懂。

  • 想容器中自动配置组建 * Autoconfiguration
  • 自动配置类,封装配置文件的内容 *Properties

没事就多读读源码,会加速自己的进步。

静态资源处理

静态资源映射规则

  • 写请求十分简单,要引入前端资源,项目中有许多的静态资源,比如css,js等文件,springboot中是怎么处理的?
  • 如果是一个web应用,main下会有一个webapp,之前的开发都是将所有的页面导在webapp下,但是pom组织依赖打包是jar的方式,springboot对于静态资源防止的位置,是有规定的。

    上源码

  • springboot中,springMvc的web配置都在WebMvcConfiguration 这个配置类里面,WebMvcConfigurationAdapter中有很多配置方法

  • 有一个方法为 addResourceHandler 见名知意,添加资源处理

    1. @Override
    2. public void addResourceHandlers(ResourceHandlerRegistry registry) {
    3. if (!this.resourceProperties.isAddMappings()) {
    4. // 已禁用默认资源处理
    5. logger.debug("Default resource handling disabled");
    6. return;
    7. }
    8. // 缓存控制
    9. Duration cachePeriod = this.resourceProperties.getCache().getPeriod();
    10. CacheControl cacheControl = this.resourceProperties.getCache().getCachecontrol().toHttpCacheControl();
    11. // webjars 配置
    12. if (!registry.hasMappingForPattern("/webjars/**")) {
    13. customizeResourceHandlerRegistration(registry.addResourceHandler("/webjars/**")
    14. .addResourceLocations("classpath:/META-INF/resources/webjars/")
    15. .setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
    16. }
    17. // 静态资源配置
    18. String staticPathPattern = this.mvcProperties.getStaticPathPattern();
    19. if (!registry.hasMappingForPattern(staticPathPattern)) {
    20. customizeResourceHandlerRegistration(registry.addResourceHandler(staticPathPattern)
    21. .addResourceLocations(getResourceLocations(this.resourceProperties.getStaticLocations()))
    22. .setCachePeriod(getSeconds(cachePeriod)).setCacheControl(cacheControl));
    23. }
    24. }

    读源码可知:比如所有的 /webjars/** 都要去classpath:/META-INF/resource/webjars/ 找对应的资源

    什么是webjars呢?

  • Webjars本质就是以jar包的方式引入静态资源,以前需要导入一个静态资源文件,直接导入即可

  • 使用springboot需要使用webjars,可以搜索一下:
  • 要使用jQuery ,只需要引入jQuery对应版本的pom依赖即可

    1. <dependency>
    2. <groupId>org.webjars</groupId>
    3. <artifactId>jquery</artifactId>
    4. <version>3.4.1</version>
    5. </dependency>
  • 导入完毕,查看webjars目录结构,并访问Jquery.js文件!

image.png

image.png

第二种资源映射规则

  • 项目中要使用自己的静态资源如何进行导入?
  • 再次回到源码,staticPathPattern发现第二种映射规则: /** 访问当前项目的任意资源都会去找 resourceProperties 这个类,点进去进一步阅读源码

    1. // 进入方法
    2. public String[] getStaticLocations() {
    3. return this.staticLocations;
    4. }
    5. // 找到对应的值
    6. private String[] staticLocations = CLASSPATH_RESOURCE_LOCATIONS;
    7. // 找到路径
    8. private static final String[] CLASSPATH_RESOURCE_LOCATIONS = {
    9. "classpath:/META-INF/resources/",
    10. "classpath:/resources/",
    11. "classpath:/static/",
    12. "classpath:/public/"
    13. };
  • 会发现 ResourceProperties 可以设置和静态资源有关的参数,这里面指向了会去寻找资源的文件夹,即上面数组的内容。得到结论,上面四个目录存放的静态资源可以被识别,访问到。

  • 我们可以在resources根目录下新建对应的文件夹,都可以存放我们的静态文件;
  • 比如访问 localhost:8080/1.js 就会去对应的文件夹中寻找相应的静态资源文件。

    自定义静态资源路径

  • 既然有 xxxProperties 文件存在,就说明也可以进行自定义配置指定静态文件存放地,在application.properties中进行配置 ```java spring.resources.static-locations=classpath:/coding/,classpath:/kuang/

  1. - 而一旦自定义了静态文件存放路径,原来的自动配置就会失效
  2. <a name="Slcxq"></a>
  3. # 首页处理
  4. - 静态资源文件看完了之后,继续向下看源码,可以看到一个欢迎页的映射,就是首页。
  5. ```java
  6. @Bean
  7. public WelcomePageHandlerMapping welcomePageHandlerMapping(ApplicationContext applicationContext,
  8. FormattingConversionService mvcConversionService,
  9. ResourceUrlProvider mvcResourceUrlProvider) {
  10. WelcomePageHandlerMapping welcomePageHandlerMapping = new WelcomePageHandlerMapping(
  11. new TemplateAvailabilityProviders(applicationContext), applicationContext, getWelcomePage(), // getWelcomePage 获得欢迎页
  12. this.mvcProperties.getStaticPathPattern());
  13. welcomePageHandlerMapping.setInterceptors(getInterceptors(mvcConversionService, mvcResourceUrlProvider));
  14. return welcomePageHandlerMapping;
  15. }
  • getWelcomePage() 点进去继续看

    1. private Optional<Resource> getWelcomePage() {
    2. String[] locations = getResourceLocations(this.resourceProperties.getStaticLocations());
    3. // ::是java8 中新引入的运算符
    4. // Class::function的时候function是属于Class的,应该是静态方法。
    5. // this::function的funtion是属于这个对象的。
    6. // 简而言之,就是一种语法糖而已,是一种简写
    7. return Arrays.stream(locations).map(this::getIndexHtml).filter(this::isReadable).findFirst();
    8. }
    9. // 欢迎页就是一个location下的的 index.html 而已
    10. private Resource getIndexHtml(String location) {
    11. return this.resourceLoader.getResource(location + "index.html");
    12. }
  • 欢迎页,静态资源文件夹的所有 index.html 页面,被 /** 映射

  • 比如访问 localhost:8080/ 就会去找到静态资源文件夹下的 index.html

    关于网站图标

    image.png
    与其他静态资源一样,springboot在配置的静态内容位置中查找 favicon.ico 如果存在这样的文件,将被自动拿来用作网页的icon

  • 关闭springboot默认图标

    1. #关闭默认图标
    2. spring.mvc.favicon.enabled=false
  • 比如做一个图标放在 /public/下,重新启动项目,图标已经生效