当前位置:   article > 正文

【Java笔记+踩坑】SpringBoot——基础_java war应用调用springboot

java war应用调用springboot

  导航:

【黑马Java笔记+踩坑汇总】JavaSE+JavaWeb+SSM+SpringBoot+瑞吉外卖+SpringCloud/SpringCloudAlibaba+黑马旅游+谷粒商城

目录

1,SpringBoot简介

1.0 SpringMvc回顾 

1.1 SpringBoot快速入门

1.1.1 开发步骤

1.1.2 SpringBoot 对比Spring

1.1.3 官网构建工程

1.1.4 SpringBoot工程打包启动

1.2 SpringBoot概述

1.2.1 起步依赖

1.2.2 程序启动

1.2.3 切换web服务器,由Tomcat切换成Jetty

2,配置文件

2.1 配置文件格式

2.1.1 环境准备

2.1.2 不同配置文件配置端口

2.1.3 三种配置文件的优先级

2.2 yaml配置文件介绍

2.2.1 概述

2.2.2 语法规则

2.2.3 常用配置、清理控制台

2.3 yaml配置文件数据读取

2.3.1 环境准备

2.3.2 三种读取yaml配置数据的方式

2.4 多环境配置

2.4.1 yaml文件

2.4.2 properties文件

2.4.3 命令行启动参数设置,修改端口、环境

2.4.4 maven和springboot多环境开发兼容

2.5 配置文件分类

2.5.1 概述

2.5.1 代码演示

3,SpringBoot整合junit

3.0 回顾 Spring 整合 junit

3.1 环境准备

3.2 编写测试类,@SpringBootTest

4,SpringBoot整合mybatis

4.1 回顾Spring整合Mybatis

4.2 SpringBoot整合mybatis

4.2.1 创建模块

4.2.2 定义实体类

4.2.3 定义dao接口

4.2.4 定义测试类

4.2.5 编写配置

4.2.6 代码测试,根据id查书籍

4.2.7 配置内置数据源、Druid数据源

4.3 案例,整合ssm的书籍增删改查项目

4.3.1 创建工程

4.3.2 代码拷贝、dao注解@Mapper、WebMvcConfigurer添加资源处理器、拦截器

4.3.3 yml配置端口、数据源

4.3.4 静态资源

4.4 SpringBoot整合MyBatis-Plus回顾

5、SSMP整合综合案例,Book增删改查分页

0.模块创建

1.实体类开发,lombok

2.数据层开发——基础CRUD

3.数据层开发——分页功能制作

4.数据层开发——条件查询功能制作

5.业务层开发

业务层快速开发(慎用)

6.表现层开发

7.表现层消息一致性处理

8.前后端联通性测试

9.页面基础功能开发

F-1.列表功能(非分页版)

F-2.添加功能

F-3.删除功能

F-4.修改功能

10.业务消息一致性处理

11.页面功能开发

F-5.分页功能

F-6.删除功能维护

F-7.条件查询功能


1,SpringBoot简介

1.0 SpringMvc回顾 

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

使用了 Spring 框架后已经简化了我们的开发。而 SpringBoot 又是对 Spring 开发进行简化的,可想而知 SpringBoot 使用的简单及广泛性。

回顾 SpringMVC

  • 1.创建工程,并在 pom.xml 配置文件中配置所依赖的坐标,还可以导入jackson,JSON类型转换

img

  • 2.编写 web3.0 的配置类

    作为 web 程序,web3.0 的配置类不能缺少,而这个配置类还是比较麻烦的,代码如下

img

  • 3.编写 SpringMVC 的配置类

img

做到这只是将工程的架子搭起来。要想被外界访问,最起码还需要提供一个 Controller 类,在该类中提供一个方法。

  • 4.编写 Controller

img

从上面的 SpringMVC 程序开发可以看到,前三步都是在搭建环境,而且这三步基本都是固定的。SpringBoot 就是对这三步进行简化了。接下来我们通过一个入门案例来体现 SpingBoot 简化 Spring 开发。

1.1 SpringBoot快速入门

1.1.1 开发步骤

SpringBoot 开发起来特别简单,分为如下几步:

  1. 创建新模块,选择Spring初始化,并配置模块相关基础信息
  2. 选择当前模块需要使用的技术集
  3. 开发控制器类
  4. 运行自动生成的Application类

知道了 SpringBoot 的开发步骤后,接下来我们进行具体的操作

创建新模块

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

img

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

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

img

  • SpringBoot 工程进行相关的设置

    我们使用这种方式构建的 SpringBoot 工程其实也是 Maven 工程,而该方式只是一种快速构建的方式而已。注意选择的包是jar,不是war。java版本和jdk版本一致,包名跟组名写一样方便阅读。

    img

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

img

  • 选中 Web,然后勾选 Spring Web

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

img

img

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

img

经过以上步骤后就创建了如下结构的模块,它会帮我们自动生成一个 Application 类,而该类一会再启动服务器时会用到。

  • 删除选中的文件、目录:

img

img

报错解决:

如果maven模块的pom图标显示不正常,就右键pom.xml,添加成Maven项目:

找不到插件 'org.springframework.boot:spring-boot-maven-plugin:':

手动导入版本,版本号与springboot一致:

  1. <plugin>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-maven-plugin</artifactId>
  4. <version>2.7.3</version>
  5. </plugin>

注意:

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

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

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

    • .mvn
    • .gitignore
    • HELP.md
    • mvnw
    • mvnw.cmd

所有文件介绍:

  • \1. .gitignore:分布式版本控制系统git的配置文件,意思为忽略提交
  • 在 .gitingore 文件中,遵循相应的语法,即在每一行指定一个忽略规则。 如:.log、/target/、.idea
  • \2. mvnw:全名是maven wrapper的文件
  • 它的作用是在maven-wrapper.properties文件中记录你要使用的maven版本,当用户执行mvnw clean 命令时,发现当前用户的maven版本和期望的版本不一致,那么就下载期望的版本,然后用期望的版本来执行mvn命令,比如mvn clean命令。
  • \3. mvn文件夹:存放mvnw相关文件
  • 存放着maven-wrapper.properties和相关jar包以及名为MavenWrapperDownloader的java文件
  • \4. mvn.cmd:执行mvnw命令的cmd入口
  • 注:mvnw文件适用于Linux(bash),mv斜体样式*nw.cmd适用于Windows 环境。
  • \5. .iml文件:intellij idea的工程配置文件
  • 里面包含当前project的一些配置信息,如模块开发的相关信息,比如java组件,maven组件,插件组件等,还可能会存储一些模块路径信息,依赖信息以及一些别的信息。
  • \6. .idea文件夹:存放项目的配置信息
  • 包括数据源,类库,项目字符编码,历史记录,版本控制信息等。
  • \7. pom.xml:项目对象模型(核心重要)
  • pom.xml主要描述了项目的maven坐标,依赖关系,开发者需要遵循的规则,缺陷管理系统,组织和licenses,以及其他所有的项目相关因素,是项目级别的配置文件。

创建 Controller

com.itheima.controller 包下创建 BookController ,代码如下:

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @GetMapping("/{id}")
  5. public String getById(@PathVariable Integer id){
  6. System.out.println("id ==> "+id);
  7. return "hello , spring boot!";
  8. }
  9. }

启动服务器

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

img

启动后修改配置:

img

img

如果报错:找不到插件org.springframework.boot spring-boot-*maven*-plugin

进入C:\Users\用户名.m2\repository

然后在这个文件夹下搜索spring-boot-maven-plugin,打开这个文件夹,里面都是版本号

img

选择加入pom.xml即可:

img

进行测试

使用 Postman 工具来测试我们的程序

img

SpringBoot 是如何让开发变简单的呢?

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

要研究这个问题,我们需要看看 Application 类和 pom.xml 都书写了什么。先看看 Applicaion 类,该类内容如下:

  1. @SpringBootApplication
  2. public class Application {
  3. public static void main(String[] args) {
  4. SpringApplication.run(Application.class, args);
  5. }
  6. }

这个类中的东西很简单,就在类上添加了一个 @SpringBootApplication 注解,而在主方法中就一行代码。我们在启动服务器时就是执行的该类中的主方法

再看看 pom.xml 配置文件中的内容,可以发现除了打包插件之外,引入的父工程、两个依赖前缀都是spring-boot-starter

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3. xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  4. <modelVersion>4.0.0</modelVersion>
  5. <!--指定了一个父工程,父工程中的东西在该工程中可以继承过来使用-->
  6. <parent>
  7. <groupId>org.springframework.boot</groupId>
  8. <artifactId>spring-boot-starter-parent</artifactId>
  9. <version>2.5.0</version>
  10. </parent>
  11. <groupId>com.itheima</groupId>
  12. <artifactId>springboot_01_quickstart</artifactId>
  13. <version>0.0.1-SNAPSHOT</version>
  14. <!--JDK 的版本-->
  15. <properties>
  16. <java.version>8</java.version>
  17. </properties>
  18. <dependencies>
  19. <!--该依赖就是我们在创建 SpringBoot 工程勾选的那个 Spring Web 产生的-->
  20. <dependency>
  21. <groupId>org.springframework.boot</groupId>
  22. <artifactId>spring-boot-starter-web</artifactId>
  23. </dependency>
  24. <!--这个是单元测试的依赖,我们现在没有进行单元测试,所以这个依赖现在可以没有-->
  25. <dependency>
  26. <groupId>org.springframework.boot</groupId>
  27. <artifactId>spring-boot-starter-test</artifactId>
  28. <scope>test</scope>
  29. </dependency>
  30. </dependencies>
  31. <build>
  32. <plugins>
  33. <!--这个插件是在打包时需要的,而这里暂时还没有用到-->
  34. <plugin>
  35. <groupId>org.springframework.boot</groupId>
  36. <artifactId>spring-boot-maven-plugin</artifactId>
  37. </plugin>
  38. </plugins>
  39. </build>
  40. </project>

1.1.2 SpringBoot 对比Spring

做完 SpringBoot 的入门案例后,接下来对比一下 Spring 程序和 SpringBoot 程序。如下图

img

  • 坐标

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

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

  • web3.0配置类

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

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

  • 配置类

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

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

1.1.3 官网构建工程

在入门案例中之所以能快速构建 SpringBoot 工程,是因为 Idea 使用了官网提供了快速构建 SpringBoot 工程的组件实现的。那如何在官网进行工程构建呢?通过如下步骤构建

进入SpringBoot官网

官网地址如下:

https://spring.io/projects/spring-boot

进入到 SpringBoot 官网后拖到最下方就可以看到如下内容

img

然后点击 Spring Initializr 超链接就会跳转到如下页面

img

这个页面内容是不是感觉很眼熟的,这和我们使用 Idea 快速构建 SpringBoot 工程的界面基本相同。在上面页面输入对应的信息

选择依赖

选择 Spring Web 可以点击上图右上角的 ADD DEPENDENCIES... CTRL + B 按钮,就会出现如下界面

img

生成工程

以上步骤完成后就可以生成 SpringBoot 工程了。在页面的最下方点击 GENERATE CTRL + 回车 按钮生成工程并下载到本地,如下图所示

img

打开下载好的压缩包可以看到工程结构和使用 Idea 生成的一模一样,如下图

img

而打开 pom.xml 文件,里面也包含了父工程和 Spring Web 的依赖。

通过上面官网的操作,我们知道 Idea 中快速构建 SpringBoot 工程其实就是使用的官网的快速构建组件,那以后即使没有 Idea 也可以使用官网的方式构建 SpringBoot 工程。

1.1.4 SpringBoot工程打包启动

问题导入

img

以后我们和前端开发人员协同开发,而前端开发人员需要测试前端程序就需要后端开启服务器,这就受制于后端开发人员。为了摆脱这个受制,前端开发人员尝试着在自己电脑上安装 TomcatIdea ,在自己电脑上启动后端程序,这显然不现实。

我们后端可以将 SpringBoot 工程打成 jar,该 jar运行不依赖于 TomcatIdea 这些工具也可以正常运行,只是这个 jar 包在运行过程中连接和我们自己程序相同的 Mysql 数据库即可。这样就可以解决这个问题,如下图

