Spring Boot 初学

2022-02-27

1.0.0-项目搭建

SpringBoot项目搭建，可以利用SpringBoot官网搭建传统Maven项目：https://start.spring.io/

先选MavenProject，语言选Java，SpringBoot版本我这里是2.6.4，这个东西更新迭代很快，所以要赶紧学。Group是指组名，这里随便什么com.wzkang，Artiface是项目名字，Name和这个一样，不管先，然后Description默认，Package name先放着，打包方式选了Jar(内嵌Tomcat)，还有个War利用Tomcat，Java版本这次选择的是8.选好这些后再选择插件，也就是旁边的Dependencies，添加个Spring Web，这样就会把什么Maven？和Tomcat？什么帮你搞完，算是环境的搭建吧。

最后再点GENERATE下载项目，一个zip包，解压后后用IDEA打开。

当然正常不会这样创建项目的吧。

这里来第二种正常的项目创建，利用IDEA直接创建。

IDEA—New Project—Spring Initializr这里有Default走上面这个官方的网站—Next—里头的东西其实和上面一样的再Next—添加Spring Web上面也有Spring的版本。

新建完后里头的包文件上面的很熟悉，上面src，main，java…，test，resources。

来看里头自带的java程序。

package com.wzkang.helloworld;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
//程序的主入口，不能删也不能改
@SpringBootApplication
public class HelloworldApplication {

   public static void main(String[] args) {
      SpringApplication.run(HelloworldApplication.class, args);
   }

}

首先还是一句话，约定大于配置！

进来看com.wzkang.helloworld这个包里头的东西。

需要创建controllert（业务层，接收前端传来的参数进行业务操作）、dao（和mybatis里的mapper差不多，对数据库进行持久化操作）、pojo（存放实体类的层）、service（服务层，对dao进行再次的封装，封装成服务，管理具体的功能）这些package，不要在其他地方写，它只会在这个包里扫描名字。

先来个简单的玩意儿，改启动的时候spring那个颜文字，只需要在resources目录下新建个banner.txt文件，并在里面写图标就行。注意：这文件的右下角一定要看到灰色的托管图标！！

1.0.1-原理初探

pom.xml

spring-boot-dependencies：核心依赖在父工程中！

我们在写或者引入一些SpringBoot依赖的时候，不需要指定版本，就因为有这些版本仓库

启动器

<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter</artifactId>
</dependency>

启动器：说白了就是SpringBoot的启动场景；

比如spring-boot-starter-web，他就会帮我们自动导入web环境所有的依赖！

springboot会将所有的功能场景，都变成一个个的启动器

我们要使用什么功能，就只需要找到对应的启动器就可以了starter

主程序

….无语源码。

2022/03/03—springboot继续学习

1.Springboot项目构建完成后，需要注意一下application.properties文件，这里推荐改成.yml文件，别问，问就是高级n+1倍。

2.导入配置文件处理器

<dependency>
   <groupId>org.springframework.boot</groupId>
   <artifactId>spring-boot-starter</artifactId>
   <optional>true</optional>
    <!--这个optional好像不用也行-->
</dependency>

然后编写yml文件：

# 使用yml可以给实体类赋值，就像key value那样，不用new也不用@Value赋值了
person:
  name: 王八
  age: 2000
  happy: true
  birth: 2022/03/03
  maps: {k1: v1,k2: v2}
  lists:
    - code
    - music
    - girl
  dog:
    name: ${person.name=王八:王八狗} #玩法太多了，比prop好
    age: ${random.int(10)}
#server:
#  servlet:
#    context-path: 6666

光上面这个编写完还不行，还需要绑定扫描使用呢

package com.wzkang.springboot02config.pojo;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.stereotype.Component;

import java.util.Date;
import java.util.List;
import java.util.Map;

@Data
@NoArgsConstructor
@AllArgsConstructor

@Component//这个是注册Bean容器

//@PropertySource(value = "classpath:application2.properties") 如果硬要用properties文件注入属性的话就只好用这个了，指定某个配置文件，哪怕取不是application这名字都行
@ConfigurationProperties(prefix = "person")//还是这个好，直接扫描application.yml文件下的person对象并赋值
//从application文件中拿person对象并进行赋值,只能是yml文件,传统properties很麻烦还要改File Encodings里的utf-8,还要勾√,不然是乱码
public class Person {
//    @Value("#${name}") 这样玩有病
    private String name;
    private Integer age;
    private Boolean happy;
    private Date birth;
    private Map<String,Object> maps;
    private List<Object> lists;
    private Dog dog;//接下来顺便看看Dog类吧
}

Dog：

package com.wzkang.springboot02config.pojo;

import lombok.Data;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Component;

