SpringBoot----（1）基础

1 SpringBoot简介

1.1 入门案例（IDEA构建）

• SpringBoot 是由 Pivotal 团队提供的全新框架，其设计目的是用来简化 Spring 应用的初始搭建以及开发过程

1. 创建新模块，选择Spring初始化，并配置模块相关基础信息
   
2. 选择当前模块需要用到的技术集
   

在创建好的工程中不需要创建SpringConfig和SpringMvcConfig配置类
创建好的项目会自动生成其他的一些文件，而这些文件目前对我们来说没有任何作用，所以可以将这些文件删除。
可以删除的目录和文件如下：
.mvn
.gitignore
HELP.md
mvnw
mvnw.cmd

3. 开发控制器

@RestController
@RequestMapping("/books")
public class BookController {
 
    @GetMapping("/{id}")
    public String getById(@PathVariable Integer id){
        System.out.println("id ==> "+id);
        return "hello , spring boot!";
    }
}

4. 运行自动生成的Application类
   运行 SpringBoot 工程不需要使用本地的 Tomcat 和 插件，只需要右键运行项目 com.zs包下的 Application 类，我们就可以在控制台看出如下信息
   

报错原因：SpringBoot 3.0以上版本要求JDK 17以上，jdk版本1.8 与 spring boot 3.0.1 版本不匹配
SpringBoot 对比Spring

基于Idea的 Spring Initializr 快速构建 SpringBoot 工程时需要联网。

1.2 官网构建工程

官网：https://spring.io/projects/spring-boot
进入到 SpringBoot 官网后拖到最下方，点击 Spring Initializr
配置：

以上步骤完成后就可以生成 SpringBoot 工程了。在页面的最下方点击 GENERATE CTRL + 回车 按钮生成工程并下载到本地
打开下载好的压缩包可以看到工程结构和使用 Idea 生成的一模一样

1.3 SpringBoot程序快速启动

问题：

以后我们和前端开发人员协同开发，而前端开发人员需要测试前端程序就需要后端开启服务器，这就受制于后端开发人员。为了摆脱这个受制，前端开发人员尝试着在自己电脑上安装 Tomcat 和 Idea ，在自己电脑上启动后端程序，这显然不现实。
解决：
我们后端可以将 SpringBoot 工程打成 jar 包，该 jar 包运行不依赖于 Tomcat 和 Idea 这些工具也可以正常运行，只是这个 jar 包在运行过程中连接和我们自己程序相同的 Mysql 数据库即可。这样就可以解决这个问题，如下图：

打包：

打包package前先clean是好习惯

先终止当前运行的项目。由于我们在构建 SpringBoot 工程时已经在 pom.xml 中配置了spring-boot-maven-plugin插件

//spring-boot-maven-plugin插件打包时需要的
<plugin>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-maven-pluginartifactId>
plugin>

注意：该插件必须配置，不然打好的 jar 包也是有问题的。

所以我们只需要使用 Maven 的 package 指令打包就会在 target 目录下生成对应的 Jar 包

进入 jar 包所在位置，地址栏输入cmd回车，在 命令提示符 中输入如下命令：

java -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar

输入s然后点个Tab键就可以直接： springboot_01_quickstart-0.0.1-SNAPSHOT.jar

然后postman发请求，可以看到命令行里输出后端信息，postman展示响应信息。

非springboot的maven是不能用java -jar命令的

1.4 SpringBoot概述

• SpringBoot 是由Pivotal团队提供的全新框架，其设计目的是用来简化Spring应用的初始搭建以及开发过程
• Spring程序的缺点：
  • 配置繁琐
  • 依赖设置繁琐
• SpringBoot 程序优点：
  • 自动配置。这个是用来解决 Spring 程序配置繁琐的问题
  • 起步依赖（简化以来配置）。这个是用来解决 Spring 程序依赖设置繁琐的问题
  • 辅助功能（内置服务器,…）。我们在启动 SpringBoot 程序时既没有使用本地的 tomcat 也没有使用 tomcat 插件，而是使用 SpringBoot 内置的服务器。

1.5 起步依赖