img

打包

打包package前先clean是好习惯。

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

  1. //spring-boot-maven-plugin插件打包时需要的
  2. <plugin>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-maven-plugin</artifactId>
  5. </plugin>

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

img

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

启动

img

进入 jar 包所在位置,地址栏输入cmd回车,在 命令提示符 中输入如下命令(将jar包名字改为自己的):

java -jar springboot_01_quickstart-0.0.1-SNAPSHOT.jar

启动jar包并覆盖设置端口、 切换环境:

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

执行上述命令就可以看到 SpringBoot 运行的日志信息

img

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

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

1.2 SpringBoot概述

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

大家已经感受了 SpringBoot 程序,回过头看看 SpringBoot 主要作用是什么,就是简化 Spring 的搭建过程和开发过程。

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

  • 配置繁琐
  • 依赖设置繁琐

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

  • 自动配置。这个是用来解决 Spring 程序配置繁琐的问题
  • 起步依赖(简化以来配置)。这个是用来解决 Spring 程序依赖设置繁琐的问题
  • 辅助功能(内置服务器,...)。我们在启动 SpringBoot 程序时既没有使用本地的 tomcat 也没有使用 tomcat 插件,而是使用 SpringBoot 内置的服务器

接下来我们来说一下 SpringBoot 的起步依赖

1.2.1 起步依赖

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

img

这些依赖就是启动依赖,接下来我们探究一下他是如何实现的。

1.2.1.1 探索父工程

爷工程spring-boot-dependencies.pom里配置了各依赖插件的特定版本,因此我们只需要使用对应版本的springboot,在pom.xml里配置不含版本的插件或依赖,就可以继承对应插件或依赖。

爷工程pom.xml查看:

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

img

再进入到该父工程中,在该工程中我们可以看到配置内容结构如下图所示

img

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

img

properties 中我们找 servletmysql 的版本如下图

img

爷工程pom.xml里依赖管理标签:

dependencyManagement 标签是进行依赖版本锁定,但是并没有导入对应的依赖

如果我们工程需要哪个依赖只需要引入依赖的 groupidartifactId 不需要定义 version

img

爷工程pom.xml里插件管理:

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

img

看完了父工程中 pom.xml 的配置后不难理解我们工程的的依赖不配置 version的原因

1.2.1.2 探索依赖

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

img

进入到该依赖,查看 pom.xml 的依赖会发现它引入了如下的依赖

img

里面引入了 spring-webspring-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(要小心版本冲突)

1.2.2 程序启动

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

  1. @SpringBootApplication
  2. public class Springboot01QuickstartApplication {
  3. public static void main(String[] args) {
  4. SpringApplication.run(Springboot01QuickstartApplication.class, args);
  5. }
  6. }

注意:

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

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

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

1.2.3 切换web服务器,由Tomcat切换成Jetty

使用spring-boot-starter-web 依赖实现内置Tomcat服务器,是springboot带来的辅助功能。

现在我们启动工程使用的是 tomcat 服务器,那能不能不使用 tomcat 而使用 jetty 服务器

jetty 在我们 maven 高级时讲 maven 私服使用的服务器,比Tomcat更轻量级,可扩展性强,谷歌应用引擎已全面切换为Jetty,但目前大型应用一般用的还是Tomcat。

而要切换 web 服务器就需要使用 exclusion 标签将默认的 tomcat 服务器给排除掉。

排除Tomcat依赖

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-web</artifactId>
  4. <exclusions>
  5. <exclusion>
  6. <artifactId>spring-boot-starter-tomcat</artifactId>
  7. <groupId>org.springframework.boot</groupId>
  8. </exclusion>
  9. </exclusions>
  10. </dependency>

引入 jetty 的起步依赖:

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-jetty</artifactId>
  4. </dependency>

接下来再次运行引导类,在日志信息中就可以看到使用的是 jetty 服务器

img

小结:

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

2,配置文件

2.1 配置文件格式

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

http://localhost:8080/books/1

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

http://localhost/books/1

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

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

    server.port=80
    
  • application.yml(以后用这种)

    1. server:
    2. port: 81
  • application.yaml

    1. server:
    2. port: 82

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

2.1.1 环境准备

创建一个新工程 springboot_02_base_config 用来演示不同的配置文件,工程环境和入门案例一模一样,结构如下:

img

在该工程中的 com.itheima.controller 包下创建一个名为 BookController 的控制器。内容如下:

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @GetMapping("/{id}")
  5. public String getById(@PathVariable Integer id){
  6. System.out.println("id ==> "+id);
  7. return "hello , spring boot!";
  8. }
  9. }

2.1.2 不同配置文件配置端口

  • 方法一(默认,不建议):application.properties配置文件

现在需要进行配置,配合文件必须放在 resources 目录下,而该目录下有一个名为 application.properties 的配置文件,我们就可以在该配置文件中修改端口号,在该配置文件中书写 portIdea 就会提示,如下

img

application.properties 配置文件内容如下:

  1. #端口号
  2. server.port = 8888
  3. #项目名,如果不设定,默认是 /
  4. server.servlet.context-path : /demo

启动服务,会在控制台打印出日志信息,从日志信息中可以看到绑定的端口号已经修改了

img

  • 方法二(以后使用):application.yml配置文件

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

  1. server:
  2. #端口号
  3. port: 8888
  4. #项目名,如果不设定,默认是 /
  5. servlet:
  6. context-path: /demo

注意: 在:后,数据前一定要加空格。

而在 yml 配置文件中也是有提示功能的,我们也可以在该文件中书写 port ,然后 idea 就会提示并书写成上面的格式

img

启动服务,可以在控制台看到绑定的端口号是 81

img

  • 方法三(不建议):application.yaml配置文件

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

application.yaml 配置文件内容如下:

  1. server:
  2. port: 83

启动服务,在控制台可以看到绑定的端口号

img

注意:在配置文件中输入port,如果没有提示,可以使用以下方式解决

  • 点击 File 选中 Project Structure

img

  • 弹出如下窗口,按图中标记红框进行选择

img

  • 通过上述操作,会弹出如下窗口

img

  • 点击上图的 + 号,弹出选择该模块的配置文件

img

  • 通过上述几步后,就可以看到如下界面。properties 类型的配合文件有一个,ymal 类型的配置文件有两个

img

2.1.3 三种配置文件的优先级

结论:优先级properties>yml>yaml

在三种配合文件中分别配置不同的端口号,启动服务查看绑定的端口号。用这种方式就可以看到哪个配置文件的优先级更高一些

application.properties 文件内容如下:

server.port=80

application.yml 文件内容如下:

  1. server:
  2. port: 81

application.yaml 文件内容如下:

  1. server:
  2. port: 82

启动服务,在控制台可以看到使用的端口号是 80。说明 application.properties 的优先级最高

注释掉 application.properties 配置文件内容。再次启动服务,在控制台可以看到使用的端口号是 81,说明 application.yml 配置文件为第二优先级。

从上述的验证结果可以确定三种配置文件的优先级是:

application.properties > application.yml > application.yaml

注意:

  • SpringBoot 核心配置文件名为 application

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

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

    1. logging:
    2. level:
    3. root: info

2.2 yaml配置文件介绍

2.2.1 概述

properties 类型的配合文件之前我们学习过,接下来我们重点学习 yaml 类型的配置文件。

yaml格式扩展名:.yml(主流)或.yaml。

YAML(YAML Ain't Markup Language),一种数据序列化格式。这种格式的配置文件在近些年已经占有主导地位,那么这种配置文件和前期使用的配置文件是有一些优势的,我们先看之前使用的配置文件。

最开始我们使用的是 xml ,格式如下:

  1. <enterprise>
  2. <name>itcast</name>
  3. <age>16</age>
  4. <tel>4006184000</tel>
  5. </enterprise>

properties 类型的配置文件如下

  1. enterprise.name=itcast
  2. enterprise.age=16
  3. enterprise.tel=4006184000

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

  1. enterprise:
  2. name: itcast
  3. age: 16
  4. tel: 4006184000

优点:

  • 容易阅读

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

  • 容易与脚本语言交互

  • 以数据为核心,重数据轻格式,如下图数据清爽

    yaml 更注重数据,而 xml 更注重格式

img

YAML 文件扩展名:

  • .yml (主流)
  • .yaml

上面两种后缀名都可以,以后使用更多的还是 yml 的。

2.2.2 语法规则

  • 大小写敏感

  • 属性层级关系使用多行描述,每行结尾使用冒号结束(这里冒号说的是标签名后的冒号

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

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

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

  • #表示注释

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

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

  1. enterprise:
  2. name: itcast
  3. age: 16
  4. tel: 4006184000
  5. subject:
  6. - Java
  7. - 前端
  8. - 大数据

连接符---作用:单文件中可以通过---实现多文件的效果。

  1. #开发
  2. spring:
  3. profiles: dev #给开发环境起的名字
  4. server:
  5. port: 80
  6. ---
  7. #生产
  8. spring:
  9. profiles: pro #给生产环境起的名字
  10. server:
  11. port: 81
  12. ---
  13. #测试
  14. spring:
  15. profiles: test #给测试环境起的名字
  16. server:
  17. port: 82
  18. ---

2.2.3 常用配置、清理控制台

properties下新建logback.xml:

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <configuration>
  3. </configuration>

  1. server:
  2. port: 80
  3. spring:
  4. datasource:
  5. type: com.alibaba.druid.pool.DruidDataSource
  6. url: jdbc:mysql://localhost/ssm_db?serverTimezone=UTC
  7. username: root
  8. password: 填密码
  9. driver-class-name: com.mysql.cj.jdbc.Driver
  10. main:
  11. banner-mode: off
  12. mybatis-plus:
  13. global-config:
  14. db-config:
  15. table-prefix: tbl_
  16. #关闭图标
  17. banner: false
  18. #打开日志
  19. configuration:
  20. log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

2.3 yaml配置文件数据读取

2.3.1 环境准备

新创建一个名为 springboot_03_read_dataSpringBoot 工程,目录结构如下

img

com.itheima.controller 包写创建名为 BookController 的控制器,内容如下

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @GetMapping("/{id}")
  5. public String getById(@PathVariable Integer id){
  6. System.out.println("id ==> "+id);
  7. return "hello , spring boot!";
  8. }
  9. }

com.itheima.domain 包下创建一个名为 Enterprise 的实体类等会用来封装数据,内容如下

  1. public class Enterprise {
  2. private String name;
  3. private int age;
  4. private String tel;
  5. private String[] subject;
  6. //自己加上setter and getter,别忘了,别忘了,别忘了
  7. //toString
  8. }

resources 下创建一个名为 application.yml 的配置文件,里面配置了不同的数据,内容如下

  1. lesson: SpringBoot
  2. server:
  3. port: 80
  4. enterprise:
  5. name: itcast
  6. age: 16
  7. tel: 4006184000
  8. subject:
  9. - Java
  10. - 前端
  11. - 大数据

2.3.2 三种读取yaml配置数据的方式

2.3.2.1 使用 @Value注解读取yaml(适合少量数据)

使用 @Value("表达式") 注解可以从配合文件中读取数据,注解中用于读取属性名引用方式跟Spring里一样,是:${一级属性名.二级属性名……}

这种方法和Spring读取配置文件很像,不同点是Spring要读取配置文件,要先在SpringConfig配置类扫描配置文件,例如@PropertySource("classpath:jdbc.properties")

我们可以在 BookController 中使用 @Value 注解读取配合文件数据,如下

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @Value("${lesson}")
  5. private String lesson;
  6. @Value("${server.port}")
  7. private Integer port;
  8. @Value("${enterprise.subject[0]}")
  9. private String subject_00;
  10. @GetMapping("/{id}")
  11. public String getById(@PathVariable Integer id){
  12. System.out.println(lesson);
  13. System.out.println(port);
  14. System.out.println(subject_00);
  15. return "hello , spring boot!";
  16. }
  17. }

