devbox
我家小花儿
这个屌丝很懒，什么也没留下！
关注作者
热门标签
热门文章
当前位置:   article > 正文

《学成在线》微服务实战项目实操笔记系列（P1~P83）【上】_学成在线 项目 笔记

作者：我家小花儿 | 2024-04-14 04:45:34

赞

踩

学成在线 项目 笔记

史上最详细《学成在线》项目实操笔记系列【上】，跟视频的每一P对应，全系列18万字，涵盖详细步骤与问题的解决方案。如果你操作到某一步卡壳，参考这篇，相信会带给你极大启发。

一、前期准备

1.1 项目介绍 P2

To C面向个人，B2B2C（第1个B是指商品或服务的供应商，第2个B是指从事电子商务的企业，C是消费者。例子：腾讯课堂，第1个B是腾讯公司，第2个B是入驻授课的企业，C是用户学习课程）

本项目含有3个端：用户端；机构端；运营端

1.2 说自己项目 P3

从以下几个方面进行项目介绍：

1.项目的背景，包括：是自研还是外包，什么业务，服务的客户群是谁，谁去运营等问题。

2.项目的业务流程（核心的业务流程）

3.项目的功能模块（核心模块一定要说）

4.项目的技术架构

5.个人工作职责（说得详细一些）

6.个人负责模块的详细说明，包括模块设计，用到的技术，技术的实现方案等（找最熟悉的模块进行说明）。

项目基本介绍：是公司自研的专门针对成人职业技能教育的网络课堂系统，网站提供了成人职业技能培训的相关课程，如：软件开发培训。基于B2B2C的业务模式。培训机构可以在平台入驻、发布课程，我们公司作为运营方由专门的人员对发布的课程进行审核，审核通过后课程才可以发布成功，课程包括免费和收费两种形式，对于免费课程用户可以直接选课学习，对于收费课程要在选课后支付成功才可以继续学习。

本项目包括3个端：用户端、机构端、运营端。

核心模块：内容管理、媒资管理、课程搜索、订单支付、选课管理、认证授权等。

本项目采用前后端分离架构，后端采用SpringBoot、SpringCloud技术栈开发，数据库使用了Mysql，还使用了Redis、消息队列、分布式文件系统、Elasticsearch等中间件系统（要清楚这些中间件在系统中是如何使用的，在哪里使用的）。

划分的微服务包括：内容管理服务、媒资管理服务、搜索服务、订单支付服务、学习中心服务、系统管理服务、认证授权服务、网关服务、注册中心服务、配置中心服务等。

我在这个项目中负责了内容管理、媒资管理、订单支付模块的设计与开发。

个人负责模块的详细说明：内容管理模块，是对平台上的课程进行管理。设计了课程基本信息表、课程营销表、课程计划、课程师资表。培训机构要发布一门课程需要填写课程基本信息、课程营销信息、课程计划信息、课程师资信息，填写完毕后要提交审核，由运营人员进行课程信息的审核，整个审核过程是程序自动审核加入人工确认的方式，通常24小时完成审核。课程审核通过即可发布课程，课程的相关信息会聚合到课程发布表中，这里不仅要将课程信息写到课程发布表还要将课程信息写到索引库、分布式文件系统中，所以这里存在分布式事务的问题，项目使用本地消息表加任务调度的方式去解决这里的分布式事务，保证数据的最终一致性。

1.3 技术架构 P5

业务：解决了什么问题，为用户提供了什么样的服务。

 

技术栈：

1.4 环境配置 P6

配置环境版本如下：

IDEA基本配置如下：

Maven配置：

先把maven解压，然后把maven仓库解压。

在maven的setting.xml文件中进行配置：

 

  1. <mirror>
  2.    <id>alimaven</id>
  3.    <name>aliyun maven</name>
  4.    <url>http://maven.aliyun.com/nexus/content/groups/public</url>
  5.    <blocked>central</blocked>
  6. </mirror>

在IDEA中进行配置：

虚拟机配置：

解压虚拟机

双击虚拟机

点击虚拟网络编辑器

把VMnet8的子网地址改为：192.168.101.0

虚拟机的用户名：root，密码：centos

虚拟机ip：192.168.101.65

启动docker

systemctl start docker

运行所有的软件： 

sh /data/soft/restart.sh

 查询docker容器：docker ps

docker ps

数据库配置：

我是先用Navicat连接上虚拟机中的mysql：

Git配置：

下载完Git然后配置到IDEA上：

搭建Gogs：

Gogs是一个轻量级的远程仓库，是在虚拟机里面的，本项目使用Gogs作为Git远程仓库。进入Gogs：

http://192.168.101.65:10880

账号：gogs，密码：gogs

关联远程仓库：

我这里项目已经创建好了，我想要关联远程仓库，就不按照视频的方法进行。

点击VCS-Create Git Repositoty，选择当前项目的文件夹作为仓库，全选当前项目中所有文件，输入文字，然后点击commit。就可以把项目上传到本地仓库。

  

然后点击向上的按钮，点击Define remote，会跳出一个弹窗，弹窗的地址填写下面网页中的地址：

我直接使用现成的仓库，复制下面的HTTP地址，粘贴到上面弹窗中，然后会有输入账号密码的弹窗填gogs的账号密码：

然后就会出现项目内容：

如果忘记gogs密码：

可以在用户设置处更改密码；也可以在管理面板，用户管理，编辑处让管理员指定密码：

 

如何还是提示密码错误，可以在IDEA中，把文件名改掉（改成不存在的，会提示输入密码），也可以选不保存忘记密码：

配置.gitignore文件

把下面文件夹中的内容复制到IDEA的.gitignore文件中。

选中.gitignore，先commit然后push到远程仓库。

关于分支：

老师每一天的授课内容都会创建一个分支。如果想看看第1天的代码，就可以切换到第1天的分支，然后该分支只会显示第1天的代码。

分支在Git中相当于一个独立的工作流，每个分支都可以有不同的提交历史和代码改动。

可以通过在Git界面右键分支，点击Checkout来切换分支。

 

1.5 创建工程 P7

父工程职责：把所有依赖的版本确定下来，模块的聚合作用。

基础工程：基础的代码。所有的微服务依赖于基础工程。

首先创建名为xuecheng-plus-project的工程，把src文件删掉，然后创建xuecheng-plus-parent的模块。

项目结构大概如下，然后把第1章里的pom.xml代码复制到父工程的pom.xml文件中：

 

首先用properties标签把所有依赖的版本确定，然后dependencyManagement标签来引入对应的依赖。

下面创建xuecheng-plus-base模块，这个模块和parent模块是并列关系。base模块里除了src和pom.xml文件外其它东西删掉，包括一些启动类和配置项都要删除，只留下基本结构。

 

所有模块都是直接或间接继承父模块，所以要把父工程的坐标（下面红框里）复制，然后粘贴到base模块的<parent>标签下

然后把下面文件中base模块pom.xml中的<dependencies>标签下的内容单独复制，粘贴替换base模块的pom.xml中的<dependencies>下的内容。

1.6 Git面试 P8

可以在Git面板看到所有commit提交到本地仓库的版本。小铅笔所在的就是当前的分支。

面试题1：Git代码冲突怎么处理？
冲突的原因：本地文件的版本浴目标分支中文件的版本不一致时，当存在同一行的内容不同时在进行合并时会出现冲突。

场景：多个分支向主分支合并时（A同事和B同事开发过程中对同一文件的同一行内容进行修改）。同一个分支下pull或push操作时。

在IDEA里commit是提交到本地仓库（是本地机上的一个目录）。push是把本地仓库提交到远程仓库。

可以通过图形界面修改

通过代码行修改方式如下：

然后要add将文件添加到暂存区，commit将文件提交，最后push提交到远程仓库。

面试题2：你是在哪个分支开发？

我们不是直接在主分支开发，由技术经理创建独立的开发分支，我们是在独立的开发分支中进行开发，最后由技术经理将开发分支合并到主分支（技术经理对代码进行审查最终合并到主分支）。

1.7 Maven面试 P9

面试题1：Maven指令的作用

mvn clean 清除target目录中的生成结果

mvn compile 编译源代码（生成target目录，然后会有classes文件）

mvn test 执行单元测试

mvn package 打包（打成的jar包会放在target目录）

mvn install 打包并把打好的包上传到本地仓库

mvn deploy 打包并把打好的包上传到远程仓库

面试题2：Maven依赖版本冲突怎么处理？

maven的依赖版本冲突一般是由于间接依赖导致一个jar包有多个不同的版本。比如：A依赖了B的1.0版本，C依赖了B的2.0版本，项目依赖A和C，从而间接依赖了B的1.0和2.0版本，此时B有两个版本引入到了项目中，可能会出现ClassNotFoundException和NoSuchMethodError等错误。

处理版本冲突可以使用以下方法：

1.使用exclusions排除依赖

比如：我们只依赖B的1.0版本，此时可以在依赖C时排除对B的依赖。

2.使用dependencyManagement锁定版本号

通常在父工程对依赖的版本同一管理

比如：我们只依赖B的1.0版本，此时可以在父工程中限定B的版本为1.0

1.8 数据库环境 P10

数据库用的是虚拟docker容器里的数据库。

数据库用户名：root，密码：mysql。

输入下面启动运行：

  1. systemctl start docker
  2. sh /data/soft/restart.sh

我是在Navicat中对虚拟机中MySQL的连接下新建了一个数据库： 

右键表，然后点击运行sql文件，选择下面的xcplus_content.sql这个文件打开，最后可以看到表都加载到了数据库中：

 

1.9 存储引擎及区别 P11

1.InnoDB（InnoDB用于事务处理，具有ACID事务支持等特性，如果要执行大量insert和update操作，应该选择这个）：支持事务。使用的锁颗粒度默认为行级锁，可以支持更高的并发，也可以支持表锁。支持外键约束，外键约束降低了表的查询速度，增加了表之间的耦合度。

2.MyISAM（管理非事务表，提供高速存储和检索以及全文搜索能力）：不提供事务支持。只支持表级锁。不支持外键。

3.memory：数据存储在内存中。

1.10 MySQL建表注意 P12

注意选择存储引擎，如果要支持事务需要选择InnoDB。

日期类型如果要记录时分秒选择datetime，只记录年月日使用date；固定长度字符选择char，不固定长度字符varchar（varchar比char节省空间但速度没有char快）；对于内容介绍类的长广文本字段使用text或longtext类型；如果存储图片等二进制数据使用blob或longblob类型；对金额字段使用DECIMAL。

如果要存储text、blob字段建议单独建一张表，使用外键关联。

尽量不要定义外键，保证表的独立性，可以存在外键意义的字段。

注意字段的约束，如：非空、唯一、主键等。

1.11 (内容管理)创建工程 P15

 这一节具体可以参考day01/资料中的第2章讲义。

在xuecheng-plus-content下面创建xuecheng-plus-content-api、xuecheng-plus-content-model和xuecheng-plus-content-service这三个模块。

新建的目录结构如下：

 模块之间依赖关系如下：

xuecheng-plus-content-model依赖xuecheng-plus-base。

xuecheng-plus-content-service依赖xuecheng-plus-model。

xuecheng-plus-content-api依赖xuecheng-plus-content-service。因为看图，api依赖service也依赖model，但因为service依赖model，所以api如果依赖了service变相也依赖了model。

xuecheng-plus-content-model的pom.xml文件：

  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.     <parent>
  6.         <artifactId>xuecheng-plus-content</artifactId>
  7.         <groupId>com.xuecheng</groupId>
  8.         <version>0.0.1-SNAPSHOT</version>
  9.     </parent>
  10.     <artifactId>xuecheng-plus-content-model</artifactId>
  11.     <dependencies>
  12.         <dependency>
  13.             <groupId>com.xuecheng</groupId>
  14.             <artifactId>xuecheng-plus-base</artifactId>
  15.             <version>0.0.1-SNAPSHOT</version>
  16.         </dependency>
  17.     </dependencies>
  18.  
  19. </project>

xuecheng-plus-content-service的pom.xml文件：

  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.     <parent>
  6.         <artifactId>xuecheng-plus-content</artifactId>
  7.         <groupId>com.xuecheng</groupId>
  8.         <version>0.0.1-SNAPSHOT</version>
  9.     </parent>
  10.     <artifactId>xuecheng-plus-content-service</artifactId>
  11.         <dependencies>
  12.         <dependency>
  13.             <groupId>com.xuecheng</groupId>
  14.             <artifactId>xuecheng-plus-content-model</artifactId>
  15.             <version>0.0.1-SNAPSHOT</version>
  16.         </dependency>
  17.      </dependencies>
  18. </project>

xuecheng-plus-content-api的pom.xml文件：

  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.     <parent>
  6.         <artifactId>xuecheng-plus-content</artifactId>
  7.         <groupId>com.xuecheng</groupId>
  8.         <version>0.0.1-SNAPSHOT</version>
  9.     </parent>
  10.     <artifactId>xuecheng-plus-content-api</artifactId>
  11.     <dependencies>
  12.         <dependency>
  13.             <groupId>com.xuecheng</groupId>
  14.             <artifactId>xuecheng-plus-content-service</artifactId>
  15.             <version>0.0.1-SNAPSHOT</version>
  16.         </dependency>
  17.     </dependencies>
  18. </project>

二、课程模块开发

2.1 课程查询 需求分析 P16

操作流程（一步一步要怎么操作）就是业务流程，然后弄清在操作流程中需要哪些数据。

2.2 课程查询 生成PO类 P17

具体的搭建步骤可以看资料中下面这个文件里的内容：

course_base文件是课程基本信息文件。

表结构如下。

首先把xuecheng-plus-generator这个代码生成器解压出来，然后放到xuecheng-plus-project这个总工程下面。

此时该模块还是灰色的，右键pom.xml然后点击Add as Maven Project，可以使其变成maven工程。

修改generator下的ContentCodeGenerator类：

修改下面数据的连接配置，像我的表叫content，可以去掉前面xc402：

先把java下面的content删掉，然后运行ContentCodeGenerator的main方法：

main方法执行完后，可以看到生成了content包，model下面有po类。把po下面的所有po类复制粘贴到xuecheng-plus-content-model下的po包中：

发现有一些报错，主要的原因是缺乏了依赖。

可以加入如下的依赖到model模块的pom.xml文件中：

  1. <!--存在mybatisplus注解添加相关注解保证不报错-->
  2.         <dependency>
  3.             <groupId>com.baomidou</groupId>
  4.             <artifactId>mybatis-plus-annotation</artifactId>
  5.             <version>${mybatis-plus-boot-starter.version}</version>
  6.         </dependency>
  7.         <dependency>
  8.             <groupId>com.baomidou</groupId>
  9.             <artifactId>mybatis-plus-core</artifactId>
  10.             <version>${mybatis-plus-boot-starter.version}</version>
  11.         </dependency>
  12.         <dependency>
  13.             <groupId>org.projectlombok</groupId>
  14.             <artifactId>lombok</artifactId>
  15. </dependency>

现在就不会报错了： 

2.3 课程查询 设计分析 P18

2.4 课程查询 接口定义 P19

该节内容可以参考下面的文档进行配置，所以我只罗列关键步骤。

第1步：定义分页查询模型类。在xuecheng-plus-base下面的src\main\java\com\xuecheng\base\model下面创建PageParams类，写入代码。

第2步：定义条件模型类。在xuecheng-plus-content/xuecheng-plus-content-model下面src/main/java/com/xuecheng/content/model下创建dto包，创建QueryCourseParamsDto类：

第3步：定义响应模型类。

PageResult分为2部分，1部分是数据，另1部分是分页信息。

第4步：把依赖放到xuecheng-plus-content-api的pom.xml中

详细请见文档：

我个人导入的时候cloud的基础环境包有点问题，然后我修改了<parent>里面的代码：

第5步：在xuecheng-plus-content-api的com/xuecheng下面创建content/api，然后创建一个CourseBaseInfoController类：

  1. @RestController
  2. public class CourseBaseInfoController {
  3.     @RequestMapping("/course/list")
  4.     public PageResult<CourseBase> list(PageParams pageParams,@RequestBody QueryCourseParamsDto queryCourseParamsDto){
  5.         return null;
  6.     }
  7. }

第6步：在xuecheng-plus-content-api的com/xuecheng下面创建ContentApplication启动类，注意这个类一定是要在xucheng下面（不要放到content下）。

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

log4j2-dev.xml在下面的位置，粘贴到下面位置：

 

在xuecheng-plus-content的xuecheng-plus-content-api下面的resources下创建bootstrap.yml文件，然后写入如下代码，注意把url中端口后的数据库名称改成自己的：

点击启动类中下面按钮启动项目：

重点：请求localhost:63040/content/course/list出现的是下面的情况（政策现象）：

请求的数据和接口不匹配，加上pageNo和pageSize仍旧不行。

localhost:63040/content/course/list?pageNo=1&pageSize=30

是因为第二个参数要接受json数据转化为Java对象，而现在没有这个json数据。

@RequestBody这个注解对参数的要求为true，因此不行。修改方式如下给@RequestBody加一个required=false。

现在再请求就没有任何问题了：

控制台也显示成功：

前端和controller层间用vo传递数据，controller和service层间用DTO传输数据，service和dao层间用po传输数据。

如果有多个前端，比如手机、PC，传入的参数个数不同，就需要有VO（避免让负责手机前端的工程师误认为有5个参数），比如VO1对应手机是3个参数，VO2对应PC是5个参数。如果没有多个前端，就只有1个前端，那就只需要用DTO即可，不需要VO。

 2.5 课程查询 swagger P20

swagger可以在线生成接口文档。

首先加入swagger依赖（之前已加完），然后要在配置文件bootstrap.yml中进行配置：

  1. swagger:
  2.   title: "学成在线内容管理系统"
  3.   description: "内容系统管理系统对课程相关信息进行管理"
  4.   base-package: com.xuecheng.content
  5.   enabled: true
  6.   version: 1.0.0

在启动类上加@EnableSwagger2Doc注解

然后重启项目

在浏览器中输入：localhost:63040/content/swagger-ui.html，然后可以看到如下的界面：

在类上加@Api注解，在方法上加@ApiOperation接口，把@RequestMapping改成@PostMapping：

  1. @Api(value="课程信息管理接口",tags="课程信息管理接口")
  2. @RestController
  3. public class CourseBaseInfoController {
  4.     @ApiOperation("课程查询接口")
  5.     @PostMapping("/course/list")
  6.     public PageResult<CourseBase> list(PageParams pageParams,@RequestBody(required=false) QueryCourseParamsDto queryCourseParamsDto){
  7.         return null;
  8.     }
  9. }

