Spring Boot基础篇

快速上手

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

入门案例

在Idea创建

创建时要选择Spring Initializr。

Server URL为要连接的网站，默认为官网start.spring.io（访问速度慢，可能会经常失败），可以使用阿里云的start/aliyun.com

name为项目名，Language选择Java，Type选择Maven，JDK版本要与Java版本相对应(java >= JDK)，打包方式选择jar包

Spring Boot为使用的版本，创建后还可以更改，可以直接选择所要加入的依赖。现在创建一个最简单的案例，只需要勾选Spring Web即可

创建后工程只需要创建一个Controller类，加上注解即可直接运行

@RestController
@RequestMapping("/hero")
public class HeroController {@RequestMapping("/index")public String index(){return "index";}}

在网站创建

工程除了可以在Idea创建，还可以在网站创建。访问Spring Boot官网https://start.spring.io（访问速度可能会比较慢）或访问阿里云的https://start.aliyun.com

Java版本可以在高级选项里选择。获取代码后将其解压后即可使用Idea打开

创建工程后导入

导入坐标

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"><modelVersion>4.0.0</modelVersion><groupId>com.GLATY</groupId><artifactId>StudySpringBoot</artifactId><version>0.0.1-SNAPSHOT</version><properties><java.version>1.8</java.version><project.build.sourceEncoding>UTF-8</project.build.sourceEncoding><project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding><spring-boot.version>2.6.13</spring-boot.version></properties><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId></dependency></dependencies><dependencyManagement><dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-dependencies</artifactId><version>${spring-boot.version}</version><type>pom</type><scope>import</scope></dependency></dependencies></dependencyManagement></project>

写引导类

类上要加@SpringBootApplication注解

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

入门案例解析

parent

        开发SpringBoot程序要继承spring-boot-starter-parent

spring-boot-starter-parent中定义了若干个依赖管理

        继承parent模块可以避免多个依赖使用相同技术时出现依赖版本冲突

        继承parent的形式也可以采用引入依赖的形式实现效果

parent是SpringBoot中常见项目名称，定义了当前项目使用的所有依赖坐标，以达到减少依赖配置的目的。也就是配置好版本，可以直接使用

spring-boot-starter-parent各版本间存在着诸多坐标版本不同，如发生坐标错误，再指定Version（要小心版本冲突）

starter

使用starter可以实现快速配置的效果，达到简化配置的目的

starter是所有SpringBoot项目要继承的项目，定义了若干个坐标版本号（依赖管理，而非依赖），以达到减少依赖冲突的目的。也就是在导入坐标时会帮你调用parent中的版本

使用任意坐标时，仅书写GAV中的G和A，V由SpringBoot提供，除非SpringBoot未提供对应版本V

引导类

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

SpringBoot工程运行后初始化Spring容器，扫描引导类所在包加载bean

内嵌Tomcat

内嵌Tomcat服务器是SpringBoot辅助功能之一

在Spring中内嵌了Tomcat，其运行原理是将Tomcat服务器作为对象运行，并将该对象交给Spring容器管理。同时也方便更改服务器。

变更内嵌服务器思想是去除现有服务器，添加全新的服务器

<dependencies><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-web</artifactId><exclusions><!--排除Tomcat服务器--><exclusion><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-tomcat</artifactId></exclusion></exclusions></dependency><!--添加Jetty起步依赖，版本由SpringBoot的starter控制--><dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-jetty</artifactId></dependency>
</dependencies>

内置服务器除了tomcat还有jetty和undertow

tomcat：apache出品，应用面广，负载了若干较重的组件

jetty：更轻量级、负载性能远不及tomcat

undertow：undertow，负载性能勉强跑赢tomcat

基础配置

属性配置

SpringBoot默认配置文件application.properties，通过键值对配置对应属性

修改服务器端口

server.port=80

关闭运行日志图标（banner）

spring.main.banner-mode=off

设置日志相关

logging.level.root=debug

pringBoot内置属性查询，参考官方文档

