【微服务 | 学成在线】项目易错重难点分析（内容管理模块篇）

已于 2023-04-20 18:53:03 修改
阅读量843 收藏 10
点赞数 4
分类专栏： # 微服务项目-学成在线 文章标签： 微服务 架构 云原生
于 2023-04-08 14:51:30 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/zyb18507175502/article/details/129869343
版权

文章目录

项目的模块架构理解

在我们做项目之前首先要对项目的模块结构有一个基本的了解，放一张我做的结构图：

在这里插入图片描述

注意点：

  • 我们将依赖版本管理和依赖管理分为两个工程，而不是放在一个工程中，这样的话可以子模块可以选择性的继承，而不会太重
    • parent工程：对整个项目的依赖包版本进行管理
    • base工程：提供基础类库、工具类库等（继承parent工程，从而也纳入版本管理）
  • content工程是一个聚合工程，不需要依赖，所以我们让它继承于parent工程拿到依赖版本即可
  • 在content微服务工程中，我们可以发现api工程和service工程都依赖于model工程，那么我们就不需要让api、service、model工程都去继承base工程，而是让model工程去继承base工程即可实现同样的效果。
  • 有人可能会问：通过model工程，service和api工程都继承了base工程间接继承了parent工程，为什么还要再去分别继承content工程？
    • 这说明对项目结构还不是非常的清楚。parent工程是对整个项目的依赖版本进行管理，base工程中只是管理了基础依赖、工具依赖。而api、service、model工程中他们除了使用base中管理的基础依赖之外，肯定还有自己独有的依赖，这些独有的依赖如果想要纳入项目的依赖版本管理，只能是通过继承content，从而间接的继承parent工程。

模型类的作用

我们得项目中会涉及到以下几种模型类：

  • DTO数据传输对象：用于接口层向业务层之间传输数据
  • PO持久化对象：用于业务层与持久层之间传输数据
  • VO：前端与接口层之间传输数据

在这里插入图片描述

当前端有多个平台且接口存在差异时就需要设置VO对象用于前端和接口层传输数据。

比如：课程列表查询接口，根据需求用户在手机端也要查询课程信息，此时课程查询接口是否需要编写手机端和PC端两个接口呢？如果用户要求通过手机和PC的查询条件或查询结果不一样，此时就需要定义两个Controller课程查询接口，每个接口定义VO对象与前端传输数据。

  • 手机查询：根据课程状态查询，查询结果只有课程名称和课程状态。
  • PC查询：可以根据课程名称、课程状态、课程审核状态等条件查询，查询结果也比手机查询结果内容多。

此时，Service业务层尽量提供一个业务接口，即使两个前端接口需要的数据不一样，Service可以提供一个最全查询结果，由Controller进行数据整合。
如下图：
在这里插入图片描述
如果前端的接口没有多样性且比较固定，此时可以取消VO，只用DTO即可。
如下图：

在这里插入图片描述

生成接口文档

在前后端分离开发中通常由后端程序员设计接口，完成后需要编写接口文档，最后将文档交给前端工程师，前端工程师参考文档进行开发。

可以通过一些工具快速生成接口文档 ，本项目通过Swagger生成接口在线文档 。

