1. 尚医通介绍

1.1 简介

尚医通即为网上预约挂号系统,网上预约挂号是近年来开展的一项便民就医服务,旨在缓解看病难、挂号难的就医难题,许多患者为看一次病要跑很多次医院,最终还不一定能保证看得上医生。网上预约挂号全面提供的预约挂号业务从根本上解决了这一就医难题。随时随地轻松挂号!不用排长队!

1.2 我们能从这个项目中学到什么?

1.2.1 巩固以前知识,学习技术点与技术点应用场景,掌握预约挂号流程

1.2.2 核心技术

SpringBoot:简化新Spring应用的初始搭建以及开发过程
SpringCloud:基于Spring Boot实现的云原生应用开发工具,SpringCloud使用的技术:(SpringCloudGateway、Spring Cloud Alibaba Nacos、Spring Cloud Alibaba Sentinel、SpringCloud Task和SpringCloudFeign等)
MyBatis-Plus:持久层框架
Redis:内存缓存
RabbitMQ:消息中间件
HTTPClient: Http协议客户端
Swagger2:Api接口文档工具
Nginx:负载均衡
Lombok
Mysql:关系型数据库
MongoDB:面向文档的NoSQL数据库

Vue.js:web 界面的渐进式框架
Node.js: JavaScript 运行环境
Axios:Axios 是一个基于 promise 的 HTTP 库
NPM:包管理器
Babel:转码器
Webpack:打包工具

Docker :容器技术
Git:代码管理工具

1.3 业务流程

尚医通业务流程.png

1.4 服务架构

尚医通架构图.png

2. MyBatis-Plus入门

2.1 简介

MyBatis-Plus(简称 MP)是一个 MyBatis 的增强工具,在 MyBatis 的基础上只做增强不做改变,为简化开发、提高效率而生。
润物无声:只做增强不做改变,引入它不会对现有工程产生影响,如丝般顺滑。
效率至上:只需简单配置,即可快速进行 CRUD 操作,从而节省大量时间。
丰富功能:热加载、代码生成、分页、性能分析等功能一应俱全。

2.2 创建并初始化数据库

2.2.1 创建数据库

mybatis_plus

2.2.2 创建User表

  1. CREATE TABLE USER
  2. (
  3. id BIGINT(20)NOT NULL COMMENT '主键ID',
  4. NAME VARCHAR(30)NULL DEFAULT NULL COMMENT '姓名',
  5. age INT(11)NULL DEFAULT NULL COMMENT '年龄',
  6. email VARCHAR(50)NULL DEFAULT NULL COMMENT '邮箱',
  7. PRIMARY KEY (id)
  8. );

对应数据

  1. INSERT INTO user (id, name, age, email)VALUES
  2. (1, 'Jone', 18, 'test1@baomidou.com'),
  3. (2, 'Jack', 20, 'test2@baomidou.com'),
  4. (3, 'Tom', 28, 'test3@baomidou.com'),
  5. (4, 'Sandy', 21, 'test4@baomidou.com'),
  6. (5, 'Billie', 24, 'test5@baomidou.com');

2.3 确认idea配置

2.3.1 打开配置

image.pngimage.png

2.3.2 Java编译器

image.png

2.3.3 项目和文件的编码

image.png

2.3.4 Maven配置

image.png

2.4 创建项目

2.4.1 初始化工程

使用 Spring Initializr 快速初始化一个 Spring Boot 工程
Group:com.atguigu
Artifact:mybatis_plus
版本:2.2.1.RELEASE

2.4.2 引入依赖

注意:引入 MyBatis-Plus 之后请不要再次引入 MyBatis,以避免因版本差异导致的问题。

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter</artifactId>
  5. </dependency>
  6. <dependency>
  7. <groupId>org.springframework.boot</groupId>
  8. <artifactId>spring-boot-starter-test</artifactId>
  9. <scope>test</scope>
  10. <exclusions>
  11. <exclusion>
  12. <groupId>org.junit.vintage</groupId>
  13. <artifactId>junit-vintage-engine</artifactId>
  14. </exclusion>
  15. </exclusions>
  16. </dependency>
  17. <!--mybatis-plus-->
  18. <dependency>
  19. <groupId>com.baomidou</groupId>
  20. <artifactId>mybatis-plus-boot-starter</artifactId>
  21. <version>3.3.1</version>
  22. </dependency>
  23. <!--mysql依赖-->
  24. <dependency>
  25. <groupId>mysql</groupId>
  26. <artifactId>mysql-connector-java</artifactId>
  27. </dependency>
  28. <!--lombok用来简化实体类-->
  29. <dependency>
  30. <groupId>org.projectlombok</groupId>
  31. <artifactId>lombok</artifactId>
  32. <optional>true</optional>
  33. </dependency>
  34. </dependencies>