我们使用 Spring Initializr 方式创建的 Maven 工程的的 pom.xml 配置文件中自动生成了很多包含 starter 的依赖

这些依赖就是启动依赖

从上面的文件中可以看到指定了一个父工程，我们ctrl+b进入到父工程，发现父工程中又指定了一个父工程

再进入到该父工程中，在该工程中我们可以看到配置内容结构

properties 标签中定义了各个技术软件依赖的版本，避免了我们在使用不同软件技术时考虑版本的兼容问题
在 properties 中我们找 servlet 和 mysql 的版本如下图

爷工程pom.xml里依赖管理标签：
dependencyManagement 标签是进行依赖版本锁定，但是并没有导入对应的依赖。
如果我们工程需要哪个依赖只需要引入依赖的 groupid 和 artifactId 不需要定义 version

build 标签中也对插件的版本进行了锁定

在我们创建的工程中的 pom.xml 中配置了spring-boot-starter-web依赖：

进入到该依赖，查看 pom.xml 的依赖会发现它引入了引入了 spring-web 和 spring-webmvc 的依赖，这就是为什么我们的工程中没有依赖这两个包还能正常使用 springMVC 中的注解的原因。

而依赖 spring-boot-starter-tomcat ，从名字基本能确认内部依赖了 tomcat，所以我们的工程才能正常启动。
结论：以后需要使用技术，只需要引入该技术对应的起步依赖即可
同样方法，spring-boot-starter-test依赖里有spring-test等依赖。

• starter

  • 只要依赖名字中有starter，就一定是起步依赖。starter是SpringBoot 中常见项目名称，定义了当前项目使用的所有项目坐标，以达到减少依赖配置的目的。

• parent

  • 所有 SpringBoot 项目要继承的项目，定义了若干个坐标版本号（依赖管理，而非依赖），以达到减少依赖冲突的目的
    spring-boot-starter-parent（2.5.0）与 spring-boot-starter-parent（2.4.6）共计57处坐标版本不同。springboot版本也不是越新越好，实际开发中要看公司项目的spring-boot-starter-parent版本，然后使用对应的springboot版本。

• 实际开发

  • 使用任意坐标时，仅书写GAV中的G和A，V由SpringBoot提供
    G：groupid；A：artifactId；V：version

  • 如发生坐标错误，再指定version（要小心版本冲突）

• 辅助功能
  
  在starter-web中引入了tomact starter就可以让程序内置了一个tomcat服务器，这个功能就是辅助功能（不是用来做程序的，是用来启动程序的），不能提供业务功能（如导入junit能做测试，导入logback能做日志）

1.6 程序启动

创建的每一个 SpringBoot 程序时都包含一个类似于下面的类，我们将这个类称作引导类、主启动类

@SpringBootApplication
public class SpringbootApplication {

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

}

• SpringBoot 在创建项目时，采用jar的打包方式
• SpringBoot 的引导类是项目的入口，运行 main 方法就可以启动项目

因为我们在 pom.xml 中配置了 spring-boot-starter-web 依赖，而该依赖通过前面的学习知道它依赖 tomcat ，所以运行 main 方法就可以使用 tomcat 启动咱们的工程。

1.7 切换web服务器

使用spring-boot-starter-web 依赖实现内置Tomcat服务器，是springboot带来的辅助功能。
现在我们启动工程使用的是 tomcat 服务器，那能不能不使用 tomcat 而使用 jetty 服务器。
jetty 在我们 maven 高级时讲 maven 私服使用的服务器，比Tomcat更轻量级，可扩展性强，谷歌应用引擎已全面切换为Jetty，但目前大型应用一般用的还是Tomcat。
而要切换 web 服务器就需要使用 exclusion 标签将默认的 tomcat 服务器给排除掉。

• 使用maven依赖管理变更起步依赖

<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-webartifactId>
    <exclusions>
        <exclusion>
            <artifactId>spring-boot-starter-tomcatartifactId>
            <groupId>org.springframework.bootgroupId>
        exclusion>
    exclusions>
dependency>
<dependency>
    <groupId>org.springframework.bootgroupId>
    <artifactId>spring-boot-starter-jettyartifactId>