SpringBoot中导入对应starter后，提供对应配置属性

书写SpringBoot配置采用关键字+提示形式书写

配置文件分类

SpringBoot提供了多种属性配置方式

1.application.properties(传统格式/默认格式)：

server.port=80

2.application.yml(主流格式)：

server:
port: 81

3.application.yaml：

server:
port: 82

配置文件间的加载优先级properties最高，yaml最低。不同配置文件中相同配置按照加载优先级相互覆盖，不同配置文件中不同配置全部保留

yaml文件

yaml

        YAML（YAML Ain't Markup Language），一种数据序列化格式
                优点：
                        容易阅读
                        容易与脚本语言交互
                        以数据为核心，重数据轻格式
        YAML文件扩展名
                .yml（主流）
                .yaml

yaml语法规则

        大小写敏感

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

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

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

        # 表示注释

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

字面值表示方式

boolean: TRUE                        #TRUE,true,True,FALSE,false，False均可
float: 3.14                          #6.8523015e+5 #支持科学计数法
int: 123                             #0b1010_0111_0100_1010_1110 #支持二进制、八进制、十六进制
null: ~                              #使用~表示null
string: HelloWorld                   #字符串可以直接书写
string2: "Hello World"               #可以使用双引号包裹特殊字符
date: 2018-02-17                     #日期必须使用yyyy-MM-dd格式
datetime: 2018-02-17T15:02:31+08:00  #时间和日期之间使用T连接，最后使用+代表时区

数组表示方式：在属性名书写位置的下方使用减号作为数据开始符号，每行书写一个数据，减号与数据间空格分隔

subject:- Java- 前端- 大数据
enterprise:name: itcastage: 16subject:- Java- 前端- 大数据
# 数组书写缩略格式
likes: [ 永劫无间,植物大战僵尸 ]# 对象数组格式
user1:- name: Tomage: 4- name: Jerryage: 5
# 对象数组格式二
user2:-name: Tomage: 4-name: Jerryage: 5
# 对象数组缩略格式
users: [ { name:Tom , age:4 } , { name:Jerry , age:5 } ]

yaml数据读取

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

@Value("${user1.name}")
int name;@Value("${like[1]}")
String like;

在配置文件中可以使用属性名引用方式引用属性

baseDir: /usr/local/fire
center:dataDir: ${baseDir}/datatmpDir: ${baseDir}/tmplogDir: ${baseDir}/logmsgDir: ${baseDir}/msgDir

属性值中如果出现转移字符，需要使用双引号包裹

lesson: "Spring\tboot\nlesson"

将全部数据封装到Environment对象，使用时调用该对象的getProperty()方法

//作用自动装配将所有数据封装到一个对象中
@Autowired
Environment environment;@RequestMapping("/index")
public String index(){System.out.println(environment.getProperty("server.port"));return "index";
}

自定义对象封装指定数据

@Component  //将对象交给bean管理
@ConfigurationProperties(prefix = "datasource")  //指定加载的数据
public class UseDataSource {private String drive;private String url;private String username;private String password;// ......
}

整合第三方技术

通用方式：先导入对应的starter，然后根据提供的配置格式配置非默认值对应的配置项

整合JUnit

1.导入测试对应的starter

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

2.测试类使用@SpringBootTest修饰

@SpringBootTest(classes = StudySpringBootApplication.class)
class StudySpringBootApplicationTests {@Testvoid contextLoads() {}}

*创建项目时就将junit到入的话测试类会自动创建好

*如果测试类在SpringBoot启动类的包或子包中，可以省略启动类的设置，也就是省略classes的设定

整合MyBatis

1.导坐标(如果在创建工程的时候勾选后SpringBoot会将坐标自动导入)

<dependency><groupId>org.mybatis.spring.boot</groupId><artifactId>mybatis-spring-boot-starter</artifactId><version>2.2.2</version>
</dependency>
<dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>

2.配置application文件

spring:datasource:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456

3.在mapper接口上加上@Mapper注解

