SpringBoot基础

SpringBoot

• 掌握基于SpringBoot框架的程序开发步骤

• 熟练使用SpringBoot配置信息修改服务器配置

• 基于SpringBoot的完成SSM整合项目开发

SpringBoot简介

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

SpringBoot快速入门

SpringBoot 开发起来特别简单，分为如下几步：

• 创建新模块，选择Spring初始化，并配置模块相关基础信息

• 选择当前模块需要使用的技术集

• 开发控制器类

• 运行自动生成的Application类

创建新模块

• 点击 + 选择 New Module 创建新模块

• 选择 Spring Initializr ，用来创建 SpringBoot 工程

  • 以前我们选择的是 Maven ，今天选择 Spring Initializr 来快速构建 SpringBoot 工程。而在 Module SDK 这一项选择我们安装的 JDK 版本

• 对 SpringBoot 工程进行相关的设置

  • 我们使用这种方式构建的 SpringBoot 工程其实也是 Maven 工程，而该方式只是一种快速构建的方式而已

  • 注意：打包方式这里需要设置为 Jar

• 选中 Web ，然后勾选 Spring Web

• 由于我们需要开发一个 web 程序，使用到了 SpringMVC 技术，所以按照下图红框进行勾选、

• 下图界面不需要任何修改，直接点击 Finish 完成 SpringBoot 工程的构建

注意：

1. 在创建好的工程中不需要创建配置类

2. 创建好的项目会自动生成其他的一些文件，而这些文件目前对我们来说没有任何作用，所以可以将这些文件删除。

   可以删除的目录和文件如下：

   • .mvn

   • .gitignore

   • HELP.md

   • mvnw

   • mvnw.cmd

Application类:

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

pom.xml：

<!--指定了一个父工程，父工程中的东西在该工程中可以继承过来使用-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.7.2</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>
 <properties>
        <java.version>1.8</java.version>
    </properties>
    <dependencies>
        <!--该依赖就是我们在创建 SpringBoot 工程勾选的那个 Spring Web 产生的-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.mybatis.spring.boot</groupId>
            <artifactId>mybatis-spring-boot-starter</artifactId>
            <version>2.2.2</version>
        </dependency>
        <!-- mysql 链接-->
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
            <scope>runtime</scope>
        </dependency>
        <!--这个是单元测试的依赖，我们现在没有进行单元测试，所以这个依赖现在可以没有-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
            <scope>test</scope>
        </dependency>

我们代码之所以能简化，就是因为指定的父工程和 Spring Web 依赖实现的

接下来对比一下 Spring 程序和 SpringBoot 程序

类/配置文件	Spring	SpringBoot
pom文件中的坐标	手工添加	勾选添加
web3.0的配置	手工添加	无
Spring/SpringMVC配置类	手工添加	无
控制器	手工添加	手工制作

• 坐标

  • Spring 程序中的坐标需要自己编写，而且坐标非常多

  • SpringBoot 程序中的坐标是我们在创建工程时进行勾选自动生成的

• web3.0配置类

  • Spring 程序需要自己编写这个配置类。这个配置类大家之前编写过，肯定感觉很复杂

  • SpringBoot 程序不需要我们自己书写

• 配置类

  • Spring/SpringMVC 程序的配置类需要自己书写。而 SpringBoot 程序则不需要书写。

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

SpringBoot工程快速启动

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

由于我们在构建 SpringBoot 工程时已经在 pom.xml 中配置了如下插件

<plugin>
       <!--这个插件是在打包时需要的，而这里暂时还没有用到-->
       <groupId>org.springframework.boot</groupId>
       <artifactId>spring-boot-maven-plugin</artifactId>
</plugin>

所以我们只需要使用 Maven 的 package 指令打包就会在 target 目录下生成对应的 Jar 包，该插件必须配置，不然打好的 jar 包也是有问题的

jar包的启动

进入jar包所在目录，然后再cmd窗口输入下面的命令即可

jar -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar

SpringBoot概述

• 原始 Spring 环境搭建和开发存在以下问题：

  • 配置繁琐

  • 依赖设置繁琐