2.4.3 idea中安装lombok插件

2.5 编写代码

2.5.1 配置

在 application.properties 配置文件中添加 MySQL 数据库的相关配置:
spring boot 2.0(内置jdbc5驱动)

  1. #mysql数据库连接
  2. spring.datasource.driver-class-name=com.mysql.jdbc.Driver
  3. spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_plus?characterEncoding=utf-8&useSSL=false
  4. spring.datasource.username=root
  5. spring.datasource.password=root

spring boot 2.1及以上(内置jdbc8驱动)
注意:driver和url的变化

  1. spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
  2. spring.datasource.url=jdbc:mysql://localhost:3306/mybatis_plus?serverTimezone=GMT%2B8
  3. spring.datasource.username=root
  4. spring.datasource.password=root

注意

1、这里的 url 使用了 ?serverTimezone=GMT%2B8 后缀,因为8.0版本的jdbc驱动需要添加这个后缀,否则运行测试用例报告如下错误: java.sql.SQLException: The server time zone value ‘Öйú±ê׼ʱ¼ä’ is unrecognized or represents more 2、这里的 driver-class-name 使用了 com.mysql.cj.jdbc.Driver ,在 jdbc 8 中建议使用这个驱动,否则运行测试用例的时候会有 WARN 信息

2.5.2 启动类

在 Spring Boot 启动类中添加 @MapperScan 注解,扫描 Mapper 文件夹

  1. @SpringBootApplication
  2. @MapperScan("com.atguigu.demomptest.mapper")
  3. public class DemomptestApplication {
  4. public static void main(String[] args) {
  5. SpringApplication.run(DemomptestApplication.class, args);
  6. }
  7. }

2.5.3 添加实体

创建包 entity 编写实体类 User.java(此处使用了 Lombok 简化代码)

  1. @Data
  2. public class User {
  3. private Long id;
  4. private String name;
  5. private Integer age;
  6. private String email;
  7. }

查看编译结果
image.png

2.5.4 添加mapper

创建包 mapper 编写Mapper 接口: UserMapper.java

  1. @Repository
  2. public interface UserMapper extends BaseMapper<User> {
  3. }

2.5.5 测试

添加测试类,进行功能测试:

  1. @SpringBootTest
  2. class DemomptestApplicationTests {
  3. @Autowired
  4. private UserMapper userMapper;
  5. @Test
  6. public void findAll() {
  7. List<User> users = userMapper.selectList(null);
  8. System.out.println(users);
  9. }
  10. }

注意: IDEA在 userMapper 处报错,因为找不到注入的对象,因为类是动态创建的,但是程序可以正确的执行。 为了避免报错,可以在 dao 层的接口上添加 @Repository 注 通过以上几个简单的步骤,我们就实现了 User 表的 CRUD 功能,甚至连 XML 文件都不用编写! 查看控制台输出:

image.png

2.5.6 查看sql输出日志

  1. #mybatis日志
  2. mybatis-plus.configuration.log-impl=org.apache.ibatis.logging.stdout.StdOutImpl

3. 主键策略

3.1 插入操作

  1. //添加
  2. @Test
  3. public void testAdd() {
  4. User user = new User();
  5. user.setName("lucy");
  6. user.setAge(20);
  7. user.setEmail("1243@qq.com");
  8. int insert = userMapper.insert(user);
  9. System.out.println(insert);
  10. }

注意:数据库插入id值默认为:全局唯一id

image.png

3.2 MP的主键策略

3.2.1 ASSIGN_ID

MyBatis-Plus默认的主键策略是:ASSIGN_ID (使用了雪花算法)

  1. @TableId(type = IdType.ASSIGN_ID)
  2. private String id;

雪花算法:分布式ID生成器 雪花算法是由Twitter公布的分布式主键生成算法,它能够保证不同表的主键的不重复性,以及相同表的主键的有序性。

核心思想