dependency>

• Jetty比Tomcat更轻量级，可扩展性更强（相较于Tomcat），谷歌应用引擎（GAE）已全面切换为Jetty

2 配置

2.1 配置文件格式（3种）

• application.properties，常用，在resources包下

server.port=80

• application.yml（以后用这种）

server:
	port: 81

• application.yaml

server:
	port: 82

SpringBoot 程序的配置文件名必须是 application ，只是后缀名不同而已

自动提示功能消失解决方案：
在配置文件中输入port，如果没有提示，可以使用以下方式解决

点击绿叶图标追加配置文件：

点击加号选择要添加的配置文件：

• SpringBoot三种配置文件加载顺序（了解）

  • application.properties > application.yml > application.yaml

• SpringBoot 内置属性过多，且所有属性集中在一起修改，在使用时，通过提示键+关键字修改属性

  • 例如要设置日志的级别时，可以在配置文件中书写 logging，就会提示出来。配置内容：

logging:
  level:
    root: info

2.2 yaml格式

• YAML（YAML Ain’t Markup Language），一种数据序列化格式。
• 优点：
  • 容易阅读
    yaml 类型的配置文件比 xml 类型的配置文件更容易阅读，结构更加清晰
  • 容易与脚本语言交互
    以数据为核心，重数据轻格式，如下图数据清爽
  • yaml 更注重数据，而 xml 更注重格式
• YAML文件扩展名
  • .yml（主流）
  • .yaml
• yaml语法规则
  • 大小写敏感
  • 属性层级关系使用多行描述，每行结尾使用冒号结束（这里冒号说的是标签名后的冒号）
  • 使用缩进表示层级关系，同层级左侧对齐，只允许使用空格（不允许使用Tab键）
  • 空格的个数并不重要，只要保证同层级的左侧对齐即可。
  • 属性值前面添加空格（属性名与属性值之间使用冒号加空格作为分隔）
  • #表示注释

核心规则：数据前面要加空格与冒号隔开

• 数组数据在数据书写位置的下方使用减号作为数据开始符号，每行书写一个数据，减号与数据间空格分隔

【示例】

enterprise:
  name: itcast
  age: 16
  tel: 4006184000
  subject:
    - Java
    - 前端
    - 大数据

2.3 yaml数据读取方式（3种）

• 环境准备：
  新创建一个 SpringBoot 工程
  在 com.zs.controller 包写创建名为 BookController 的控制器

@RestController
@RequestMapping("/books")
public class BookController {
 
    @GetMapping("/{id}")
    public String getById(@PathVariable Integer id){
        System.out.println("id ==> "+id);
        return "hello , spring boot!";
    }
}

在 com.zs.domain 包下创建一个名为 Enterprise 的实体类等会用来封装数据

public class Enterprise {
    private String name;
    private int age;
    private String tel;
    private String[] subject;
    
    //setter and getter
    
    //toString
}

在 resources 下创建一个名为 application.yml 的配置文件

lesson: SpringBoot
 
server:
  port: 80
 
enterprise:
  name: itcast
  age: 16
  tel: 4006184000
  subject:
    - Java
    - 前端
    - 大数据

• 方式一：使用@Value读取单个数据，属性名引用方式：${一级属性名.二级属性名…}（读取单个数据）
  

• 方式二：封装全部数据到Environment对象（封装读取全部数据）

  • 将配置文件中所有的数据封装到 Environment 对象中，如果需要使用哪个数据只需要通过调用 Environment 对象的 getProperty(String name) 方法获取
    

• 方式三：自定义对象封装指定数据（常用）

  • 将实体类 bean 的创建交给 Spring 管理。在类上添加 @Component 注解
  • 使用 @ConfigurationProperties 注解表示加载配置文件，在该注解中也可以使用 prefix 属性指定只加载指定前缀的数据
  • 在 BookController 中进行注入
    

• 自定义对象封装数据警告解决方案

  • 问题：使用第三种方式，在实体类上有如下警告提示
    
  • 解决：这个警告提示解决是在 pom.xml 中添加如下依赖即可
    