2.3.2.2 自动注入Environment对象读取yaml(少用,了解)

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

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @Autowired
  5. private Environment env;
  6. @GetMapping("/{id}")
  7. public String getById(@PathVariable Integer id){
  8. System.out.println(env.getProperty("lesson"));
  9. System.out.println(env.getProperty("enterprise.name"));
  10. System.out.println(env.getProperty("enterprise.subject[0]"));
  11. return "hello , spring boot!";
  12. }
  13. }

注意:这种方式,框架内容大量数据,而在开发中我们很少使用。

2.3.2.3 自定义实体类bean读取yaml(最常用),@ConfigurationProperties

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

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

    在类上添加 @Component 注解

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

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

  • BookController 中进行注入

为什么这种方法最常用:

例如配置Mybatis时候,会定义一个实体类bean,加载yaml中的数据库信息。

具体代码如下:

Enterprise 实体类内容如下:实体类要有getter,setter,toString好习惯,防止报错。

  1. @Component
  2. //ConfigurationProperties译为配置属性,prefix前缀必须设为"enterprise",不加冒号,不能少字母。配置prefix后可以读取到yaml中前缀为enterprise标签的所有属性。
  3. //虽然prefix叫前缀,但它的意思是通过标签名看成前缀。
  4. @ConfigurationProperties(prefix = "enterprise")
  5. public class Enterprise {
  6. private String name;
  7. private int age;
  8. private String tel;
  9. private String[] subject;
  10. public String getName() {
  11. return name;
  12. }
  13. public void setName(String name) {
  14. this.name = name;
  15. }
  16. public int getAge() {
  17. return age;
  18. }
  19. public void setAge(int age) {
  20. this.age = age;
  21. }
  22. public String getTel() {
  23. return tel;
  24. }
  25. public void setTel(String tel) {
  26. this.tel = tel;
  27. }
  28. public String[] getSubject() {
  29. return subject;
  30. }
  31. public void setSubject(String[] subject) {
  32. this.subject = subject;
  33. }
  34. @Override
  35. public String toString() {
  36. return "Enterprise{" +
  37. "name='" + name + '\'' +
  38. ", age=" + age +
  39. ", tel='" + tel + '\'' +
  40. ", subject=" + Arrays.toString(subject) +
  41. '}';
  42. }
  43. }

BookController 内容如下:

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController {
  4. @Autowired
  5. private Enterprise enterprise;
  6. @GetMapping("/{id}")
  7. public String getById(@PathVariable Integer id){
  8. System.out.println(enterprise.getName());
  9. System.out.println(enterprise.getAge());
  10. System.out.println(enterprise.getSubject());
  11. System.out.println(enterprise.getTel());
  12. System.out.println(enterprise.getSubject()[0]);
  13. return "hello , spring boot!";
  14. }
  15. }

注意:

警告:使用第三种方式,在实体类上有如下警告提示

img

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

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-configuration-processor</artifactId>
  4. <optional>true</optional>
  5. </dependency>

为了加强管理第三方配置类,这种方式还可以优化:

 步骤①在引导类上开启@EnableConfigurationProperties注解,并标注要使用@ConfigurationProperties注解绑定属性的类

  1. @SpringBootApplication
  2. @EnableConfigurationProperties(ServerConfig.class)
  3. public class Springboot13ConfigurationApplication {
  4. }

步骤②:在对应的类上直接使用@ConfigurationProperties进行属性绑定

  1. @Data
  2. @ConfigurationProperties(prefix = "servers")
  3. //这里不用加@component了
  4. public class ServerConfig {
  5. private String ipAddress;
  6. private int port;
  7. private long timeout;
  8. }

注意:

  • 开启了@EnableConfigurationProperties注解后绑定属性的ServerConfig类就不能声明@Component注解,否则会被spring检测到两个bean

当使用@EnableConfigurationProperties注解时,spring会默认将其标注的类定义为bean,因此不能再次声明@Component注解了。

2.4 多环境配置

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

img

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

2.4.1 yaml文件

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

连接符---作用:单文件中可以通过---实现多文件的效果。

配置多个环境并设置启动环境:

  1. #设置启用的环境
  2. spring:
  3. profiles:
  4. active: dev #表示使用的是开发环境的配置
  5. ---
  6. #开发
  7. spring:
  8. profiles: dev
  9. server:
  10. port: 80
  11. ---
  12. #生产
  13. spring:
  14. profiles: pro
  15. server:
  16. port: 81
  17. ---
  18. #测试
  19. spring:
  20. profiles: test
  21. server:
  22. port: 82
  23. ---

上面配置中 spring.profiles 是用来给不同的配置起名字的。

注意:

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

  1. #开发
  2. spring:
  3. config:
  4. activate:
  5. on-profile: dev

2.4.2 properties文件

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

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

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

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

    server.port=82
    

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

spring.profiles.active=pro

2.4.3 命令行启动参数设置,修改端口、环境

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

命令行jar包切换环境:

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

我们知道 jar 包其实就是一个压缩包,可以解压缩,然后修改配置,最后再打成jar包就可以了。这种方式显然有点麻烦。

SpringBoot 提供了在运行 jar 时设置开启指定的环境的方式,如下

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

命令行jar包修改端口:

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

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

命令行jar包同时修改环境和端口:

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

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

进入上面网站后会看到如下页面

img

如果使用了多种方式配合同一个配置项,优先级高的生效。

2.4.4 maven和springboot多环境开发兼容

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

pom.xml

解析resources资源的插件maven-resources-plugin

img配置多环境

img

application.yml

img

2.5 配置文件分类

2.5.1 概述

img

有这样的场景,我们开发完毕后需要测试人员进行测试。

由于测试环境和开发环境的很多配置都不相同,所以测试人员在运行我们的工程时需要临时修改很多配置,如下

java –jar springboot.jar –-spring.profiles.active=test --server.port=85 --server.servlet.context-path=/heima --server.tomcat.connection-timeout=-1 …… …… …… …… ……

针对这种情况,SpringBoot 定义了配置文件不同的放置的位置;而放在不同位置的优先级时不同的。

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

  • 1级:classpath:application.yml
  • 2级:classpath:config/application.yml
  • 3级:file :application.yml
  • 4级:file :config/application.yml

说明:

  • 级别越高优先级越高,file:config优先级最高
  • 一二级classpath是为开发用的,三四级file是为打包后设置通用属性用的。
  • resources下config目录里放配置文件
  • classpath:是类路径,在resources下,优先级高。
  • file:是在包目录下,这个目录下创建config文件夹里放配置文件优先级最高。

2.5.1 代码演示

在这里我们只演示不同级别配置文件放置位置的优先级。

2.5.1.1 环境准备

创建一个名为 springboot_06_config_fileSpringBoot 工程,目录结构如下

img

resources 下创建一个名为 config 的目录,在该目录中创建 application.yml 配置文件,而在该配置文件中将端口号设置为 81,内容如下

  1. server:
  2. port: 81

而在 resources 下创建的 application.yml 配置文件中并将端口号设置为 80,内容如下

  1. server:
  2. port: 80

2.5.1.2 验证1级和2级的优先级

运行启动引导类,可以在控制台看到如下日志信息

img

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

2.5.1.3 验证2级和4级的优先级

结论:file: config 下的配置文件优先于类路径下的配置文件。

要验证4级,按照以下步骤完成

  • 将工程打成 jar

    点击工程的 package 来打 jar

    img

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

    img

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

  • 在命令行使用以下命令运行程序

    java -jar springboot_06_config_file-0.0.1-SNAPSHOT.jar
    

    运行后日志信息如下

    img

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

注意:

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

3,SpringBoot整合junit

3.0 回顾 Spring 整合 junit

回顾 Spring 整合 junit

  1. @RunWith(SpringJUnit4ClassRunner.class)
  2. @ContextConfiguration(classes = SpringConfig.class)
  3. public class UserServiceTest {
  4. @Autowired
  5. private BookService bookService;
  6. @Test
  7. public void testSave(){
  8. bookService.save();
  9. }
  10. }

使用 @RunWith 注解指定运行器,使用 @ContextConfiguration 注解来指定配置类或者配置文件。

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

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

在springboot中,@RunWith不用特别写,springboot内部自己加上了。@ContextConfiguration加载SpringConfig也不用特别写了,因为springboot的引导类起到了配置类的作用,这个类会把同位置下所有包扫描一遍,所以@Component的类才能加载成bean,测试类也就不用写@ContextConfiguration加载SpringConfig了。

3.1 环境准备

创建一个名为 springboot_07_testSpringBoot 工程,工程目录结构如下

img

com.itheima.service 下创建 BookService 接口,内容如下

  1. public interface BookService {
  2. public void save();
  3. }

com.itheima.service.impl 包写创建一个 BookServiceImpl 类,使其实现 BookService 接口,内容如下

  1. @Service
  2. public class BookServiceImpl implements BookService {
  3. @Override
  4. public void save() {
  5. System.out.println("book service is running ...");
  6. }
  7. }

3.2 编写测试类,@SpringBootTest

实际上,整合很简单,只有一步,包都不用再导, 直接给引导类同包下的测试类注解@SpringBootTest

test/java创建 com.itheima 包,在该包下创建测试类,将 BookService 注入到该测试类中

  1. @SpringBootTest
  2. class Springboot07TestApplicationTests {
  3. @Autowired
  4. private BookService bookService;
  5. @Test
  6. public void save() {
  7. bookService.save();
  8. }
  9. }

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

例如:

  • 引导类所在包是 com.itheima
  • 测试类所在包是 com.itheima

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

4,SpringBoot整合mybatis

4.1 回顾Spring整合Mybatis

Spring 整合 Mybatis 需要定义很多配置类

  • SpringConfig 配置类

    • 导入 JdbcConfig 配置类

    • 导入 MybatisConfig 配置类

      1. @Configuration
      2. @ComponentScan("com.itheima")
      3. @PropertySource("classpath:jdbc.properties")
      4. @Import({JdbcConfig.class,MyBatisConfig.class})
      5. public class SpringConfig {
      6. }
  • JdbcConfig 配置类

    • 定义数据源(加载properties配置项:driver、url、username、password)

      1. public class JdbcConfig {
      2. @Value("${jdbc.driver}")
      3. private String driver;
      4. @Value("${jdbc.url}")
      5. private String url;
      6. @Value("${jdbc.username}")
      7. private String userName;
      8. @Value("${jdbc.password}")
      9. private String password;
      10. @Bean
      11. public DataSource getDataSource(){
      12. DruidDataSource ds = new DruidDataSource();
      13. ds.setDriverClassName(driver);
      14. ds.setUrl(url);
      15. ds.setUsername(userName);
      16. ds.setPassword(password);
      17. return ds;
      18. }
      19. }
  • MybatisConfig 配置类

    • 定义 SqlSessionFactoryBean

    • 定义映射配置

      1. public class MybatisConfig {
      2. @Bean
      3. public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource){
      4. SqlSessionFactoryBean factoryBean = new SqlSessionFactoryBean();
      5. factoryBean.setDataSource(dataSource);
      6. factoryBean.setTypeAliasesPackage("package1.pojo");
      7. return factoryBean;
      8. }
      9. @Bean
      10. public MapperScannerConfigurer mapperScannerConfigurer(){
      11. MapperScannerConfigurer msc=new MapperScannerConfigurer();
      12. msc.setBasePackage("package1.dao");
      13. return msc;
      14. }
      15. }

4.2 SpringBoot整合mybatis

两个关键步骤:@Mapper和yml配置数据源

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

4.2.1 创建模块

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

img

  • 选择当前模块需要使用的技术集(MyBatis、MySQL)。如果需要写controller层则再添加Web里的Spring Web,或者在pom.xml导入依赖spring-boot-starter-web

    img

4.2.2 定义实体类

com.itheima.domain 包下定义实体类 Book,内容如下

  1. public class Book {
  2. private Integer id;
  3. private String name;
  4. private String type;
  5. private String description;
  6. //自己生成setter and getter,别忘了,别忘了,别忘了,别忘了,别忘了,别忘了,
  7. //toString
  8. }