长度共64bit(一个long型)。 首先是一个符号位,1bit标识,由于long基本类型在Java中是带符号的,最高位是符号位,正数是0,负数是1,所以id一般是正数,最高位是0。 41bit时间截(毫秒级),存储的是时间截的差值(当前时间截 - 开始时间截),结果约等于69.73年。 10bit作为机器的ID(5个bit是数据中心,5个bit的机器ID,可以部署在1024个节点)。 12bit作为毫秒内的流水号(意味着每个节点在每毫秒可以产生 4096 个 ID)。

image.png

优点:整体上按照时间自增排序,并且整个分布式系统内不会产生ID碰撞,并且效率较高。

3.2.2 AUTO自增策略

需要在创建数据表的时候设置主键自增
实体字段中配置 @TableId(type = IdType.AUTO)

  1. @TableId(type = IdType.AUTO)
  2. private Long id;

要想影响所有实体的配置,可以设置全局主键配置

  1. #全局设置主键生成策略
  2. mybatis-plus.global-config.db-config.id-type=auto

4. 自动填充和乐观锁

4.1 更新操作

注意:update时生成的sql自动是动态sql:UPDATE user SET age=? WHERE id=?

  1. //修改
  2. @Test
  3. public void testUpdate() {
  4. User user = new User();
  5. user.setId(1340868235401764865L);
  6. user.setName("lucymary");
  7. int count = userMapper.updateById(user);
  8. System.out.println(count);
  9. }

4.2 自动填充

需求描述:
项目中经常会遇到一些数据,每次都使用相同的方式填充,例如记录的创建时间,更新时间等。
我们可以使用MyBatis Plus的自动填充功能,完成这些字段的赋值工作

4.2.1 数据库修改

在User表中添加datetime类型的新的字段 create_time、update_time

4.2.2 实体类修改

实体上增加字段并添加自动填充注解

  1. @TableField(fill = FieldFill.INSERT)
  2. private Date createTime; //create_time
  3. @TableField(fill = FieldFill.INSERT_UPDATE)
  4. private Date updateTime; //update_time

4.2.3 实体元第项处理器接口

注意:不要忘记添加 @Component 注解

  1. @Component
  2. public class MyMetaObjectHandler implements MetaObjectHandler {
  3. //mp执行添加操作,这个方法执行
  4. @Override
  5. public void insertFill(MetaObject metaObject) {
  6. this.setFieldValByName("createTime",new Date(),metaObject);
  7. this.setFieldValByName("updateTime",new Date(),metaObject);
  8. }
  9. //mp执行修改操作,这个方法执行
  10. @Override
  11. public void updateFill(MetaObject metaObject) {
  12. this.setFieldValByName("updateTime",new Date(),metaObject);
  13. }
  14. }

4.3 乐观锁

4.3.1 场景

主要适用场景:当要更新一条记录的时候,希望这条记录没有被别人更新,也就是说实现线程安全的数据更新
乐观锁实现方式:
取出记录时,获取当前version
更新时,带上这个version
执行更新时, set version = newVersion where version = oldVersion
如果version不对,就更新失败
接下来介绍如何在Mybatis-Plus项目中,使用乐观锁:

4.4 乐观锁实现流程

4.4.1 修改实体类

添加 @Version 注解

  1. @Version
  2. private Integer version;

4.4.2 创建配置文件

创建包config,创建文件MybatisPlusConfig.java
此时可以删除主类中的 @MapperScan 扫描注解

  1. @Configuration
  2. @MapperScan("com.atguigu.demomptest.mapper")
  3. public class MpConfig {
  4. /**
  5. * 乐观锁插件
  6. */
  7. @Bean
  8. public OptimisticLockerInterceptor optimisticLockerInterceptor() {
  9. return new OptimisticLockerInterceptor();
  10. }
  11. }

4.4.3 注册乐观锁插件

在 MybatisPlusConfig 中注册 Bean

  1. /**
  2. * 乐观锁插件
  3. */
  4. @Bean
  5. public OptimisticLockerInterceptor optimisticLockerInterceptor() {
  6. return new OptimisticLockerInterceptor();
  7. }

5. 查询

5.1 查询

5.1.1 通过多个id批量查询

完成了动态sql的foreach的功能

  1. //多个id批量查询
  2. @Test
  3. public void testSelect1() {
  4. List<User> users = userMapper.selectBatchIds(Arrays.asList(1, 2, 3));
  5. System.out.println(users);
  6. }

5.1.2 简单的条件查询