• SpringBoot 程序优点恰巧就是针对 Spring 的缺点

  • 自动配置。这个是用来解决 Spring 程序配置繁琐的问题

  • 起步依赖。这个是用来解决 Spring 程序依赖设置繁琐的问题

  • 辅助功能（内置服务器,...）。我们在启动 SpringBoot 程序时既没有使用本地的 tomcat 也没有使用 tomcat 插件，而是使用 SpringBoot 内置的服务器。

起步依赖

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

父工程

我们在pom文件中可以发现，指定了一个父工程，再进入到该父工程中

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

• dependencyManagement 标签是进行依赖版本锁定，但是并没有导入对应的依赖；如果我们工程需要那个依赖只需要引入依赖的 groupid 和 artifactId 不需要定义 version

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

探索依赖

在我们创建的工程中的 pom.xml 中配置了如下依赖

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

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

而依赖 spring-boot-starter-tomcat ，从名字基本能确认内部依赖了 tomcat ，所以我们的工程才能正常启动

结论：以后需要使用技术，只需要引入该技术对应的起步依赖即可

小结

• starter

  • SpringBoot 中常见项目名称，定义了当前项目使用的所有项目坐标，以达到减少依赖配置的目的

• parent

  • 所有 SpringBoot 项目要继承的项目，定义了若干个坐标版本号（依赖管理，而非依赖），以达到减少依赖冲突的目的

  • spring-boot-starter-parent （2.5.0）与 spring-boot-starter-parent （2.4.6）共计57处坐标版本不同

使用任意坐标时，仅书写GAV中的G和A，V由SpringBoot提供

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

G：groupid

A：artifactId

V：version

程序启动

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

@SpringBootApplication
public class SSmApplication {
​
    public static void main(String[] args) {
        SpringApplication.run(SSmApplication.class, args);
    }
}

注意：

• SpringBoot 在创建项目时，采用jar的打包方式

• SpringBoot 的引导类是项目的入口，运行 main 方法就可以启动项目

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

切换 web 服务器

现在我们启动工程使用的是 tomcat 服务器，那能不能不使用 tomcat 而使用 jetty 服务器， jetty 在我们 maven 高级时讲 maven 私服使用的服务器。而要切换 web 服务器就需要将默认的 tomcat 服务器给排除掉，怎么排除呢？使用exclusion 标签

引入 jetty 服务器。在 pom.xml 中因为 jetty 的起步依赖

<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
<exclusions>
    <exclusion>
        <artifactId>spring-boot-starter-tomcat</artifactId>
        <groupId>org.springframework.boot</groupId>
    </exclusion>
</exclusions>
</dependency>
<dependency> 
    <groupId>org.springframework.boot</groupId> 
    <artifactId>spring-boot-starter-jetty</artifactId>
</dependency>

小结：通过切换服务器，我们不难发现在使用 SpringBoot 换技术时只需要导入该技术的起步依赖即可

配置文件

我们现在启动服务器默认的端口号是 8080 ，访问路径可以书写为

http://localhost:8080/books/1

在线上环境我们还是希望将端口号改为 80 ，这样在访问的时候就可以不写端口号了，如下

http://localhost/books/1 1

而 SpringBoot 程序如何修改呢？ SpringBoot 提供了多种属性配置方式

• application.properties

server.port=80

• application.yml

server: 
		port: 81

• application.yaml

server: 
		port: 82

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

• application.yml配置文件

删除 application.properties 配置文件中的内容。在 resources 下创建一个名为 application.yml 的配置文件，在该文件中书写端口号的配置项

注意： 在 : 后，数据前一定要加空格

• application.yaml配置文件

删除 application.yml 配置文件和 application.properties 配置文件内容，然后在 resources 下创建名为application.yaml 的配置文件，配置内容和后缀名为 yml 的配置文件中的内容相同，只是使用了不同的后缀名而已

三种配合文件的优先级

application.properties > application.yml > application.yaml

注意：

• SpringBoot 核心配置文件名为 application

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

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

logging: 
	level: 
		root: info

yaml格式

YAML（YAML Ain't Markup Language），一种数据序列化格式。这种格式的配置文件在近些年已经占有主导地位，那么

这种配置文件和前期使用的配置文件是有一些优势的，我们先看之前使用的配置文件

最开始的xml

<enterprise> 
    <name>itcast</name>
    <age>16</age> 
    <tel>4006184000</tel> 
</enterprise>

而 properties 类型的配置文件如下

enterprise.name=itcast 
enterprise.age=16 
enterprise.tel=4006184000