2.4 多环境配置

以后在工作中，对于开发环境、测试环境、生产环境的配置肯定都不相同，比如我们开发阶段会在自己的电脑上安装 mysql ，连接自己电脑上的 mysql 即可，但是项目开发完毕后要上线就需要该配置，将环境的配置改为线上环境的

来回的修改配置会很麻烦，而 SpringBoot 给开发者提供了多环境的快捷配置，需要切换环境时只需要改一个配置即可。不同类型的配置文件多环境开发的配置都不相同

• yaml文件多环境启动
  • 在 application.yml 中使用 — 来分割不同的配置

连接符—作用：单文件中可以通过—实现多文件的效果

#设置启用的环境
spring:
  profiles:
    active: dev  #表示使用的是开发环境的配置
 
---
#开发
spring:
  profiles: dev
server:
  port: 80
---
#生产
spring:
  profiles: pro
server:
  port: 81
---
#测试
spring:
  profiles: test
server:
  port: 82
---

注意：在上面配置中给不同配置起名字的 spring.profiles 配置项已经过时。最新用来起名字的配置项是：

• properties文件多环境启动

  • 主启动配置文件：application.properties
    

  • 环境分类配置文件：application-pro.properties
    

  • 环境分类配置文件：application-dev.properties
    

  • 环境分类配置文件：application-test.properties
    

2.5 多环境启动的命令格式

使用 SpringBoot 开发的程序以后都是打成 jar 包，通过 java -jar xxx.jar …的方式启动服务的

打包时注意两个坑：
坑一： 执行package命令前先执行以下clean命令，避免上一次的结果影响本次操作。
坑二：配置文件中偶尔可能写中文，会导致打包失败，更改一下配置

带参数启动SpringBoot：

java –jar springboot.jar –-spring.profiles.active=test

java –jar springboot.jar –-server.port=88

java –jar springboot.jar –-server.port=88 –-spring.profiles.active=test

注意： 命令行启动参数都是临时更改，不影响源代码

进行测试后就会发现命令行设置的端口号优先级高（也就是使用的是命令行设置的端口号），配置的优先级SpringBoot官网上进行了说明

2.6 maven和springboot多环境开发兼容

Maven和springboot都有profile环境配置，在实际开发中，应该maven为主，springboot为辅。springboot读取maven多环境配置

1. Maven中设置多环境属性
   

2. SpringBoot中引用Maven属性
   

3. 执行Maven打包命令

   • 问题：Maven指令执行完毕后，生成对应的包，其中类参与编译，但是配置文件并没有编译，而是复制到包中
     

   • 解决思路：对于源码中非java类的操作要求加载Maven对应的属性，解析${}占位符
     对资源文件开启默认占位符的解析
     

   • 解决完后，Maven打包加载到属性，打包顺利执行
     

2.7 配置文件分类

问题：由于测试环境和开发环境的很多配置都不相同，所以测试人员在运行我们的工程时需要临时修改很多配置
解决方案：针对这种情况，SpringBoot 定义了配置文件不同的放置的位置；而放在不同位置的优先级时不同的。

SpringBoot 中4级配置文件放置位置：

• 1级：file ：config/application.yml（最高）
• 2级：file ：application.yml
• 3级：classpath：config/application.yml
• 4级：classpath：application.yml（最低）

一二级留作系统打包后设置通用属性
三四级用于系统开发阶段设置通用属性

注意：SpringBoot 2.5.0版本存在一个bug，我们在使用这个版本时，需要在 jar 所在位置的 config 目录下创建一个任意名称的文件夹

3 SpringBoot整合JUnit

SpringBoot 整合 junit：

• 在测试类上添加 SpringBootTest 注解
• 使用 @Autowired 注入要测试的资源
• 定义测试方法进行测试

3.1 环境准备

1. 创建名为springboot_test的springboot工程
2. 在com.zs.service目录下创建BookService接口和impl.BookServiceImpl实现类

public interface BookService {
    public void save();
}
@Service
public class BookServiceImpl implements BookService {
    @Override
    public void save() {
        System.out.println("book service is running ...");
    }
}