4.2.3 定义dao接口

com.itheima.dao 包下定义 BookDao 接口,内容如下

或者可以在引导类扫描@MapperScan

  1. //@Repository //BookDao是接口无实现类,不定义成bean也能在Service自动注入
  2. @Mapper
  3. public interface BookDao {
  4. @Select("select * from tbl_book where id = #{id}")
  5. public Book getById(Integer id);
  6. }

4.2.4 定义测试类

test/java 下定义包 com.itheima ,在该包下测试类,内容如下

  1. @SpringBootTest
  2. class Springboot08MybatisApplicationTests {
  3. @Autowired
  4. private BookDao bookDao;
  5. @Test
  6. void testGetById() {
  7. Book book = bookDao.getById(1);
  8. System.out.println(book);
  9. }
  10. }

4.2.5 编写配置

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

 application.yml 

  1. spring:
  2. datasource:
  3. #mysql6以后必须driver-class-name中间加cj,url设置时区,否则会报错
  4. driver-class-name: com.mysql.cj.jdbc.Driver
  5. url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
  6. username: root
  7. password: root

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

4.2.6 代码测试,根据id查书籍

运行测试方法,我们会看到如下错误信息

img

错误信息显示在 Spring 容器中没有 BookDao 类型的 bean。为什么会出现这种情况呢?

原因是 Mybatis 会扫描接口并创建接口的代码对象交给 Spring 管理,但是现在并没有告诉 Mybatis 哪个是 dao 接口。而我们要解决这个问题需要BookDao 接口上使用 @Mapper

BookDao 接口加上@Mapper注解或者引导类加@MapperScan:

  1. //@Mapper替代MybatisConfig里的MapperScannerConfigurer方法。
  2. //即Mybatis核心配置文件的<mappers>标签里的扫描mapper包
  3. @Mapper
  4. public interface BookDao {
  5. @Select("select * from tbl_book where id = #{id}")
  6. public Book getById(Integer id);
  7. }

注意:

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

4.2.7 配置内置数据源、Druid数据源

 

application.yml

  1. spring:
  2. datasource:
  3. driver-class-name: com.mysql.jdbc.Driver
  4. url: jdbc:mysql://localhost:3306/ssm_db
  5. username: root
  6. password: root

此时运行引导类,项目就已经能跑起来了,不过实际开发中更多的是使用druid数据源。

Druid数据源

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

  • 导入 Druid 依赖

    1. <dependency>
    2. <groupId>com.alibaba</groupId>
    3. <artifactId>druid</artifactId>
    4. <version>1.1.16</version>
    5. </dependency>
  • application.yml 配置文件配置

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

    1. spring:
    2. datasource:
    3. #druid建议driver设成com.mysql.cj.jdbc.Driver
    4. driver-class-name: com.mysql.cj.jdbc.Driver
    5. url: jdbc:mysql://localhost:3306/ssm_db
    6. username: root
    7. password: root
    8. type: com.alibaba.druid.pool.DruidDataSource

如果spring-boot-starter-parent版本是2.4.3 以前,在url后面加上?serverTimezone=UTC,否则会报错:

  1. spring:
  2. datasource:
  3. #druid建议driver设成com.mysql.cj.jdbc.Driver
  4. driver-class-name: com.mysql.cj.jdbc.Driver
  5. url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
  6. username: root
  7. password: root
  8. type: com.alibaba.druid.pool.DruidDataSource

4.3 案例,整合ssm的书籍增删改查项目

SpringBoot 到这就已经学习完毕,接下来我们将学习 SSM 时做的三大框架整合的案例用 SpringBoot 来实现一下。我们完成这个案例基本是将之前做的拷贝过来,修改成 SpringBoot 的即可,主要从以下几部分完成

  1. pom.xml

    配置起步依赖,必要的资源坐标(druid)

  2. application.yml

    设置数据源、端口等

  3. 配置类

    全部删除

  4. dao

    设置@Mapper

  5. 测试类

  6. 页面

    放置在resources目录下的static目录中

4.3.1 创建工程

创建 SpringBoot 工程,在创建工程时需要勾选 webmysqlmybatis,工程目录结构如下

img

由于我们工程中使用到了 Druid ,所以需要导入 Druid 的坐标

  1. <dependency>
  2. <groupId>com.alibaba</groupId>
  3. <artifactId>druid</artifactId>
  4. <version>1.1.16</version>
  5. </dependency>

4.3.2 代码拷贝、dao注解@Mapper、WebMvcConfigurer添加资源处理器、拦截器

将上一节整合ssm的项目, springmvc_11_page 工程中的 java 代码及测试代码连同包拷贝到 springboot_09_ssm 工程,按照下图进行拷贝

img

需要修改的内容如下:

  • Springmvc_11_pageconfig 包下的是配置类,而 SpringBoot 工程不需要这些配置类,所以这些可以直接删除

  • dao 包下的接口上在拷贝到 springboot_09-ssm 工程中需要在接口中添加 @Mapper 注解

  • BookServiceTest 测试类需要加@SpringBootTest注解,改成 SpringBoot 整合 junit

    1. @SpringBootTest
    2. public class BookServiceTest {
    3. @Autowired
    4. private BookService bookService;
    5. @Test
    6. public void testGetById(){
    7. Book book = bookService.getById(2);
    8. System.out.println(book);
    9. }
    10. @Test
    11. public void testGetAll(){
    12. List<Book> all = bookService.getAll();
    13. System.out.println(all);
    14. }
    15. }

另外还需要修改配置文件。

controller包下拦截器interceptor失效,因为以前需要SpringMvcConfig实现WebMvcConfigurer 接口;

因为没有了ServletConfig,springmvc也就不会拦截资源,也就不用放行静态资源了

SpringMvcConfig回顾:

  1. @Configuration
  2. //package1.config主要为了扫描项目拦截器类、ServletContainersInitConfig类
  3. @ComponentScan({"package1.controller","package1.config"})
  4. @EnableWebMvc
  5. public class SpringMvcConfig implements WebMvcConfigurer {
  6. @Autowired
  7. private ProjectInterception projectInterception;
  8. //添加拦截器,配置本地资源映射路径,在访问A(虚拟的)的时候,需要到B(实际的)的位置去访问。
  9. @Override
  10. public void addInterceptors(InterceptorRegistry registry) {
  11. registry.addInterceptor(projectInterception).addPathPatterns("/books","/books/*");
  12. //如果只拦截/books,发送http://localhost/books/100后会发现拦截器没有被执行
  13. //registry.addInterceptor(projectInterceptor).addPathPatterns("/books");
  14. }
  15. //添加资源处理器
  16. @Override
  17. public void addResourceHandlers(ResourceHandlerRegistry registry) {
  18. registry.addResourceHandler("/pages/**").addResourceLocations("/pages/");
  19. registry.addResourceHandler("/js/**").addResourceLocations("/js/");
  20. registry.addResourceHandler("/css/**").addResourceLocations("/css/");
  21. registry.addResourceHandler("/plugins/**").addResourceLocations("/plugins/");
  22. }
  23. }

4.3.3 yml配置端口、数据源

application.yml 配置文件中需要配置如下内容

  • 服务的端口号
  • 连接数据库的信息
  • 数据源
  1. server:
  2. port: 80
  3. spring:
  4. datasource:
  5. type: com.alibaba.druid.pool.DruidDataSource
  6. driver-class-name: com.mysql.cj.jdbc.Driver
  7. url: jdbc:mysql://localhost:3306/ssm_db?servierTimezone=UTC
  8. username: root
  9. password: root

4.3.4 静态资源

SpringBoot 程序中是没有 webapp 目录的,那么在 SpringBoot 程序中静态资源需要放在什么位置呢?

静态资源需要放在 resources 下的 static,如下图所示

img

另外配置一个index.html,实现直接http://localhost/即可访问books列表:

img

然后运行引导类,先输入http://localhost/books测试后端,再用postman测试所有功能,完成。

img

4.4 SpringBoot整合MyBatis-Plus回顾

具体整合看下面文章的入门案例:

MyBatisPlus基础_vincewm的博客-CSDN博客

步骤①:导入对应的starter

  1. <!--mybatis和mysql依赖勾选自动生成-->
  2. <dependency>
  3. <groupId>com.baomidou</groupId>
  4. <artifactId>mybatis-plus-boot-starter</artifactId>
  5. <version>3.4.3</version>
  6. </dependency>
  7. <dependencies>
  8. <dependency>
  9. <groupId>com.alibaba</groupId>
  10. <artifactId>druid-spring-boot-starter</artifactId>
  11. <version>1.2.6</version>
  12. </dependency>
  13. </dependencies>
  14. <dependency>
  15. <groupId>org.projectlombok</groupId>
  16. <artifactId>lombok</artifactId>
  17. </dependency>

关于这个坐标,此处要说明一点,之前我们看的starter都是spring-boot-starter-???,也就是说都是下面的格式

Spring-boot-start-***

而MyBatis与MyBatisPlus这两个坐标的名字书写比较特殊,是第三方技术名称在前,boot和starter在后。

springboot依赖命名规范:

starter所属命名规则示例
官方提供spring-boot-starter-技术名称spring-boot-starter-web spring-boot-starter-test
第三方提供第三方技术名称-spring-boot-startermybatis-spring-boot-starter druid-spring-boot-starter
第三方提供第三方技术名称-boot-starter(第三方技术名称过长,简化命名)mybatis-plus-boot-starter

温馨提示

创建项目时勾选里是没有mybatisplus的,因为SpringBoot官网还未收录此坐标。

步骤②配置数据源相关信息

  1. #2.配置相关信息
  2. spring:
  3. datasource:
  4. driver-class-name: com.mysql.cj.jdbc.Driver
  5. url: jdbc:mysql://localhost:3306/ssm_db
  6. username: root
  7. password: root

步骤3:映射接口(Dao)

  1. @Mapper
  2. public interface BookDao extends BaseMapper<Book> {
  3. }

核心在于Dao接口继承了一个BaseMapper的接口,这个接口中帮助开发者预定了若干个常用的API接口,简化了通用API接口的开发工作。

img

下面就可以写一个测试类进行测试了,此处省略。

温馨提示

目前数据库的表名定义规则是tbl_模块名称,为了能和实体类相对应,需要实体类注解@TableName("表名"),或者配置application.yml文件,添加如下配置即可,设置所有表名的通用前缀名。

  1. //注解了lombok的@Data会自动生成getter,setter,toString方法
  2. @Data
  3. //一般数据库表名tbl_user,这里注解@TableName("tbl_user"),就可以对应上表名,毕竟mp的语句里没有指定表名,都是在数据库中搜索和首字母小的的实体类名对应的表的。
  4. @TableName("user")
  5. public class User {
  6. //设置主键自增策略为auto,mp默认自增策略是ASSIGN_ID,分布式、雪花算法。自增策略也可以在yml中全局配置。
  7. @TableId(type = IdType.AUTO)
  8. private Long id;
  9. private String name;
  10. //value属性起别名,select设置该字段是否参与查询,针对于一些密码等隐私数据不希望被查出来
  11. @TableField(value = "password",select = false)
  12. private String password;
  13. private Integer age;
  14. private String tel;
  15. //exist属性设置是否在数据库中存在该字段
  16. @TableField(exist = false)
  17. private String online;
  18. //乐观锁注解版本,需要搭配乐观拦截器
  19. @Version
  20. private Integer version;
  21. //逻辑删除,本质是更新,数据库内该字段默认是0,通过标记为1来判定删除。
  22. @TableLogic
  23. private Integer delete;
  24. }

或者配置yml

  1. mybatis-plus:
  2. global-config:
  3. db-config:
  4. table-prefix: tbl_ #设置所有表的通用前缀名称为tbl_

5、SSMP整合综合案例,Book增删改查分页

主页面

img

添加

img

删除

img

修改

img

分页

img

条件查询

img