yaml 类型的配置文件内容如下

enterprise: 
		name: itcast 
		age: 16 
		tel: 4006184000

优点：

• 容易阅读

  • yaml 类型的配置文件比 xml 类型的配置文件更容易阅读，结构更加清晰

• 容易与脚本语言交互

• 以数据为核心，重数据轻格式

• yaml 更注重数据，而 xml 更注重格式

YAML 文件扩展名：

• .yml (主流)

• .yaml

语法规则

• 大小写敏感

• 属性层级关系使用多行描述，每行结尾使用冒号结束

• 使用缩进表示层级关系，同层级左侧对齐，只允许使用空格（不允许使用Tab键）

• 空格的个数并不重要，只要保证同层级的左侧对齐即可。

• 属性值前面添加空格（属性名与属性值之间使用冒号+空格作为分隔）

• # 表示注释

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

yaml配置文件数据读取

使用 @Value注解

使用 @Value("表达式") 注解可以从配合文件中读取数据，注解中用于读取属性名引用方式是： ${一级属性名.二级属性名……}我们可以在 BookController 中使用 @Value 注解读取配合文件数据，如下

@RestController
@RequestMapping("/books")
public class BookController {
    @Value("${lesson}")
    private String lesson;
    @Value("${server.port}")
    private Integer port;
    @Value("${enterprise.subject[0]}")
    private String subject_00;

    @GetMapping("/{id}")
    public String getById(@PathVariable Integer id) {
        System.out.println(lesson);
        System.out.println(port);
        System.out.println(subject_00);
        return "hello , spring boot!";
    }
}

Environment对象

上面方式读取到的数据特别零散， SpringBoot 还可以使用 @Autowired 注解注入 Environment 对象的方式读取数据。这种方式 SpringBoot 会将配置文件中所有的数据封装到 Environment 对象中，如果需要使用哪个数据只需要通过调用Environment 对象的 getProperty(String name) 方法获取。具体代码如下：

@RestController
@RequestMapping("/books")
public class BookController {
    @Autowired
    private Environment env;

    @GetMapping("/{id}")
    public String getById(@PathVariable Integer id) {
        System.out.println(env.getProperty("lesson"));
        System.out.println(env.getProperty("enterprise.name"));
        System.out.println(env.getProperty("enterprise.subject[0]"));
        return "hello , spring boot!";
    }
}

自定义对象

SpringBoot 还提供了将配置文件中的数据封装到我们自定义的实体类对象中的方式。具体操作如下：

• 将实体类 bean 的创建交给 Spring 管理。

• 在类上添加 @Component 注解

• 使用 @ConfigurationProperties 注解表示加载配置文件

• 在该注解中也可以使用 prefix 属性指定只加载指定前缀的数据

• 在 BookController 中进行注入

注意：用第三种方式，在实体类上有如下警告提示

这个警告提示解决是在 pom.xml 中添加如下依赖即可

<dependency> 
    <groupId>org.springframework.boot</groupId> 
    <artifactId>spring-boot-configuration-processor</artifactId> 
    <optional>true</optional> 
</dependency>

多环境配置

以后在工作中，对于开发环境、测试环境、生产环境的配置肯定都不相同，比如我们开发阶段会在自己的电脑上安装 mysql，连接自己电脑上的 mysql 即可，但是项目开发完毕后要上线就需要该配置，将环境的配置改为线上环境的。来回的修改配置会很麻烦，而 SpringBoot 给开发者提供了多环境的快捷配置，需要切换环境时只需要改一个配置即可。不同类型的配置文件多环境开发的配置都不相同，接下来对不同类型的配置文件进行说明

yml文件

在 application.yml 中使用 --- 来分割不同的配置，内容如下

#开发 
spring: 
	profiles: dev #给开发环境起的名字 
server:
	port: 80 
---
#生产 
spring: 
	profiles: pro #给生产环境起的名字
server: 
	port: 81 
---
#测试 
spring: 
	profiles: test #给测试环境起的名字 
server: 
	port: 82
---

上面配置中 spring.profiles 是用来给不同的配置起名字的。而如何告知 SpringBoot 使用哪段配置呢？可以使用如下配置来启用都一段配置

#设置启用的环境 
spring: 
	profiles: 
		active: dev