效果如下： 

@ApiModelProperty可以加在属性上，用来给属性备注名称。

swagger里还可以进行接口测试

但发现日期不太好看

可以直接从下面这个文件中取出LocalDateTimeConfig这个工具类：

然后放到如下的位置：

重启项目，重新测试：

2.6 SpringBoot常用注解 P21

@ResponseBody ： 将数据以json的格式响应给前端（侧重返回，定义在类上）

@RequestBody ：将json数据转化为java对象（侧重接收，定义在方法上）

@PathVariable ： 接收请求路径中占位符的值

@Autowired：是基于类型的注入。

@Resource：基于名称注入。

2.7 项目开发流程 P22

1.产品人员设计产品原型。

2.讨论需求。

3.分模块设计接口。

4.出接口文档。

5.将接口文档给到前端人员，前后端分离开发。

6.开发完毕进行测试。

7.测试完毕发布项目，由运维人员进行部署安装。

2.8 课程查询 DAO接口 P23

前后端分离开发，先定义controller层的接口，生成接口文档，然后再前后端一起开发。

要从底层开始写，从持久层开始写。

在xuecheng-plus-content-service下面的com/xuecheng下面创建content包，在content下创建mapper包。

然后把xuecheng-plus-generator下的com/xuecheng/content/mapper下的所有文件拷贝到上面service的mapper包下。

然后要进行单元测试，首先把xuecheng-plus-content-service的依赖补全，把如下这些依赖复制粘贴到service：

在service的test下创建resources：

把api模块定义的2个配置文件，拷贝到service模块：

配置文件只需要像下面这样：

在service的test/java下创建com/xuecheng包，然后把api的启动类拷贝到com/xuecheng下，删掉生成接口文档的注解：

分页插件会自动加limit语句

分页插件的原理：分页参数会放到ThreadLocal中，mybatis plus有一个拦截器，可以拦截执行的sql，根据数据库类型添加对应的分页语句重写sql，在末尾拼加limit。

在xuecheng-plus-content-service的java/com/xuecheng/content下创建一个config包，然后创建MybatisPlusConfig类，把代码都写入进去：

在service模块的test/java/com/xuecheng/content下创建CourseBaseMapperTests，写入如下内容：

如果左侧为绿√，代表测试通过，也可以打个断点看看：

CourseBaseMapperTests代码如下： 

  1. @SpringBootTest
  2. public class CourseBaseMapperTests {
  3.     @Autowired
  4.     CourseBaseMapper courseBaseMapper;
  5.     @Test
  6.     public void testCourseBaseMapper(){
  7.         CourseBase courseBase = courseBaseMapper.selectById(18);
  8.         Assertions.assertNotNull(courseBase);
  9.         //详细进行分页查询的单元测试
  10.         //查询条件
  11.         QueryCourseParamsDto courseParamsDto = new QueryCourseParamsDto();
  12.         courseParamsDto.setCourseName("java"); //课程名称查询条件
  13.         //拼装查询条件
  14.         LambdaQueryWrapper<CourseBase> queryWrapper = new LambdaQueryWrapper<>();
  15.         //根据名称模糊查询.在sql中拼接course_base.name like '%值%'
  16.         queryWrapper.like(StringUtils.isNotEmpty(courseParamsDto.getCourseName()),CourseBase::getName,courseParamsDto.getCourseName());
  17.         //根据课程审核状态查询 course_base.audit_status= ?
  18.         queryWrapper.eq(StringUtils.isNotEmpty(courseParamsDto.getAuditStatus()),CourseBase::getAuditStatus,courseParamsDto.getAuditStatus());
  19.         //分页参数对象
  20.         PageParams pageParams = new PageParams();
  21.         pageParams.setPageNo(1L);
  22.         pageParams.setPageSize(2L);
  23.         //创建page分页参数对象，参数：当前页码，每页记录数。
  24.         Page<CourseBase> page = new Page<>(pageParams.getPageNo(), pageParams.getPageSize());
  25.         //开始进行分页查询
  26.         Page<CourseBase> pageResult = courseBaseMapper.selectPage(page, queryWrapper);
  27.         //数据列表
  28.         List<CourseBase> items = pageResult.getRecords();
  29.         //总记录数
  30.         long total = pageResult.getTotal();
  31.         //List<T> items,long counts,long page,long pageSize
  32.         PageResult<CourseBase> courseBasePageResult = new PageResult<CourseBase>(items,total,pageParams.getPageNo(),pageParams.getPageSize());
  33.         System.out.println(courseBasePageResult);
  34.     }
  35. }

在末尾打上断点，进行断点调试： 

看一下是否有LIMIT语句： 

看一下结果数据是否完整：

如果觉得数据有问题可以把SQL语句复制到Navicat中，然后把参数逐一替换问号，进行执行、

2.9 数据字典表 P24

下拉框的文字来源于数据字典表，方便前端进行修改替换展示。

数据字典由code编码和文字组成，通过编码来指代文字。

在Navicat中创建一个新的数据库，xc_system，uff8mb4_general_ci。然后执行.sql文件，全称是xcplus_system.sql。

虚拟机里面的Mysql已经有了这个数据库，名字叫作xcplus-system，所以我们不用创建，只需要知道流程。

2.10 (课程查询)service P25

在xuecheng-plus-base的xuecheng-plus-content-service下的src/main/java/com/xuecheng/content下创建service包，在service包下创建CourseBaseInfoService接口，写入如下代码：

  1. //课程信息管理接口
  2. public interface CourseBaseInfoService {
  3.     /**
  4.      * 课程分页查询
  5.      * @param pageParams 分页查询参数
  6.      * @param queryCourseParamsDto 查询条件
  7.      * @return 查询结果
  8.      */
  9.     public PageResult<CourseBase> queryCourseBaseList(PageParams pageParams, QueryCourseParamsDto queryCourseParamsDto);
  10. }

再在service包下创建impl包，在impl包下创建实现类CourseBaseInfoServiceImpl，写入如下代码（注意一定要把return null改过了）：

  1. @Slf4j
  2. @Service
  3. public class CourseBaseInfoServiceImpl implements CourseBaseInfoService {
  4.     @Autowired
  5.     CourseBaseMapper courseBaseMapper;
  6.  
  7.     @Override
  8.     public PageResult<CourseBase> queryCourseBaseList(PageParams pageParams, QueryCourseParamsDto courseParamsDto) {
  9.         //拼装查询条件
  10.         LambdaQueryWrapper<CourseBase> queryWrapper = new LambdaQueryWrapper<>();
  11.         //根据名称模糊查询.在sql中拼接course_base.name like '%值%'
  12.         queryWrapper.like(StringUtils.isNotEmpty(courseParamsDto.getCourseName()),CourseBase::getName,courseParamsDto.getCourseName());
  13.         //根据课程审核状态查询 course_base.audit_status= ?
  14.         queryWrapper.eq(StringUtils.isNotEmpty(courseParamsDto.getAuditStatus()),CourseBase::getAuditStatus,courseParamsDto.getAuditStatus());
  15.         //创建page分页参数对象，参数：当前页码，每页记录数。
  16.         Page<CourseBase> page = new Page<>(pageParams.getPageNo(), pageParams.getPageSize());
  17.         //开始进行分页查询
  18.         Page<CourseBase> pageResult = courseBaseMapper.selectPage(page, queryWrapper);
  19.         //数据列表
  20.         List<CourseBase> items = pageResult.getRecords();
  21.         //总记录数
  22.         long total = pageResult.getTotal();
  23.         //List<T> items,long counts,long page,long pageSize
  24.         PageResult<CourseBase> courseBasePageResult = new PageResult<CourseBase>(items,total,pageParams.getPageNo(),pageParams.getPageSize());
  25.         return courseBasePageResult;
  26.     }
  27. }

 然后要进行单元测试，复制service模块test下原有的CourseBaseMapperTests粘贴到自己的路径下，然后改名为CourseBaseInfoServiceTests，写入如下代码：

  1. @SpringBootTest
  2. public class CourseBaseInfoServiceTests {
  3.     @Autowired
  4.     CourseBaseInfoService courseBaseInfoService;
  5.     @Test
  6.     public void testCourseBaseInfoService(){
  7.         //查询条件
  8.         QueryCourseParamsDto courseParamsDto = new QueryCourseParamsDto();
  9.         courseParamsDto.setCourseName("java"); //课程名称查询条件
  10.         courseParamsDto.setAuditStatus("202004");
  11.         //分页参数对象
  12.         PageParams pageParams = new PageParams();
  13.         pageParams.setPageNo(1L);
  14.         pageParams.setPageSize(2L);
  15.         PageResult<CourseBase> courseBasePageResult = courseBaseInfoService.queryCourseBaseList(pageParams, courseParamsDto);
  16.         System.out.println(courseBasePageResult);
  17.     }
  18. }

看一下控制台输出没太大问题： 

2.11 (课程查询)接口测试 P26

完善xuecheng-plus-content-api下的CourseBaseInfoController的代码：

  1. @Api(value="课程信息管理接口",tags="课程信息管理接口")
  2. @RestController
  3. public class CourseBaseInfoController {
  4.     @Autowired
  5.     CourseBaseInfoService courseBaseInfoService;
  6.     @ApiOperation("课程查询接口")
  7.     @PostMapping("/course/list")
  8.     public PageResult<CourseBase> list(PageParams pageParams,@RequestBody(required=false) QueryCourseParamsDto queryCourseParamsDto){
  9.         PageResult<CourseBase> courseBasePageResult = courseBaseInfoService.queryCourseBaseList(pageParams, queryCourseParamsDto);
  10.         return courseBasePageResult;
  11.     }
  12. }

用swagger来测试没有问题： 

 

点击请求这里的地球，然后点击如下，生成一个Http的请求。 

把swagger上面的参数转移到下面：

  1. ###
  2. POST http://localhost:63040/content/course/list?pageNo=1&pageSize=2
  3. Content-Type: application/json
  4.  
  5. {
  6.   "auditStatus": "202004",
  7.   "courseName": "java",
  8.   "publishStatus": ""
  9. }

同样可以查询出结果： 

现在可以把这些查询的文件，统一放到一个包下方便管理。

在xuecheng-plus-project下面创建一个api-test包，在包下创建一个文件名为：xc-content-api.http用来存放请求测试的语句，然后再创建一个http-client.env.json文件，用来配置相应的环境变量。

 

效果如下：

2.12 部署前端和管理服务 P27

安装完node和npm看看版本（我用的是《苍穹外卖》配置的版本，经测试可以，表明项目可以向下兼容）：

用IDEA打开project-xczx2-portal-vue-ts，右键package.json，点击show npm scripts：

右键serve，然后点击Edit serve Settings。然后配置好Node和nmp的版本。最后Run serve：

 4

成功后点击链接访问即可：

打开开发者工具，all报错，这是系统管理服务，请求的是63110端口。

打开第2天的资料，把xuecheng-plus-system放到project里，把pom.xml转化为maven工程，把api模块的配置文件中的数据库修改为我们自己的数据库。

运行Api模块下的SystemApplication启动类。

出现的是跨域问题：

2.13 跨域三种方案 P28

判断是否跨域请求是基于浏览器的同源策略，同源策略是浏览器的一种安全机制，从一个地址请求另一个地址，如果协议、主机、端口三者全部一致则不属于跨域，否则有一个不一致就是跨域。

从http://localhost:8601到http://localhost:8602，因为端口不同，所以是跨域

从http://192.168.101.10:8601到http://192.168.101.11:8601，由于主机不同，是跨域

从http://192.168.101.10:8601到https://192.168.101.10:8601，由于协议不用，是跨域

方法1：JSONP

方法2：添加响应头

Access-Control-Allow-Origin: http://localhost:8601

服务器收到请求判断这个Origin是否允许跨域，如果允许则在响应头中说明允许该来源的跨域请求。

Access-Control-Allow-Origin: *

方法3：通过nginx代理跨域

由于服务器之间没有跨域，浏览器可以通过nginx去访问。 

Nginx和浏览器之间不是跨域的（协议、服务器、端口都一样），通过Nginx代理去访问服务器。

2.14 定义cors过滤器 P29

在xuecheng-plus-system的xuecheng-plus-content-api下的config包下创建一个GlobalCorsConfig类，写入如下代码：

  1. @Configuration
  2.  public class GlobalCorsConfig {
  3.   @Bean
  4.   public CorsFilter corsFilter() {
  5.    CorsConfiguration config = new CorsConfiguration();
  6.    //允许白名单域名进行跨域调用
  7.    config.addAllowedOrigin("*");
  8.    //允许跨越发送cookie
  9.    config.setAllowCredentials(true);
  10.    //放行全部原始头信息
  11.    config.addAllowedHeader("*");
  12.    //允许所有请求方法跨域调用
  13.    config.addAllowedMethod("*");
  14.    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
  15.    source.registerCorsConfiguration("/**", config);
  16.    return new CorsFilter(source);
  17.   }
  18.  }

现在解决了跨域问题，前端页面能正常显示。 

2.15 课程查询前后端联调 P30

前端.env是重要文件，修改了要重新启动项目。

当前内容管理模块打开：VUE_APP_SERVER_API_URL=http://localhost:63040

引入网关后会打开：VUE_APP_SERVER_API_URL=http://localhost:63010

前后端联调的过程。

测试：输入java，看是否出现课程。点击下拉框，看是否有文字。

2.16 (分类查询)接口定义 P31

下表是树形结构，是三级结构。

在xuecheng-plus-content的xuecheng-plus-content-model下的dto中，定义一个新类CourseCategoryTreeDto，写入如下代码：

  1. @Data
  2. public class CourseCategoryTreeDto extends CourseCategory implements  java.io.Serializable{
  3.     List<CourseCategoryTreeDto> childrenTreeNodes;
  4. }

在xuecheng-plus-content的xuecheng-plus-content-api/src/main/java/com/xuecheng/content/api下新增一个类CourseCategoryController，写入如下代码：

  1. @RestController
  2. public class CourseCategoryController {
  3.     @GetMapping("/course-category/tree-nodes")
  4.     public List<CourseCategoryTreeDto> queryTreeNodes(){
  5.         return null;
  6.     }
  7. }

2.17 (分类查询)树型查询 P32

方法1：表的自连接。

  1. select 
  2. one.id one_id,
  3. one.label one_label,
  4. two.id two_id,
  5. two.label two_label
  6. from course_category one 
  7. inner join course_category two 
  8. on two.parentid = one.id
  9. where one.parentid = '1'
  10. and one.is_show = '1'
  11. and two.is_show = '1'
  12. order by one.orderby,two.orderby

方法2：递归

向下递归，由根节点找子节点。 

  1. with recursive t1 as (
  2. 	select * from course_category where id='1'
  3. 	union all 
  4. 	select t2.* from course_category t2 inner join t1 on t1.id=t2.parentid
  5. )
  6. select * from t1
  7. order by t1.id

向上递归，由子节点找根节点。

  1. with recursive t1 as (
  2. 	select * from course_category where id='1-1-1'
  3. 	union all 
  4. 	select t2.* from course_category t2 inner join t1 on t1.parentid = t2.id
  5. )
  6. select * from t1
  7. order by t1.id

2.18 (分类查询)开发测试 P33

在xuecheng-plus-content的xuecheng-plus-content-service下的mapper中增加CourseCategoryMapper中的代码：

  1. public interface CourseCategoryMapper extends BaseMapper<CourseCategory> {
  2.     //使用递归查询分类
  3.     public List<CourseCategoryTreeDto> selectTreeNodes(String id);
  4. }

在xuecheng-plus-content的xuecheng-plus-content-service下的mapper中增加CourseCategoryMapper.xml中的代码：

  1. <select id="selectTreeNodes" parameterType="string" resultType="com.xuecheng.content.model.dto.CourseCategoryTreeDto">
  2.     with recursive t1 as (
  3.         select * from course_category where id=#{id}
  4.         union all
  5.         select t2.* from course_category t2 inner join t1 on t1.id = t2.parentid
  6.     )
  7.     select * from t1
  8.     order by t1.id
  9. </select>

在xuecheng-plus-content的xuecheng-plus-content-service的test下的java/com/xuecheng/content下，把CourseBaseMapperTests拷贝一份起名CourseCategoryMapperTests：

写入如下代码：

  1. @SpringBootTest
  2. public class CourseCategoryMapperTests {
  3.     @Autowired
  4.     CourseCategoryMapper courseCategoryMapper;
  5.     @Test
  6.     public void testCourseBaseMapper(){
  7.         List<CourseCategoryTreeDto> courseCategoryTreeDtos = courseCategoryMapper.selectTreeNodes("1");
  8.         System.out.println(courseCategoryTreeDtos);
  9.     }
  10. }


在xuecheng-plus-content的xuecheng-plus-content-service下的service下创建CourseCategoryService接口，写入如下代码：

  1. public interface CourseCategoryService {
  2.     public List<CourseCategoryTreeDto> queryTreeNodes(String id);
  3. }

在xuecheng-plus-content的xuecheng-plus-content-service下的service下创建CourseCategoryServiceImpl类，写入如下代码：

  1. @Slf4j
  2. @Service
  3. public class CourseCategoryServiceImpl implements CourseCategoryService {
  4.     @Autowired
  5.     CourseCategoryMapper courseCategoryMapper;
  6.     @Override
  7.     public List<CourseCategoryTreeDto> queryTreeNodes(String id) {
  8.         //调用mapper递归查询出分类信息
  9.         List<CourseCategoryTreeDto> courseCategoryTreeDtos = courseCategoryMapper.selectTreeNodes(id);
  10.         //找到每个节点的子节点，最终封装成List<CourseCategoryTreeDto>
  11.         //先将list转成map,key就是结点的id,value就是CourseCategoryTreeDto对象，目的是为了方便从map获取结点。filter(item->!id.equals(item.getId()))把根节点拍出
  12.         Map<String, CourseCategoryTreeDto> mapTemp = courseCategoryTreeDtos.stream().filter(item->!id.equals(item.getId())).collect(Collectors.toMap(key -> key.getId(), value -> value));
  13.         //定义一个list作为最终返回的list
  14.         List<CourseCategoryTreeDto> courseCategoryList = new ArrayList<>();
  15.         //从头遍历List<CourseCategoryTreeDto>，一边遍历一边找子节点放在父节点的childrenTreeNodes
  16.         courseCategoryTreeDtos.stream().filter(item->!id.equals(item.getId())).forEach(item->{
  17.             if(item.getParentid().equals(id)){
  18.                 courseCategoryList.add(item);
  19.             }
  20.             //找到节点的父节点
  21.             CourseCategoryTreeDto courseCategoryTreeDto = mapTemp.get(item.getParentid());
  22.             if(courseCategoryTreeDto!=null) {
  23.                 if (courseCategoryTreeDto.getChildrenTreeNodes() == null) {
  24.                     //如果该父节点的ChildrenTreeNodes属性为空要new一个集合，因为要向该集合中放它的子节点
  25.                     courseCategoryTreeDto.setChildrenTreeNodes(new ArrayList<CourseCategoryTreeDto>());
  26.                 }
  27.                 //到每个节点的子节点放在父节点的childrenTreeNodes属性中
  28.                 courseCategoryTreeDto.getChildrenTreeNodes().add(item);
  29.             }
  30.         });
  31.         return courseCategoryList;
  32.     }
  33. }