@Data
@Component //用这个标记表示它为Spring容器的一个Bean
//相当于配置文件里的<Bean id="dog" class="xxx.xxx.Dog(没记错的话)">
public class Dog {
    @Value("旺财")
    //使用这个直接赋值也行
    private String name;
    @Value("3")
    private String age;
}

弄完这些后直接在springboot自带的text测试类里测试下

package com.wzkang.springboot02config;

import com.wzkang.springboot02config.pojo.Dog;
import com.wzkang.springboot02config.pojo.Person;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.beans.factory.annotation.Qualifier;
import org.springframework.boot.test.context.SpringBootTest;
//这里是官方内置的注解，直接拿来用就行。
@SpringBootTest
class Springboot02ConfigApplicationTests {

    //自动装配啦，就那个byType>byName
    //顺便讲下 @Qualifier
    //指定使用容器的哪个id

    @Autowired
    private Person person;
    @Test
    void contextLoads() {
        System.out.println(person);
    }

}

运行结果：

Person(name=王八, age=2000, happy=true, birth=Thu Mar 03 00:00:00 CST 2022,

maps={k1=v1, k2=v2}, lists=[code, music, girl],

dog=Dog(name=王八狗, age=5))

2022/03/05—springboot继续学习

yml的好处：

可以松散绑定，啥意思，yml里写last-name和代码里的lastName是一样的，后面跟着的字母默认是大写的，这就是松散绑定。

@ConfigurationProperties(prefix = "person")
public class Person {
    private String lastName;
    ......
}

1 2	person: last-name: 王八

当然也可以这样玩

@ConfigurationProperties(prefix = "a.b")
------------------yml------------------
a:
  b:
    last-name: 安安
# 照样可以绑定到

这个松散绑定，**@Value**可做不到。

JSR303校验

现在需要导入依赖了

1
2
3

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-validation</artifactId>

导入完之后就可以用**javax.validation.constraints.***里的注解了

前提是一件在class类上打了**@Validated**开启数据校验，否则没用。

1
2
3

@Email(message="邮箱格式错误")
private String lastName;
//比如这样玩，检测邮箱的格式，我在yaml里放的name注入肯定是错的，那么他运行起来肯定会报错

application配置文件可以放在哪里？

按照运行优先度：

1.springboot-03-config/config/application.yml

2.springboot-03-config//application.yml

3.springboot-03-config/src/main/resources/config/aplication.yml

4.springboot-03-config/src/main/resources/aplication.yml(默认放在这)

有多套application配置文件要怎么替换使用？

比如有3个配置文件

application.properties 默认环境

application-dev.properties 开发环境

application-test.properties 测试环境

假设有3种环境要配套用，如果要替换，只能在application.properties使用下面的代码。

spring.profiles.active=dev

这样就会切换到别的配置文件了

但是这很麻烦，还是看看yml吧

spring:
  profiles:
    active: dev
# 上面这个表示切换到dev环境
server:
  port: 8080
# 这里是默认环境的配置信息
---
spring:
  profiles: dev
# 利用---隔开环境，再利用spring.profiles表明自己的环境名字叫dev
server:
  port: 8081

---
spring:
  profiles: test
# 同理，环境名字叫test
server:
  port: 8082

但是好像过时了，其次感觉不方便管理啊。

2022/03/09—springboot继续学习

那些源码先放着，先学开发吧，看了半天只有一点点头绪。

这次先解决静态资源导入的问题。

这里扯到一个WebMvcAutoConfiguration自动配置类

里头有这个

1	public static class WebMvcAutoConfigurationAdapter implements WebMvcConfigurer, ServletContextAware {...}

其头上的注解还有段这个

1	@EnableConfigurationProperties({ WebMvcProperties.class, WebProperties.class })

这里头还有个添加静态资源的方法addResourceHandler

他是不是又扯到了这个啊

1
2
3

public String getStaticPathPattern() {
   return this.staticPathPattern;
}

往下走

1	private String staticPathPattern = "/**";

头上注解是不是这个啊

1	@ConfigurationProperties(prefix = "spring.mvc")

这样是不是可以在yml里这样配置？

1
2
3

spring:
  mvc:
    static-path-pattern: 、

是不是根据配置文件找的？这可不是凭空突然能记下来的。

回到WebMvcAutoConfiguration

看看这个

@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
   if (!this.resourceProperties.isAddMappings()) {
      logger.debug("Default resource handling disabled");
      return;
   }
    //上面写了是不是没有配置就失效？springboot里的自动配置好多都是这样的，先写了，要用了再导入。
   addResourceHandler(registry, "/webjars/**", "classpath:/META-INF/resources/webjars/");
    //看这个，前面是不是映射了一个什么/webjars/**的路由地址啊，是不是判断webjars有东西，有就添加到webjars后面的东西
    //这个东西在哪个位置呢？就在/META-INF/resources/webjars/  这
    //这是第一个能找到静态资源的地方，但是左侧没发现有，既然如此就百度webjars
   addResourceHandler(registry, this.mvcProperties.getStaticPathPattern(), (registration) -> {
      registration.addResourceLocations(this.resourceProperties.getStaticLocations());
      if (this.servletContext != null) {
         ServletContextResource resource = new ServletContextResource(this.servletContext, SERVLET_LOCATION);
         registration.addResourceLocations(resource);
      }
   });
}