整体案例中需要采用的技术如下:

  1. 实体类开发————使用Lombok快速制作实体类

  2. Dao开发————整合MyBatisPlus,制作数据层测试

  3. Service开发————基于MyBatisPlus进行增量开发,制作业务层测试类

  4. Controller开发————基于Restful开发,前后端开发协议制作,使用PostMan测试接口功能

  5. 页面开发————基于VUE+ElementUI制作,前后端联调,页面数据处理,页面消息处理

    • 列表
    • 新增
    • 修改
    • 删除
    • 分页
    • 查询
  6. 项目异常处理————异常拦截器、业务和系统异常类

  7. 按条件查询————页面功能调整、Controller修正功能、Service修正功能

0.模块创建

对于这个案例如果按照企业开发的形式进行应该制作后台微服务,前后端分离的开发。

img

这个对初学的小伙伴要求太高了,咱们简化一下。后台做单体服务器,前端不使用前后端分离的制作了。

img

一个服务器即充当后台服务调用,又负责前端页面展示,降低学习的门槛。

模块构建步骤:

pom.xml

  1. <dependencies>
  2. <dependency>
  3. <groupId>org.springframework.boot</groupId>
  4. <artifactId>spring-boot-starter-web</artifactId>
  5. </dependency>
  6. <dependency>
  7. <groupId>org.springframework.boot</groupId>
  8. <artifactId>spring-boot-starter-test</artifactId>
  9. <scope>test</scope>
  10. </dependency>
  11. </dependencies>

application.yml

  1. server:
  2. port: 80

1.实体类开发,lombok

本案例对应的模块表结构如下:

  1. -- ----------------------------
  2. -- Table structure for tbl_book
  3. -- ----------------------------
  4. DROP TABLE IF EXISTS `tbl_book`;
  5. CREATE TABLE `tbl_book` (
  6. `id` int(11) NOT NULL AUTO_INCREMENT,
  7. `type` varchar(20) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  8. `name` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  9. `description` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL,
  10. PRIMARY KEY (`id`) USING BTREE
  11. ) ENGINE = InnoDB AUTO_INCREMENT = 51 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;
  12. -- ----------------------------
  13. -- Records of tbl_book
  14. -- ----------------------------
  15. INSERT INTO `tbl_book` VALUES (1, '计算机理论', 'Spring实战 第5版', 'Spring入门经典教程,深入理解Spring原理技术内幕');
  16. INSERT INTO `tbl_book` VALUES (2, '计算机理论', 'Spring 5核心原理与30个类手写实战', '十年沉淀之作,手写Spring精华思想');
  17. INSERT INTO `tbl_book` VALUES (3, '计算机理论', 'Spring 5 设计模式', '深入Spring源码剖析Spring源码中蕴含的10大设计模式');
  18. INSERT INTO `tbl_book` VALUES (4, '计算机理论', 'Spring MVC+MyBatis开发从入门到项目实战', '全方位解析面向Web应用的轻量级框架,带你成为Spring MVC开发高手');
  19. INSERT INTO `tbl_book` VALUES (5, '计算机理论', '轻量级Java Web企业应用实战', '源码级剖析Spring框架,适合已掌握Java基础的读者');
  20. INSERT INTO `tbl_book` VALUES (6, '计算机理论', 'Java核心技术 卷I 基础知识(原书第11版)', 'Core Java 第11版,Jolt大奖获奖作品,针对Java SE9、10、11全面更新');
  21. INSERT INTO `tbl_book` VALUES (7, '计算机理论', '深入理解Java虚拟机', '5个维度全面剖析JVM,大厂面试知识点全覆盖');
  22. INSERT INTO `tbl_book` VALUES (8, '计算机理论', 'Java编程思想(第4版)', 'Java学习必读经典,殿堂级著作!赢得了全球程序员的广泛赞誉');
  23. INSERT INTO `tbl_book` VALUES (9, '计算机理论', '零基础学Java(全彩版)', '零基础自学编程的入门图书,由浅入深,详解Java语言的编程思想和核心技术');
  24. INSERT INTO `tbl_book` VALUES (10, '市场营销', '直播就该这么做:主播高效沟通实战指南', '成长为网红的秘密都在书中');
  25. INSERT INTO `tbl_book` VALUES (11, '市场营销', '直播销讲实战一本通', '和秋叶一起学系列网络营销书籍');
  26. INSERT INTO `tbl_book` VALUES (12, '市场营销', '直播带货:淘宝、天猫直播从新手到高手', '一本教你如何玩转直播的书,10堂课轻松实现带货月入3W+');

根据上述表结构,制作对应的实体类

实体类

  1. public class Book {
  2. private Integer id;
  3. private String type;
  4. private String name;
  5. private String description;
  6. }

实体类的开发可以自动通过工具手工生成get/set方法,然后覆盖toString()方法,方便调试,等等。不过这一套操作书写很繁琐,有对应的工具可以帮助我们简化开发,介绍一个小工具,lombok。

Lombok,一个Java类库,提供了一组注解,简化POJO实体类开发,SpringBoot目前默认集成了lombok技术,并提供了对应的版本控制,所以只需要提供对应的坐标即可,在pom.xml中添加lombok的坐标。

  1. <dependencies>
  2. <!--lombok-->
  3. <dependency>
  4. <groupId>org.projectlombok</groupId>
  5. <artifactId>lombok</artifactId>
  6. </dependency>
  7. </dependencies>

使用lombok可以通过一个注解@Data完成一个实体类对应的getter,setter,toString,equals,hashCode等操作的快速添加

  1. import lombok.Data;
  2. @Data
  3. public class Book {
  4. private Integer id;
  5. private String type;
  6. private String name;
  7. private String description;
  8. }

到这里实体类就做好了,是不是比不使用lombok简化好多,这种工具在Java开发中还有N多,后面遇到了能用的实用开发技术时,在不增加各位小伙伴大量的学习时间的情况下,尽量多给大家介绍一些。

总结

  1. 实体类制作

  2. 使用lombok简化开发

    • 导入lombok无需指定版本,由SpringBoot提供版本
    • @Data注解

2.数据层开发——基础CRUD

数据层开发本次使用MyBatisPlus技术,数据源使用前面学习的Druid,学都学了都用上。

步骤①:导入MyBatisPlus与Druid对应的starter,当然mysql的驱动不能少

  1. <dependencies>
  2. <dependency>
  3. <groupId>com.baomidou</groupId>
  4. <artifactId>mybatis-plus-boot-starter</artifactId>
  5. <version>3.4.3</version>
  6. </dependency>
  7. <dependency>
  8. <groupId>com.alibaba</groupId>
  9. <artifactId>druid-spring-boot-starter</artifactId>
  10. <version>1.2.6</version>
  11. </dependency>
  12. <dependency>
  13. <groupId>mysql</groupId>
  14. <artifactId>mysql-connector-java</artifactId>
  15. <scope>runtime</scope>
  16. </dependency>
  17. </dependencies>

 spring-boot-starter-web和spring-boot-starter-test在创建springboot项目时已经勾选创建了:

步骤②:配置druid数据库连接相关的数据源配置

  1. server:
  2. port: 80
  3. spring:
  4. datasource:
  5. druid:
  6. driver-class-name: com.mysql.cj.jdbc.Driver
  7. url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
  8. username: root
  9. password: root

步骤③:使用MyBatisPlus的标准通用接口BaseMapper加速开发,别忘了@Mapper和泛型的指定

  1. @Mapper
  2. public interface BookDao extends BaseMapper<Book> {
  3. }

步骤④:制作测试类测试结果,这个测试类制作是个好习惯,不过在企业开发中往往都为加速开发跳过此步,且行且珍惜吧

  1. package com.itheima.dao;
  2. import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
  3. import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
  4. import com.baomidou.mybatisplus.core.metadata.IPage;
  5. import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
  6. import com.itheima.domain.Book;
  7. import org.junit.jupiter.api.Test;
  8. import org.springframework.beans.factory.annotation.Autowired;
  9. import org.springframework.boot.test.context.SpringBootTest;
  10. @SpringBootTest
  11. public class BookDaoTestCase {
  12. @Autowired
  13. private BookDao bookDao;
  14. @Test
  15. void testGetById(){
  16. System.out.println(bookDao.selectById(1));
  17. }
  18. @Test
  19. void testSave(){
  20. Book book = new Book();
  21. book.setType("测试数据123");
  22. book.setName("测试数据123");
  23. book.setDescription("测试数据123");
  24. bookDao.insert(book);
  25. }
  26. @Test
  27. void testUpdate(){
  28. Book book = new Book();
  29. book.setId(17);
  30. book.setType("测试数据abcdefg");
  31. book.setName("测试数据123");
  32. book.setDescription("测试数据123");
  33. bookDao.updateById(book);
  34. }
  35. @Test
  36. void testDelete(){
  37. bookDao.deleteById(16);
  38. }
  39. @Test
  40. void testGetAll(){
  41. bookDao.selectList(null);
  42. }
  43. }

配置id生成策略

MyBatisPlus技术默认的主键生成策略为雪花算法,生成的主键ID长度较大,和目前的数据库设定规则不相符,需要配置一下使MyBatisPlus使用数据库的主键生成策略。在application.yml中添加对应配置即可,具体如下

  1. server:
  2. port: 80
  3. spring:
  4. datasource:
  5. druid:
  6. driver-class-name: com.mysql.cj.jdbc.Driver
  7. url: jdbc:mysql://localhost:3306/ssm_db?serverTimezone=UTC
  8. username: root
  9. password: root
  10. mybatis-plus:
  11. global-config:
  12. db-config:
  13. table-prefix: tbl_ #设置表名通用前缀
  14. id-type: auto #设置主键id字段的生成策略为参照数据库设定的策略,当前数据库设置id生成策略为自增

清理控制台没用日志

yml

  1. mybatis-plus:
  2. global-config:
  3. banner: false
  4. spring:
  5. main:
  6. banner-mode: off

resources下创建logback.xml

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <configuration>
  3. </configuration>

查看MyBatisPlus运行日志

在进行数据层测试的时候,因为基础的CRUD操作均由MyBatisPlus给我们提供了,所以就出现了一个局面,开发者不需要书写SQL语句了,这样程序运行的时候总有一种感觉,一切的一切都是黑盒的,作为开发者我们啥也不知道就完了。如果程序正常运行还好,如果报错了,这个时候就很崩溃,你甚至都不知道从何下手,因为传递参数、封装SQL语句这些操作完全不是你开发出来的,所以查看执行期运行的SQL语句就成为当务之急。

SpringBoot整合MyBatisPlus的时候充分考虑到了这点,通过配置的形式就可以查阅执行期SQL语句,配置如下

  1. mybatis-plus:
  2. global-config:
  3. db-config:
  4. table-prefix: tbl_
  5. id-type: auto
  6. configuration:
  7. log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