在xuecheng-plus-content的xuecheng-plus-content-service下的test下创建CourseCategoryServiceTests测试类，写入如下代码：

  1. @SpringBootTest
  2. public class CourseCategoryServiceTests {
  3.     @Autowired
  4.     CourseCategoryService courseCategoryService;
  5.     @Test
  6.     public void testCourseBaseInfoService(){
  7.         List<CourseCategoryTreeDto> courseCategoryTreeDtos = courseCategoryService.queryTreeNodes("1");
  8.         System.out.println(courseCategoryTreeDtos);
  9.     }
  10. }

单元测试的效果如下： 

在xuecheng-plus-content-api的CourseCategoryController下完善代码如下：

  1. @RestController
  2. public class CourseCategoryController {
  3.     @Autowired
  4.     CourseCategoryService courseCategoryService;
  5.     @GetMapping("/course-category/tree-nodes")
  6.     public List<CourseCategoryTreeDto> queryTreeNodes(){
  7.         return courseCategoryService.queryTreeNodes("1");
  8.     }
  9. }

先把xuecheng-plus-content的xuecheng-plus-content-api下的ContentApplication启动。

然后在api-test包下的xc-content-api.http中添加如下代码：

  1. ### 查询课程分类
  2. GET {{content_host}}/content/course-category/tree-nodes

可以看到正常输出结果： 

在前后端联调的时候可以看到课程分类有了结果：

2.19 (新增课程)接口定义 P34

2.20 (新增课程)接口开发 P35

 把下面2个Dto类复制到xuecheng-plus-content的xuecheng-plus-content-api的dto下面：

在xuecheng-plus-content的xuecheng-plus-content-api下的CourseBaseInfoController中写入如下代码：

  1. @ApiOperation("新增课程")
  2.     @PostMapping("/content/course")
  3.     public CourseBaseInfoDto createCourseBase(@RequestBody AddCourseDto addCourseDto){
  4.         return null;
  5.     }

在xuecheng-plus-content的xuecheng-plus-content-service的service下的CourseBaseInfoService中添加接口：

public CourseBaseInfoDto createCourseBase(Long companyId,AddCourseDto addCourseDto);

 在xuecheng-plus-content的xuecheng-plus-content-service的service/impl下的CourseBaseInfoServiceImpl中添加代码：

  1. @Autowired
  2.     private CourseMarketMapper courseMarketMapper;
  3.     @Autowired
  4.     private CourseCategoryMapper courseCategoryMapper;
  5.     @Transactional
  6.     @Override
  7.     public CourseBaseInfoDto createCourseBase(Long companyId, AddCourseDto dto) {
  8.         //参数的合法性校验
  9.         if (StringUtils.isBlank(dto.getName())) {
  10.             throw new RuntimeException("课程名称为空");
  11.         }
  12.  
  13.         if (StringUtils.isBlank(dto.getMt())) {
  14.             throw new RuntimeException("课程分类为空");
  15.         }
  16.  
  17.         if (StringUtils.isBlank(dto.getSt())) {
  18.             throw new RuntimeException("课程分类为空");
  19.         }
  20.  
  21.         if (StringUtils.isBlank(dto.getGrade())) {
  22.             throw new RuntimeException("课程等级为空");
  23.         }
  24.  
  25.         if (StringUtils.isBlank(dto.getTeachmode())) {
  26.             throw new RuntimeException("教育模式为空");
  27.         }
  28.  
  29.         if (StringUtils.isBlank(dto.getUsers())) {
  30.             throw new RuntimeException("适应人群为空");
  31.         }
  32.  
  33.         if (StringUtils.isBlank(dto.getCharge())) {
  34.             throw new RuntimeException("收费规则为空");
  35.         }
  36.  
  37.         //向课程基本信息表course_base写入数据
  38.         CourseBase courseBaseNew = new CourseBase();
  39.         //将传入的页面的参数放到courseBase对象中
  40.         BeanUtils.copyProperties(dto,courseBaseNew); //只要属性名相同就可以拷贝
  41.         courseBaseNew.setCompanyId(companyId);
  42.         courseBaseNew.setCreateDate(LocalDateTime.now());
  43.         //审核状态默认为未提交
  44.         courseBaseNew.setAuditStatus("202002");
  45.         //发布状态为未发布
  46.         courseBaseNew.setStatus("203001");
  47.         //插入数据库
  48.         int insert = courseBaseMapper.insert(courseBaseNew);
  49.         if(insert<=0){
  50.             throw new RuntimeException("添加课程失败");
  51.         }
  52.         //向课程营销表course_market写入数据
  53.         CourseMarket courseMarketNew = new CourseMarket();
  54.         //将页面输入的数据拷贝到courseMarketNew
  55.         BeanUtils.copyProperties(dto,courseMarketNew);
  56.         //课程的id
  57.         Long courseId = courseBaseNew.getId();
  58.         courseMarketNew.setId(courseId);
  59.         //保存营销信息
  60.         saveCourseMarket(courseMarketNew);
  61.         //从数据库查询课程的详细信息，包括两部分
  62.         CourseBaseInfoDto courseBaseInfo = getCourseBaseInfo(courseId);
  63.         return courseBaseInfo;
  64.     }
  65.  
  66.     //查询课程信息
  67.     public CourseBaseInfoDto getCourseBaseInfo(long courseId){
  68.         //从课程基本信息表查询
  69.         CourseBase courseBase = courseBaseMapper.selectById(courseId);
  70.         if(courseBase==null){
  71.             return null;
  72.         }
  73.         //从课程营销表查询
  74.         CourseMarket courseMarket = courseMarketMapper.selectById(courseId);
  75.         //组装在一起
  76.         CourseBaseInfoDto courseBaseInfoDto = new CourseBaseInfoDto();
  77.         BeanUtils.copyProperties(courseBase,courseBaseInfoDto);
  78.         BeanUtils.copyProperties(courseMarket,courseBaseInfoDto);
  79.         //通过courseCategoryMapper查询分类信息，将分类名称放在courseBaseInfoDto对象
  80.         return courseBaseInfoDto;
  81.     }
  82.  
  83.     //单独写一个方法保存营销信息，逻辑：存在则更新，不存在则添加
  84.     private int saveCourseMarket(CourseMarket courseMarketNew){
  85.         //参数的合法性校验
  86.         String charge = courseMarketNew.getCharge();
  87.         if(StringUtils.isEmpty(charge)){
  88.             throw new RuntimeException("收费规则为空");
  89.         }
  90.         //如果课程收费，价格没有填写也需要抛出异常
  91.         if(charge.equals("201001")){
  92.             if(courseMarketNew.getPrice()==null || courseMarketNew.getPrice().floatValue()<=0){
  93.                 throw new RuntimeException("课程的价格不能为空并且必须大于0");
  94.             }
  95.         }
  96.         //从数据库查询营销信息，存在则更新，不存在则添加
  97.         Long id = courseMarketNew.getId();
  98.         CourseMarket courseMarket = courseMarketMapper.selectById(id);
  99.         if(courseMarket==null){
  100.             //插入数据库
  101.             int insert = courseMarketMapper.insert(courseMarketNew);
  102.             return insert;
  103.         }else{
  104.             //将courseMarketNew拷贝到courseMarket
  105.             BeanUtils.copyProperties(courseMarketNew,courseMarket);
  106.             courseMarket.setId(courseMarket.getId());
  107.             //更新
  108.             int i = courseMarketMapper.updateById(courseMarket);
  109.             return i;
  110.         }
  111.     }

2.21 (新增课程)接口测试 P36

首先是完善controller的接口。在xuecheng-plus-content的xuecheng-plus-content-api下的CourseBaseInfoController中完善createCourseBase方法：

  1. @ApiOperation("新增课程")
  2. @PostMapping("/course")
  3. public CourseBaseInfoDto createCourseBase(@RequestBody AddCourseDto addCourseDto){
  4.     //获取到用户所述机构的id
  5.     Long companyId = 1232141425L;
  6.     CourseBaseInfoDto courseBase = courseBaseInfoService.createCourseBase(companyId, addCourseDto);
  7.     return courseBase;
  8. }

然后节约时间跳过单元测试，直接倒api-test下的xc-content-api.http中进行接口测试：

  1. ### 新增课程
  2. POST {{content_host}}/content/course
  3. Content-Type: application/json
  4. {
  5.   "charge": "201001",
  6.   "description": "adsd",
  7.   "grade": "204001",
  8.   "mt": "1-1",
  9.   "name": "java网络编程高级",
  10.   "originalPrice": 100,
  11.   "phone": "13333333",
  12.   "pic": "fdsf",
  13.   "price": 10,
  14.   "qq": "22333",
  15.   "st": "1-1-1",
  16.   "tags": "sdsdwe",
  17.   "teachmode": "20002",
  18.   "users": "初级人员",
  19.   "validDays": 365,
  20.   "wechat": "223344"
  21. }

 在controller和service的实现类上打上断点，主要是看看断点调试时接受的数据是否完整。

放行之后数据效果如下：

前端可以直接看到之前新增的课程：

数据库中也有如下数据，没问题：

前端还暂时无法提交。

2.22 Mybatis相关问题 P37

1.Mybatis分页插件的实现原理：

首先分页参数会被放到ThreadLocal中，拦截执行的sql语句，根据数据库的类型（比如是Mysql就会在末尾添加LIMIT）添加对应的分页语句重写sql。

计算出total总记录数，pageNum当前是第几页，pageSize每页的大小。是否为首页，是否为尾页，总页数等。

2.树型表的标记字段是什么？如何查询MySQL树型表？

树型表的标记字段是parentid即父结点的id。

3.查询一个树型表的方法：

当层级固定时可以用表的自连接进行查询。

如果想灵活查询每个层级可以使用mysql递归方法，使用with RECURSIVE实现。

4.Result Type和Result Map的区别：

Result Type：当查询到的SQL字段的名字和Result Type中模型类型的属性名字对应上的，可以由MyBatis自动完成映射。

Result Map：当查询到的SQL字段的名字和Result Type中模型类型的属性名字对应不上时，需要通过Result Map手动完成映射。

5. #{}和${}的区别

#{}是标记一个占位符，可以防止sql注入。

${}用于在动态sql中拼接字符串，可能导致sql注入。

2.23 自定义异常类型 P38

如果前端名称为空，会报错500。但仅在控制台输出，前端没展示。

如果写很多try-catch代码，会造成代码冗余。

由增强类来捕获异常，原理是AOP面向切面编程。

用@ControllerAdvice注解来控制器增强，用异常处理注解@ExceptionHandler。

在xuecheng-plus-base的base包下创建exception包。

在exception包下创建RestErrorResponse类，和前端约定返回的异常信息模型：

  1. /**
  2.  * 错误响应参数包装
  3.  */
  4. public class RestErrorResponse implements Serializable {
  5.  
  6.     private String errMessage;
  7.  
  8.     public RestErrorResponse(String errMessage){
  9.         this.errMessage= errMessage;
  10.     }
  11.  
  12.     public String getErrMessage() {
  13.         return errMessage;
  14.     }
  15.  
  16.     public void setErrMessage(String errMessage) {
  17.         this.errMessage = errMessage;
  18.     }
  19. }

在exception包下创建XueChengPlusException类：

  1. /**
  2.  * @description 学成在线项目异常类
  3.  * @author Mr.M
  4.  * @date 2022/9/6 11:29
  5.  * @version 1.0
  6.  */
  7. public class XueChengPlusException extends RuntimeException {
  8.  
  9.    private String errMessage;
  10.  
  11.    public XueChengPlusException() {
  12.       super();
  13.    }
  14.  
  15.    public XueChengPlusException(String errMessage) {
  16.       super(errMessage);
  17.       this.errMessage = errMessage;
  18.    }
  19.  
  20.    public String getErrMessage() {
  21.       return errMessage;
  22.    }
  23.  
  24.    public static void cast(CommonError commonError){
  25.        throw new XueChengPlusException(commonError.getErrMessage());
  26.    }
  27.    public static void cast(String errMessage){
  28.        throw new XueChengPlusException(errMessage);
  29.    }
  30.  
  31. }

在exception包下创建CommonError类：

  1. /**
  2.  * @description 通用错误信息
  3.  * @author Mr.M
  4.  * @date 2022/9/6 11:29
  5.  * @version 1.0
  6.  */
  7. public enum CommonError {
  8.  
  9.    UNKOWN_ERROR("执行过程异常，请重试。"),
  10.    PARAMS_ERROR("非法参数"),
  11.    OBJECT_NULL("对象为空"),
  12.    QUERY_NULL("查询结果为空"),
  13.    REQUEST_NULL("请求参数为空");
  14.  
  15.    private String errMessage;
  16.  
  17.    public String getErrMessage() {
  18.       return errMessage;
  19.    }
  20.  
  21.    private CommonError( String errMessage) {
  22.       this.errMessage = errMessage;
  23.    }
  24.  
  25. }

2.24 异常处理开发测试 P39

 现在想测试课程名称为空是否会触发XueChengPlusException异常处理。

首先在service模块的service包的impl包下的CourseBaseInfoServiceImpl类中修改下面的代码：

  1. //参数的合法性校验
  2. if (StringUtils.isBlank(dto.getName())) {
  3.     //throw new RuntimeException("课程名称为空");
  4.     XueChengPlusException.cast("课程名称为空");
  5. }

 在xuecheng-plus-base的exception下的GlobalExceptionHandler类下的如下位置打上断点：

最后在api-test包下的xc-content-api.http下面，让name参数为空。

在如下位置添加自定义的异常处理语句。

 把现价改为负数，会触发异常。

 

2.25 系统异常处理 P40

处理自定义异常：程序在编写代码时根据校验结果主动抛出自定义异常类对象，抛出异常时指定详细的异常信息，异常处理器捕获异常信息记录异常日志并相应给客户。

2.26 JSR303校验 P41

JSR303是一个校验框架。

使用方式：只需要在模型类中通过注解指定校验规则（比如@NOTEmpty来指定不能为空，@Size来指定长度的下限和上限），对不同的应用场景可以通过分组来切换校验规则使用groups，在controller方法上开启校验@Validated。

前端请求后端接口传输参数，在controller和service中都需要校验。

controller校验请求参数的合法性，包括必填项校验、数据格式校验（是否符合一定的日期格式）。

service校验业务规则的相关内容。

因为service是根据业务规则去校验所以不方便写成通用代码，controller中则可以将校验的代码写成通用代码。

引入如下依赖：

合法性校验的注解如下：

如果想要使用需要激活：

首先要把service层校验屏蔽掉（我是直接删掉）：

然后记得要把启动类重启一下，代码才能生效。

在xc-content-api.http中把name改为空，走的是系统异常处理，所以一律输出为位置错误，执行过程异常，请重试。

现在出现问题，如果多个接口使用同一个模型类时，对校验的需求不一样时会出现问题。

解决方法：分组校验。

在xuecheng-plus-base的exception下面的ValidationGroups类中写入如下代码：

  1. //用于分组校验，定义一些常用的组
  2. public class ValidationGroups {
  3.     public interface Insert{};
  4.     public interface Update{};
  5.     public interface Delete{};
  6. }

在xuecheng-plus-content的xuecheng-plus-content-model的dto下面的类AddCourseDto替换如下代码：

  1. @NotEmpty(message = "新增课程名称不能为空",groups={ValidationGroups.Insert.class})
  2. @NotEmpty(message = "修改课程名称不能为空",groups={ValidationGroups.Update.class})
  3. @ApiModelProperty(value = "课程名称", required = true)
  4. private String name;

 @Validated注解里面写上所分的组类：

2.27 系统参数合法性校验 P42

提问：对表单的数据是怎么校验的？

回答：JSR303校验规则。

如果javax.validation.constraints包下的校验规则满足不了需求怎么办？

1.手写校验代码

2.自定义校验规则注解

2.28 (修改课程)接口开发 P44

在xuecheng-plus-content的xuecheng-plus-content-api的api包下的CourseBaseInfoController中，写入如下代码：

  1. @ApiOperation("根据课程id查询接口")
  2. @GetMapping("/course/{courseId}")
  3. public CourseBaseInfoDto getCourseBaseById(@PathVariable Long courseId){
  4.     CourseBaseInfoDto courseBaseInfo = courseBaseInfoService.getCourseBaseInfo(courseId);
  5.     return courseBaseInfo;
  6. }

在xuecheng-plus-content的xuecheng-plus-content-service的service包下的CourseBaseInfoService中写入如下代码：

  1. //根据课程id查询课程信息
  2. public CourseBaseInfoDto getCourseBaseInfo(Long courseId);

在xuecheng-plus-content的xuecheng-plus-content-service的service/impl包下的CourseBaseInfoServiceImpl中写入如下代码：

  1. //查询课程信息
  2. public CourseBaseInfoDto getCourseBaseInfo(Long courseId){
  3.     //从课程基本信息表查询
  4.     CourseBase courseBase = courseBaseMapper.selectById(courseId);
  5.     if(courseBase==null){
  6.         return null;
  7.     }
  8.     //从课程营销表查询
  9.     CourseMarket courseMarket = courseMarketMapper.selectById(courseId);
  10.     //组装在一起
  11.     CourseBaseInfoDto courseBaseInfoDto = new CourseBaseInfoDto();
  12.     BeanUtils.copyProperties(courseBase,courseBaseInfoDto);
  13.     BeanUtils.copyProperties(courseMarket,courseBaseInfoDto);
  14.     //通过courseCategoryMapper查询分类信息，将分类名称放在courseBaseInfoDto对象
  15.     return courseBaseInfoDto;
  16. }

 在api-test的xc-content-api.http中写入如下代码：

  1. ### 课程查询
  2. GET {{content_host}}/content/course/40
  3. Content-Type: application/json