#表示使用的是开发环境的配置

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

#开发 
spring:
    config: 
		activate: 
			on-profile: dev

properties文件

properties 类型的配置文件配置多环境需要定义不同的配置文件

• application-dev.properties 是开发环境的配置文件。我们在该文件中配置端口号为 80

server.port=80

• application-test.properties 是测试环境的配置文件。我们在该文件中配置端口号为 81

• application-pro.properties 是生产环境的配置文件。我们在该文件中配置端口号为 82

SpringBoot 只会默认加载名为 application.properties 的配置文件，所以需要在 application.properties 配置文件中设置启用哪个配置文件，配置如下:

spring.profiles.active=pro

命令行启动参数设置

使用 SpringBoot 开发的程序以后都是打成 jar 包，通过 java -jar xxx.jar 的方式启动服务的。那么就存在一个问题，如何切换环境呢？因为配置文件打到的jar包中了。

我们知道 jar 包其实就是一个压缩包，可以解压缩，然后修改配置，最后再打成jar包就可以了。这种方式显然有点麻烦，而 SpringBoot 提供了在运行 jar 时设置开启指定的环境的方式，如下

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

那么这种方式能不能临时修改端口号呢？也是可以的，可以通过如下方式

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

当然也可以同时设置多个配置，比如即指定启用哪个环境配置，又临时指定端口，如下

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

大家进行测试后就会发现命令行设置的端口号优先级高（也就是使用的是命令行设置的端口号），配置的优先级其实SpringBoot 官网已经进行了说明，参见:

https://docs.spring.io/spring-boot/docs/current/reference/html/spring-boot-features.html#boot- features-external-config

配置文件分类

SpringBoot 定义了配置文件不同的放置的位置；而放在不同位置的优先级时不同的

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

• 1级：classpath：application.yml

• 2级：classpath：config/application.yml

• 3级：file ：application.yml

• 4级：file ：config/application.yml

说明：级别越高优先级越高

• 在硬盘上找到 jar 包所在位置

• 在 jar 包所在位置创建 config 文件夹，在该文件夹下创建 application.yml 配置文件，而在该配合文件中将端口号设置为 82

通过这个结果可以得出file： config 下的配置文件优先于类路径下的配置文件

注意：

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

称的文件夹

SpringBoot整合Junit

SpringBoot 整合junit 特别简单分为以下三步完成

• 在测试类上添加 SpringBootTest 注解

• 使用 @Autowired 注入要测试的资源

• 定义测试方法进行测试

@SpringBootTest
class Springboot07TestApplicationTests {
    @Autowired
    private BookService bookService;

    @Test
    public void save() {
        bookService.save();
    }
}

注意：这里的引导类所在包必须是测试类所在包及其子包。

例如：

• 引导类所在包是 com.itheima

• 测试类所在包是 com.itheima

如果不满足这个要求的话，就需要在使用 @SpringBootTest 注解时，使用 classes 属性指定引导类的字节码对象。如

@SpringBootTest(classes = Springboot07TestApplication.class)

SpringBoot整合Mybatis

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

• 选择当前模块需要使用的技术集（MyBatis、MySQL）

我们代码中并没有指定连接哪儿个数据库，用户名是什么，密码是什么。所以这部分需要在 SpringBoot 的配置文件中进行

配合。在 application.yml 配置文件中配置如下内容

spring: 
	datasource: 
	driver-class-name: com.mysql.jdbc.Driver 
	url: jdbc:mysql://localhost:3306/ssm_db 
	username: root 
	password: root

我们要解决这个问题需要在 BookDao 接口上使用 @Mapper ， BookDao 接口改进为

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

注意：

SpringBoot 版本低于2.4.3(不含)，Mysql驱动版本大于8.0时，需要在url连接串中配置时区

jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC ，或在MySQL数据库端配置时区解决此问题

使用Druid数据源

现在我们并没有指定数据源， SpringBoot 有默认的数据源，我们也可以指定使用 Druid 数据源，按照以下步骤实现

• 导入 Druid 依赖

<dependency> 
    <groupId>com.alibaba</groupId>
    <artifactId>druid</artifactId> 
    <version>1.1.16</version> 
</dependency>

• 在 application.yml 配置文件配置

可以通过 spring.datasource.type 来配置使用什么数据源。配置文件内容可以改进为

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