再来看运行结果,此时就显示了运行期执行SQL的情况。

  1. Creating a new SqlSession
  2. SqlSession [org.apache.ibatis.session.defaults.DefaultSqlSession@2c9a6717] was not registered for synchronization because synchronization is not active
  3. JDBC Connection [com.mysql.cj.jdbc.ConnectionImpl@6ca30b8a] will not be managed by Spring
  4. ==> Preparing: SELECT id,type,name,description FROM tbl_book
  5. ==> Parameters:
  6. <== Columns: id, type, name, description
  7. <== Row: 1, 计算机理论, Spring实战 第5版, Spring入门经典教程,深入理解Spring原理技术内幕
  8. <== Row: 2, 计算机理论, Spring 5核心原理与30个类手写实战, 十年沉淀之作,手写Spring精华思想
  9. <== Row: 3, 计算机理论, Spring 5 设计模式, 深入Spring源码剖析Spring源码中蕴含的10大设计模式
  10. <== Row: 4, 计算机理论, Spring MVC+MyBatis开发从入门到项目实战, 全方位解析面向Web应用的轻量级框架,带你成为Spring MVC开发高手
  11. <== Row: 5, 计算机理论, 轻量级Java Web企业应用实战, 源码级剖析Spring框架,适合已掌握Java基础的读者
  12. <== Row: 6, 计算机理论, Java核心技术 卷I 基础知识(原书第11版), Core Java 第11版,Jolt大奖获奖作品,针对Java SE91011全面更新
  13. <== Row: 7, 计算机理论, 深入理解Java虚拟机, 5个维度全面剖析JVM,大厂面试知识点全覆盖
  14. <== Row: 8, 计算机理论, Java编程思想(第4版), Java学习必读经典,殿堂级著作!赢得了全球程序员的广泛赞誉
  15. <== Row: 9, 计算机理论, 零基础学Java(全彩版), 零基础自学编程的入门图书,由浅入深,详解Java语言的编程思想和核心技术
  16. <== Row: 10, 市场营销, 直播就该这么做:主播高效沟通实战指南, 成长为网红的秘密都在书中
  17. <== Row: 11, 市场营销, 直播销讲实战一本通, 和秋叶一起学系列网络营销书籍
  18. <== Row: 12, 市场营销, 直播带货:淘宝、天猫直播从新手到高手, 一本教你如何玩转直播的书,10堂课轻松实现带货月入3W+
  19. <== Row: 13, 测试类型, 测试数据, 测试描述数据
  20. <== Row: 14, 测试数据update, 测试数据update, 测试数据update
  21. <== Row: 15, -----------------, 测试数据123, 测试数据123
  22. <== Total: 15

其中清晰的标注了当前执行的SQL语句是什么,携带了什么参数,对应的执行结果是什么,所有信息应有尽有。

此处设置的是日志的显示形式,当前配置的是控制台输出,当然还可以由更多的选择,根据需求切换即可

img

总结

  1. 手工导入starter坐标(2个),mysql驱动(1个)

  2. 配置数据源与MyBatisPlus对应的配置

  3. 开发Dao接口(继承BaseMapper)

  4. 制作测试类测试Dao功能是否有效

  5. 使用配置方式开启日志,设置日志输出方式为标准输出即可查阅SQL执行日志

3.数据层开发——分页功能制作

前面仅仅是使用了MyBatisPlus提供的基础CRUD功能,实际上MyBatisPlus给我们提供了几乎所有的基础操作,这一节说一下如何实现数据库端的分页操作。

MyBatisPlus提供的分页操作API如下:

  1. @Test
  2. void testGetPage(){
  3. IPage page = new Page(2,5);
  4. bookDao.selectPage(page, null);
  5. System.out.println(page.getCurrent());
  6. System.out.println(page.getSize());
  7. System.out.println(page.getTotal());
  8. System.out.println(page.getPages());
  9. System.out.println(page.getRecords());
  10. }

其中selectPage方法需要传入一个封装分页数据的对象,可以通过new的形式创建这个对象,当然这个对象也是MyBatisPlus提供的,别选错包了。创建此对象时需要指定两个分页的基本数据

  • 当前显示第几页
  • 每页显示几条数据

可以通过创建Page对象时利用构造方法初始化这两个数据。

IPage page = new Page(2,5);

将该对象传入到查询方法selectPage后,可以得到查询结果,但是我们会发现当前操作查询结果返回值仍然是一个IPage对象,这又是怎么回事?

IPage page = bookDao.selectPage(page, null);

原来这个IPage对象中封装了若干个数据,而查询的结果作为IPage对象封装的一个数据存在的,可以理解为查询结果得到后,又塞到了这个IPage对象中,其实还是为了高度的封装,一个IPage描述了分页所有的信息。下面5个操作就是IPage对象中封装的所有信息了。

  1. @Test
  2. void testGetPage(){
  3. IPage page = new Page(2,5);
  4. bookDao.selectPage(page, null);
  5. System.out.println(page.getCurrent()); //当前页码值
  6. System.out.println(page.getSize()); //每页显示数
  7. System.out.println(page.getTotal()); //数据总量
  8. System.out.println(page.getPages()); //总页数
  9. System.out.println(page.getRecords()); //详细数据
  10. }

到这里就知道这些数据如何获取了,但是当你去执行这个操作时,你会发现并不像我们分析的这样,实际上这个分页功能当前是无效的。为什么这样呢?这个要源于MyBatisPlus的内部机制。

对于MySQL的分页操作使用limit关键字进行,而并不是所有的数据库都使用limit关键字实现的,这个时候MyBatisPlus为了制作的兼容性强,将分页操作设置为基础查询操作的升级版,你可以理解为IPhone6与IPhone6S-PLUS的关系。

基础操作中有查询全部的功能,而在这个基础上只需要升级一下(PLUS)就可以得到分页操作。所以MyBatisPlus将分页操作做成了一个开关,你用分页功能就把开关开启,不用就不需要开启这个开关。而我们现在没有开启这个开关,所以分页操作是没有的。这个开关是通过MyBatisPlus的拦截器的形式存在的,其中的原理这里不分析了,有兴趣的小伙伴可以学习MyBatisPlus这门课程进行详细解读。具体设置方式如下:

定义MyBatisPlus拦截器并将其设置为Spring管控的bean

  1. @Configuration
  2. public class MPConfig {
  3. @Bean
  4. public MybatisPlusInterceptor mybatisPlusInterceptor(){
  5. MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
  6. interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
  7. return interceptor;
  8. }
  9. }

上述代码第一行是创建MyBatisPlus的拦截器栈,这个时候拦截器栈中没有具体的拦截器,第二行是初始化了分页拦截器,并添加到拦截器栈中。如果后期开发其他功能,需要添加全新的拦截器,按照第二行的格式继续add进去新的拦截器就可以了。

总结

  1. 使用IPage封装分页数据
  2. 分页操作依赖MyBatisPlus分页拦截器实现功能
  3. 借助MyBatisPlus日志查阅执行SQL语句

4.数据层开发——条件查询功能制作

除了分页功能,MyBatisPlus还提供有强大的条件查询功能。以往我们写条件查询要自己动态拼写复杂的SQL语句,现在简单了,MyBatisPlus将这些操作都制作成API接口,调用一个又一个的方法就可以实现各种条件的拼装。这里给大家普及一下基本格式,详细的操作还是到MyBatisPlus的课程中查阅吧。

下面的操作就是执行一个模糊匹配对应的操作,由like条件书写变为了like方法的调用。

  1. @Test
  2. void testGetBy(){
  3. QueryWrapper<Book> qw = new QueryWrapper<>();
  4. qw.like("name","Spring");
  5. bookDao.selectList(qw);
  6. }

其中第一句QueryWrapper对象是一个用于封装查询条件的对象,该对象可以动态使用API调用的方法添加条件,最终转化成对应的SQL语句。第二句就是一个条件了,需要什么条件,使用QueryWapper对象直接调用对应操作即可。比如做大于小于关系,就可以使用lt或gt方法,等于使用eq方法,等等,此处不做更多的解释了。

这组API使用还是比较简单的,但是关于属性字段名的书写存在着安全隐患,比如查询字段name,当前是以字符串的形态书写的,万一写错,编译器还没有办法发现,只能将问题抛到运行器通过异常堆栈告诉开发者,不太友好。

MyBatisPlus针对字段检查进行了功能升级,全面支持Lambda表达式,就有了下面这组API。由QueryWrapper对象升级为LambdaQueryWrapper对象,这下就避免了上述问题的出现。

  1. @Test
  2. void testGetBy2(){
  3. String name = "1";
  4. LambdaQueryWrapper<Book> lqw = new LambdaQueryWrapper<Book>();
  5. lqw.like(Book::getName,name);
  6. bookDao.selectList(lqw);
  7. }

为了便于开发者动态拼写SQL,防止将null数据作为条件使用,MyBatisPlus还提供了动态拼装SQL的快捷书写方式。

  1. @Test
  2. void testGetBy2(){
  3. String name = "1";
  4. LambdaQueryWrapper<Book> lqw = new LambdaQueryWrapper<Book>();
  5. //if(name != null) lqw.like(Book::getName,name); //方式一:JAVA代码控制
  6. lqw.like(name != null,Book::getName,name); //方式二:API接口提供控制开关
  7. bookDao.selectList(lqw);
  8. }

其实就是个格式,没有区别。关于MyBatisPlus的基础操作就说到这里吧,如果这一块知识不太熟悉的小伙伴建议还是完整的学习一下MyBatisPlus的知识吧,这里只是蜻蜓点水的用了几个操作而已。

MyBatisPlus基础_vincewm的博客-CSDN博客

总结

  1. 使用QueryWrapper对象封装查询条件

  2. 推荐使用LambdaQueryWrapper对象

  3. 所有查询操作封装成方法调用

  4. 查询条件支持动态条件拼装

5.业务层开发

业务层是组织业务逻辑功能,并根据业务需求,对数据持久层发起调用。目标是为了组织出符合需求的业务逻辑功能,至于调不调用数据层还真不好说,有需求就调用,没有需求就不调用。

区分数据层和业务层:

业务层的方法名定义一定要与业务有关,例如登录操作

login(String username,String password);

而数据层的方法名定义一定与业务无关,是一定,不是可能,也不是有可能,例如根据用户名密码查询

selectByUserNameAndPassword(String username,String password);

我们在开发的时候是可以根据完成的工作不同划分成不同职能的开发团队的。比如一个哥们制作数据层,他就可以不知道业务是什么样子,拿到的需求文档要求可能是这样的

  1. 接口:传入用户名与密码字段,查询出对应结果,结果是单条数据
  2. 接口:传入ID字段,查询出对应结果,结果是单条数据
  3. 接口:传入离职字段,查询出对应结果,结果是多条数据

但是进行业务功能开发的哥们,拿到的需求文档要求差别就很大

接口:传入用户名与密码字段,对用户名字段做长度校验,4-15位,对密码字段做长度校验,824位,对密码字段做特殊字符校验,不允许存在空格,查询结果为对象。如果为null,返回BusinessException,封装消息码INFO_LOGON_USERNAME_PASSWORD_ERROR

你比较一下,能是一回事吗?差别太大了,所以说业务层方法定义与数据层方法定义差异化很大,只不过有些入门级的开发者手懒或者没有使用过公司相关的ISO标准化文档而已。

代码实现:

业务层接口:

  1. public interface BookService {
  2. Boolean save(Book book);
  3. Boolean update(Book book);
  4. Boolean delete(Integer id);
  5. Book getById(Integer id);
  6. List<Book> getAll();
  7. IPage<Book> getPage(int currentPage,int pageSize);
  8. }

业务层实现类如下,转调数据层即可:

  1. @Service
  2. public class BookServiceImpl implements BookService {
  3. @Autowired
  4. private BookDao bookDao;
  5. @Override
  6. public Boolean save(Book book) {
  7. return bookDao.insert(book) > 0;
  8. }
  9. @Override
  10. public Boolean update(Book book) {
  11. return bookDao.updateById(book) > 0;
  12. }
  13. @Override
  14. public Boolean delete(Integer id) {
  15. return bookDao.deleteById(id) > 0;
  16. }
  17. @Override
  18. public Book getById(Integer id) {
  19. return bookDao.selectById(id);
  20. }
  21. @Override
  22. public List<Book> getAll() {
  23. return bookDao.selectList(null);
  24. }
  25. @Override
  26. public IPage<Book> getPage(int currentPage, int pageSize) {
  27. IPage page = new Page(currentPage,pageSize);
  28. bookDao.selectPage(page,null);
  29. return page;
  30. }
  31. }

别忘了对业务层接口进行测试,测试类如下:

  1. @SpringBootTest
  2. public class BookServiceTest {
  3. @Autowired
  4. private IBookService bookService;
  5. @Test
  6. void testGetById(){
  7. System.out.println(bookService.getById(4));
  8. }
  9. @Test
  10. void testSave(){
  11. Book book = new Book();
  12. book.setType("测试数据123");
  13. book.setName("测试数据123");
  14. book.setDescription("测试数据123");
  15. bookService.save(book);
  16. }
  17. @Test
  18. void testUpdate(){
  19. Book book = new Book();
  20. book.setId(17);
  21. book.setType("-----------------");
  22. book.setName("测试数据123");
  23. book.setDescription("测试数据123");
  24. bookService.updateById(book);
  25. }
  26. @Test
  27. void testDelete(){
  28. bookService.removeById(18);
  29. }
  30. @Test
  31. void testGetAll(){
  32. bookService.list();
  33. }
  34. @Test
  35. void testGetPage(){
  36. IPage<Book> page = new Page<Book>(2,5);
  37. bookService.page(page);
  38. System.out.println(page.getCurrent());
  39. System.out.println(page.getSize());
  40. System.out.println(page.getTotal());
  41. System.out.println(page.getPages());
  42. System.out.println(page.getRecords());
  43. }
  44. }