通过map封装查询条件
注意:map中的key对应数据库中的列名。如:数据库user_id,实体类是userId,这时map的key需要填写user_id

  1. //简单条件查询
  2. @Test
  3. public void testSelect2() {
  4. Map<String, Object> columnMap = new HashMap<>();
  5. columnMap.put("name","Jack");
  6. columnMap.put("age",20);
  7. List<User> users = userMapper.selectByMap(columnMap);
  8. System.out.println(users);
  9. }

5.2 分页

5.2.1 分页插件

MyBatis Plus自带分页插件,只要简单的配置即可实现分页功能

5.2.1.1 添加分页插件

配置类中添加@Bean配置

  1. /**
  2. * 分页插件
  3. */
  4. @Bean
  5. public PaginationInterceptor paginationInterceptor() {
  6. return new PaginationInterceptor();
  7. }

5.2.1.2 测试selectPage分页

测试:最终通过page对象获取相关数据

  1. //分页查询
  2. @Test
  3. public void testSelectPage() {
  4. Page<User> page = new Page(1,3);
  5. Page<User> userPage = userMapper.selectPage(page, null);
  6. //返回对象得到分页所有数据
  7. long pages = userPage.getPages(); //总页数
  8. long current = userPage.getCurrent(); //当前页
  9. List<User> records = userPage.getRecords(); //查询数据集合
  10. long total = userPage.getTotal(); //总记录数
  11. boolean hasNext = userPage.hasNext(); //下一页
  12. boolean hasPrevious = userPage.hasPrevious(); //上一页
  13. System.out.println(pages);
  14. System.out.println(current);
  15. System.out.println(records);
  16. System.out.println(total);
  17. System.out.println(hasNext);
  18. System.out.println(hasPrevious);
  19. }

5.2.2 测试selectMapsPage分页

当指定了特定的查询列时,希望分页结果列表只返回被查询的列,而不是很多null值
测试selectMapsPage分页:结果集是Map

  1. @Test
  2. public void testSelectMapsPage() {
  3. //Page不需要泛型
  4. Page<Map<String, Object>> page = newPage<>(1, 5);
  5. Page<Map<String, Object>> pageParam = userMapper.selectMapsPage(page, null);
  6. List<Map<String, Object>> records = pageParam.getRecords();
  7. records.forEach(System.out::println);
  8. System.out.println(pageParam.getCurrent());
  9. System.out.println(pageParam.getPages());
  10. System.out.println(pageParam.getSize());
  11. System.out.println(pageParam.getTotal());
  12. System.out.println(pageParam.hasNext());
  13. System.out.println(pageParam.hasPrevious());
  14. }

6. 删除与逻辑删除

6.1 删除

6.1.1 根据id删除记录

  1. @Test
  2. public void testDeleteById(){
  3. int result = userMapper.deleteById(5L);
  4. System.out.println(result);
  5. }

6.1.2 批量删除

  1. @Test
  2. public void testDeleteBatchIds() {
  3. int result = userMapper.deleteBatchIds(Arrays.asList(8, 9, 10));
  4. System.out.println(result);
  5. }

6.1.3 简单条件删除

  1. @Test
  2. public void testDeleteByMap() {
  3. HashMap<String, Object> map = new HashMap<>();
  4. map.put("name", "Helen");
  5. map.put("age", 18);
  6. int result = userMapper.deleteByMap(map);
  7. System.out.println(result);
  8. }

6.2 逻辑删除

6.2.1 物理删除和逻辑删除

物理删除:真实删除,将对应数据从数据库中删除,之后查询不到此条被删除数据
逻辑删除:假删除,将对应数据中代表是否被删除字段状态修改为“被删除状态”,之后在数据库中仍旧能看到此条数据记录

逻辑删除的使用场景:
可以进行数据恢复
有关联数据,不便删除

6.2.2 逻辑删除实现流程

6.2.2.1 数据库修改

添加 deleted字段

  1. ALTERTABLE `user` ADD COLUMN `deleted` boolean DEFAULT false

6.2.2.2 实体类修改

添加deleted 字段,并加上 @TableLogic 注解

  1. @TableLogic
  2. private Integer deleted;

6.2.2.3 配置(可选)

application.properties 加入以下配置,此为默认值,如果你的默认值和mp默认的一样,该配置可无

  1. mybatis-plus.global-config.db-config.logic-delete-value=1
  2. mybatis-plus.global-config.db-config.logic-not-delete-value=0

6.2.2.4 测试

测试后发现,数据并没有被删除,deleted字段的值由0变成了1
测试后分析打印的sql语句,是一条update
注意:被删除前,数据的deleted 字段的值必须是 0,才能被选取出来执行逻辑删除的操作

  1. @Test
  2. public void testLogicDelete() {
  3. int result = userMapper.deleteById(1L);
  4. System.out.println(result);
  5. }