返回的结果如下：

在xuecheng-plus-content的xuecheng-plus-content-model下面的dto包下面，重新定义一个类EditCourseDto，代码如下：

因为修改比新增就多了一个id，可以继承新增。

  1. @Data
  2. @ApiModel(value="EditCourseDto",description="修改课程基本信息")
  3. public class EditCourseDto extends AddCourseDto{
  4.     @ApiModelProperty(value="课程id",required=true)
  5.     private Long Id;
  6. }

在xuecheng-plus-content的xuecheng-plus-content-api的api包下的CourseBaseInfoController中，写入如下代码：

  1. @ApiOperation("修改课程")
  2. @PutMapping("/course")
  3. public CourseBaseInfoDto modifyCourseBase(@RequestBody @Validated EditCourseDto editCourseDto){
  4.     //获取到用户所属机构的id
  5.     Long companyId = 1232141425L;
  6.     CourseBaseInfoDto courseBaseInfoDto = courseBaseInfoService.updateCourseBase(companyId, editCourseDto);
  7.     return courseBaseInfoDto;
  8. }

在xuecheng-plus-content的xuecheng-plus-content-service的service包下的CourseBaseInfoService中写入如下代码：

public CourseBaseInfoDto updateCourseBase(Long companyId,EditCourseDto editCourseDto);

在xuecheng-plus-content的xuecheng-plus-content-service的service/impl包下的CourseBaseInfoServiceImpl中写入如下代码（缺少更新营销信息）：

  1. @Override
  2. public CourseBaseInfoDto updateCourseBase(Long companyId, EditCourseDto editCourseDto) {
  3.     //拿到课程id
  4.     Long courseId = editCourseDto.getId();
  5.     //查询课程信息
  6.     CourseBase courseBase = courseBaseMapper.selectById(courseId);
  7.     if(courseBase == null){
  8.         XueChengPlusException.cast("课程不存在");
  9.     }
  10.     //数据合法性校验
  11.     //根据具体的业务逻辑去校验
  12.     //本机构只能修改本机构的课程
  13.     if(!companyId.equals(courseBase.getCompanyId())){
  14.         XueChengPlusException.cast("本机构只能膝盖本机构的课程");
  15.     }
  16.     //封装数据
  17.     BeanUtils.copyProperties(editCourseDto,courseBase);
  18.     //修改时间
  19.     courseBase.setChangeDate(LocalDateTime.now());
  20.     //更新数据库
  21.     int i = courseBaseMapper.updateById(courseBase);
  22.     if(i<=0){
  23.         XueChengPlusException.cast("修改课程失败");
  24.     }
  25.     //查询课程信息
  26.     CourseBaseInfoDto courseBaseInfo = getCourseBaseInfo(courseId);
  27.     return courseBaseInfo;
  28. }

 在api-test的xc-content-api.http中写入如下代码：

  1. ### 课程查询
  2. GET {{content_host}}/content/course/40
  3. Content-Type: application/json

2.29 (修改课程)接口测试 P45

输入下面的网址，打开前端界面：

http://localhost:8601/#/

 点击编辑按钮，尝试修改基本信息

 修改完毕之后，原先的信息会被更改。

 返回的结果如下（属于正常，跳转到另外一个还没写的界面）：

2.30 (计划查询)接口定义 P46

在xuecheng-plus-content的xuecheng-plus-content-model下面的dto包下面，定义一个新类TeachplanDto，代码如下：

  1. @Data
  2. @ToString
  3. public class TeachplanDto extends Teachplan {
  4.     //课程计划关联的媒资信息
  5.     private TeachplanMedia teachplanMedia;
  6.     //子结点
  7.     private List<TeachplanDto> teachPlanTreeNodes;
  8. }

在xuecheng-plus-content的xuecheng-plus-content-api的api包下的TeachplanController中，写入如下代码（初步）：

  1. //课程计划管理相关的接口
  2. @Api(value="课程计划编辑接口",tags="课程计划编辑接口")
  3. @RestController
  4. public class TeachplanController {
  5.     @ApiOperation("查询课程计划树形结构")
  6.     @GetMapping("/teachplan/{courseId}/tree-nodes")
  7.     public List<TeachplanDto> getTreeNodes(@PathVariable Long courseId){
  8.         return null;
  9.     }
  10. }

2.31 (计划查询)sql语句 P47

在xuecheng-plus-content的xuecheng-plus-content-service的mapper下的TeachplanMapper中写入如下代码：

  1. public interface TeachplanMapper extends BaseMapper<Teachplan> {
  2.     //课程计划查询
  3.     public List<TeachplanDto> selectTreeNodes(Long courseId);
  4. }

在xuecheng-plus-content的xuecheng-plus-content-service的mapper下的TeachplanMapper.xml中写入如下代码：

  1. <select id="selectTreeNodes" parameterType="long" resultMap="treeNodeResultMap">
  2.     select
  3.         one.id             one_id,
  4.         one.pname          one_pname,
  5.         one.parentid       one_parentid,
  6.         one.grade          one_grade,
  7.         one.media_type     one_mediaType,
  8.         one.start_time     one_stratTime,
  9.         one.end_time       one_endTime,
  10.         one.orderby        one_orderby,
  11.         one.course_id      one_courseId,
  12.         one.course_pub_id  one_coursePubId,
  13.         two.id             two_id,
  14.         two.pname          two_pname,
  15.         two.parentid       two_parentid,
  16.         two.grade          two_grade,
  17.         two.media_type     two_mediaType,
  18.         two.start_time     two_stratTime,
  19.         two.end_time       two_endTime,
  20.         two.orderby        two_orderby,
  21.         two.course_id      two_courseId,
  22.         two.course_pub_id  two_coursePubId,
  23.         m1.media_fileName mediaFilename,
  24.         m1.id teachplanMeidaId,
  25.         m1.media_id mediaId
  26.     from teachplan one
  27.              INNER JOIN teachplan two on one.id = two.parentid
  28.              LEFT JOIN teachplan_media m1 on m1.teachplan_id = two.id
  29.     where one.parentid = 0 and one.course_id=#{value}
  30.     order by one.orderby,two.orderby
  31. </select>

2.32 (计划查询)接口开发 P48

在xuecheng-plus-content的xuecheng-plus-content-service的java的mapper下的TeachplanMapper下写入如下代码：

  1. public interface TeachplanMapper extends BaseMapper<Teachplan> {
  2.     //课程计划查询
  3.     public List<TeachplanDto> selectTreeNodes(Long courseId);
  4. }

在xuecheng-plus-content的xuecheng-plus-content-service的java的mapper下的TeachplanMapper.xml下写入如下代码：

column是从数据库查到的字段，property是目标类的属性，也就是将从数据库查到的字段（column）映射到目标类的属性（property）上。

除了id字段用id标签，其它都用result标签。

  1. <resultMap id="treeNodeResultMap" type="com.xuecheng.content.model.dto.TeachplanDto">
  2.     <id column="one_id" property="id"/>
  3.     <result column="one_pname" property="pname"/>
  4.     <result column="one_pname"      property="pname" />
  5.     <result column="one_parentid"     property="parentid" />
  6.     <result column="one_grade"  property="grade" />
  7.     <result column="one_mediaType"   property="mediaType" />
  8.     <result column="one_stratTime"   property="stratTime" />
  9.     <result column="one_endTime"   property="endTime" />
  10.     <result column="one_orderby"   property="orderby" />
  11.     <result column="one_courseId"   property="courseId" />
  12.     <result column="one_coursePubId"   property="coursePubId" />
  13.     <!--映射子节点，一对多映射，ofType填的是list中对象类型-->
  14.     <collection property="teachPlanTreeNodes" ofType="com.xuecheng.content.model.dto.TeachplanDto">
  15.         <!-- 二级数据映射 -->
  16.         <id     column="two_id"        property="id" />
  17.         <result column="two_pname"      property="pname" />
  18.         <result column="two_parentid"     property="parentid" />
  19.         <result column="two_grade"  property="grade" />
  20.         <result column="two_mediaType"   property="mediaType" />
  21.         <result column="two_stratTime"   property="stratTime" />
  22.         <result column="two_endTime"   property="endTime" />
  23.         <result column="two_orderby"   property="orderby" />
  24.         <result column="two_courseId"   property="courseId" />
  25.         <result column="two_coursePubId"   property="coursePubId" />
  26.         <!--一对一映射-->
  27.         <association property="teachplanMedia" javaType="com.xuecheng.content.model.po.TeachplanMedia">
  28.             <result column="teachplanMeidaId"   property="id" />
  29.             <result column="mediaFilename"   property="mediaFilename" />
  30.             <result column="mediaId"   property="mediaId" />
  31.             <result column="two_id"   property="teachplanId" />
  32.             <result column="two_courseId"   property="courseId" />
  33.             <result column="two_coursePubId"   property="coursePubId" />
  34.         </association>
  35.     </collection>
  36. </resultMap>

在xuecheng-plus-content的xuecheng-plus-content-service的test的content下创建一个TeachplanMapperTests类，写入如下代码：

  1. @SpringBootTest
  2. public class TeachplanMapperTests {
  3.     @Autowired
  4.     TeachplanMapper teachplanMapper;
  5.     @Test
  6.     public void testSelectTreeNodes(){
  7.         List<TeachplanDto> teachplanDtos = teachplanMapper.selectTreeNodes(117L);
  8.         System.out.println(teachplanDtos);
  9.     }
  10. }

当测试数据为117L的时候，会有2个大章节。

在xuecheng-plus-content的xuecheng-plus-content-service的service包下的TeachplanService

中写入如下代码：

  1. //课程计划管理相关接口
  2. public interface TeachplanService {
  3.     //根据课程id查询课程计划
  4.     public List<TeachplanDto> findTeachplanTree(Long courseId);
  5. }

在xuecheng-plus-content的xuecheng-plus-content-service的service/impl包下的TeachplanService

中写入如下代码：

  1. @Service
  2. public class TeachplanServiceImpl implements TeachplanService {
  3.     @Autowired
  4.     TeachplanMapper teachplanMapper;
  5.     @Override
  6.     public List<TeachplanDto> findTeachplanTree(Long courseId) {
  7.         List<TeachplanDto> teachplanTree = teachplanMapper.selectTreeNodes(courseId);
  8.         return teachplanTree;
  9.     }
  10. }

在xuecheng-plus-content的xuecheng-plus-content-api的api包下的TeachplanController中，写入如下代码（完善）： 

  1. //课程计划管理相关的接口
  2. @Api(value="课程计划编辑接口",tags="课程计划编辑接口")
  3. @RestController
  4. public class TeachplanController {
  5.     @Autowired
  6.     private TeachplanService teachplanService;
  7.     @ApiOperation("查询课程计划树形结构")
  8.     @GetMapping("/teachplan/{courseId}/tree-nodes")
  9.     public List<TeachplanDto> getTreeNodes(@PathVariable Long courseId){
  10.         List<TeachplanDto> teachplanTree = teachplanService.findTeachplanTree(courseId);
  11.         return teachplanTree;
  12.     }
  13. }

 在api-test的xc-content-api.http中写入如下代码：

  1. ### 课程计划查询
  2. GET {{content_host}}/content/teachplan/117/tree-nodes

控制台输出的效果如下，测试成功（前后端联调测试没问题）： 

 

2.33 (新增修改计划)定义 P49

点击“添加章”新增第一级课程计划。

点击“添加小节”向某个第一级课程计划下添加小节。

点击“章”、“节”的名称，可以修改名称、选择是否免费。

同一个接口接收新增和修改两个业务请求，以是否传递课程计划id 来判断是新增还是修改（传递了课程计划id说明当前是要修改该课程计划，否则是新增一个课程计划）。

在xuecheng-plus-content的xuecheng-plus-content-model下的dto中新增一个类，写入如下代码：

  1. @Data
  2. @ToString
  3. public class SaveTeachplanDto {
  4.     private Long id;
  5.     private String pname;
  6.     private Long parentid;
  7.     private Integer grade;
  8.     private String mediaType;
  9.     private Long courseId;
  10.     private Long coursePubId;
  11.     private String isPreview;
  12. }

 在xuecheng-plus-conten的xuecheng-plus-content-api下的content/api下的TeachplanController中写入如下代码：

  1. @ApiOperation("课程计划创建或修改")
  2. @PostMapping("/teachplan")
  3. public void saveTeachplan(@RequestBody SaveTeachplanDto teachplan){
  4. }

2.34 (新增修改计划)开发 P50

在xuecheng-plus-content的xuecheng-plus-content-api的api的TeachplanController完善接口：

  1. @ApiOperation("课程计划创建或修改")
  2. @PostMapping("/teachplan")
  3. public void saveTeachplan(@RequestBody SaveTeachplanDto teachplan){
  4.      teachplanService.saveTeachplan(teachplan);
  5. }

在xuecheng-plus-content的xuecheng-plus-content-service的service的TeachplanService下新增接口：

  1. //新增/修改/保存课程计划
  2. public void saveTeachplan(SaveTeachplanDto saveTeachplanDto);

 在xuecheng-plus-content的xuecheng-plus-content-service的service的TeachplanServiceImpl下编写如下代码：

  1. @Override
  2. public void saveTeachplan(SaveTeachplanDto saveTeachplanDto) {
  3.     Long teachplanId = saveTeachplanDto.getId();
  4.     if(teachplanId==null){
  5.         //新增
  6.         Teachplan teachplan = new Teachplan();
  7.         BeanUtils.copyProperties(saveTeachplanDto,teachplan);
  8.         //确定排序字段，找到它的同级节点个数，排序字段就是个数+1
  9.         Long parentId = saveTeachplanDto.getParentid();
  10.         Long courseId = saveTeachplanDto.getCourseId();
  11.         teachplan.setOrderby(getTeachplanCount(courseId, parentId));
  12.         teachplanMapper.insert(teachplan);
  13.     }else{
  14.         //修改
  15.         Teachplan teachplan = teachplanMapper.selectById(teachplanId);
  16.         //将参数复制到teachplan
  17.         BeanUtils.copyProperties(saveTeachplanDto,teachplan);
  18.         teachplanMapper.updateById(teachplan);
  19.     }
  20. }

前后端联调测试没问题， 添加小节没问题：

存在一个BUG，添加章的时候不显示。

2.35 项目实战说明 P51

本节主要讲解了，如何下载gogs的windows版本，然后配置环境，方便分工协作开发接口。

删除课程计划。上移、下移排序。

师资管理，对老师表进行增删改查。

删除课程要把课程相关的基本信息、营销信息、课程计划、课程教师信息也删掉。

三、媒资管理模块

3.1 媒资管理需求分析 P52

媒资管理是媒体资源管理，媒体资源主要包括视频、文章、图片、音频等。

图片会存储到分布式文件系统中。

视频上传会通过断点续传的方式上传。

到当前已经有了3个微服务，内容管理（管理课程），系统管理（数据字典），媒资管理。

3.2 为什么用网关 P53

网关是用来路由的，转发请求；可以实现权限控制、限流等功能；避免前端直接请求微服务，编程前端请求网关，网关来请求微服务。

网关从服务注册中心来拿到微服务实例的地址。

3.3 (nacos)服务发现中心 P54

Spring Cloud是一系列微服务技术栈，是一套规范。

Spring Cloud alibaba：nacos服务注册中心、配置中心。

namespace是命名空间，用于区分环境，比如：开发环境、测试环境、生产环境。

group：用于区分项目。

下面是我登录nacos遇到的问题：

起初输入如下的命令，没能登录上nacos，显示的是拒绝访问：

http://192.168.101.65:8848/nacos/#/login

此时需要到虚拟机中，输入docker ps看看哪些服务启动了： 

一定要确保先启动mysql再启动docker：

  1. docker stop mysql
  2. docker stop nacos
  3. docker start mysql
  4. docker start nacos

 如下图能够正常访问：

 

具体配置：

1.先要在xuecheng-plus-parent中添加如下依赖：

  1. <dependency>
  2.    <groupId>com.alibaba.cloud</groupId>
  3.    <artifactId>spring-cloud-alibaba-dependencies</artifactId>
  4.    <version>${spring-cloud-alibaba.version}</version>
  5.    <type>pom</type>
  6.    <scope>import</scope>
  7. </dependency>

2.然后要在xuecheng-plus-content-api的pom.xml中写入如下代码：

  1. <dependency>
  2.     <groupId>com.alibaba.cloud</groupId>
  3.     <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
  4. </dependency>

3.在api的bootstrap.yml配置文件中写入如下代码，配置nacos的地址：

  1. spring:
  2.   application:
  3.     name: content-api #服务名
  4.   cloud:
  5.     nacos:
  6.       server-addr: 192.168.101.65:8848
  7.       discovery: #服务注册相关配置
  8.         namespace: dev #命名空间
  9.         group: xuecheng-plus-project

 记得刷新maven，然后启动contentApplication启动类，然后到nacos网页可以看到有服务成功注册入

3.4 (nacos)配置api P55

搭建Nacos配置中心，目的是通过Nacos去管理项目的所有配置。更加方便，可以不用重启就去更改配置。

nacos定位一个具体配置文件的方式是：namespace、group、dataid。

dataid由三部分组成：应用名-环境名.配置文件格式

通过spring.profiles.active来指定环境名（开发环境，测试环境，生产环境）：

配置文件的名称如下：content-api-dev.yaml

配置如下：

可以把api的配置文件中的datasource给注释掉，记得要添加config的配置，把配置文件配置上，代码如下：

  1.   cloud:
  2.     nacos:
  3.       server-addr: 192.168.101.65:8848
  4.       discovery: #服务注册相关配置
  5.         namespace: dev #命名空间
  6.         group: xuecheng-plus-project
  7.  
  8.       profiles:
  9.         active: dev #环境名
  10.  
  11.       config: #配置文件的相关信息
  12.         namespace: dev #命名空间
  13.         group: xuecheng-plus-project
  14.         file-extension: yaml
  15.         refresh-enabled: true
  16.         extension-configs:
  17.           - data-id: content-service-${spring.profiles.active}.yml
  18.             group: xuecheng-plus-project
  19.             refresh: true