总结

  1. Service接口名称定义成业务名称,并与Dao接口名称进行区分
  2. 制作测试类测试Service功能是否有效

业务层快速开发(慎用)

其实MyBatisPlus技术不仅提供了数据层快速开发方案,业务层MyBatisPlus也给了一个通用接口,个人观点不推荐使用,凑合能用吧,其实就是一个封装+继承的思想,代码给出,实际开发慎用。

业务层接口快速开发

  1. public interface IBookService extends IService<Book> {
  2. //添加非通用操作API接口
  3. }

业务层接口实现类快速开发,关注继承的类需要传入两个泛型,一个是数据层接口,另一个是实体类。

  1. @Service
  2. public class BookServiceImpl extends ServiceImpl<BookDao, Book> implements IBookService {
  3. @Autowired
  4. private BookDao bookDao;
  5. //添加非通用操作API
  6. }

如果感觉MyBatisPlus提供的功能不足以支撑你的使用需要(其实是一定不能支撑的,因为需求不可能是通用的),在原始接口基础上接着定义新的API接口就行了,此处不再说太多了,就是自定义自己的操作了,但是不要和已有的API接口名冲突即可。

总结

  1. 使用通用接口(ISerivce)快速开发Service
  2. 使用通用实现类(ServiceImpl<M,T>)快速开发ServiceImpl
  3. 可以在通用接口基础上做功能重载或功能追加
  4. 注意重载时不要覆盖原始操作,避免原始提供的功能丢失

6.表现层开发

终于做到表现层了,做了这么多都是基础工作。其实你现在回头看看,哪里还有什么SpringBoot的影子?前面1,2步就搞完了。继续完成表现层制作吧,咱们表现层的开发使用基于Restful的表现层接口开发,功能测试通过Postman工具进行。

表现层接口如下:

  1. @RestController
  2. @RequestMapping("/books")
  3. public class BookController2 {
  4. @Autowired
  5. private IBookService bookService;
  6. @GetMapping
  7. public List<Book> getAll(){
  8. return bookService.list();
  9. }
  10. @PostMapping
  11. public Boolean save(@RequestBody Book book){
  12. return bookService.save(book);
  13. }
  14. @PutMapping
  15. public Boolean update(@RequestBody Book book){
  16. return bookService.modify(book);
  17. }
  18. @DeleteMapping("{id}")
  19. public Boolean delete(@PathVariable Integer id){
  20. return bookService.delete(id);
  21. }
  22. @GetMapping("{id}")
  23. public Book getById(@PathVariable Integer id){
  24. return bookService.getById(id);
  25. }
  26. //当前页码和每页数量由前端传
  27. @GetMapping("{currentPage}/{pageSize}")
  28. public IPage<Book> getPage(@PathVariable int currentPage,@PathVariable int pageSize){
  29. return bookService.getPage(currentPage,pageSize);
  30. }
  31. }

在使用Postman测试时关注提交类型,对应上即可,不然就会报405的错误码了。

普通GET请求

img

PUT请求传递json数据,后台实用@RequestBody接收数据

img

GET请求传递路径变量,后台实用@PathVariable接收数据

img

总结

  1. 基于Restful制作表现层接口

    • 新增:POST
    • 删除:DELETE
    • 修改:PUT
    • 查询:GET
  2. 接收参数

    • 实体数据:@RequestBody
    • 路径变量:@PathVariable

7.表现层消息一致性处理

目前我们通过Postman测试后业务层接口功能是通的,但是这样的结果给到前端开发者会出现一个小问题。不同的操作结果所展示的数据格式差异化严重。

增删改操作结果

true

查询单个数据操作结果

  1. {
  2. "id": 1,
  3. "type": "计算机理论",
  4. "name": "Spring实战 第5版",
  5. "description": "Spring入门经典教程"
  6. }

查询全部数据操作结果

  1. [
  2. {
  3. "id": 1,
  4. "type": "计算机理论",
  5. "name": "Spring实战 第5版",
  6. "description": "Spring入门经典教程"
  7. },
  8. {
  9. "id": 2,
  10. "type": "计算机理论",
  11. "name": "Spring 5核心原理与30个类手写实战",
  12. "description": "十年沉淀之作"
  13. }
  14. ]

每种不同操作返回的数据格式都不一样,而且还不知道以后还会有什么格式,这样的结果让前端人员看了是很容易让人崩溃的,必须将所有操作的操作结果数据格式统一起来,需要设计表现层返回结果的模型类,用于后端与前端进行数据格式统一,也称为前后端数据协议

  1. @Data
  2. public class R {
  3. //完整形态应该把flag改integer型code,加上String的错误信息msg,再创建一个code类定义所有成功失败的码,
  4. private Boolean flag;
  5. private Object data;
  6. }

其中flag用于标识操作是否成功,data用于封装操作数据,现在的数据格式就变了

  1. {
  2. "flag": true,
  3. "data":{
  4. "id": 1,
  5. "type": "计算机理论",
  6. "name": "Spring实战 第5版",
  7. "description": "Spring入门经典教程"
  8. }
  9. }

表现层开发格式也需要转换一下

img

img

img

结果这么一折腾,全格式统一,现在后端发送给前端的数据格式就统一了,免去了不少前端解析数据的烦恼。

总结

  1. 设计统一的返回值结果类型便于前端开发读取数据

  2. 返回值结果类型可以根据需求自行设定,没有固定格式

  3. 返回值结果模型类用于后端与前端进行数据格式统一,也称为前后端数据协议

8.前后端联通性测试

后端的表现层接口开发完毕,就可以进行前端的开发了。

将前端人员开发的页面保存到lresources目录下的static目录中,建议执行maven的clean生命周期,避免缓存的问题出现。

img

在进行具体的功能开发之前,先做联通性的测试,通过页面发送异步提交(axios),这一步调试通过后再进行进一步的功能开发。

  1. //列表
  2. getAll() {
  3. axios.get("/books").then((res)=>{
  4. console.log(res.data);
  5. });
  6. },

只要后台代码能够正常工作,前端能够在日志中接收到数据,就证明前后端是通的,也就可以进行下一步的功能开发了。

总结

  1. 单体项目中页面放置在resources/static目录下
  2. created钩子函数用于初始化页面时发起调用
  3. 页面使用axios发送异步请求获取数据后确认前后端是否联通

9.页面基础功能开发

F-1.列表功能(非分页版)

列表功能主要操作就是加载完数据,将数据展示到页面上,此处要利用VUE的数据模型绑定,发送请求得到数据,然后页面上读取指定数据即可。

页面数据模型定义

  1. data:{
  2. dataList: [], //当前页要展示的列表数据
  3. ...
  4. },

异步请求获取数据

  1. //列表
  2. getAll() {
  3. axios.get("/books").then((res)=>{
  4. this.dataList = res.data.data;
  5. });
  6. },

这样在页面加载时就可以获取到数据,并且由VUE将数据展示到页面上了。

总结:

  1. 将查询数据返回到页面,利用前端数据绑定进行数据展示

F-2.添加功能

添加功能用于收集数据的表单是通过一个弹窗展示的,因此在添加操作前首先要进行弹窗的展示,添加后隐藏弹窗即可。因为这个弹窗一直存在,因此当页面加载时首先设置这个弹窗为不可显示状态,需要展示,切换状态即可。

默认状态

  1. data:{
  2. dialogFormVisible: false, //添加表单是否可见
  3. ...
  4. },

切换为显示状态

  1. //弹出添加窗口
  2. handleCreate() {
  3. this.dialogFormVisible = true;
  4. },

由于每次添加数据都是使用同一个弹窗录入数据,所以每次操作的痕迹将在下一次操作时展示出来,需要在每次操作之前清理掉上次操作的痕迹。

定义清理数据操作

  1. //重置表单
  2. resetForm() {
  3. this.formData = {};
  4. },

切换弹窗状态时清理数据

  1. //弹出添加窗口
  2. handleCreate() {
  3. this.dialogFormVisible = true;
  4. this.resetForm();
  5. },

至此准备工作完成,下面就要调用后台完成添加操作了。

添加操作

  1. //添加
  2. handleAdd () {
  3. //发送异步请求
  4. axios.post("/books",this.formData).then((res)=>{
  5. //如果操作成功,关闭弹层,显示数据
  6. if(res.data.flag){
  7. this.dialogFormVisible = false;
  8. this.$message.success("添加成功");
  9. }else {
  10. this.$message.error("添加失败");
  11. }
  12. }).finally(()=>{
  13. this.getAll();
  14. });
  15. },
  1. 将要保存的数据传递到后台,通过post请求的第二个参数传递json数据到后台

  2. 根据返回的操作结果决定下一步操作

    • 如何是true就关闭添加窗口,显示添加成功的消息
    • 如果是false保留添加窗口,显示添加失败的消息
  3. 无论添加是否成功,页面均进行刷新,动态加载数据(对getAll操作发起调用)

取消添加操作

  1. //取消
  2. cancel(){
  3. this.dialogFormVisible = false;
  4. this.$message.info("操作取消");
  5. },

总结

  1. 请求方式使用POST调用后台对应操作
  2. 添加操作结束后动态刷新页面加载数据
  3. 根据操作结果不同,显示对应的提示信息
  4. 弹出添加Div时清除表单数据

F-3.删除功能

模仿添加操作制作删除功能,差别之处在于删除操作仅传递一个待删除的数据id到后台即可。

删除操作

  1. // 删除
  2. handleDelete(row) {
  3. axios.delete("/books/"+row.id).then((res)=>{
  4. if(res.data.flag){
  5. this.$message.success("删除成功");
  6. }else{
  7. this.$message.error("删除失败");
  8. }
  9. }).finally(()=>{
  10. this.getAll();
  11. });
  12. },

删除操作提示信息

  1. // 删除
  2. handleDelete(row) {
  3. //1.弹出提示框
  4. this.$confirm("此操作永久删除当前数据,是否继续?","提示",{
  5. type:'info'
  6. }).then(()=>{
  7. //2.做删除业务
  8. axios.delete("/books/"+row.id).then((res)=>{
  9. if(res.data.flag){
  10. this.$message.success("删除成功");
  11. }else{
  12. this.$message.error("删除失败");
  13. }
  14. }).finally(()=>{
  15. this.getAll();
  16. });
  17. }).catch(()=>{
  18. //3.取消删除
  19. this.$message.info("取消删除操作");
  20. });
  21. },

总结

  1. 请求方式使用Delete调用后台对应操作
  2. 删除操作需要传递当前行数据对应的id值到后台
  3. 删除操作结束后动态刷新页面加载数据
  4. 根据操作结果不同,显示对应的提示信息
  5. 删除操作前弹出提示框避免误操作

F-4.修改功能

修改功能可以说是列表功能、删除功能与添加功能的合体。几个相似点如下:

  1. 页面也需要有一个弹窗用来加载修改的数据,这一点与添加相同,都是要弹窗

  2. 弹出窗口中要加载待修改的数据,而数据需要通过查询得到,这一点与查询全部相同,都是要查数据

  3. 查询操作需要将要修改的数据id发送到后台,这一点与删除相同,都是传递id到后台

  4. 查询得到数据后需要展示到弹窗中,这一点与查询全部相同,都是要通过数据模型绑定展示数据

  5. 修改数据时需要将被修改的数据传递到后台,这一点与添加相同,都是要传递数据

    所以整体上来看,修改功能就是前面几个功能的大合体

    查询并展示数据

  1. //弹出编辑窗口
  2. handleUpdate(row) {
  3. axios.get("/books/"+row.id).then((res)=>{
  4. if(res.data.flag){
  5. //展示弹层,加载数据
  6. this.formData = res.data.data;
  7. this.dialogFormVisible4Edit = true;
  8. }else{
  9. this.$message.error("数据同步失败,自动刷新");
  10. }
  11. });
  12. },