6.2.2.5 测试逻辑删除后的查询

MyBatis Plus中查询操作也会自动添加逻辑删除字段的判断

  1. @Test
  2. public void testLogicDeleteSelect() {
  3. List<User> users = userMapper.selectList(null);
  4. users.forEach(System.out::println);
  5. }

7. 条件构造器和常用接口

7.1 wapper介绍

image.png
Wrapper :条件构造抽象类,最顶端父类
AbstractWrapper :用于查询条件封装,生成 sql 的 where 条件
QueryWrapper :查询条件封装
UpdateWrapper : Update 条件封装
AbstractLambdaWrapper :使用Lambda 语法
LambdaQueryWrapper :用于Lambda语法使用的查询Wrapper
LambdaUpdateWrapper : Lambda 更新封装Wrapper

  1. @SpringBootTest
  2. publicclassQueryWrapperTests {
  3. @Autowired
  4. privateUserMapperuserMapper;
  5. }

7.2 测试用例

7.2.1 ge、gt、le、lt、isNull、isNotNull

  1. @Test
  2. public void testQuery() {
  3. QueryWrapper<User>queryWrapper = new QueryWrapper<>();
  4. queryWrapper
  5. .isNull("name")
  6. .ge("age", 12)
  7. .isNotNull("email");
  8. int result = userMapper.delete(queryWrapper);
  9. System.out.println("delete return count = " + result);
  10. }

7.2.2 eq、ne

注意:seletOne()返回的是一条实体记录,当出现多条时会报错

  1. @Test
  2. public void testSelectOne() {
  3. QueryWrapper<User>queryWrapper = newQueryWrapper<>();
  4. queryWrapper.eq("name", "Tom");
  5. Useruser = userMapper.selectOne(queryWrapper);//只能返回一条记录,多余一条则抛出异常
  6. System.out.println(user);
  7. }

7.2.3 between、notbetween

包含大小边界

  1. @Test
  2. public void testSelectCount() {
  3. QueryWrapper<User>queryWrapper = new QueryWrapper<>();
  4. queryWrapper.between("age", 20, 30);
  5. Integer count = userMapper.selectCount(queryWrapper); //返回数据数量
  6. System.out.println(count);
  7. }

7.2.4 like、notLike、likeLeft、likeRight

selectMaps()返回Map集合列表,通常配合select()使用

  1. @Test
  2. public void testSelectMaps() {
  3. QueryWrapper<User>queryWrapper = new QueryWrapper<>();
  4. queryWrapper
  5. .select("name", "age")
  6. .like("name", "e")
  7. .likeRight("email", "5");
  8. List<Map<String, Object>>maps = userMapper.selectMaps(queryWrapper);//返回值是Map列表
  9. maps.forEach(System.out::println);
  10. }

7.2.5 orderBy、orderByDesc、orderByAsc

  1. @Test
  2. public void testSelectListOrderBy() {
  3. QueryWrapper<User>queryWrapper = newQueryWrapper<>();
  4. queryWrapper.orderByDesc("age", "id");
  5. List<User>users = userMapper.selectList(queryWrapper);
  6. users.forEach(System.out::println);
  7. }

7.3 查询方式

查询方式 说明
setSqlSelect 设置 SELECT 查询字段
where WHERE 语句,拼接 + WHERE 条件
and AND 语句,拼接 + AND 字段=值
andNew AND 语句,拼接 + AND (字段=值)
or OR 语句,拼接 + OR 字段=值
orNew OR 语句,拼接 + OR (字段=值)
eq 等于=
allEq 基于 map 内容等于=
ne 不等于<>
gt 大于>
ge 大于等于>=
lt 小于<
le 小于等于<=
like 模糊查询 LIKE
notLike 模糊查询 NOT LIKE
in IN 查询
notIn NOT IN 查询
isNull NULL 值查询
isNotNull IS NOT NULL
groupBy 分组 GROUP BY
having HAVING 关键词
orderBy 排序 ORDER BY
orderAsc ASC 排序 ORDER BY
orderDesc DESC 排序 ORDER BY
exists EXISTS 条件语句
notExists NOT EXISTS 条件语句
between BETWEEN 条件语句
notBetween NOT BETWEEN 条件语句
addFilter 自由拼接 SQL
last 拼接在最后,例如:last(“LIMIT 1”)