什么是Swagger？

  • OpenAPI规范（OpenAPI Specification 简称OAS）是Linux基金会的一个项目，试图通过定义一种用来描述API格式或API定义的语言，来规范RESTful服务开发过程，目前版本是V3.0，并且已经发布并开源在github上。（https://github.com/OAI/OpenAPI-Specification）
  • Swagger是全球最大的OpenAPI规范（OAS）API开发工具框架，Swagger是一个在线接口文档的生成工具，前后端开发人员依据接口文档进行开发。 (https://swagger.io/)
  • Spring Boot 可以集成Swagger，Swaager根据Controller类中的注解生成接口文档 ，只要添加Swagger的依赖和配置信息即可使用它。

  1. 在API工程添加swagger-spring-boot-starter依赖

    <!-- Spring Boot 集成 swagger -->
 <dependency>
     <groupId>com.spring4all</groupId>
     <artifactId>swagger-spring-boot-starter</artifactId>
 </dependency>

  2. 在 bootstrap.yml中配置swagger的扫描包路径及其它信息，base-package为扫描的包路径，扫描Controller类。

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

  3. 在启动类中添加@EnableSwagger2Doc注解再次启动服务，工程启动起来，访问http://localhost:63040/content/swagger-ui.html查看接口信息

下图为swagger接口文档的界面：
在这里插入图片描述
这个文档存在两个问题：

  • 接口名称显示course-base-info-controller名称不直观
  • 课程查询是post方式只显示post /course/list即可。

下边进行修改，添加一些接口说明的注解，并且将RequestMapping改为PostMapping，如下：

@Api(value = "课程信息编辑接口",tags = "课程信息编辑接口")
@RestController
public class CourseBaseInfoController {

  @ApiOperation("课程查询接口")
  @PostMapping("/course/list")
  public PageResult<CourseBase> list(PageParams pageParams, @RequestBody(required=false) QueryCourseParamsDto queryCourseParams){

     //....

  }

}

再次启动服务，工程启动起来，访问http://localhost:63040/content/swagger-ui.html查看接口信息：
在这里插入图片描述

接口文档中会有关于接口参数的说明，在模型类上也可以添加注解对模型类中的属性进行说明，方便对接口文档的阅读。

比如：下边标红的属性名称，可以通过swaager注解标注一个中文名称，方便阅读接口文档
在这里插入图片描述
标注的方法非常简单：

找到模型类，在属性上添加注解

public class PageParams {
 ...
@ApiModelProperty("当前页码")
private Long pageNo = 1L;

@ApiModelProperty("每页记录数默认值")
private Long pageSize = 30L;
...

public class QueryCourseParamsDto {

  //审核状态
 @ApiModelProperty("审核状态")
 private String auditStatus;
 //课程名称
 @ApiModelProperty("课程名称")
 private String courseName;

}

重启服务，再次进入接口文档，如下图：

在这里插入图片描述

在Java类中添加Swagger的注解即可生成Swagger接口，常用Swagger注解如下：

  • @Api：修饰整个类，描述Controller的作用
  • @ApiOperation：描述一个类的一个方法，或者说一个接口
  • @ApiParam：单个参数描述
  • @ApiModel：用对象来接收参数
  • @ApiModelProperty：用对象接收参数时，描述对象的一个字段
  • @ApiResponse：HTTP响应其中1个描述
  • @ApiResponses：HTTP响应整体描述
  • @ApiIgnore：使用该注解忽略这个API
  • @ApiError ：发生错误返回的信息
  • @ApiImplicitParam：一个请求参数
  • @ApiImplicitParams：多个请求参数

@ApiImplicitParam属性如下：
在这里插入图片描述

MyBatis之ResultMap的使用

官方文档地址：
结果映射（resultMap）

ResultMap 的属性列表：
在这里插入图片描述

ResultMap标签：
在这里插入图片描述

id & result标签参数详解：
在这里插入图片描述
association标签参数详解以及使用

在这里插入图片描述

@Data
//书籍
public class Book {
    private String id;
    private String name;
    private String author;
    private Double price;
    private Integer del;
    private Date publishdate;
    private String info;
    //把出版社对象当作属性
    private Publisher pub;//------重点在这里一本书对应一个出版社,这是一个出版社对象
}

@Data
//出版社
public class Publisher {
    private String id;
    private String name;
    private String phone;
    private String address;
}

<resultMap id="rMap_book" type="com.wang.test.demo.entity.Book">
    <!-- 主键  property为实体类属性 column为数据库字段 jdbcType为实体类对应的jdbc类型-->
    <id property="id" column="b_id" jdbcType="VARCHAR"></id>
    <!-- 普通属性  property为实体类属性 column为数据库字段  jdbcType为实体类对应的jdbc类型-->
    <result property="name" column="b_name" jdbcType="VARCHAR"></result>
    <result property="author" column="author" jdbcType="VARCHAR"></result>
    <result property="price" column="price" jdbcType="VARCHAR"></result>
    <result property="del" column="del" jdbcType="NUMERIC"></result>
    <result property="publisherid" column="publisher_id" jdbcType="VARCHAR"></result>
    <result property="publishdate" column="publish_date" jdbcType="TIMESTAMP"></result>
    <!--一对一映射association property 为实体类book中的属性名字 javaType为实体类属性的类型 -->
    <association property="pub" javaType="com.wang.test.demo.entity.Publisher">
        <id property="id" column="p_id" jdbcType="VARCHAR"></id>
        <result property="name" column="name" jdbcType="VARCHAR"></result>
        <result property="phone" column="phone" jdbcType="VARCHAR"></result>
        <result property="address" column="address" jdbcType="VARCHAR"></result>
    </association>
</resultMap>

collection标签常用参数详解以及使用

在这里插入图片描述

@Data
//班级类
public class Class {

    private String id;
    private String name;
    private List<Student> students;//----重点在这里,一个班级对应多个学生

}


@Data
public class Student {

    private int id;
    private String name;
    private int age;
}

<resultMap id="rMap_class" type="com.wang.test.demo.entity.Class">
    <id property="id" column="id" jdbcType="VARCHAR"></id>
    <result property="name" column="name" jdbcType="VARCHAR"></result>
    <!--一对多映射用这个  ofTyp是一对多的集合的所存放的实体类  javaType实体类的属性类型-->
    <collection property="students" ofType="com.wang.test.demo.entity.Student" javaType="list">
        <id property="id" column="id" jdbcType="INTEGER"></id>
        <result property="name" column="name" jdbcType="VARCHAR"></result>
        <result property="age" column="age" jdbcType="INTEGER"></result>
    </collection>
</resultMap>

内容管理部分

树形结构查询

两种方法：

  • 在树的层级固定的情况下：使用表的自连接
  • 在树的层级不固定的情况下：使用mysql的递归查询

我们查询出来的结果是树各个节点组成的列表，所以我们在service层中要对查询结果进行处理，返回前端需要的结果：

[
         {
            "childrenTreeNodes" : [
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-1",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "HTML/CSS",
                  "name" : "HTML/CSS",
                  "orderby" : 1,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-2",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "JavaScript",
                  "name" : "JavaScript",
                  "orderby" : 2,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-3",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "jQuery",
                  "name" : "jQuery",
                  "orderby" : 3,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-4",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "ExtJS",
                  "name" : "ExtJS",
                  "orderby" : 4,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-5",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "AngularJS",
                  "name" : "AngularJS",
                  "orderby" : 5,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-6",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "ReactJS",
                  "name" : "ReactJS",
                  "orderby" : 6,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-7",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "Bootstrap",
                  "name" : "Bootstrap",
                  "orderby" : 7,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-8",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "Node.js",
                  "name" : "Node.js",
                  "orderby" : 8,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-9",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "Vue",
                  "name" : "Vue",
                  "orderby" : 9,
                  "parentid" : "1-1"
               },
               {
                  "childrenTreeNodes" : null,
                  "id" : "1-1-10",
                  "isLeaf" : null,
                  "isShow" : null,
                  "label" : "其它",
                  "name" : "其它",
                  "orderby" : 10,
                  "parentid" : "1-1"
               }
            ],
            "id" : "1-1",
            "isLeaf" : null,
            "isShow" : null,
            "label" : "前端开发",
            "name" : "前端开发",
            "orderby" : 1,
            "parentid" : "1"
         },
		·······

我们的思路是：

  • 将一级节点收集成一个map，并且将一级节点的ChildrenTreeNodes属性由null变为一个空列表，防止后面会出现空指针异常
  • 遍历树的节点列表将二级节点放入到一级节点的childrenTreeNodes属性中
  • 将map的values收集成一个列表返回

处理的过程中我们使用了JDK8中的stream流技术，代码如下：

public class CourseCategoryServiceImpl implements CourseCategoryService {

    @Resource
    private CourseCategoryMapper courseCategoryMapper;

    /**
     * 课程分类树形结构查询
     * @param id
     * @return
     */
    @Override
    public List<CourseCategoryTreeDto> queryTreeNodes(String id) {
        //首先通过mapper递归查询得到树的节点
        List<CourseCategoryTreeDto> courseCategoryTreeDtos = courseCategoryMapper.selectTreeNodes(id);

        //第一步将一级节点收集成一个map,并且将ChildrenTreeNodes属性由null变为一个空列表
        Map<String, CourseCategoryTreeDto> firstNodeMap = courseCategoryTreeDtos.stream().filter(
                item -> item.getParentid().equals("1")
        ).map(
                item -> {
                    item.setChildrenTreeNodes(new ArrayList<>());

                    return item;
                }
        ).collect(Collectors.toMap(
                //规定key的映射
                CourseCategory::getId,
                //规定value的映射
                item -> item,
                //规定合并的规则
                (item1, item2) -> item2
        ));

        //遍历树的节点将二级节点放入到一级节点的childrenTreeNodes属性中
        for (CourseCategoryTreeDto courseCategoryTreeDto : courseCategoryTreeDtos) {
            //首先拿到父节点的id
            String parentid = courseCategoryTreeDto.getParentid();

            if (!firstNodeMap.containsKey(parentid)) continue;

            //添加
            CourseCategoryTreeDto firstNode = firstNodeMap.get(parentid);

            firstNode.getChildrenTreeNodes().add(courseCategoryTreeDto);
        }

        return new ArrayList<>(firstNodeMap.values());
    }
}

全局异常处理

在service方法中有很多的参数合法性校验，当参数不合法则抛出异常，下边我们测试下异常处理。

请求创建课程基本信息，故意将必填项设置为空。
测试发现报500异常，如下：

http://localhost:63040/content/course

HTTP/1.1 500 
Content-Type: application/json
Transfer-Encoding: chunked
Date: Wed, 07 Sep 2022 11:40:29 GMT
Connection: close

{
  "timestamp": "2022-09-07T11:40:29.677+00:00",
  "status": 500,
  "error": "Internal Server Error",
  "message": "",
  "path": "/content/course"
}

  • 问题：并没有输出我们抛出异常时指定的异常信息

    • 我们要求当非正常流程时要获取异常信息进行记录，并提示给用户。异常处理除了输出在日志中，还需要提示给用户，前端和后端需要作一些约定：

      • 错误提示信息统一以json格式返回给前端。
      • 以HTTP状态码决定当前是否出错，非200为操作异常。

      这里我们前端能显示后端抛出的异常信息就是因为前后端统一了异常对象：
      前端：在这里插入图片描述
      后端：在这里插入图片描述

      • 如何规范异常信息？

    • 代码中统一抛出项目的自定义异常类型，这样可以统一去捕获这一类或几类的异常。规范了异常类型就可以去获取异常信息。如果捕获了非项目自定义的异常类型统一向用户提示“执行过程异常，请重试”的错误信息。

  • 如何捕获异常？

    • 代码统一用try/catch方式去捕获代码比较臃肿，可以通过SpringMVC提供的控制器增强类统一由一个类去完成异常的捕获。
      在这里插入图片描述

JSR303校验

前端请求后端接口传输参数，是在controller中校验还是在Service中校验？

答案是都需要校验，只是分工不同：

  • Contoller中校验请求参数的合法性，包括：必填项校验，数据格式校验，比如：是否是符合一定的日期格式，等。
  • Service中要校验的是业务规则相关的内容，比如：课程已经审核通过所以提交失败。

Service中根据业务规则去校验不方便写成通用代码，Controller中则可以将校验的代码写成通用代码。

早在JavaEE6规范中就定义了参数校验的规范，它就是JSR-303，它定义了Bean Validation，即对bean属性进行校验。SpringBoot提供了JSR-303的支持，它就是spring-boot-starter-validation，它的底层使用Hibernate Validator，Hibernate Validator是Bean Validation 的参考实现。

所以，我们准备在Controller层使用spring-boot-starter-validation完成对请求参数的基本合法性进行校验。

引入的相关依赖：

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

校验注解以及规则如下：
在这里插入图片描述

使用步骤：

  • 引入依赖
  • 在模型类的属性上添加校验注解
  • 在Controller的模型类之前使用@Validated注解，开启校验
  • 校验出错Spring会抛出MethodArgumentNotValidException异常，我们需要在统一异常处理器中捕获异常，解析出异常信息
@ResponseBody
@ExceptionHandler(MethodArgumentNotValidException.class)
@ResponseStatus(HttpStatus.INTERNAL_SERVER_ERROR)
public RestErrorResponse methodArgumentNotValidException(MethodArgumentNotValidException e) {
    BindingResult bindingResult = e.getBindingResult();
    List<String> msgList = new ArrayList<>();
    //将错误信息放在msgList
    bindingResult.getFieldErrors().stream().forEach(item->msgList.add(item.getDefaultMessage()));
    //拼接错误信息
    String msg = StringUtils.join(msgList, ",");
    log.error("【系统异常】{}",msg);
    return new RestErrorResponse(msg);
}

分组校验

有时候在同一个属性上设置一个校验规则不能满足要求，比如：订单编号由系统生成，在添加订单时要求订单编号为空，在更新 订单时要求订单编写不能为空。此时就用到了分组校验，同一个属性定义多个校验规则属于不同的分组，比如：添加订单定义@NULL规则属于insert分组，更新订单定义@NotEmpty规则属于update分组，insert和update是分组的名称，是可以修改的。
下边举例说明
我们用class类型来表示不同的分组，所以我们定义不同的接口类型（空接口）表示不同的分组，由于校验分组是公用的，所以定义在 base工程中。如下：

package com.xuecheng.base.execption;
 /**
 * @description 校验分组
 * @author Mr.M
 * @date 2022/9/8 15:05
 * @version 1.0
 */
public class ValidationGroups {

 public interface Inster{};
 public interface Update{};
 public interface Delete{};

}

下边在定义校验规则时指定分组：

@NotEmpty(groups = {ValidationGroups.Inster.class},message = "添加课程名称不能为空")
 @NotEmpty(groups = {ValidationGroups.Update.class},message = "修改课程名称不能为空")
// @NotEmpty(message = "课程名称不能为空")
 @ApiModelProperty(value = "课程名称", required = true)
 private String name;

在Controller方法中启动校验规则指定要使用的分组名：

@ApiOperation("新增课程基础信息")
@PostMapping("/course")
public CourseBaseInfoDto createCourseBase(@RequestBody @Validated({ValidationGroups.Inster.class}) AddCourseDto addCourseDto){
    //机构id，由于认证系统没有上线暂时硬编码
    Long companyId = 1L;
  return courseBaseInfoService.createCourseBase(companyId,addCourseDto);
}

再次测试，由于这里指定了Insert分组，所以抛出 异常信息：添加课程名称不能为空。

如果修改分组为ValidationGroups.Update.class，异常信息为：修改课程名称不能为空。

查询课程计划

我们这里也是一个树形结构的查询，前面我们查询出来之后是在业务层使用stream流进行处理之后再返回给前端。这里我们使用另外一种处理查询出来的数据，也就是mybatis自带的ResultMap。

我们想要如下的结构：
在这里插入图片描述

我们将查询出来的结果经过ResultMap的映射之后就可以得到我们想要的形式：

你可以简单地理解为ResultMap就是把查询到的每一条数据，按照你配置的规则映射到你给定的模型类中去。

    <!-- 课程分类树型结构查询映射结果 -->
    <resultMap id="treeNodeResultMap" type="com.xuecheng.content.model.dto.TeachplanDto">
        <!-- 一级数据映射 -->
        <id     column="one_id"        property="id" />
        <result column="one_pname"      property="pname" />
        <result column="one_parentid"     property="parentid" />
        <result column="one_grade"  property="grade" />
        <result column="one_mediaType"   property="mediaType" />
        <result column="one_stratTime"   property="stratTime" />
        <result column="one_endTime"   property="endTime" />
        <result column="one_orderby"   property="orderby" />
        <result column="one_courseId"   property="courseId" />
        <result column="one_coursePubId"   property="coursePubId" />
        <!-- 一级中包含多个二级数据 -->
        <collection property="teachPlanTreeNodes" ofType="com.xuecheng.content.model.dto.TeachplanDto">
            <!-- 二级数据映射 -->
            <id     column="two_id"        property="id" />
            <result column="two_pname"      property="pname" />
            <result column="two_parentid"     property="parentid" />
            <result column="two_grade"  property="grade" />
            <result column="two_mediaType"   property="mediaType" />
            <result column="two_stratTime"   property="stratTime" />
            <result column="two_endTime"   property="endTime" />
            <result column="two_orderby"   property="orderby" />
            <result column="two_courseId"   property="courseId" />
            <result column="two_coursePubId"   property="coursePubId" />
            <association property="teachplanMedia" javaType="com.xuecheng.content.model.po.TeachplanMedia">
                <result column="teachplanMeidaId"   property="id" />
                <result column="mediaFilename"   property="mediaFilename" />
                <result column="mediaId"   property="mediaId" />
                <result column="two_id"   property="teachplanId" />
                <result column="two_courseId"   property="courseId" />
                <result column="two_coursePubId"   property="coursePubId" />
            </association>
        </collection>
    </resultMap>
    <!--课程计划树型结构查询-->
    <select id="selectTreeNodes" resultMap="treeNodeResultMap" parameterType="long" >
        select
            one.id             one_id,
            one.pname          one_pname,
            one.parentid       one_parentid,
            one.grade          one_grade,
            one.media_type     one_mediaType,
            one.start_time     one_stratTime,
            one.end_time       one_endTime,
            one.orderby        one_orderby,
            one.course_id      one_courseId,
            one.course_pub_id  one_coursePubId,
            two.id             two_id,
            two.pname          two_pname,
            two.parentid       two_parentid,
            two.grade          two_grade,
            two.media_type     two_mediaType,
            two.start_time     two_stratTime,
            two.end_time       two_endTime,
            two.orderby        two_orderby,
            two.course_id      two_courseId,
            two.course_pub_id  two_coursePubId,
            m1.media_fileName mediaFilename,
            m1.id teachplanMeidaId,
            m1.media_id mediaId

        from teachplan one
                 LEFT JOIN teachplan two on one.id = two.parentid
                 LEFT JOIN teachplan_media m1 on m1.teachplan_id = two.id
        where one.parentid = 0 and one.course_id=#{value}
        order by one.orderby,
                 two.orderby
    </select>

注意这里的自连接要使用left join 如果使用inner join的话，我们在新增章节时候是查询不出来的(也就是不会显示)。

项目实战部分

这一部分文档里面没有给出代码，所以这里给出我的代码供大家参考。

删除课程计划

注意点如下：

  • 删除第一级别的大章节时要求大章节下边没有小章节时方可删除。
  • 删除第二级别的小章节的同时需要将teachplan_media表关联的信息也删除。

接口：

Request URL: /content/teachplan/246
Request Method: DELETE

如果失败返回：
{"errCode":"120409","errMessage":"课程计划信息还有子级信息，无法操作"}

如果成功：状态码200，不返回信息

业务层代码：

    @Resource
    private TeachplanMediaMapper teachplanMediaMapper;

    /**
     * 删除课程计划
     * @param teachplanId
     */
    @Override
    @Transactional
    public void deleteTeachplan(Long teachplanId) {
        //首先判断该课程计划是大章节还是小章节
        Teachplan teachplan = teachplanMapper.selectById(teachplanId);

        //如果不存在则直接返回错误
        if (teachplan == null) {
            throw new XueChengPlusException("该课程信息不存在");
        }

        if (teachplan.getGrade().equals(1)) {
            //说明是大章节

            //判断此大章节下是否有小章节
            LambdaQueryWrapper<Teachplan> teachplanLambdaQueryWrapper = new LambdaQueryWrapper<>();

            teachplanLambdaQueryWrapper.eq(Teachplan::getParentid,teachplan.getId());

            Integer count = teachplanMapper.selectCount(teachplanLambdaQueryWrapper);

            if (count > 0) {
                //说明大章节下有小章节，返回错误
                throw new XueChengPlusException("课程计划信息还有子级信息，无法操作");
            }

            //执行删除操作
            teachplanMapper.deleteById(teachplanId);

            return;
        }

        //说明是小章节

        //首先删除小章节
        int i = teachplanMapper.deleteById(teachplanId);

        if (i > 0) {
            //删除小章节成功再删除媒资信息
            LambdaQueryWrapper<TeachplanMedia> teachplanMediaLambdaQueryWrapper = new LambdaQueryWrapper<>();

            teachplanMediaLambdaQueryWrapper.eq(TeachplanMedia::getTeachplanId,teachplanId);

            teachplanMediaMapper.delete(teachplanMediaLambdaQueryWrapper);

        }
    }

课程计划排序

在这里插入图片描述
注意点；

  • 向上移动后和上边同级的课程计划交换位置，可以将两个课程计划的排序字段值进行交换
  • 向下移动后和下边同级的课程计划交换位置，可以将两个课程计划的排序字段值进行交换
  • 边缘位置的判断
    • 第一名的上移
    • 最后一名的下移

接口定义：

向下移动：

Request URL: http://localhost:8601/api/content/teachplan/movedown/43
Request Method: POST
  • 参数1：movedown 为 移动类型，表示向下移动
  • 参数2：43为课程计划id

向上移动：

Request URL: http://localhost:8601/api/content/teachplan/moveup/43
Request Method: POST
  • 参数1：moveup 为 移动类型，表示向上移动
  • 参数2：43为课程计划id

每次移动传递两个参数：

  • 移动类型: movedown和moveup
  • 课程计划id

业务代码如下：

    /**
     * 控制课程计划的上下移动
     * @param type
     * @param id
     */
    @Override
    @Transactional
    public void moveTeachplan(String type, Long id) {
        //首先判断该课程计划是否存在
        Teachplan teachplan = teachplanMapper.selectById(id);

        if (teachplan == null) {
            throw new XueChengPlusException("该课程计划不存在");
        }

        //获取当前课程计划的同级课程计划个数,为后面的业务做准备
        LambdaQueryWrapper<Teachplan> teachplanLambdaQueryWrapper = new LambdaQueryWrapper<>();

        teachplanLambdaQueryWrapper.eq(Teachplan::getCourseId,teachplan.getCourseId())
                .eq(Teachplan::getGrade,teachplan.getGrade())
                .eq(Teachplan::getParentid,teachplan.getParentid());

        Integer count = teachplanMapper.selectCount(teachplanLambdaQueryWrapper);

        //查询当前课程计划的排序序号
        Integer orderby = teachplan.getOrderby();

        //处理向上移动的情况
        if ("moveup".equals(type)) {

            //如果是第一位则不做任何处理
            if (orderby.equals(1)) {
                return;
            }

            //获得前面的plan
            Teachplan teachplanSwap = teachplanMapper.selectOne(
                    teachplanLambdaQueryWrapper.eq(Teachplan::getOrderby, orderby - 1)
            );

            //将当前plan排序-1
            LambdaUpdateWrapper<Teachplan> teachplanLambdaUpdateWrapper = new LambdaUpdateWrapper<>();

            teachplanLambdaUpdateWrapper.set(Teachplan::getOrderby,orderby - 1)
                                        .eq(Teachplan::getId,teachplan.getId());

            teachplanMapper.update(null,teachplanLambdaUpdateWrapper);



            //将前面plan的排序 + 1
            teachplanMapper.update(
                    null,
                    new LambdaUpdateWrapper<Teachplan>()
                            .set(Teachplan::getOrderby, teachplanSwap.getOrderby() + 1)
                            .eq(Teachplan::getId, teachplanSwap.getId())
            );

            return;
        }

        //处理向下移动的情况

        //如果是最后一位则不做任何处理
        if (orderby.equals(count)) {
            return;
        }

        //获得后面的plan
        Teachplan teachplanSwap = teachplanMapper.selectOne(
                teachplanLambdaQueryWrapper.eq(Teachplan::getOrderby, orderby + 1)
        );

        //将当前plan排序+1
        LambdaUpdateWrapper<Teachplan> teachplanLambdaUpdateWrapper = new LambdaUpdateWrapper<>();

        teachplanLambdaUpdateWrapper.set(Teachplan::getOrderby,orderby + 1)
                                    .eq(Teachplan::getId,teachplan.getId());;

        teachplanMapper.update(null,teachplanLambdaUpdateWrapper);


        //将后面plan的排序 - 1
        teachplanMapper.update(
                null,
                new LambdaUpdateWrapper<Teachplan>()
                        .set(Teachplan::getOrderby,teachplanSwap.getOrderby() - 1)
                        .eq(Teachplan::getId, teachplanSwap.getId())
        );
    }

两个注意点：

  • 判定同一级别的条件
    • 同一个courseid
    • 同一个grade
    • 同一个parentid
  • 我们在获取排在前面或者后面的元素的时候，一定是在当前元素更新之前，如果在更新之后去获取，会得到两个结果(更新之后当前元素的order发生了变化)而报错。

师资管理

查询教师接口：

get /courseTeacher/list/75
75为课程id，请求参数为课程id

响应结果
[{"id":23,"courseId":75,"teacherName":"张老师","position":"讲师","introduction":"张老师教师简介张老师教师简介张老师教师简介张老师教师简介","photograph":null,"createDate":null}]

添加教师接口：

post  /courseTeacher

请求参数：
{
  "courseId": 75,
  "teacherName": "王老师",
  "position": "教师职位",
  "introduction": "教师简介"
}
响应结果：
{"id":24,"courseId":75,"teacherName":"王老师","position":"教师职位","introduction":"教师简介","photograph":null,"createDate":null}

修改教师接口：

post /courseTeacher
请求参数：
{
  "id": 24,
  "courseId": 75,
  "teacherName": "王老师",
  "position": "教师职位",
  "introduction": "教师简介",
  "photograph": null,
  "createDate": null
}
响应：
{"id":24,"courseId":75,"teacherName":"王老师","position":"教师职位","introduction":"教师简介","photograph":null,"createDate":null}

删除教师接口：

delete /ourseTeacher/course/75/26

75:课程id
26:教师id，即course_teacher表的主键
请求参数：课程id、教师id

响应：状态码200，不返回信息

注意：

  • 只允许向机构自己的课程中添加老师、删除老师

业务代码：

/**
 * @author 十八岁讨厌编程
 * @date 2023/4/8 12:23
 * @PROJECT_NAME xuecheng_plus
 * @description
 */

@Service
public class CourseTeacherServiceImpl implements CourseTeacherService {

    @Resource
    private CourseTeacherMapper courseTeacherMapper;

    /**
     * 教师列表查询
     * @param id
     * @return
     */
    @Override
    public List<CourseTeacher> courseTeacherList(Long id) {
        LambdaQueryWrapper<CourseTeacher> courseTeacherLambdaQueryWrapper = new LambdaQueryWrapper<>();

        courseTeacherLambdaQueryWrapper.eq(CourseTeacher::getCourseId,id);

        return courseTeacherMapper.selectList(courseTeacherLambdaQueryWrapper);
    }

    /**
     * 添加&修改教师
     * @param dto
     * @return
     */
    @Override
    public CourseTeacher courseTeacherAddOrUpdate(CourseTeacher dto) {
        //如果没有id说明为添加
        if (dto.getId() == null) {
            CourseTeacher courseTeacher = new CourseTeacher();

            BeanUtils.copyProperties(dto,courseTeacher);

            courseTeacherMapper.insert(courseTeacher);

            return courseTeacherMapper.selectOne(
                    new LambdaQueryWrapper<CourseTeacher>()
                            .eq(CourseTeacher::getCourseId,dto.getCourseId())
                            .eq(CourseTeacher::getTeacherName,dto.getTeacherName())
            );
        }

        //有id说明为修改
        courseTeacherMapper.updateById(dto);

        return courseTeacherMapper.selectById(dto.getId());
    }

    /**
     * 删除教师
     * @param courseId
     * @param teacherId
     */
    @Override
    public void courseTeacherDelete(Long courseId, Long teacherId) {

        courseTeacherMapper.delete(
                new LambdaQueryWrapper<CourseTeacher>()
                        .eq(CourseTeacher::getCourseId,courseId)
                        .eq(CourseTeacher::getId,teacherId)
        );
    }

}

删除课程

删除课程接口；

delete  /course/87
87为课程id
请求参数：课程id
响应：状态码200，不返回信息

注意：

  • 课程的审核状态为未提交时方可删除(也就是auditStatus为202002)
  • 删除课程需要删除课程相关的基本信息、营销信息、课程计划、课程教师信息
    /**
     * 删除课程信息
     * @param courseId
     */
    @Override
    @Transactional
    public void deleteCourseBase(Long courseId) {
        //判断审核状态
        CourseBase courseBase = courseBaseMapper.selectById(courseId);

        if (!courseBase.getAuditStatus().equals("202002")) return;

        //审核状态为未提交时方可删除

        //删除基本信息
        courseBaseMapper.deleteById(courseId);

        //删除营销信息
        courseMarketMapper.deleteById(courseId);

        //删除课程计划
        teachplanMapper.delete(
                new LambdaQueryWrapper<Teachplan>().eq(Teachplan::getCourseId,courseId)
        );

        //删除课程计划的媒资信息
        teachplanMediaMapper.delete(
                new LambdaQueryWrapper<TeachplanMedia>().eq(TeachplanMedia::getCourseId,courseId)
        );

        //删除课程教师信息
        courseTeacherMapper.delete(
                new LambdaQueryWrapper<CourseTeacher>().eq(CourseTeacher::getCourseId,courseId)
        );
    }
十八岁讨厌编程
关注
  • 4
    点赞
  • 踩
  • 10
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
专栏目录
专题12解三角形重难点、易错点突破.docx
01-27
专题12解三角形重难点、易错点突破.docx
【微服务 | 学成在线】项目易错重难点分析（媒资管理模块篇·下）
十八岁讨厌编程的博客
05-04 1347
本文涉及项目中视频处理相关的内容，例如分布式任务调度、XXL-JOB、分片广播、分布式锁等内容。
六年级数学重难点易错题集锦PPT教案学习.pptx
10-02
六年级数学重难点易错题集锦PPT教案学习.pptx
系统集成项目管理工程师经典易错题
03-26
内容包括系统集成项目管理工程师经典易错题 适合自学系统集成项目管理工程师的同学 如有问题，欢迎私信
通用版中考化学重难点易错点复习讲练巧学盐的性质含解析
09-09
通用版中考化学重难点易错点复习讲练巧学盐的性质含解析
学成在线总结（1）
wmh1152151276的博客
05-17 6474
学成在线是一个在线教育平台，提供IT职业课程在线学习，它有门户、课程管理中心、系统管理中心、学习中心等系统。 门户系统负责，注册登录、门户首页展示、课程搜索等功能。 教学管理中心提供：课程管理、媒资管理、问答管理等功能。 系统管理中心提供：CMS页面管理、数据字典、分类管理等功能。 本项目采用前后端分离的技术架构、前端采用vue.js+elementui技术栈、后端采用springboot + s...
黑马程序员-学成在线项目总结
pillow233的博客
05-10 1369
基础公共样式清除默认样式，例如内边距、外边距、项目符号等等设置通用样式，例如：文字样式项目结构注:多个css文件引入顺序，先清除，后设置版心效果许多网页整体都有版心居中，可将版心样式设为通用css若有通栏（水平方向铺满）则多嵌套一层div即可整体布局方法先整体后局部，从左往右，层层递进，善用flex布局，例下图第一步：本模块为通栏效果，则先设置通栏div的效果第二步：设置版心样式，分析可知，内容左右两部分，采用flex布局。
第一章--学成在线--项目介绍&环境搭建
Kaka_csdn14的博客
06-05 2147
本文是黑马项目学成在线的学习,仅仅用作个人复习练习使用
2023年最新黑马程序员Java微服务项目--学成在线
技术专家
01-13 6796
Java人必学的微服务项目上线
《学成在线》微服务实战项目实操笔记系列（P1~P83）【上】
RuanFun的博客
02-04 4545
《学成在线》项目实操笔记系列【下】，跟视频的每一P对应，全系列12万字，涵盖详细步骤与问题的解决方案。如果你操作到某一步卡壳，参考这篇，相信会带给你极大启发。
中考物理电学综合问题难点和易错点整理.doc
04-04
中考物理电学综合问题难点和易错点整理
自学学成在线第一天遇到的坑和自我总结
SeveCc博客
07-09 558
我在学习中遇到的问题 Nginx配的时候成功访问会报404，可能是Nginx开的太多，自己查看进程，结束后重新开下就可以。 引入项目的时候会报这个这样的错，差报这个为解决 安装mongoDB。配置mongo.conf,里面要配置会老报错，当初忘了截屏了，可以主要就是要创建文件夹（data目录）、日志路径（logs目录）和日志文件（mongo.log文件），看下里面路径是否正确，命令的–可能是中文的 4.创建 xc-service-manage-cms时候pom文件，将里面的所有的-自己改成英
微服务实战项目-学成在线-项目部署
爪蛙毁一生的博客
08-12 1262
DevOps兴起于2009年，近年来由于云计算、互联网的发展，促进了DevOps的基础设施及工具链的发展，涌现了一大批优秀的工具，这些工具包括开发、测试、运维的各各领域，例如：GitHub、Docker、Jenkins、Hudson、K8S、Ant/Maven/Gradle、Selenium、QUnit、JMeter等。在持续交付的基础上由开发人员或运维人员自助式的定期向生产环境部署稳定的构建版本，持续部署的目标是代码在任何时刻都是可部署的，并可自动进入到生产环境。使用CI/CD后通过自动化的工具去完成。
学成在线笔记+踩坑（5）——【媒资模块】上传视频，断点续传
vincewm的博客
04-22 2170
上传视频，MinIO断点续传、检查文件/分块、上传分块、合并分块
学成在线小项目
weixin_48650082的博客
05-21 1852
前言 在学完 Html 和 CSS 基础后，跟着黑马的视频教程，写了一个网页，叫做学成在线，是纯 Html 和 CSS 写的，没有交互功能。刚接触前端的小伙伴可以用来练手哦，话不多说，咱们先看看这个网页长啥样子吧！ 学成在线网页展示： index.css * { margin: 0; padding: 0; /* 内减模式，避免盒子被撑大 */ box-sizing: border-box; } /* 清除li的小圆点 */ li { list-style:
《学成在线》微服务实战项目实操笔记系列（P92~P120）【下】
最新发布
RuanFun的博客
02-17 1931
《学成在线》项目实操笔记系列【下】，跟视频的每一P对应，全系列12万字，涵盖详细步骤与问题的解决方案。如果你操作到某一步卡壳，参考这篇，相信会带给你极大启发。
学成在线笔记+踩坑（1）——项目思路、架构、父工程和基础工程，Gogs使用
vincewm的博客
04-19 4202
项目思路、架构、父工程和基础工程，Gogs使用
微服务实战项目-学成在线-内容管理模块(有项目实战实现)
爪蛙毁一生的博客
05-30 2257
下边从查询条件、查询列表两个方面分析数据模型 1、查询条件： 包括：课程名称、课程审核状态、课程发布状态 课程名称：可以模糊搜索 课程审核状态：未提交、已提交、审核通过、审核未通过 课程发布状态：未发布、已发布、已下线 因为是分页查询所以查询条件中还要包括当前页码、每页显示记录数。
实战 - 学成在线项目
你今天真好看呀
08-20 1431
文章目录01. 环境搭建02. 页面查询接口定义2.1 模型类（实体类）介绍2.2 定义请求类型2.3 定义响应类型2.3 分页查询接口定义03. 创建CMS服务工程04. 分页查询CmsPage接口测试05. Swagger常用注解06. 新增页面接口开发与测试07. 修改页面接口开发与测试08. 删除页面接口开发与测试09. 异常处理9.1 异常处理的问题分析9.2 异常处理流程9.3 可预知异常处理9.4 不可预知异常处理 用于练习SpringData MongoDB的增删改查，但是找的项目有点老，导
请根据以上语文、数学、英语的重点、难点、易错点内容列出详细知识点和例题
05-31
好的，以下是根据语文、数学、英语的重点、难点、易错点内容列出的详细知识点和例题： 一、数学 1.1 基础知识 - 加减乘除：四则运算的基本规则； - 分数：分数的定义和分数的加减乘除运算； - 小数：小数的定义和小数的加减乘除运算； - 几何图形：常见的几何图形，如正方形、长方形、圆形等。 例题：小明有 3 个苹果，小红有 2 个苹果，那么他们一共有几个苹果？ 1.2 应用题 - 物品的购买：如若干个物品的价格及数量，求总价； - 比例：如两个数的比，求其中一个数； - 面积、周长：如长方形、正方形等图形的面积、周长。 例题：一条长方形的长是 5 厘米，宽是 3 厘米，它的面积是多少？ 1.3 难点 - 长除法：如两个数相除，商有小数，被除数有余数，如何计算； - 分数的加减乘除：分数的加减乘除需要通分，计算时需要注意； - 解方程：如何通过方程求解未知数的值。 例题：计算 8 ÷ 3 的商和余数。 1.4 易错点 - 计算错误：如漏算、错算； - 题意理解不清：如未理解题意，导致答案错误。 例题：一本书的原价是 40 元，现在降价 20%，打折后的价格是多少？ 二、语文 2.1 词语积累 - 近义词：同一个意思的词语； - 反义词：相反意思的词语； - 成语：固定搭配的词语。 例题：将下列词语中的近义词选出来：善良、好心、仁慈、友善。 2.2 词语搭配 - 形容词和名词的搭配； - 动词和宾语的搭配； - 副词和动词的搭配。 例题：下列句子中哪个词语的搭配不正确？A. 热情地欢迎；B. 暴躁的性格；C. 活泼的小狗。 2.3 阅读理解 - 理解文章的主旨； - 理解文章的细节； - 理解文章的含义。 例题：阅读下面的短文，回答问题。孔子是中国古代的一位哲学家，他的思想对中国的历史产生了深远的影响。孔子的哪些思想对中国的历史产生了深远的影响？ 2.4 作文 - 作文的格式； - 作文的结构； - 作文的语言表达。 例题：写一篇关于我的家乡的作文。 三、英语 3.1 词汇积累 - 单词：英语单词的拼写和发音； - 短语：英语常用短语的含义和用法； - 语法：英语语法的基本规则。 例题：下列单词中哪个单词的拼写不正确？A. sunflower；B. beutiful；C. elephant。 3.2 阅读理解 - 理解文章的主旨； - 理解文章的细节； - 理解文章的含义。 例题：阅读下面的短文，回答问题。Tom is a student. He likes playing football. He often plays football with his friends after school. What does Tom like? When does Tom often play football? 3.3 口语表达 - 口语的基本用语； - 口语的语音语调； - 口语的表达技巧。 例题：请你用英语问候老师。 以上是针对语文、数学、英语的重点、难点、易错点列出的详细知识点和例题，希望能对你的学习有所帮助。

“相关推荐”对你有帮助么？

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

十八岁讨厌编程

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值