记得要在api的pom.xml文件中填写如下依赖，会从nacos定时拉取配置：

  1. <dependency>
  2.     <groupId>com.alibaba.cloud</groupId>
  3.     <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  4. </dependency>

然后刷新maven，然后重启ContentApplication启动类，会出现如下场景：

然后在swagger里面进行简单测试，看数据库能否连上，选择查询的接口，输入参数然后发送请求。

3.5 (nacos)配置service P56

service的配置文件在test里面。

api原本不需要数据库配置连接，但因为api依赖了service模块，所以启动后service的代码依赖都会到api中。

所以现在的思路是：只在service中配置数据库依赖，然后api引用service的配置。

第1步：在service中进行相关配置

在service的pom.xml中加依赖，只需要加config依赖，不需要加discovery依赖：

  1. <dependency>
  2.       <groupId>com.alibaba.cloud</groupId>
  3.       <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
  4. </dependency>

在service的bootstrap.yml中修改配置文件（这里要注意2点，profiles这里不要写成profile，还有profiles是和cloud和application同级的）：

  1. #微服务配置
  2. spring:
  3.   application:
  4.     name: content-service
  5.   cloud:
  6.     nacos:
  7.       server-addr: 192.168.101.65:8848
  8.       config: #配置文件的相关信息
  9.         namespace: dev #命名空间
  10.         group: xuecheng-plus-project
  11.         file-extension: yaml
  12.         refresh-enabled: true
  13.   profiles:
  14.     active: dev

在nacos中点+号，新建service的配置，把数据库的配置粘贴上即可：

现在启动service的test下的CourseBaseMapperTests单元测试文件：

第2步：让api引用service的配置

注意这里要把api中的数据库连接屏蔽掉，只在service的nacos配置中留有数据库连接：

api的bootstrap.yml配置文件中的代码如下：

  1. #微服务配置
  2. spring:
  3.   application:
  4.     name: content-api #服务名
  5.   cloud:
  6.     nacos:
  7.       server-addr: 192.168.101.65:8848
  8.       discovery: #服务注册相关配置
  9.         namespace: dev #命名空间
  10.         group: xuecheng-plus-project
  11.       config: #配置文件的相关信息
  12.         namespace: dev #命名空间
  13.         group: xuecheng-plus-project
  14.         file-extension: yaml
  15.         refresh-enabled: true
  16.         extension-configs:
  17.           - data-id: content-service-${spring.profiles.active}.yaml
  18.             group: xuecheng-plus-project
  19.             refresh: true
  20.   profiles:
  21.     active: dev #环境名

这里有几点易错的点：1.冒号后面都要空1格。2.config是在nacos的下一级，与server-addr和 discovery同级。3.profiles是在spring的下一级，与application和cloud同级。4.文件的后缀是yaml。5.${spring.profiles.active}注意这个花括号里都是点号分隔

能出数据就没啥问题：

因为swagger在所有的模块中都需要配置，所以我们想如何在nacos中配置项目的公用配置。

配置内容填写如下内容：

  1. swagger:
  2.   title: "学成在线项目接口文档"
  3.   description: "学成在线项目接口文档"
  4.   base-package: com.xuecheng
  5.   enabled: true
  6.   version: 1.0.0

微服务的完整配置如下，shared-configs必须要在extension-configs的平级位置，在config的次一级位置。

  1. #微服务配置
  2. spring:
  3.   application:
  4.     name: content-api#服务名
  5.   cloud:
  6.     nacos:
  7.       server-addr: 192.168.101.65:8848
  8.       discovery: #服务注册相关配置
  9.         namespace: dev #命名空间
  10.         group: xuecheng-plus-project
  11.       config: #配置文件的相关信息
  12.         namespace: dev #命名空间
  13.         group: xuecheng-plus-project
  14.         file-extension: yaml
  15.         refresh-enabled: true
  16.         extension-configs:
  17.           - data-id: content-service-${spring.profiles.active}.yml
  18.             group: xuecheng-plus-project
  19.             refresh: true
  20.         shared-configs:
  21.           - data-id: swagger-${spring-profiles.active}.yaml
  22.             group: xuecheng-plus-common
  23.             refresh: true
  24.           - data-id: logging-${spring-profiles.active}.yaml
  25.             group: xuecheng-plus-common
  26.             refresh: true
  27.  
  28.   profiles:
  29.     active: dev #环境名

这里有几点易错的点：1.冒号后面都要空1格。2.config是在nacos的下一级，与server-addr和 discovery同级。3.profiles是在spring的下一级，与application和cloud同级。4.文件的后缀是yaml。5.${spring.profiles.active}注意这个花括号里都是点号分隔 

测试：如果名称改变，控制台有DEBUG语句输出就没问题！

3.6 (nacos)配置优先级 P57

引入配置文件的形式有：

1、以项目应用名方式引入

2、以扩展配置文件方式引入

3、以共享配置文件 方式引入

4、本地配置文件

各配置文件 的优先级：项目应用名配置文件 > 扩展配置文件  > 共享配置文件 > 本地配置文件。

然后我们还要在nacos中加上本地优先。

现在启动contentApplication就没啥问题了。

3.7 (nacos)配置代码导入 P58

把下面的文件解压。

然后点击上传文件把这些配置都上传上来。

3.8 搭建网关 P59

按照如下的方式创建一个网关模块：

先把依赖全部先导入到pom.xml文件中：

把xuecheng-plus-system的配置文件全部拷贝到xuecheng-plus-gateway中：

启动类修改如下：

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

现在启动启动类，可以看到gateway网关已经申报到nacos：

测试的方法是把content_host改为gateway_host，然后发送请求，看看是否正常返回结果。

3.9 搭建媒资服务工程 P60

媒资服务工程的文件在day05的资料中，将xuecheng-plus-media.zip文件解压到当前文件夹，

把模块直接导入xuecheng-plus-project下面

启动完xuecheng-plus-media的xuecheng-plus-media-api下的启动类MediaApplication之后，然后可以访问下面的地址看看能不能访问接口文档：

http://localhost:63050/media/swagger-ui.html

3.10 分布式文件系统 P61

文件系统：方便对磁盘上的文件进行管理的软件系统。

因为一台计算机无法存储海量的文件，所以通过网络将若干计算机组织起来共同存储海量文件。

3.11 MinIO文件系统 P62

MinIO是一个轻量级的开源文件系统，可以存储大量的非结构化数据。去中心化的共享架构。

采用冗余存储，一个节点2块磁盘，8块磁盘组成一个集合。使用纠删码技术来保护数据，可以恢复丢失和损坏的数据。当上传一个文件会通过纠删码算法计算对文件进行分块存储，分成4个数据块，4个校验块，数据块和校验块会分散的存储在这8块硬盘上。

只要挂掉的节点不超过一半，就可以继续使用。

访问下面的地址：

192.168.101.65:9001/login

 

在xuecheng-plus-media的xuecheng-plus-media-service下的pom.xml中写入如下代码：

  1. <dependency>
  2.     <groupId>io.minio</groupId>
  3.     <artifactId>minio</artifactId>
  4.     <version>8.4.3</version>
  5. </dependency>
  6. <dependency>
  7.     <groupId>com.squareup.okhttp3</groupId>
  8.     <artifactId>okhttp</artifactId>
  9.     <version>4.8.1</version>
  10. </dependency>

创建一个testbucket，记得把访问方式改为公有

在xuecheng-plus-media的xuecheng-plus-media-servicesrc下创建test包，然后在test下创建com.xuecheng.media包，然后在media包下面创建MinioTest类，然后写入如下的代码：

  1. //测试minio的sdk
  2. public class MinioTest {
  3.     MinioClient minioClient =
  4.             MinioClient.builder()
  5.                     .endpoint("http://192.168.101.65:9000")
  6.                     .credentials("minioadmin","minioadmin")
  7.                     .build();
  8.     @Test
  9.     public void test_upload() throws Exception{
  10.         //上传文件的参数信息
  11.         UploadObjectArgs uploadObjectArgs = UploadObjectArgs.builder()
  12.                 .bucket("testbucket") //桶
  13.                 .filename("C:\\xuechengzaixian\\1.mp4")//指定本地文件路径
  14.                 .object("1.mp4")
  15.                 .build();//对象名
  16.         //上传文件
  17.         minioClient.uploadObject(uploadObjectArgs);
  18.     }
  19. }

点击运行之后，可以看到1.mp4文件已经成功上传。

可以通过设置多层目录，来把文件存放在目录中。 

.object("test/01/1.mp4")

删除文件的代码如下：

  1. @Test
  2. public void test_delete() throws Exception{
  3.  
  4.     RemoveObjectArgs removeObjectArgs = RemoveObjectArgs.builder()
  5.             .bucket("testbucket")
  6.             .object("1.mp4")
  7.             .build();
  8.  
  9.     //上传文件
  10.     minioClient.removeObject(removeObjectArgs);
  11. }

下载文件，从minio中下载文件到本地的某一目录：

  1. //查询文件，从minio中下载
  2.     @Test
  3.     public void test_getFile() throws ServerException, InsufficientDataException, ErrorResponseException, IOException, NoSuchAlgorithmException, InvalidKeyException, InvalidResponseException, XmlParserException, InternalException {
  4.         GetObjectArgs getObjectArgs = GetObjectArgs.builder().bucket("testbucket").object("test/01/1.mp4").build();
  5.         FilterInputStream inputStream = minioClient.getObject(getObjectArgs);
  6.         //指定输出流
  7.         FileOutputStream outputStream = new FileOutputStream(new File("C:\\xuechengzaixian\\1.mp4"));
  8.         IOUtils.copy(inputStream,outputStream);
  9.         //校验文件的完整性对文件内容进行md5
  10.         String source_md5 = DigestUtils.md5Hex(inputStream); //minio中文件的md5
  11.         String local_md5 = DigestUtils.md5Hex(new FileInputStream(new File("C:\\code\\result.mp4")));
  12.         if(source_md5.equals(local_md5)){
  13.             System.out.println("下载成功");
  14.         }
  15.     }

可以用md5来校验文件下载是否完整，有无缺损或者被破坏。

现在需要比较的是本地流和输出流文件的区别。 

 3.12 (上传图片)需求分析 P63

流程图如下：

如何判断文件已经上传，是通过md5值比较，文件上传的主体是机构，

3.13 (上传图片)接口定义 P64

首先要把mediafiles和video的状态设置为公开。

然后要在media-service-dev.yaml中把配置的信息填上去。

  1. minio:
  2.   endpoint: http://192.168.101.65:9000
  3.   accessKey: minioadmin
  4.   secretKey: minioadmin
  5.   bucket:
  6.     files: mediafiles
  7.     videofiles: video

在xuecheng-plus-media的xuecheng-plus-media-service的config包下新建一个叫MinioConfig的类

  1. import io.minio.MinioClient;
  2. import org.springframework.beans.factory.annotation.Value;
  3. import org.springframework.context.annotation.Bean;
  4. import org.springframework.context.annotation.Configuration;
  5. @Configuration
  6. public class MinioConfig {
  7.     @Value("${minio.endpoint}")
  8.     private String endpoint;
  9.     @Value("${minio.accessKey}")
  10.     private String accessKey;
  11.     @Value("${minio.secretKey}")
  12.     private String secretKey;
  13.     @Bean
  14.     public MinioClient minioClient(){
  15.         MinioClient build = MinioClient.builder()
  16.                 .endpoint(endpoint)
  17.                 .credentials(accessKey, secretKey)
  18.                 .build();
  19.         return build;
  20.     }
  21. }

在xuecheng-plus-media-model下的dto的UploadFileResultDto中写入如下代码：

  1. @Data
  2. @ToString
  3. public class UploadFileResultDto extends MediaFiles{
  4. }

 定义接口在xuecheng-plus-media-api下的api的MediaFilesController中写入如下的代码：

  1. @ApiOperation("上传图片")
  2. @RequestMapping(value = "/upload/coursefile",consumes= MediaType.MULTIPART_FORM_DATA_VALUE)
  3. public UploadFileResultDto upload(@RequestPart("filedata")MultipartFile filedata){
  4.  //调用service上传图片
  5.  return null;
  6. }

3.14 (上传图片)上传文件 P65

在xuecheng-plus-media-model的dto下面创建UploadFileParamsDto，写入如下代码：

在xuecheng-plus-media-service的service的MediaFileService类中，写入如下代码：

  1. //本地文件的路径
  2. public UploadFileResultDto uploadFile(Long companyId, UploadFileParamsDto uploadFileParamsDto, String localFilePath) throws Exception;

 在xuecheng-plus-media-service的service/impl的MediaFileServiceImpl类中，写入的完整代码见下一节：

3.15 (上传图片)信息入库 P66

xuecheng-plus-media的xuecheng-plus-media-api的MediaFilesController的上传图片功能的完整代码：

  1. @ApiOperation("上传图片")
  2.      @RequestMapping(value = "/upload/coursefile",consumes= MediaType.MULTIPART_FORM_DATA_VALUE)
  3.      public UploadFileResultDto upload(@RequestPart("filedata")MultipartFile filedata) throws Exception {
  4.          //准备上传文件的信息
  5.          UploadFileParamsDto uploadFileParamsDto = new UploadFileParamsDto();
  6.          //原始文件名称
  7.          uploadFileParamsDto.setFilename(filedata.getOriginalFilename());//原始文件名称
  8.          //文件大小
  9.          uploadFileParamsDto.setFileSize(filedata.getSize());
  10.          //文件类型
  11.          uploadFileParamsDto.setFileType("001001");
  12.          //接收到文件
  13.          //创建一个临时文件
  14.          File tempFile = File.createTempFile("minio", ".temp");
  15.          filedata.transferTo(tempFile);
  16.          Long companyId=1232141425L;
  17.          //文件路径
  18.          String localFilePath = tempFile.getAbsolutePath();
  19.          //调用service上传图片
  20.          UploadFileResultDto uploadFileResultDto = mediaFileService.uploadFile(companyId, uploadFileParamsDto, localFilePath);
  21.          return uploadFileResultDto;
  22.      }

xuecheng-plus-media的xuecheng-plus-media-service的service下的MediaFileService的上传图片功能的完整代码：

  1. //本地文件的路径
  2. public UploadFileResultDto uploadFile(Long companyId, UploadFileParamsDto uploadFileParamsDto, String localFilePath) throws Exception;
  3.  
  4. public MediaFiles addMediaFilesToDb(Long companyId,String fileMd5,UploadFileParamsDto uploadFileParamsDto,String bucket,String objectName);

xuecheng-plus-media的xuecheng-plus-media-service的service的impl下的MediaFileServiceImpl的上传图片功能的完整代码： 

  1. //根据扩展名来获取mimeType
  2. private String getMimeType(String extension){
  3. if(extension==null){
  4.    extension="";
  5. }
  6. //根据扩展名取出mimeType
  7. ContentInfo extensionMatch = ContentInfoUtil.findExtensionMatch(extension);
  8. String mimeType = MediaType.APPLICATION_OCTET_STREAM_VALUE;//通用mimeType,字节流
  9. if(extensionMatch != null){
  10.  mimeType = extensionMatch.getMimeType();
  11. }
  12. return mimeType;
  13. }
  14.  
  15. @Autowired
  16. MinioClient minioClient;
  17.  
  18. //存储普通文件
  19. @Value("${minio.bucket.files}")
  20. private String bucket_mediafiles;
  21.  
  22. //存储视频
  23. @Value("${minio.bucket.videofiles}")
  24. private String bucket_video;
  25.  
  26. /** 将文件上传到minio
  27.  * @param localFilePath 文件本地路径
  28.  * @param mimeType 媒体类型
  29.  * @param bucket 桶
  30.  * @param objectName 对象名
  31.  * @return
  32.  */
  33. public boolean addMediaFilesToMinIO(String localFilePath,String mimeType,String bucket,String objectName) {
  34.  try {
  35.      UploadObjectArgs uploadObjectArgs = UploadObjectArgs.builder()
  36.          .bucket(bucket) //桶
  37.          .filename(localFilePath) //指定本地文件路径
  38.          .object(objectName) //对象名 放在子目录下
  39.          .contentType(mimeType) //设置媒体文件类型
  40.          .build();//对象名
  41.      //上传文件
  42.      minioClient.uploadObject(uploadObjectArgs);
  43.      log.debug("上传文件到minio成功,bucket:{},objectName;{},错误信息:{}",bucket,objectName);
  44.      return true;
  45.  } catch (Exception e) {
  46.      e.printStackTrace();
  47.      log.error("上传文件出错,bucket:{},objectName:{},错误信息:{}",bucket,objectName,e.getMessage());
  48.      return false;
  49.  }
  50. }
  51.  
  52. //获取文件默认存储目录路径 年/月/日
  53. private String getDefaultFolderPath(){
  54. SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd");
  55. String folder = sdf.format(new Date()).replace("-","/")+"/";
  56. return folder;
  57. }
  58.  
  59. private String getFileMd5(File file) throws Exception {
  60.  try(FileInputStream fileInputStream = new FileInputStream(file)){
  61.      String fileMd5 = DigestUtils.md5Hex(fileInputStream);
  62.      return fileMd5;
  63.  }catch (Exception e){
  64.      e.printStackTrace();
  65.      return null;
  66.  }
  67. }
  68. @Transactional
  69. @Override
  70. public UploadFileResultDto uploadFile(Long companyId, UploadFileParamsDto uploadFileParamsDto, String localFilePath) throws Exception {
  71.  //文件名
  72.  String filename = uploadFileParamsDto.getFilename();
  73.  //先得到扩展名
  74.  String extension = filename.substring(filename.lastIndexOf("."));
  75.  //将文件上传到minio
  76.  String mimeType = getMimeType(extension);
  77.  //子目录
  78.  String defaultFolderPath = getDefaultFolderPath();
  79.  //文件的md5值
  80.  String fileMd5 = getFileMd5(new File(localFilePath));
  81.  String objectName = defaultFolderPath+fileMd5+extension;
  82.  //上传文件到minio
  83.  boolean result = addMediaFilesToMinIO(localFilePath,mimeType,bucket_mediafiles,objectName);
  84.  if(!result){
  85.      XueChengPlusException.cast("上传文件失败");
  86.  }
  87.  //上传文件信息
  88.  MediaFiles mediaFiles = currentProxy.addMediaFilesToDb(companyId, fileMd5, uploadFileParamsDto, bucket_mediafiles, objectName);
  89.  if(mediaFiles==null){
  90.     XueChengPlusException.cast("文件上传后保存信息失败");
  91.  }
  92.  //准备返回的对象
  93. UploadFileResultDto uploadFileResultDto = new UploadFileResultDto();
  94. BeanUtils.copyProperties(mediaFiles,uploadFileResultDto);
  95. return uploadFileResultDto;
  96. }
  97.  
  98. @Autowired
  99. MediaFileService currentProxy;
  100.  
  101. @Transactional
  102. public MediaFiles addMediaFilesToDb(Long companyId,String fileMd5,UploadFileParamsDto uploadFileParamsDto,String bucket,String objectName){
  103. MediaFiles mediaFiles = mediaFilesMapper.selectById(fileMd5);
  104. if(mediaFiles == null){
  105.     mediaFiles = new MediaFiles();
  106.     BeanUtils.copyProperties(uploadFileParamsDto,mediaFiles);
  107.     //文件id
  108.     mediaFiles.setId(fileMd5);
  109.     //机构id
  110.     mediaFiles.setCompanyId(companyId);
  111.     //桶
  112.     mediaFiles.setBucket(bucket);
  113.     //file_path
  114.     mediaFiles.setFilePath(objectName);
  115.     //file_id
  116.     mediaFiles.setFileId(fileMd5);
  117.     //url
  118.     mediaFiles.setUrl("/"+bucket+"/"+objectName);
  119.     //上传时间
  120.     mediaFiles.setCreateDate(LocalDateTime.now());
  121.     //状态
  122.     mediaFiles.setStatus("1");
  123.     //审核状态
  124.     mediaFiles.setAuditStatus("002003");
  125.     //插入数据库
  126.     int insert = mediaFilesMapper.insert(mediaFiles);
  127.     if(insert<=0){
  128.         log.debug("向数据库保存文件失败，bucket:{},objectName",bucket,objectName);
  129.         return null;
  130.     }
  131.     return mediaFiles;
  132. }
  133. return mediaFiles;
  134. }