@Mapper
public interface HeroMapper {public Hero selectById(@Param("id") Integer id);}

整合MyBatis-Plus

MyBatis-Plus简称mp，在中国人自己制造的技术。

MyBatis-Plus与MyBatis的区别：导入坐标不同、数据层实现简化

SpringBoot中未收录MyBatis-Plus的坐标版本，需要指定对应的Version

1.导入坐标

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.3</version>
</dependency><dependency><groupId>mysql</groupId><artifactId>mysql-connector-java</artifactId>
</dependency>

2. 定义数据层接口与映射配置，继承BaseMapper(源码注释是汉语)

@Mapper
public interface HeroMapper extends BaseMapper<Hero> {}

其他同SpringBoot整合MyBatis

MyBatis-Plus相关配置可以在application设置

#设置MyBatis-Plus相关配置
mybatis-plus:global-config:db-config:table-prefix:

整合Druid

导入坐标

<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.2.6</version>
</dependency>

配置application文件

#数据源通用配法
#spring:
#  datasource:
#    driver-class-name: com.mysql.cj.jdbc.Driver
#    url: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTC
#    username: root
#    password: 123456
#    type: com.alibaba.druid.pool.DruidDataSource#专用配发，建议使用
spring:datasource:druid:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456

SSMP整合

实体类快速开发(lombok)

使用lombok可以快速开发实体类

导入lombok坐标（lombok版本由SpringBoot提供，无需指定版本）

<!--lombok坐标，用于快速创建实体类-->
<dependency><groupId>org.projectlombok</groupId><artifactId>lombok</artifactId>
</dependency>

创建实体类，加注解

@Data  //@Data注解为实体类在编译时期设置对应的get方法，set方法，toString方法，hashCode方法，equals方法等
@AllArgsConstructor
@NoArgsConstructor
public class Hero {private String name;private Integer id;private String codeName;private Integer ability;
}

数据层标准开发(基于CRUD)

搭建环境

导入MyBatisPlus与Druid对应的starter

<dependency><groupId>com.baomidou</groupId><artifactId>mybatis-plus-boot-starter</artifactId><version>3.4.3</version>
</dependency>
<dependency><groupId>com.alibaba</groupId><artifactId>druid-spring-boot-starter</artifactId><version>1.2.6</version>
</dependency>

配置数据源与MyBatisPlus对应的基础配置（id生成策略使用数据库自增策略）

spring:datasource:druid:driver-class-name: com.mysql.cj.jdbc.Driverurl: jdbc:mysql://localhost:3306/secondtable?serverTimezone=UTCusername: rootpassword: 123456mybatis-plus:global-config:db-config:id-type: auto

mapper接口继承BaseMapper并指定泛型

@Mapper
public interface HeroMapper extends BaseMapper<Hero> {}

*开启MP日志

mybatis-plus:global-config:db-config:id-type: autoconfiguration:log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

分页查询

分页操作是在MyBatisPlus的常规操作基础上增强得到，内部是动态的拼写SQL语句，因此需要增强对应的功能，使用MyBatisPlus拦截器实现

创建类编辑连接器