修改操作

  1. //修改
  2. handleEdit() {
  3. axios.put("/books",this.formData).then((res)=>{
  4. //如果操作成功,关闭弹层并刷新页面
  5. if(res.data.flag){
  6. this.dialogFormVisible4Edit = false;
  7. this.$message.success("修改成功");
  8. }else {
  9. this.$message.error("修改失败,请重试");
  10. }
  11. }).finally(()=>{
  12. this.getAll();
  13. });
  14. },

总结

  1. 加载要修改数据通过传递当前行数据对应的id值到后台查询数据(同删除与查询全部)
  2. 利用前端双向数据绑定将查询到的数据进行回显(同查询全部)
  3. 请求方式使用PUT调用后台对应操作(同新增传递数据)
  4. 修改操作结束后动态刷新页面加载数据(同新增)
  5. 根据操作结果不同,显示对应的提示信息(同新增)

10.业务消息一致性处理

目前的功能制作基本上达成了正常使用的情况,什么叫正常使用呢?也就是这个程序不出BUG,如果我们搞一个BUG出来,你会发现程序马上崩溃掉。比如后台手工抛出一个异常,看看前端接收到的数据什么样子。

  1. {
  2. "timestamp": "2021-09-15T03:27:31.038+00:00",
  3. "status": 500,
  4. "error": "Internal Server Error",
  5. "path": "/books"
  6. }

面对这种情况,前端的同学又不会了,这又是什么格式?怎么和之前的格式不一样?

  1. {
  2. "flag": true,
  3. "data":{
  4. "id": 1,
  5. "type": "计算机理论",
  6. "name": "Spring实战 第5版",
  7. "description": "Spring入门经典教程"
  8. }
  9. }

看来不仅要对正确的操作数据格式做处理,还要对错误的操作数据格式做同样的格式处理。

首先在当前的数据结果中添加消息字段,用来兼容后台出现的操作消息。

  1. @Data
  2. public class R{
  3. //完整形态是flag换Integer型的状态码code
  4. private Boolean flag;
  5. private Object data;
  6. private String msg; //用于封装消息
  7. }

后台代码也要根据情况做处理,当前是模拟的错误。

  1. @PostMapping
  2. public R save(@RequestBody Book book) throws IOException {
  3. Boolean flag = bookService.insert(book);
  4. return new R(flag , flag ? "添加成功^_^" : "添加失败-_-!");
  5. }

然后在表现层做统一的异常处理,使用SpringMVC提供的异常处理器做统一的异常处理。

  1. @RestControllerAdvice
  2. public class ProjectExceptionAdvice {
  3. @ExceptionHandler(Exception.class)
  4. public R doOtherException(Exception ex){
  5. //记录日志
  6. //发送消息给运维
  7. //发送邮件给开发人员,ex对象发送给开发人员
  8. ex.printStackTrace();
  9. return new R(false,null,"系统错误,请稍后再试!");
  10. }
  11. }

页面上得到数据后,先判定是否有后台传递过来的消息,标志就是当前操作是否成功,如果返回操作结果false,就读取后台传递的消息。

  1. //添加
  2. handleAdd () {
  3. //发送ajax请求
  4. axios.post("/books",this.formData).then((res)=>{
  5. //如果操作成功,关闭弹层,显示数据
  6. if(res.data.flag){
  7. this.dialogFormVisible = false;
  8. this.$message.success("添加成功");
  9. }else {
  10. this.$message.error(res.data.msg); //消息来自于后台传递过来,而非固定内容
  11. }
  12. }).finally(()=>{
  13. this.getAll();
  14. });
  15. },

总结

  1. 使用注解@RestControllerAdvice定义SpringMVC异常处理器用来处理异常的
  2. 异常处理器必须被扫描加载,否则无法生效
  3. 表现层返回结果的模型类中添加消息属性用来传递消息到页面

11.页面功能开发

F-5.分页功能

分页功能的制作用于替换前面的查询全部,其中要使用到elementUI提供的分页组件。

  1. <!--分页组件-->
  2. <div class="pagination-container">
  3. <el-pagination
  4. class="pagiantion"
  5. @current-change="handleCurrentChange"
  6. :current-page="pagination.currentPage"
  7. :page-size="pagination.pageSize"
  8. layout="total, prev, pager, next, jumper"
  9. :total="pagination.total">
  10. </el-pagination>
  11. </div>

为了配合分页组件,封装分页对应的数据模型。

  1. data:{
  2. pagination: {
  3. //分页相关模型数据
  4. currentPage: 1, //当前页码
  5. pageSize:10, //每页显示的记录数
  6. total:0, //总记录数
  7. }
  8. },

修改查询全部功能为分页查询,通过路径变量传递页码信息参数。

  1. getAll() {
  2. axios.get("/books/"+this.pagination.currentPage+"/"+this.pagination.pageSize).then((res) => {
  3. });
  4. },

后台提供对应的分页功能。

  1. @GetMapping("/{currentPage}/{pageSize}")
  2. public R getAll(@PathVariable Integer currentPage,@PathVariable Integer pageSize){
  3. IPage<Book> pageBook = bookService.getPage(currentPage, pageSize);
  4. return new R(null != pageBook ,pageBook);
  5. }

页面根据分页操作结果读取对应数据,并进行数据模型绑定。

  1. getAll() {
  2. axios.get("/books/"+this.pagination.currentPage+"/"+this.pagination.pageSize).then((res) => {
  3. this.pagination.total = res.data.data.total;
  4. this.pagination.currentPage = res.data.data.current;
  5. this.pagination.pagesize = res.data.data.size;
  6. this.dataList = res.data.data.records;
  7. });
  8. },

对切换页码操作设置调用当前分页操作。

  1. //切换页码
  2. handleCurrentChange(currentPage) {
  3. this.pagination.currentPage = currentPage;
  4. this.getAll();
  5. },

总结

  1. 使用el分页组件
  2. 定义分页组件绑定的数据模型
  3. 异步调用获取分页数据
  4. 分页数据页面回显

F-6.删除功能维护

由于使用了分页功能,当最后一页只有一条数据时,删除操作就会出现BUG,最后一页无数据但是独立展示,对分页查询功能进行后台功能维护,如果当前页码值大于最大页码值,重新执行查询。其实这个问题解决方案很多,这里给出比较简单的一种处理方案。

  1. @GetMapping("{currentPage}/{pageSize}")
  2. public R getPage(@PathVariable int currentPage,@PathVariable int pageSize){
  3. IPage<Book> page = bookService.getPage(currentPage, pageSize);
  4. //如果当前页码值大于了总页码值,那么重新执行查询操作,使用最大页码值作为当前页码值
  5. if( currentPage > page.getPages()){
  6. page = bookService.getPage((int)page.getPages(), pageSize);
  7. }
  8. return new R(true, page);
  9. }

F-7.条件查询功能

最后一个功能来做条件查询,其实条件查询可以理解为分页查询的时候除了携带分页数据再多带几个数据的查询。这些多带的数据就是查询条件。比较一下不带条件的分页查询与带条件的分页查询差别之处,这个功能就好做了

  • 页面封装的数据:带不带条件影响的仅仅是一次性传递到后台的数据总量,由传递2个分页相关数据转换成2个分页数据加若干个条件

  • 后台查询功能:查询时由不带条件,转换成带条件,反正不带条件的时候查询条件对象使用的是null,现在换成具体条件,差别不大

  • 查询结果:不管带不带条件,出来的数据只是有数量上的差别,其他都差别,这个可以忽略

    经过上述分析,看来需要在页面发送请求的格式方面做一定的修改,后台的调用数据层操作时发送修改,其他没有区别。

    页面发送请求时,两个分页数据仍然使用路径变量,其他条件采用动态拼装url参数的形式传递。

    页面封装查询条件字段

    1. pagination: {
    2. //分页相关模型数据
    3. currentPage: 1, //当前页码
    4. pageSize:10, //每页显示的记录数
    5. total:0, //总记录数
    6. name: "",
    7. type: "",
    8. description: ""
    9. },

    页面添加查询条件字段对应的数据模型绑定名称

    1. <div class="filter-container">
    2. <el-input placeholder="图书类别" v-model="pagination.type" class="filter-item"/>
    3. <el-input placeholder="图书名称" v-model="pagination.name" class="filter-item"/>
    4. <el-input placeholder="图书描述" v-model="pagination.description" class="filter-item"/>
    5. <el-button @click="getAll()" class="dalfBut">查询</el-button>
    6. <el-button type="primary" class="butT" @click="handleCreate()">新建</el-button>
    7. </div>

    将查询条件组织成url参数,添加到请求url地址中,这里可以借助其他类库快速开发,当前使用手工形式拼接,降低学习要求

    1. getAll() {
    2. //1.获取查询条件,拼接查询条件
    3. param = "?name="+this.pagination.name;
    4. param += "&type="+this.pagination.type;
    5. param += "&description="+this.pagination.description;
    6. console.log("-----------------"+ param);
    7. axios.get("/books/"+this.pagination.currentPage+"/"+this.pagination.pageSize+param).then((res) => {
    8. this.dataList = res.data.data.records;
    9. });
    10. },

    后台代码中定义实体类封查询条件

    1. @GetMapping("{currentPage}/{pageSize}")
    2. public R getAll(@PathVariable int currentPage,@PathVariable int pageSize,Book book) {
    3. System.out.println("参数=====>"+book);
    4. IPage<Book> pageBook = bookService.getPage(currentPage,pageSize);
    5. return new R(null != pageBook ,pageBook);
    6. }

    对应业务层接口与实现类进行修正

    1. public interface IBookService extends IService<Book> {
    2. IPage<Book> getPage(Integer currentPage,Integer pageSize,Book queryBook);
    3. }
    1. @Service
    2. public class BookServiceImpl2 extends ServiceImpl<BookDao,Book> implements IBookService {
    3. public IPage<Book> getPage(Integer currentPage,Integer pageSize,Book queryBook){
    4. IPage page = new Page(currentPage,pageSize);
    5. LambdaQueryWrapper<Book> lqw = new LambdaQueryWrapper<Book>();
    6. lqw.like(Strings.isNotEmpty(queryBook.getName()),Book::getName,queryBook.getName());
    7. lqw.like(Strings.isNotEmpty(queryBook.getType()),Book::getType,queryBook.getType());
    8. lqw.like(Strings.isNotEmpty(queryBook.getDescription()),Book::getDescription,queryBook.getDescription());
    9. return bookDao.selectPage(page,lqw);
    10. }
    11. }

    页面回显数据

    1. getAll() {
    2. //1.获取查询条件,拼接查询条件
    3. param = "?name="+this.pagination.name;
    4. param += "&type="+this.pagination.type;
    5. param += "&description="+this.pagination.description;
    6. console.log("-----------------"+ param);
    7. axios.get("/books/"+this.pagination.currentPage+"/"+this.pagination.pageSize+param).then((res) => {
    8. this.pagination.total = res.data.data.total;
    9. this.pagination.currentPage = res.data.data.current;
    10. this.pagination.pagesize = res.data.data.size;
    11. this.dataList = res.data.data.records;
    12. });
    13. },

总结

  1. 定义查询条件数据模型(当前封装到分页数据模型中)
  2. 异步调用分页功能并通过请求参数传递数据到后台

声明:本文内容由网友自发贡献,不代表【wpsshop博客】立场,版权归原作者所有,本站不承担相应法律责任。如您发现有侵权的内容,请联系我们。转载请注明出处:https://www.wpsshop.cn/w/AllinToyou/article/detail/674717
推荐阅读
相关标签
  

闽ICP备14008679号