3.16 (上传图片)测试 P67

我在本地路径上保存了一张图片。

在api-test包的xc-media-api.http下，写入如下代码：

  1. ### 上传文件
  2. POST {{media_host}}/media/upload/coursefile
  3. Content-Type: multipart/form-data; boundary=WebAppBoundary
  4.  
  5. --WebAppBoundary
  6. Content-Disposition: form-data; name="filedata"; filename="2.jpg"
  7. Content-Type: application/octet-stream
  8.  
  9. < c:/xuechengzaixian/2.jpg

 然后断点跟踪，在controller的第1行打上一个断点，在uploadFile上打上一个断点，一步步看是否传入的参数符合预期。

最后可以看到文件成功上传，点击预览可以看到文件是否正确。

首先在前端文件中把网关放开。然后在IDEA中把网关模块启动，内容管理和系统管理服务也要启动。然后上网找了一张新的图片。

尝试上传，在数据库中可以查找到该条记录：

3.17 (上传图片)事务优化 P68

如果一个方法中存在网络请求这种，时间不固定的代码，如果只在方法上面加事务注解，可能导致对数据库的占用时间比较长的问题。

事务的原理是在执行方法前开启事务，才执行方法后提交事务。但有一个前提，必须是在代理对象中执行。

如果是一个代理对象且加了注解，一定可以被代理控制。只要有一个条件不满足就不能被控制。

现在的问题是：一个非事务方法调用同类一个事务方法，事务无法控制。

注入的是代理对象，代理对象是在原始对象上包了一层代理对象。

解决思路：在MediaFileServiceImpl中把MediaFileService注入进来，在MediaFileService中加入addMediaFilesToDb方法，然后在addMediaFilesToDb的方法上加上@Transactional注解。

完整的代码见上节。

3.18 (上传视频)断点续传 P69

上传界面如下：

断点续传实现原理：1.前端上传前先把文件分成若干块。2.一块一块的上传，上传中断后重新上传，已上传的分块则不用再上传。3.各分块上传完成最后在服务端合并文件。

3.19 (上传视频)分块合并 P70

在xuecheng-plus-media的xuecheng-plus-media-service下的test下创建BigFileTest，然后写入如下代码：

  1. public class BigFileTest {
  2.     //分块测试
  3.     @Test
  4.     public void testChunk() throws IOException {
  5.         //源文件
  6.         File sourceFile = new File("C:\\xuechengzaixian\\1.mp4");
  7.         //分块文件存储路径
  8.         String chunkFilePath="C:\\code\\result\\"; 
  9.         //分块文件大小
  10.         int chunkSize = 1024 * 1024 * 1;
  11.         //分块文件的个数
  12.         int chunkNum = (int)Math.ceil(sourceFile.length()*1.0 / chunkSize);
  13.         //使用流从源文件读数据，向分块文件中写数据
  14.         RandomAccessFile raf_r = new RandomAccessFile(sourceFile, "r");
  15.         //缓存区
  16.         byte[] bytes = new byte[1024];
  17.         for(int i=0;i<chunkNum;i++){
  18.             File chunkFile = new File(chunkFilePath + i);
  19.             //分块文件写入流
  20.             RandomAccessFile raf_rw = new RandomAccessFile(chunkFile, "rw");
  21.             int len = -1;
  22.             while((len=raf_r.read(bytes))!=-1){
  23.                 raf_rw.write(bytes,0,len);
  24.                 if(chunkFile.length()>=chunkSize){
  25.                     break;
  26.                 }
  27.             }
  28.             raf_rw.close();
  29.         }
  30.         raf_r.close();
  31.     }
  32.     //合并测试
  33.     @Test
  34.     public void testMerge(){
  35.  
  36.     }
  37. }

效果是： 把位于c:/xuechengzaixian/1.mp4的视频文件进行分片，然后存储到c:/code/result下（这里要注意下面这段代码String chunkFilePath="C:\\code\\result\\";其中result代表文件夹后面两个\\代表文件名为空，会自动用0.1.2.3...命名）

合并的代码如下：

  1. //合并测试
  2. @Test
  3. public void testMerge() throws IOException {
  4.     //块文件目录
  5.     File chunkFolder = new File("C:\\code\\result");
  6.     //源文件
  7.     File sourceFile = new File("C:\\xuechengzaixian\\1.mp4");
  8.     //合并后的文件
  9.     File mergeFile = new File("C:\\code\\res.mp4");
  10.     //取出所有的分块文件
  11.     File[] files = chunkFolder.listFiles();
  12.     //将数组转成list
  13.     List<File> filesList = Arrays.asList(files);
  14.  
  15.     //对分块文件排序
  16.     Collections.sort(filesList, new Comparator<File>() {
  17.         @Override
  18.         public int compare(File o1, File o2) {
  19.             return Integer.parseInt(o1.getName())-Integer.parseInt(o2.getName());
  20.         }
  21.     });
  22.     //向合并文件写的流
  23.     RandomAccessFile raf_rw = new RandomAccessFile(mergeFile, "rw");
  24.     //缓存区
  25.     byte[] bytes = new byte[1024];
  26.     //遍历分块文件，向合并的文件写
  27.     for(File file: filesList){
  28.         //读分块的流
  29.         RandomAccessFile raf_r = new RandomAccessFile(file, "r");
  30.         int len = -1;
  31.         while((len=raf_r.read(bytes))!=-1){
  32.             raf_rw.write(bytes,0,len);
  33.         }
  34.         raf_r.close();
  35.     }
  36.     raf_rw.close();
  37.     //合并文件完成后对合并的文件md5值校验
  38.     FileInputStream fileInputStream_merge = new FileInputStream(mergeFile);
  39.     FileInputStream fileInputStream_source = new FileInputStream(sourceFile);
  40.     String md5_merge = DigestUtils.md5Hex(fileInputStream_merge);
  41.     String md5_source = DigestUtils.md5Hex(fileInputStream_source);
  42.     if(md5_merge.equals(md5_source)){
  43.         System.out.println("文件合并成功");
  44.     }
  45. }

3.20 (上传视频)minio合并 P71

测试的逻辑是：testChunk() -> uploadChunk() -> testMerge()

1.首先将本地的视频分块。因为minio中要求视频的每个分块要大于5MB，所以大小设定如下：chunkSize = 1024 * 1024 * 5，分块的代码写在xuecheng-plus-media-service的test的BigFileTest代码如下：

  1. //分块测试
  2. @Test
  3. public void testChunk() throws IOException {
  4.     //源文件
  5.     File sourceFile = new File("C:\\xuechengzaixian\\1.mp4");
  6.     //分块文件存储路径
  7.     String chunkFilePath="C:\\code\\result\\";
  8.     //分块文件大小
  9.     int chunkSize = 1024 * 1024 * 5;
  10.     //分块文件的个数
  11.     int chunkNum = (int)Math.ceil(sourceFile.length()*1.0 / chunkSize);
  12.     //使用流从源文件读数据，向分块文件中写数据
  13.     RandomAccessFile raf_r = new RandomAccessFile(sourceFile, "r");
  14.     //缓存区
  15.     byte[] bytes = new byte[1024];
  16.     for(int i=0;i<chunkNum;i++){
  17.         File chunkFile = new File(chunkFilePath + i);
  18.         //分块文件写入流
  19.         RandomAccessFile raf_rw = new RandomAccessFile(chunkFile, "rw");
  20.         int len = -1;
  21.         while((len=raf_r.read(bytes))!=-1){
  22.             raf_rw.write(bytes,0,len);
  23.             if(chunkFile.length()>=chunkSize){
  24.                 break;
  25.             }
  26.         }
  27.         raf_rw.close();
  28.     }
  29.     raf_r.close();
  30. }

2.然后将分块文件上传到minio，模拟的是“上传”。上传minio的代码写在xuecheng-plus-media-service的test的MinioTest中代码如下：

  1. //将分块文件上传到minio
  2. @Test
  3. public void uploadChunk() throws Exception {
  4.     for (int i = 0; i < 13; i++) {
  5.         //上传文件的参数信息
  6.         UploadObjectArgs uploadObjectArgs = UploadObjectArgs.builder()
  7.                 .bucket("testbucket") //桶
  8.                 .filename("C:\\code\\result\\"+i)//指定本地文件路径
  9.                 .object("chunk/" + i)
  10.                 .build();//对象名
  11.         //上传文件
  12.         minioClient.uploadObject(uploadObjectArgs);
  13.         System.out.println("上传分块"+i+"成功");
  14.     }
  15. }

3.然后将minIo中分块的文件合并到minio。代码写在xuecheng-plus-media-service的test的MinioTest中如下：

  1. //调用minio接口合并分块
  2. @Test
  3. public void testMerge() throws Exception{
  4.     /*List<ComposeSource> sources = null;
  5.     for(int i=0;i<30;i++) {
  6.         //指定分块文件的信息
  7.         ComposeSource composeSource = ComposeSource.builder().bucket("testbucket").object("chunk/" + i).build();
  8.         sources.add(composeSource);
  9.     }*/
  10.     List<ComposeSource> sources = Stream.iterate(0,i->++i).limit(13).map(i->ComposeSource.builder().bucket("testbucket").object("chunk/"+i).build()).collect(Collectors.toList());
  11.     //指定合并后的objectName等信息
  12.     ComposeObjectArgs composeObjectArgs = ComposeObjectArgs.builder()
  13.             .bucket("testbucket")
  14.             .object("merge01.mp4")
  15.             .sources(sources)//指定源文件
  16.             .build();
  17.     //合并文件
  18.     //报错size 1048576 must be greater than 5242880 minio 默认的分块文件大小为5M
  19.     minioClient.composeObject(composeObjectArgs);
  20. }

3.21 (上传视频)上传分块 P72

md5值的前2位作为文件目录。

在xuecheng-plus-media的xuecheng-plus-media-api下的BigFilesController中完善如下的代码：

  1. @ApiOperation(value = "合并文件")
  2. @PostMapping("/upload/mergechunks")
  3. public RestResponse mergechunks(@RequestParam("fileMd5") String fileMd5,
  4.                                 @RequestParam("fileName") String fileName,
  5.                                 @RequestParam("chunkTotal") int chunkTotal) throws Exception {
  6.     Long companyId = 1232141425L;
  7.     //文件信息对象
  8.     UploadFileParamsDto uploadFileParamsDto = new UploadFileParamsDto();
  9.     uploadFileParamsDto.setFilename(fileName);
  10.     uploadFileParamsDto.setTags("视频文件");
  11.     uploadFileParamsDto.setFileType("001002");
  12.     RestResponse restResponse = mediaFileService.mergechunks(1232141425L, fileMd5, chunkTotal, uploadFileParamsDto);
  13.     return restResponse;
  14. }

在xuecheng-plus-media的xuecheng-plus-media-service下的MediaFileService中写入如下1个接口：

public RestResponse mergechunks(Long companyId,String fileMd5,int chunkTotal,UploadFileParamsDto uploadFileParamsDto);

在xuecheng-plus-media的xuecheng-plus-media-service下的MediaFileService中写入如下1个接口的具体实现：

  1. @Override
  2. public RestResponse mergechunks(Long companyId, String fileMd5, int chunkTotal, UploadFileParamsDto uploadFileParamsDto) {
  3.     //找到分块文件调用minio的sdk进行文件合并
  4.     //分块文件所在目录
  5.     String chunkFileFolderPath = getChunkFileFolderPath(fileMd5);
  6.     //找到所有的分块文件调用minio的sdk进行文件合并
  7.     List<ComposeSource> sources = Stream.iterate(0, i->++i)
  8.             .limit(chunkTotal)
  9.             .map(i->ComposeSource.builder()
  10.                     .bucket(bucket_video)
  11.                     .object(chunkFileFolderPath+i)
  12.                     .build())
  13.             .collect(Collectors.toList());
  14.     //源文件名称
  15.     String filename = uploadFileParamsDto.getFilename();
  16.     //扩展名
  17.     String extension = filename.substring(filename.lastIndexOf("."));
  18.     //合并后文件的objectName
  19.     String objectName = getFilePathByMd5(fileMd5, extension);
  20.     //指定合并后的objectName等信息
  21.     ComposeObjectArgs composeObjectArgs = ComposeObjectArgs.builder()
  22.             .bucket(bucket_video)
  23.             .object(objectName) //最终合并后的文件的objectName
  24.             .sources(sources)//指定源文件
  25.             .build();
  26.     //==============合并文件==================
  27.     //报错size 1048576 must be greater than 5242880 minio 默认的分块文件大小为5M
  28.     try {
  29.         minioClient.composeObject(composeObjectArgs);
  30.     } catch (Exception e) {
  31.         e.printStackTrace();
  32.         log.error("合并文件出错,bucket:{},objectName:{},错误信息:{}",bucket_video,objectName,e.getMessage());
  33.         return RestResponse.validfail(false,"合并文件异常");
  34.     }
  35.     //===========校验合并后的和源文件是否一致，视频上传才成功============
  36.     File file = downloadFileFromMinIO(bucket_video, objectName);
  37.  
  38.     try(FileInputStream fileInputStream = new FileInputStream(file)){
  39.         //计算合并后文件的md5
  40.         String mergeFile_md5 = DigestUtils.md5Hex(fileInputStream);
  41.         //比较原始的md5和合并后的md5
  42.         if(!fileMd5.equals(mergeFile_md5)){
  43.             log.error("校验合并文件md5值不一致,原始文件:{},合并文件:{}",fileMd5,mergeFile_md5);
  44.             return RestResponse.validfail(false,"文件校验失败");
  45.         }
  46.         //文件大小
  47.         uploadFileParamsDto.setFileSize(file.length());
  48.     } catch (Exception e) {
  49.         return RestResponse.validfail(false,"文件校验失败");
  50.     }
  51.     //============将文件信息入库============
  52.     MediaFiles mediaFiles = currentProxy.addMediaFilesToDb(companyId, fileMd5, uploadFileParamsDto, bucket_video, objectName);
  53.     if(mediaFiles == null){
  54.         return RestResponse.validfail(false,"文件入库失败");
  55.     }
  56.     //=============清理分块文件============
  57.     clearChunkFiles(chunkFileFolderPath,chunkTotal);
  58.     return RestResponse.success(true);
  59. }

下面是上面接口实现方法中用到的支持方法：

  1. //得到分块文件的目录
  2. private String getChunkFileFolderPath(String fileMd5) {
  3.     return fileMd5.substring(0, 1) + "/" + fileMd5.substring(1, 2) + "/" + fileMd5 + "/" + "chunk" + "/";
  4. }
  5. //从minio下载文件
  6. public File downloadFileFromMinIO(String bucket,String objectName){
  7.     //临时文件
  8.     File minioFile = null;
  9.     FileOutputStream outputStream = null;
  10.     try{
  11.         InputStream stream = minioClient.getObject(GetObjectArgs.builder()
  12.                 .bucket(bucket)
  13.                 .object(objectName)
  14.                 .build());
  15.         //创建临时文件
  16.         minioFile=File.createTempFile("minio", ".merge");
  17.         outputStream = new FileOutputStream(minioFile);
  18.         IOUtils.copy(stream,outputStream);
  19.         return minioFile;
  20.     } catch (Exception e) {
  21.         e.printStackTrace();
  22.     }finally {
  23.         if(outputStream!=null){
  24.             try {
  25.                 outputStream.close();
  26.             } catch (IOException e) {
  27.                 e.printStackTrace();
  28.             }
  29.         }
  30.     }
  31.     return null;
  32. }
  33. @Transactional
  34. public MediaFiles addMediaFilesToDb(Long companyId,String fileMd5,UploadFileParamsDto uploadFileParamsDto,String bucket,String objectName){
  35. MediaFiles mediaFiles = mediaFilesMapper.selectById(fileMd5);
  36. if(mediaFiles == null){
  37.     mediaFiles = new MediaFiles();
  38.     BeanUtils.copyProperties(uploadFileParamsDto,mediaFiles);
  39.     //文件id
  40.     mediaFiles.setId(fileMd5);
  41.     //机构id
  42.     mediaFiles.setCompanyId(companyId);
  43.     //桶
  44.     mediaFiles.setBucket(bucket);
  45.     //file_path
  46.     mediaFiles.setFilePath(objectName);
  47.     //file_id
  48.     mediaFiles.setFileId(fileMd5);
  49.     //url
  50.     mediaFiles.setUrl("/"+bucket+"/"+objectName);
  51.     //上传时间
  52.     mediaFiles.setCreateDate(LocalDateTime.now());
  53.     //状态
  54.     mediaFiles.setStatus("1");
  55.     //审核状态
  56.     mediaFiles.setAuditStatus("002003");
  57.     //插入数据库
  58.     int insert = mediaFilesMapper.insert(mediaFiles);
  59.     if(insert<=0){
  60.         log.debug("向数据库保存文件失败，bucket:{},objectName",bucket,objectName);
  61.         return null;
  62.     }
  63.     return mediaFiles;
  64. }
  65. return mediaFiles;
  66. }
  67. //清除分块文件
  68. private void clearChunkFiles(String chunkFileFolderPath,int chunkTotal){
  69.     Iterable<DeleteObject> objects= Stream.iterate(0,i->++i).limit(chunkTotal).map(i->new DeleteObject(chunkFileFolderPath.concat(Integer.toString(i)))).collect(Collectors.toList());
  70.     RemoveObjectsArgs removeObjectArgs = RemoveObjectsArgs.builder().bucket(bucket_video).objects(objects).build();
  71.     Iterable<Result<DeleteError>> results = minioClient.removeObjects(removeObjectArgs);
  72.     //真正删除加下列语句
  73.     results.forEach(f->{
  74.         try{
  75.             DeleteError deleteError = f.get();
  76.         }catch (Exception e){
  77.             e.printStackTrace();
  78.         }
  79.     });
  80. }