3.2 编写测试类

在test/java目录下创建com.zs包，在该包下编写测试类

@SpringBootTest
class Springboot07TestApplicationTests {
 
    @Autowired
    private BookService bookService;
 
    @Test
    public void save() {
        bookService.save();
    }
}

注意：这里的引导类所在包必须是测试类所在包及其子包。
例如：引导类所在包是 com.itheima；测试类所在包也是 com.itheima
如果不满足这个要求的话，就需要在使用 @SpringBootTest 注解时，使用 classes 属性指定引导类的字节码对象。如 @SpringBootTest(classes = Springboot07TestApplication.class)

4 SpringBoot整合SSM

SpringBoot整合SSM两个关键步骤：@Mapper和yml配置数据源

• 在dao接口@Mapper或引导类@MapperScan，类同于ssm中MybatisConfig的mapper扫描包。
• 导入druid依赖、在application.yml中配置数据源dataSource。

1. 创建新模块，选择Spring Initializr，并配置模块相关的基础信息
   

2. 选择当前模块需要使用的技术集（Mybatis、MySQL）
   

3. 定义实体类Book

public class Book {
    private Integer id;
    private String name;
    private String type;
    private String description;
    
    //setter and  getter.....
    
    //toString
}

4. 设置数据源参数
   
   ps：记得导入Druid的坐标

com.mysql.jdbc.Driver与com.mysql.cj.jdbc.Driver的区别：
JDBC连接Mysql5需用com.mysql.jdbc.Driver
JDBC连接Mysql6需用com.mysql.cj.jdbc.Driver，同时url需要指定时区serverTimezone。
设定时区时，serverTimezone=UTC比中国时间早8个小时，若在中国，可设置serverTimezone=Asia/Shanghai

注意：
SpringBoot 版本低于2.4.3(不含)，Mysql驱动版本大于8.0时，需要在url连接串中配置时区 jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC，或在MySQL数据库端配置时区解决此问题

5. 定义数据层接口与映射配置

@Mapper
public interface BookDao {
    @Select("select *from tbl_book where id = #{id}")
    public Book getById(Integer id);
}

6. 测试类注入Dao接口，测试功能

@SpringBootTest
class SpringbootMybatisApplicationTests {
    @Autowired
    private BookDao bookDao;
    @Test
    void testGetById() {
        Book book = bookDao.getById(1);
        System.out.println(book);
    }
}

5 案例：基于SpringBoot的SSM整合案例

1. 创建SpringBoot工程，勾选技术集（web、mysql、mybatis），将之前做的ssm_paage项目拷贝过来，修改成 SpringBoot 的即可
   导入需要的坐标Druid：

<dependency>
    <groupId>com.alibabagroupId>
    <artifactId>druidartifactId>
    <version>1.1.16version>
dependency>

2. application.yml：设置数据源、端口等

server:
  port: 80
 
spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/ssm_db?servierTimezone=UTC
    username: root
    password: root

3. 配置类config直接删除掉
4. dao设置@Mapper

//TODO 添加@Mapper
@Mapper
public interface BookDao {
    @Insert("insert into tbl_book values (null, #{type}, #{name}, #{description})")
    int save(Book book);
    @Update("update tbl_book set type = #{type}, name = #{name}, description = #{description} where id = #{id}")
    int update(Book book);
    @Delete("delete from tbl_book where id = #{id}")
    int delete(Integer id);

    @Select("select * from tbl_book where id = #{id}")
    Book getById(Integer id);
    @Select("select * from tbl_book")
    List<Book> getAll();
}

5. 测试类

@SpringBootTest
public class BookServiceTest {
    @Autowired
    private BookService bookService;

    @Test
    public void testGetById(){
        Book book = bookService.getById(2);
        System.out.println(book);
    }
    
    @Test
    public void testGetAll(){
        List<Book> bookList = bookService.getAll();
        System.out.println(bookList);
    }
}

6. 页面
   静态资源放置在 resources 目录下的 static 下
   
   可以配置一个index.html，实现直接http://localhost/即可访问books列表
   
7. 运行测试功能