@Configuration
public class MPConfig {@Beanpublic MybatisPlusInterceptor mpInterceptor() {//1.定义Mp拦截器MybatisPlusInterceptor mpInterceptor = new MybatisPlusInterceptor();//2.添加具体的拦截器mpInterceptor.addInnerInterceptor(new PaginationInnerInterceptor());return mpInterceptor;}
}

测试分页

@Test
void Testpage() {IPage page = new Page(1, 5);heroMapper.selectPage(page, null);System.out.println(page.getRecords());page.setCurrent(2);heroMapper.selectPage(page, null);System.out.println(page.getRecords());
}

条件查询

使用QueryWrapper对象封装查询条件，推荐使用LambdaQueryWrapper对象，所有查询操作封装成方法调用

@Test
void Test2() {String name = "天";QueryWrapper<Hero> queryWrapper = new QueryWrapper<>();queryWrapper.like(name != null,"name", name);System.out.println(heroMapper.selectList(queryWrapper));
}

@Test
void Test3() {String name = "天";LambdaQueryWrapper<Hero> queryWrapper = new LambdaQueryWrapper<>();queryWrapper.like(name != null,Hero::getName, name);System.out.println(heroMapper.selectList(queryWrapper));
}

业务层标准开发

基础CRUD

Service层接口定义与数据层接口定义具有较大区别，不要混用

定义接口

public interface HeroService {public boolean save(Hero hero);public boolean update(Hero hero);public boolean deleteById(Integer id);public Hero searchById(Integer id);public List<Hero> searchAllHero();public IPage<Hero> searchByPage(int currentPage, int pageSide);
}

实现类定义

import java.util.List;@Service
public class HeroServiceImpl implements HeroService {@Autowiredprivate HeroMapper mapper;@Overridepublic boolean save(Hero hero) {return mapper.insert(hero) > 0;}@Overridepublic boolean update(Hero hero) {return mapper.updateById(hero) > 0;}@Overridepublic boolean deleteById(Integer id) {return mapper.deleteById(id) > 0;}@Overridepublic Hero searchById(Integer id) {return mapper.selectById(id);}@Overridepublic List<Hero> searchAllHero() {return mapper.selectList(null);}@Overridepublic IPage<Hero> searchByPage(int currentPage, int pageSide) {return mapper.selectPage(new Page<>(currentPage, pageSide), null);}}

基于MyBatisPuls构建

        使用MyBatisPlus提供有业务层通用接口(ISerivce<T>)与业务层通用实现类(ServiceImpl<M,T>)

        在通用类基础上做功能重载或功能追加

        注意重载时不要覆盖原始操作，避免原始提供的功能丢失

定义接口

public interface IHeroService extends IService<Hero> {}

定义实现类

public class HeroServiceImplMp extends ServiceImpl<HeroMapper, Hero> implements IHeroService {}

表现层标准开发

表现层接口开发

@RestController
@RequestMapping("/hero")
public class HeroController {@AutowiredHeroServiceImpl heroServiceImpl;@GetMapping("/{id}")public Hero getById(@PathVariable Integer id) {return heroServiceImpl.searchById(id);}@GetMapping("/")public List<Hero> getAllHero() {return heroServiceImpl.searchAllHero();}@PostMapping("/")public void saveHero(@RequestBody Hero hero) {heroServiceImpl.save(hero);}@DeleteMapping("/{id}")public void deleteById(@PathVariable Integer id) {heroServiceImpl.deleteById(id);}@PutMapping("/")public void update(@RequestBody Hero hero) {heroServiceImpl.update(hero);}@GetMapping("/{currentPage}/{pageSide}")public List<Hero> searchByPage(@PathVariable Integer currentPage,@PathVariable Integer pageSide) {return heroServiceImpl.searchByPage(currentPage, pageSide).getRecords();}
}

消息一致性处理

设计表现层返回结果的模型类，用于后端与前端进行数据格式统一，也称为前后端数据协议。表现层接口统一返回值类型结果

@Data
@Component
public class Res {private int code;//类似于状态码private Object data;//储存前端所需要的数据private String msg;//信息说明public Res() {}public Res(int code, Object data, String msg) {this.code = code;this.data = data;this.msg = msg;}
}

异常消息处理

如果服务器出现异常，返回给前端的数据将时默认的，需要添加异常处理器来处理异常。

//作为SpringMVC的异常处理器
//@ControllerAdvice
@RestControllerAdvice
public class ProjectExceptionAdvice {@ExceptionHandlerpublic Res doException1(Exception e) {// 记录日志// 通知运维// 通知开发e.printStackTrace();return new Res(500, null, "error");}// 还可以处理指定异常类型@ExceptionHandler(Exception.class)public Res doException2(Exception e) {// 记录日志// 通知运维// 通知开发e.printStackTrace();return new Res(500, null, "error");}
}