完整代码可以在gitee上下载，连接如下：学成在线项目代码（CSDN吾浴西风）

3.22 (上传视频)合并分块 P73

此节视频的代码是在上节代码的基础上进一步完善！

启动下面4个项目：

 在xuecheng-plus-media的xuecheng-plus-media-api下的BigFilesController中写入如下的代码：

  1. @Api(value="大文件上传接口",tags="大文件上传接口")
  2. @RestController
  3. public class BigFilesController {
  4.     @Autowired
  5.     private MediaFileService mediaFileService;
  6.     @ApiOperation(value = "文件上传前检查文件")
  7.     @PostMapping("/upload/checkfile")
  8.     public RestResponse<Boolean> checkfile(
  9.             @RequestParam("fileMd5") String fileMd5
  10.     ) throws Exception {
  11.         RestResponse<Boolean> booleanRestResponse = mediaFileService.checkFile(fileMd5);
  12.         return booleanRestResponse;
  13.     }
  14.  
  15.  
  16.     @ApiOperation(value = "分块文件上传前的检测")
  17.     @PostMapping("/upload/checkchunk")
  18.     public RestResponse<Boolean> checkchunk(@RequestParam("fileMd5") String fileMd5,
  19.                                             @RequestParam("chunk") int chunk) throws Exception {
  20.         RestResponse<Boolean> booleanRestResponse = mediaFileService.checkChunk(fileMd5, chunk);
  21.         return booleanRestResponse;
  22.     }
  23.  
  24.     @ApiOperation(value = "上传分块文件")
  25.     @PostMapping("/upload/uploadchunk")
  26.     public RestResponse uploadchunk(@RequestParam("file") MultipartFile file,
  27.                                     @RequestParam("fileMd5") String fileMd5,
  28.                                     @RequestParam("chunk") int chunk) throws Exception {
  29.         //创建一个临时文件
  30.         File tempFile = File.createTempFile("minio",".temp");
  31.         file.transferTo(tempFile);
  32.         //文件路径
  33.         String localFilePath = tempFile.getAbsolutePath();
  34.         RestResponse restResponse = mediaFileService.uploadChunk(fileMd5, chunk, localFilePath);
  35.         return restResponse;
  36.     }
  37.  
  38.     @ApiOperation(value = "合并文件")
  39.     @PostMapping("/upload/mergechunks")
  40.     public RestResponse mergechunks(@RequestParam("fileMd5") String fileMd5,
  41.                                     @RequestParam("fileName") String fileName,
  42.                                     @RequestParam("chunkTotal") int chunkTotal) throws Exception {
  43.         return null;
  44.  
  45.     }
  46. }

在xuecheng-plus-media的xuecheng-plus-media-service下的MediaFileService中写入如下3个接口：

  1. //检查文件是否存在
  2. public RestResponse<Boolean> checkFile(String fileMd5);
  3. //检查分块是否存在
  4. public RestResponse<Boolean> checkChunk(String fileMd5, int chunkIndex);
  5. //上传分块
  6. public RestResponse uploadChunk(String fileMd5,int chunk,String localChunkFilePath);

在xuecheng-plus-media的xuecheng-plus-media-service下的MediaFileService中写入如下3个接口的具体实现：

  1. @Override
  2. public RestResponse<Boolean> checkFile(String fileMd5) {
  3.     //先查询数据库
  4.     MediaFiles mediaFiles = mediaFilesMapper.selectById(fileMd5);
  5.     //如果数据库存在再查询minio
  6.     if(mediaFiles != null){
  7.         //桶
  8.         String bucket = mediaFiles.getBucket();
  9.         //objectname
  10.         String filePath = mediaFiles.getFilePath();
  11.         //如果数据库存在再查询minio
  12.         GetObjectArgs getObjectArgs = GetObjectArgs.builder()
  13.                 .bucket(bucket)
  14.                 .object(filePath)
  15.                 .build();
  16.         //查询远程服务获取到一个流对象
  17.         try{
  18.             FilterInputStream inputStream = minioClient.getObject(getObjectArgs);
  19.             if(inputStream!=null){
  20.                 //文件已存在
  21.                 return RestResponse.success(true);
  22.             }
  23.         } catch (Exception e) {
  24.             e.printStackTrace();
  25.         }
  26.     }
  27.     //文件不存在
  28.     return RestResponse.success(false);
  29. }
  30.  
  31. @Override
  32. public RestResponse<Boolean> checkChunk(String fileMd5, int chunkIndex) {
  33.     //分块存储路径是：md5前2位为2个目录，chunk分块文件
  34.     //根据md5得到分块文件的路径
  35.     String chunkFileFolderPath = getChunkFileFolderPath(fileMd5);
  36.     //如果数据库存在再查询minio
  37.     GetObjectArgs getObjectArgs = GetObjectArgs.builder()
  38.             .bucket(bucket_video)
  39.             .object(chunkFileFolderPath+chunkIndex)
  40.             .build();
  41.     //查询远程服务获取到一个流对象
  42.     try{
  43.         FilterInputStream inputStream = minioClient.getObject(getObjectArgs);
  44.         if(inputStream!=null){
  45.             //文件已存在
  46.             return RestResponse.success(true);
  47.         }
  48.     } catch (Exception e) {
  49.         e.printStackTrace();
  50.     }
  51.     return RestResponse.success(false);
  52. }
  53. //得到分块文件的目录
  54. private String getChunkFileFolderPath(String fileMd5){
  55.     return fileMd5.substring(0,1)+"/"+fileMd5.substring(1,2);
  56. }
  57.  
  58. @Override
  59. public RestResponse uploadChunk(String fileMd5, int chunk, String localChunkFilePath) {
  60.     //分块文件的路径
  61.     String chunkFilePath = getChunkFileFolderPath(fileMd5)+chunk;
  62.     //获取mimeType
  63.     String mimeType = getMimeType(null);
  64.     //将分支文件上传到minio
  65.     boolean b = addMediaFilesToMinIO(localChunkFilePath,mimeType,bucket_video,chunkFilePath);
  66.     if(!b){
  67.         return RestResponse.validfail(false,"上传分块文件失败");
  68.     }
  69.     return RestResponse.success(true);
  70. }

测试效果如下： 

 传入一个46M的文件，进度条显示成功。

然后在minio中也可以看到文件如下：

3.23 (上传视频)合并测试 P74

上传视频功能的具体代码见上节。

第1步：我的建议是现在下面2处打上断点，第1处断点重点看objectName和sources（我第1次就是sources和objectName内部写错了，排查了很久），第2处断点看是否会抛出错误被捕获。

执行完minioClient.composeObject之后文件就上传成功了，建议先去minio中预览看看合并后的视频有无问题。

第2步：在“校验合并后和源文件是否一致”下一句打上断点，主要看比较原始视频md5值和合并后视频的md5值会不会报错。

第3步：在“将文件信息入库”的下一句打上断点（运行到该断点处md5校验通过）。现在看数据库的media_files表，看看是否出现视频名称，或者和当天日期相等的数据项记录。

第4步：在“清除分块文件”的下一句打上断点，运行过后看看分块文件会不会被删除（只留下合并后的文件）。

最后测试断点续传，上传一个比较大的文件（至少20M以上），传到一半的时候刷新网页，然后进minio对应文件夹看看上传了几块文件。然后此时重新打开网页，重新选择刚才文件，看是否是断点续传只需要看浏览器的日志。发现前面已经传过的文件只需要日志校验。

3.24 什么情况事务失效 P75

非事务方法去调用事务方法，并不是以代理对象调用。

事务成功的情况：要以代理对象的方式调用，要添加@Transactional注解。

依赖注入，把service注入到实现类的成员变量中，通过代理对象来调用事务方法。

Spring控制事务是基于AOP环绕通知的方式，如果事务方法内抛出异常，这个异常会被抛给代理对象，代理对象会对事务进行回滚。

什么情况Spring事务会失效：1.在方法中捕获异常没有抛出。2.非事务方法调用事务方法。3.事务方法内部调用事务方法。4.@Transactional注解标记的方法不是public。5.抛出的异常与rollbackFor指定的异常不匹配，默认rollbackFor指定的异常为RuntimeException。6.数据库不支持事务，比如MySQL的MyISAM。

3.25 断点续传怎么实现 P76

前端对文件分块。前端上传每一块文件之前都会向服务端确认该块文件是否已经上传。前端把文件上传到服务端，服务端把文件保存到minio中。当所有分块上传完毕，服务端就合并所有分块。前端发送一个md5值，后端也计算一个md5值，比较如果相等代表文件没有损坏，然后服务端就会把合并后的文件上传到分布式文件系统minio中。

清理：文件表记录了文件的信息，给文件记录一个状态（上传中），根据上传时间（每24小时扫描），上传中没有完成上传的文件，清理掉这些文件在分布式文件系统中的位置，清空这些分块。

3.26 以下是视频处理小专题

3.27 视频转码需求 P77

.mp4 .avi .rmvb不同的扩展名是视频文件的文件格式。

MPEG H.26X系列是编码格式。

看到的视频是视频编码和音频编码的合成，最常见的是视频H.264，音频AAG。

FFmpeg对视频进行编码，写java程序来调用FFmpeg工具来对视频进行转码。

该工具是在day01的资料中。

ffmpeg.exe -i 初始文件名.后缀名 目标文件名.后缀名

把工具类直接拷贝到xuecheng-plus-base下：

测试一下发现可以用命令行的方式来打开文件应用：

比如下Mp4VideoUtil的main中写入如下代码：

  1. ProcessBuilder builder = new ProcessBuilder();
  2. builder.command("C:\\xuechengzaixian\\学成在线项目—资料\\day01 项目介绍&环境搭建\\资料\\常用软件工具\\JSON编辑器JSONedit\\JSONedit.exe");
  3. //将标准输入流和错误输入流合并，通过标准输入流程读取信息
  4. builder.redirectErrorStream(true);
  5. Process p = builder.start();

尝试通过java调用FFmpeg来转换视频格式：

 

3.28 分布式任务调度 P78

任务调度：对任务的调度，指系统为了完成特定业务，基于给定时间点，给定时间间隔或者给定执行次数自动执行任务。

分布式任务调度：目的是为了提高任务调度的效率。

对一个视频的转码可以理解为一个任务的执行，如果视频的数量比较多，如何去高效处理一批任务。

多线程：是充分利用单机的资源。

分布式加多线程：利用多台计算机，每台计算机使用多线程处理。

分布式调度要实现的目标：

1.并行任务调度。2.高可用。3.弹性扩容。

3.29 xxl-job配置执行器 P79

xxl-job是一个轻量级的分布式任务调度平台。

由1个调度中心（按照调度配置发出调度请求）来控制多个执行器（执行器管理、任务管理、监控运维、日志管理）。

把xxl-job-2.3.1.zip解压一下

如果想本地连接的话，需要更改配置文件，数据库

可以直接登录到xxl-job

192.168.101.65:8088/xxl-job-admin

账号：admin

密码：123456 

在网页端的任务调度中心的执行器管理中创建执行器：

在xuecheng-plus-media-service的pom.xml中写入如下依赖：

  1. <dependency>
  2.     <groupId>com.xuxueli</groupId>
  3.     <artifactId>xxl-job-core</artifactId>
  4. </dependency>

 在nacos中打开media-service-dev.yaml配置文件，把appname替换为在xxl-job中配置的：

XxlJobConfig在如下的目录下：

学成在线项目—资料\day06 断点续传 xxl-job\资料\xxl-job-2.3.1\xxl-job-executor-samples\xxl-job-executor-sample-springboot\src\main\java\com\xxl\job\executor\core\config

把XxlJobConfig复制到xuecheng-plus-media-service的config下：

3.30 xxl-job执行任务测试 P80

SampleXxlJob如下：

学成在线项目—资料\day06 断点续传 xxl-job\资料\xxl-job-2.3.1\xxl-job-executor-samples\xxl-job-executor-sample-springboot\src\main\java\com\xxl\job\executor\service\jobhandler

在xuecheng-plus-media-service的service下创建jobhandler，然后把上面SampleXxlJob类复制到jobhandler下面：

@XxlJob注解里面的就是任务名称。

调度类型：固定速度指的是固定多少时间调度，CRON更加灵活年月日时分秒（可以设定每天的多少分多少秒执行）。

在JobHandler中填写@XxlJob注解中的任务名称。

路由策略会在集群配置中使用到。

然后要在任务管理选择媒资服务测试执行器，记得要把任务启动起来：

启动之后启动xuecheng-plus-media的启动类，然后控制台会每隔5秒输出处理视频......

3.31 xxl-job高级配置参数 P81

多启动一个线程，比如多启动一个MediaApplication:63051。

一致性HASH，计算出某个哈希值就调度谁。

分片广播可以在任务调度的时候把工作同时分发给多个任务。

调度过期策略：忽略，如果任务过期了就直接忽略。立即执行一次，任务过期但请求到了执行一次。

阻塞处理策略：单机串行，任务排队执行（在FIFO队列中以串行的方式运行）。丢弃后续调度，后面的任务丢弃（如果执行器中存在运行的调度任务，本次请求将会被丢弃并标记为失败）。覆盖之前调度，前面干的活丢弃，干后面的活（如果执行器存在运行中的调度任务，会终止运行中的调度任务并清空队列，然后运行本地调度任务）。

3.32 xxl-job分片广播 P82

首先要在nacos的media-service-dev.yaml中配置本地优先：

  1. spring:
  2.   cloud:
  3.     config:
  4.       override-none: true

配置如下

-Dserver.port=63051 -Dxxl.job.executor.port=9998

 需要等到testHandler一栏的OnLine机器地址为2时才可以继续。

配置如下，记得路由策略要选择分片广播。

启动分片任务测试：

可以看到控制台不同的启动类下输出的控制台数据不同。

动态扩容，如果新加1个，shardTotal会为3。

3.33 技术方案 P83

如何保证多个执行器不会查询到重复的任务？——每个待处理文件都有一个编号记录，让每个文件的编号余2，为1交给一个执行器处理，为0交给另一个处理器处理。

幂等性：对数据的操作不论多少次，操作的结果始终是一致的。

方法1：数据库约束，如：唯一索引，主键。

方法2：乐观锁，常用于数据库，更新数据时根据乐观锁状态去更新。

方法3：唯一序列号，操作传递一个唯一序列号，操作是判断与该序列号相等则执行。

业务流程：需要从左往右看。

1.首先会通过网关上传视频，视频会被上传到媒资服务器（IDEA中运行），此时媒资服务器会向数据库（待处理的任务表中）写入视频的信息。

2.媒资服务会通过网关把视频上传保存到minio-server（minio）。

3.右边的xxl-job会给微服务的执行器下发任务，文件处理服务会从数据库中取出任务编号，然后除余处理器的数量，得到的结果就是哪台处理器来处理这个数据。处理的时候该台处理器会从minio下载数据到处理器，然后对视频进行转码；处理结束之后会把结果上传到minio，然后记录结果到数据库。

 3.34 查询待处理任务 P84

待处理任务表：

如果文件上传完成，会把该文件的记录删除，然后把记录移动到历史记录表（与待处理任务表结构一致）。

如果视频上传成功，待处理任务表的数据就要添加成功。需要使用事务控制。

所以需要在addMediaFilesToDb这个方法里面写。

在xuecheng-plus-media-service的service的impl下的MediaFileServiceImpl中的addMediaFilesToDb方法的如下位置添加addWaitingTask(mediaFiles);这段代码：

在xuecheng-plus-media-service的service的impl下的MediaFileServiceImpl中写入如下代码：

  1. @Autowired
  2. MediaProcessMapper mediaProcessMapper;
  3. private void addWaitingTask(MediaFiles mediaFiles){
  4.     //获取文件的mimeType
  5.     //文件名称
  6.     String filename = mediaFiles.getFilename();
  7.     //文件扩展名 mimeType
  8.     String extension = filename.substring(filename.lastIndexOf("."));
  9.     String mimeType = getMimeType(extension);
  10.     if(mimeType.equals("video/x-msvideo")){//如果是avi视频写入待处理任务
  11.         MediaProcess mediaProcess = new MediaProcess();
  12.         BeanUtils.copyProperties(mediaFiles,mediaProcess);
  13.         //状态是未处理
  14.         mediaProcess.setStatus("1");
  15.         mediaProcess.setCreateDate(LocalDateTime.now());
  16.         mediaProcess.setFailCount(0); //失败次数默认0
  17.         mediaProcess.setUrl(null);
  18.         mediaProcessMapper.insert(mediaProcess);
  19.     }
  20.     //通过minmeTyoe判断
  21. }

在xuecheng-plus-media-service的service下创建MediaFileProcessService接口，写入如下代码：

  1. //任务处理
  2. public interface MediaFileProcessService {
  3.     public List<MediaProcess> getMediaProcessList(int shardIndex,int shardTotal,int count);
  4. }