百度webjars：https://www.webjars.org/

发现它的官网。

发现能maven导入，试试看。

<!-- 
一个叫ace的东西，管他。
-->

<dependency>
    <groupId>org.webjars</groupId>
    <artifactId>ace</artifactId>
    <version>01.08.2014</version>
</dependency>

导入完后确实maven包里多了个ace的包

其结构符合

1	/META-INF/resources/webjars/

之前也说了，他映射到/webjars/**

我试了下http://localhost:8081/webjars/ace/01.08.2014/ChangeLog.txt

确实访问到了这里头的东西

2013.12.02 Version 1.1.2

* New Features
  - Accessibility Theme for Ace (Peter Xiao)
  - use snipetManager for expanding emmet snippets
  - update jshint to 2.1.4
  - improve php syntax checker (jdalegonzalez)
  - add option for autoresizing
  - add option for autohiding vertical scrollbar
  - improvements to highlighting of xml like languages (danyaPostfactum)
  - add support for autocompletion and snippets (gjtorikyan danyaPostfactum and others)
  - add option to merge similar changes in undo history
  - add scrollPastEnd option
  - 6a87d97 Merge pull request #1494 from danyaPostfactum/snippetcompleter
  - use html5 dragndrop for text dragging (danyaPostfactum)
....
//很多懒得复制

重新回到WebMvcAutoCOnfigration.java

略微深究下在哪儿能导入静态资源

1	registration.addResourceLocations(this.resourceProperties.getStaticLocations());

可以看到添加资源位置在resourceProperties身上，点进去

1	private final Resources resourceProperties;

发现有这个类

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

回头看能看到我们项目自带的resources项目包自带的有一个static

源码显示还能放一个public和resource包，两者都可以

但是有优先度问题

resources > static(默认) ＞ public

总结：在Springboot中导入静态资源有以下方式
‌webjars | localhost:8080/webjars/
‌public static 等/** resources localhost:8080

网页图标设置，现在只需要在static包下面放.ioc好像就能直接识别。

不过好像需要在yml里设置，没测试过，要试自己试。

spring:
  mvc:
    favicon:
      enabled: false
# 关闭默认图标

thymeleaf

先导入依赖

<dependency>
    <groupId>org.thymeleaf</groupId>
    <artifactId>thymeleaf-spring5</artifactId>
</dependency>
<dependency>
    <groupId>org.thymeleaf.extras</groupId>
    <artifactId>thymeleaf-extras-java8time</artifactId>
</dependency>

要点进

1	<groupId>org.springframework.boot</groupId>

点一次

1	<groupId>org.springframework.boot</groupId>

再点一次

1	<thymeleaf.version>3.0.15.RELEASE</thymeleaf.version>

这玩意儿好像要基于3.几才行好像。

本来是2.几的，把上面那个parent

<parent>
  <groupId>org.springframework.boot</groupId>
  <artifactId>spring-boot-dependencies</artifactId>
  <version>2.6.4</version>
</parent>

这个版本来回跳再跳回来

会发现他把版本改成3.几的了。

现在版本更新快了，好像在pom用

1	<artifactId>spring-boot-starter-thymelef</artifactId>

就可以解决问题。

来看实例项目：

package com.example.demo.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
//这个注解代表他会跳转到别的页面
//在templates目录下的页面只能通过controller来跳转
public class HelloController {
    @RequestMapping("/index")
    public String index(){
        return "index";
    }

}

然后是resources/templates/index.html的代码

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<h1>index</h1>
</body>
</html>

在没导入thymeleaf模板引擎的情况下肯定会报错的。

但是导入后就不会了。

链接上：http://localhost:8080/index

运行结果：index

原理解析：导入后找ThymeleafProperties

现在导入的组件后面找Properties就是对应的组件配置了。

//进来一看还是很明显的
public class ThymeleafProperties {
//编码
   private static final Charset DEFAULT_ENCODING = StandardCharsets.UTF_8;
//表示资源只能扫描到resources/templates里头
   public static final String DEFAULT_PREFIX = "classpath:/templates/";
//表示后缀只能是.html
   public static final String DEFAULT_SUFFIX = ".html";
}

所以说最后controller类里的接口的方法的return值，要和模板类里的页面的名字一样。

结论：

要用thymeleaf导入依赖就能用了，但是如果spring版本是1.x的话，那thymeleaf好像就要2.x，反正就是跳一个版本的意思？