在xuecheng-plus-media-service的service的impl下创建MediaFileProcessServiceImpl，写入如下代码：

  1. @Slf4j
  2. @Service
  3. public class MediaFileProcessServiceImpl implements MediaFileProcessService {
  4.     @Autowired
  5.     MediaProcessMapper mediaProcessMapper;
  6.  
  7.     @Override
  8.     public List<MediaProcess> getMediaProcessList(int shardIndex, int shardTotal, int count) {
  9.         List<MediaProcess> mediaProcesses = mediaProcessMapper.selectListByShardIndex(shardTotal, shardIndex, count);
  10.         return mediaProcesses;
  11.     }
  12. }

在xuecheng-plus-media-service的mapper下的MediaProcessMapper中，写入如下代码：

  1. public interface MediaProcessMapper extends BaseMapper<MediaProcess> {
  2.     @Select("select * from media_process t where t.id % #{shardTotal} = #{shardIndex} and (t.status=1 or t.status=3) and t.fail_count < 3 limit #{count}")
  3.     List<MediaProcess> selectListByShardIndex(@Param("shardTotal")int shardTotal,@Param("shardIndex")int shardIndex,@Param("count")int count);
  4. }

代码如下：

进行前后端测试，上传4个avi视频，观察待处理任务表是否存在记录，记录是否完成。千万要注意这里要传avi视频才会进入待处理列表哦哦！

这里要注意，在数据库里没有fail_count这个字段，所以我们要在数据库设计表新增这个字段。还有id字段记得要设置成自动递增。最后一定要记得点击保存！！！！

然后media_process_history同样这样的操作。然后尝试插入数据，成功。

3.35 分布式锁开启任务 P85

存在问题：当执行器弹性扩容时无法绝对避免任务不重复执行，比如：原来有4个执行器正在执行任务，由于网络问题，原有的0和1号执行器无法与调度中心通信，调度中心会对执行器重新编号，原来的3、4号执行器可能会执行0、1号执行器相同的任务。

为了避免多线程去争抢同一个任务可以使用synchronized同步锁去解决。但synchronized只能保证同一个虚拟机中多个线程去争抢锁。

当多个虚拟机去争抢同一把锁的时候，用分布式锁。当虚拟机内部多线程去争抢同一把锁的时候，用synchronized。

现在要实现分布式环境下所有虚拟机中的线程去同步执行就需要让多个虚拟机去共用一个锁，虚拟机可以分布式部署，锁也可以分布式部署。

分布式锁实现方案：

1.基于数据库实现分布式锁：利用数据库的主键唯一性的特点，或利用数据库唯一索引、行级锁的特点，比如：多个线程同时向数据库插入主键相同的一条记录，谁插入成功谁就获取锁，多个线程同时去更新相同的记录，谁更新成功谁就抢到锁。

2.基于redis实现锁：redis提供了分布式锁的实现方案，比如：SETNX、set nx、redisson等。

拿SETNX举例说明，SETNX命令的工作过程是去set一个不存在的key，多个线程去设置一个key只会有一个线程设置成功，设置成功的线程拿到锁。

3.基于zookeeper实现锁：zookeeper是一个分布式协调服务，主要解决分布式程序之间的同步的问题。zookeeper的结构类似文件目录，多线程向zookeeper创建一个子目录（节点）只会有一个创建成功，利用此特点可以实现分布式锁，谁创建该节点成功谁就获得锁（zookeeper是一个类似目录结构的，多个进程来创建文件，只会有一个进程成功）。

本次是基于数据库实现分布式锁。

update media_process t set t.status=4 where id=2 and (t.status=1 or t.status=3) and t.fail_count<3

1未处理和3处理失败的处理机中，谁把状态设置为4处理中，谁就争夺到了处理权。

1.乐观锁：乐观地认为没有人会去抢锁，所以尽可能去执行。

思路是：在表中增加一个version字段，更新是判断是否等于某个版本，等于则更新，否则更新失败。（version等于2代表抢到锁，version等于1代表可以抢锁）：

update media_process t set t.status=4,t.version=2 where t.version=1

2、悲观锁：悲观地认为总有人会去抢锁，所以只要没抢到，都不能执行。

synchronized是悲观锁，在执行被synchronized包裹的代码时需要首先获取锁，没有拿到锁则无法执行，时因为悲观锁总认为别的线程会来抢锁，

代码如下：

在xuecheng-plus-media-service的mapper下的mediaProcessMapper中写入如下代码：

  1. @Update("update media_process m set m.status='4' where (m.status='1' or m.status='3') and m.fail_count<3 and m.id=#{id}")
  2. int startTask(@Param("id") long id);

在xuecheng-plus-media-service的service下的MediaFileProcessService中写入如下代码：

public boolean startTask(long id);

在xuecheng-plus-media-service的service的impl下的MediaFileProcessServiceImpl中写入如下代码：

  1. //实现如下
  2. @Override
  3. public boolean startTask(long id) {
  4.     int result = mediaProcessMapper.startTask(id);
  5.     return result<=0?false:true;
  6. }

3.36 保存任务处理结果 P86

在xuecheng-plus-media-service的service下的MediaFileProcessService中写入如下代码：

  1. /**
  2.  * 保存任务结果
  3.  * @param taskId 任务id
  4.  * @param status 任务状态
  5.  * @param fileId 文件id
  6.  * @param url url
  7.  * @param errorMsg 错误信息
  8.  */
  9. public void saveProcessFinishStatus(Long taskId,String status,String fileId,String url,String errorMsg);

在xuecheng-plus-media-service的service的impl下的MediaFileProcessServiceImpl中写入如下代码：

  1. @Autowired
  2. MediaFilesMapper mediaFilesMapper;
  3. @Autowired
  4. MediaProcessHistoryMapper mediaProcessHistoryMapper;
  5. @Override
  6. public void saveProcessFinishStatus(Long taskId, String status, String fileId, String url, String errorMsg) {
  7.     //要更新的任务
  8.     MediaProcess mediaProcess = mediaProcessMapper.selectById(taskId);
  9.     if(mediaProcess == null){
  10.         return ;
  11.     }
  12.     //如果任务执行失败
  13.     if(status.equals("3")){
  14.         //更新MediaProcess表的状态
  15.         mediaProcess.setStatus("3");
  16.         mediaProcess.setFailCount(mediaProcess.getFailCount()+1);//失败次数+1
  17.         mediaProcess.setErrormsg(errorMsg);
  18.         mediaProcessMapper.updateById(mediaProcess);
  19.         return;
  20.     }
  21.     //====如果任务执行成功=====
  22.     //文件表记录
  23.     MediaFiles mediaFiles = mediaFilesMapper.selectById(fileId);
  24.     //更新meida_file表中的url
  25.     mediaFiles.setUrl(url);
  26.     mediaFilesMapper.updateById(mediaFiles);
  27.     //更新MediaProcess表的状态
  28.     mediaProcess.setStatus("2");
  29.     mediaProcess.setFinishDate(LocalDateTime.now());
  30.     mediaProcess.setUrl(url);
  31.     mediaProcessMapper.updateById(mediaProcess);
  32.     //将MediaProcess表记录插入到MediaProcessHistory表
  33.     MediaProcessHistory mediaProcessHistory = new MediaProcessHistory();
  34.     BeanUtils.copyProperties(mediaProcess,mediaProcessHistory);
  35.     mediaProcessHistoryMapper.insert(mediaProcessHistory);
  36.     //从MediaProcess删除当前任务
  37.     mediaProcessMapper.deleteById(taskId);
  38. }

3.37 视频处理任务类 P87

首先要在nacos中配置videoprocess:ffmpegpath的参数：

然后要在xuecheng-plus-media的xuecheng-plus-media-service下面的servic下的jobhandler下面的VideoTask下，写入如下代码：

  1. @Slf4j
  2. @Component
  3. public class VideoTask {
  4. @Autowired
  5. MediaFileProcessService mediaFileProcessService;
  6. @Value("${videoprocess.ffmpegpath}")
  7. private String ffmpegpath;
  8. @Autowired
  9. MediaFileService mediaFileService;
  10. /**
  11.  * 视频处理任务
  12.  */
  13. @XxlJob("videoJobHandler")
  14. public void shardingJobHandler() throws Exception {
  15.  
  16.     // 分片参数
  17.     int shardIndex = XxlJobHelper.getShardIndex();
  18.     int shardTotal = XxlJobHelper.getShardTotal();
  19.     //确定cpu的核心数
  20.     int processors = Runtime.getRuntime().availableProcessors();
  21.     //查询待处理的任务
  22.     List<MediaProcess> mediaProcessList = mediaFileProcessService.getMediaProcessList(shardIndex, shardTotal, processors);
  23.     //任务数量
  24.     int size = mediaProcessList.size();
  25.     log.debug("取到的视频处理任务数:"+size);
  26.     if(size<=0){
  27.         return;
  28.     }
  29.     //创建一个线程池
  30.     ExecutorService executorService = Executors.newFixedThreadPool(size);
  31.     CountDownLatch countDownLatch = new CountDownLatch(size);//每执行一个线程，个数就减1
  32.     mediaProcessList.forEach(mediaProcess -> {
  33.         //将任务加入线程池
  34.         executorService.execute(()-> {
  35.             try{
  36.             //任务id
  37.             Long taskId = mediaProcess.getId();
  38.             //文件id就是md5
  39.             String fileId = mediaProcess.getFileId();
  40.             //开启任务
  41.             boolean b = mediaFileProcessService.startTask(taskId);
  42.             if (!b) {
  43.                 log.debug("抢占任务失败，任务id:{}", taskId);
  44.                 return;
  45.             }
  46.             //桶
  47.             String bucket = mediaProcess.getBucket();
  48.             String objectName = mediaProcess.getFilePath();
  49.             //下载minio视频到本地
  50.             File file = mediaFileService.downloadFileFromMinIO(bucket, objectName);
  51.             if (file == null) {
  52.                 log.debug("下载视频出错,任务id:{},bucket:{},objectName:{}", taskId, bucket, objectName);
  53.                 //保存任务处理失败的结果
  54.                 mediaFileProcessService.saveProcessFinishStatus(taskId, "3", fileId, null, "下载视频到本地失败");
  55.                 return;
  56.             }
  57.  
  58.             //源avi视频的路径
  59.             String video_path = file.getAbsolutePath();
  60.             //转换后mp4文件的名称
  61.             String mp4_name = fileId + ".mp4";
  62.             //转换后mp4文件的路径
  63.             //先创建一个临时文件，作为转换后的文件
  64.             File mp4File = null;
  65.             try {
  66.                 mp4File = File.createTempFile("minio", ".mp4");
  67.             } catch (IOException e) {
  68.                 log.debug("创建临时文件异常,{}", e.getMessage());
  69.                 mediaFileProcessService.saveProcessFinishStatus(taskId, "3", fileId, null, "创建临时文件异常");
  70.                 return;
  71.             }
  72.             String mp4_path = mp4File.getAbsolutePath();
  73.             //创建工具类对象
  74.             Mp4VideoUtil videoUtil = new Mp4VideoUtil(ffmpegpath, video_path, mp4_name, mp4_path);
  75.             //开始视频转换，成功将返回success，失败返回失败原因
  76.             String result = videoUtil.generateMp4();
  77.             if (!result.equals("success")) {
  78.                 log.debug("视频转码失败,原因:{},bucket:{},objectName:{}", result, bucket, objectName);
  79.                 mediaFileProcessService.saveProcessFinishStatus(taskId, "3", fileId, null, result);
  80.                 return;
  81.             }
  82.             //上传到minio
  83.             boolean b1 = mediaFileService.addMediaFilesToMinIO(mp4File.getAbsolutePath(), "video/mp4", bucket, objectName);
  84.             if (!b1) {
  85.                 log.debug("上传mp4到minio失败，taskid:{}", taskId);
  86.                 mediaFileProcessService.saveProcessFinishStatus(taskId, "3", fileId, null, "上传mp4到minio失败");
  87.                 return;
  88.             }
  89.             //mp4文件的url
  90.             String url = getFilePathByMd5(fileId, ".mp4");
  91.             //更新任务状态为成功
  92.             mediaFileProcessService.saveProcessFinishStatus(taskId, "2", fileId, url, "文件转换成功");
  93.         }finally{
  94.             //计数器减去1
  95.             countDownLatch.countDown();
  96.         }
  97.  
  98.     });
  99. });
  100. //阻塞，所有线程都在这阻塞。指定最大限度的等待时间，一定时间后解除阻塞
  101. countDownLatch.await(30, TimeUnit.MINUTES);
  102.  
  103. }
  104. //得到分块文件的目录
  105. private String getFilePathByMd5(String fileMd5,String fileExt){
  106.     return   fileMd5.substring(0,1) + "/" + fileMd5.substring(1,2) + "/" + fileMd5 + "/" +fileMd5 +fileExt;
  107. }
  108. }

下面这段代码是瞬间形成的，形成完后方法结束，所以改进的方法体现在了上面的代码中。

3.38 任务处理流程测试 P88

首先要到nacos的media-service-dev.yaml下对appname进行配置（有图修改后），上报自己是哪个执行器：

注意一定要选视频处理任务执行器，新增如下的任务配置：

看到成功配置上：

测试：

第1步：造测试数据。

上传4段avi的数据。在media_process中可以看到表项记录。

第2步：改错2个数据。

我们要测试出正确情况，也要测试错误情况。

所以我把1（彩色水墨.avi，图中id为6）和3（石锅拌饭近景 - 副本.avi，图中id为8）表项的file_path改错（比如多加一个a）。

第3步：在videoTask的第1行打上断点，然后记得打开视频处理这个任务，启动

第4步：逐步跟踪，看看哪里有问题。

第5步：检查最后效果数据库是否正确

在media_process中是处理失败的：

在media_process_history中是处理成功的：

第6步：看看minio中是否存在转码后的mp4文件

3.39 面试幂等性 P89

xxl-job的工作原理是什么？xxl-job是怎么工作的？

xxl-job分布式任务调度服务是由调度中心和执行器组成的，调度中心负责按任务策略向执行器分派任务，执行器负责接收任务执行任务。

1.首先部署并启动xxl-job调度中心。2.在有需要使用xxl-job的微服务中添加xxl-job依赖，在微服务中配置执行器。3.启动微服务，执行器向调度中心上报自己。4.在微服务中写一个任务方法并用xxl-job的注解去标记执行任务的方法名称。5.在调度中心配置任务调度策略，调度策略就是每隔多长时间执行还是每天或每月的固定时间去执行，比如每天0点执行，或每隔1小时执行一次等。6.在调度中心启动任务。7.调度中心根据任务调度策略，到达时间就开始下发任务给执行器。8.执行器收到任务就开始执行任务。

任务的幂等性如何保证：

幂等性：描述了一次和多次请求某一个资源对于资源本身具有同样的结果。

幂等性是为了解决重复提交问题，比如：恶意刷单，重复支付等。

解决幂等性的常用方案：

1.数据库约束。比如：主键约束，唯一索引约束。

2.乐观锁（更新记录的时候，根据版本号，比如为1时才能更新，更新后变成2）。常用于数据库，更新数据时根据乐观锁去更新。

3.唯一序列号。请求前生成唯一的序列号，携带序列号去请求，执行时在redis记录该序列号表示以该序列号的请求执行过了，如果相同的序列号在此执行说明是重复执行。

3.40 (绑定媒资)分析设计 P90

进入课程计划界面，点击添加视频，搜索到视频点击提交，课程计划的绑定关系就建立了。

采用先删除后添加的方式。

首先在xuecheng-plus-content的xuecheng-plus-content-model的dto下创建BindTeachplanMediaDto，写入文档中的代码：

然后在xuecheng-plus-content的xuecheng-plus-content-api的TeachplanController下写入如下代码：

  1. @ApiOperation(value="课程计划和媒资信息绑定")
  2. @PostMapping("/teachplan/association/media")
  3. public void associationMedia(@RequestBody BindTeachplanMediaDto bindTeachplanMediaDto){
  4. }

3.41  (绑定媒资)接口开发 P91

完善TeachplanController代码如下：

  1. @ApiOperation(value="课程计划和媒资信息绑定")
  2. @PostMapping("/teachplan/association/media")
  3. public void associationMedia(@RequestBody BindTeachplanMediaDto bindTeachplanMediaDto){
  4.     teachplanService.associationMedia(bindTeachplanMediaDto);
  5. }

在xuecheng-plus-content的xuecheng-plus-content-service下的TeachplanService中写入代码如下： 

  1. //教学计划绑定媒资
  2. public void associationMedia(BindTeachplanMediaDto bindTeachplanMediaDto);

在xuecheng-plus-content的xuecheng-plus-content-service的impl下的TeachplanServiceImpl

中写入代码如下： 

  1. @Autowired
  2. TeachplanMediaMapper teachplanMediaMapper;
  3. @Transactional
  4. @Override
  5. public void associationMedia(BindTeachplanMediaDto bindTeachplanMediaDto) {
  6.     //课程计划id
  7.     Long teachplanId = bindTeachplanMediaDto.getTeachplanId();
  8.     Teachplan teachplan = teachplanMapper.selectById(teachplanId);
  9.     if(teachplan==null){
  10.         XueChengPlusException.cast("课程计划不存在");
  11.     }
  12.     //先删除原有记录，根据课程计划id删除它所绑定的媒资
  13.     int delete = teachplanMediaMapper.delete(new LambdaQueryWrapper<TeachplanMedia>().eq(TeachplanMedia::getTeachplanId, bindTeachplanMediaDto.getTeachplanId()));
  14.     //再添加新记录
  15.     TeachplanMedia teachplanMedia = new TeachplanMedia();
  16.     BeanUtils.copyProperties(bindTeachplanMediaDto,teachplanMedia);
  17.     teachplanMedia.setCourseId(teachplan.getCourseId());
  18.     teachplanMedia.setMediaFilename(bindTeachplanMediaDto.getFileName());
  19.     teachplanMediaMapper.insert(teachplanMedia);
  20. }

测试效果如下：

声明：本文内容由网友自发贡献，转载请注明出处：【wpsshop】
推荐阅读
相关标签

Copyright © 2003-2013 www.wpsshop.cn 版权所有，并保留所有权利。

  

闽ICP备14008679号