在线学习平台-班级模块

在线学习平台-项目搭建

在线学习平台-需求分析

若依的基本使用

通过分析可知,班级模块的结构会比较简单,可以先从班级模块入手

1.先在domain里写上班级里的属性

快捷方式:

时区可以这里找,时区和数据库名之间要加一个 '?'

右键需要的数据库模型,便可直接生成

生成的实体类不需要get、set方法,可以全部删掉,然后在类上面加上注解@data

数据类型要改成包装类

再配置好MyBatisPlus的一套流程:

第一步:

先在mapper新建一个接口:____Mapper,继承BaseMapper<里面放上对应的实体类模型>

第二步:

在service层建一个接口:I___Service,继承IService<里面放上对应的实体类模型>

第三步

在service层下面建一个实现类的包:Impl

在impl包下建一个实现I___Service的类 ___ServiceImpl,继承ServiceImpl<mapper,class>

控制层需要调用这个地方,要用@service注入.

到此为止,就可以在控制层实现对类基本的增删改查功能

将登入接口写入swagger

将验证码接口写入swagger

关于数据的返回类型:

        com.ruoyi.common.core.domain.R;

        com.ruoyi.common.core.page.TableDateinfo; (分页)

可以借用上面两个封装好的实体类返回

班级分析

班级除了一些常规字段，还需要备注、名称、班级id、同时还需要支持分页查询

代码编写

在控制层注入Service的内容

    @Autowired
    private IMsClassService msClassService;

想要实现分类操作,可以用msClassService里的page方法,

page方法需要传入page对象,

page对象需要传入分页信息(pageNum,pageSize)

最后会返回一个分页对象Page<实体类名称>

将分页参数封装成实体类

返回值类的选择

BaseController里面封装了一个TableDateinfo类型的方法getDateTable,需要传入一个list集合

但如果使用swagger,这个方法会用不了(swagger无法识别带有问好的参数)

此时启动会出现mapper层找不到的情况

因为这是我们自己写的增强模块,命名没有符号若依设定好的规则,需要自己配置扫描路径

配置扫描

通过全局搜索,寻找com.ruo.*

加上自己的模块,才能扫描出来

启动后,因为rows里面的参数是?,swagger识别不出来,需要外面自己写一个类来返回

返回值类

在自己的模块建一个core包(放一些通用的包),里面再建一个TableDate(用于返回分类数据的实体类)

里面的rows<T>要用泛型来传,swagger才能接收到,里面再生成它的构造器,和一些通用的方法

package com.mashang.elearing.core;

/*
统一返回实体类
 */

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

import java.util.List;

@ApiModel("分页数据")
@Data
public class TableData<T> {

    @ApiModelProperty("状态码")
    private Integer code;

    @ApiModelProperty("提示消息")
    private String msg;

    @ApiModelProperty("数据")
    private List<T> rows;

    @ApiModelProperty("总数量")
    private Long total;

    public TableData(Integer code, String msg, List<T> rows, Long total) {
        this.code = code;
        this.msg = msg;
        this.rows = rows;
        this.total = total;
    }

    public static TableData success(List list, Long total){
        return new TableData(200,"操作成功",list,total);
    }

}

版本问题

这个时候可能会出现sql语法问题,这种情况是plus的版本有问题

可以在common模块更改成3.5.1

实现班级模糊查询

在page方法里,除了可以传pageNum,和pageSize还可以传条件构造器 lamdaQueryWrapper

qw.like()方法,要支持不传入班级名称时不执行该方法,调用

LambdaQueryWrapper<MsClass> qw = new LambdaQueryWrapper();

        //模糊查询,没传参数的时候不执行
        qw.like(StringUtils.isNotEmpty(className),MsClass::getClassName,className);

来判断

配置日志:

在用swagger调试时,没有日志信息,不方便排查错误

可以在ruoyi-admin/logback.xml，加上我们自己的模块

mapstruct转化

此时查询出来的数据,并不是所有的数据(如updatetime之类的)都需要返回给前端,需要借助mapstruct依赖进行转化

mapstruct有个缺点,经常需要清缓存才能正常使用

在自己的模块移入依赖mapstruct

<dependency>
      <groupId>org.mapstruct</groupId>
      <artifactId>mapstruct</artifactId>
      <version>1.4.2.Final</version>
    </dependency>
    <dependency>
      <groupId>org.mapstruct</groupId>
      <artifactId>mapstruct-processor</artifactId>
      <version>1.4.2.Final</version>
    </dependency>

提取需要的字段

需求里只需要classId、className和remake,此时可以在domain下面搞一个Vo包来映射

package com.mashang.elearing.domain.vo; 在这个位置建MsClassPageVo

package com.mashang.elearing.domain.vo;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

@Data
@ApiModel("班级分页模型")
public class MsClassPageVo {

    @ApiModelProperty("班级主键")
    private  Long classId;

    @ApiModelProperty("班级名称")
    private String className;

    @ApiModelProperty("备注")
    private String remark;

}

具体操作

分页对象和条件构造器查询出来的都是msclass,需要在最后转成MsclassPageVo来返回

建一个mapping包,包下面放接口,命名为MsClassMapper

查询接口的最终代码

@ApiOperation("分页查询")
    @GetMapping("/list")
    public TableData<MsClassPageVo> test(String className, Pager pager){

        //条件构造器,这里的实体类是MsClass,不是MsClassPageVo
        LambdaQueryWrapper<MsClass> qw = new LambdaQueryWrapper();

        //模糊查询,没传参数的时候不执行
        qw.like(StringUtils.isNotEmpty(className),MsClass::getClassName,className);
        qw.ne(MsClass::getDelFlag,"2");//假删后的内容不需要查出来
        //按降序来显示,最近添加的放在最上面
        qw.orderByDesc(MsClass::getCreateTime);

        //page对象,这里的实体类是MsClass,不是MsClassPageVo
        Page<MsClass> page =  msClassService.page(
                new Page<>(pager.getPageNum(),pager.getPageSize()),qw);

        //这个时候再把MsClass转成MsClassPageVo
        List<MsClassPageVo> vos = MsClassMapping.INSTANCE.to(page.getRecords());

        return TableData.success(vos,page.getTotal());

    }

查询接口样例

添加接口

所需参数

添加时,只需要传classId、className和remake就行,其他不用。

如果直接用实体类MsClass传,前端会得到很多数据,可能会误导前端。

跟前面的查询一样,在domain单独搞一个包params,里面放前端需要的实体类传入,然后再转成MsClass。剩下那些创建者、创建时间之类的字段可以后端统一自动填充

package com.mashang.elearing.domain.params.clazz;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

import javax.validation.constraints.NotBlank;

@ApiModel("添加模型")
@Data
public class MsClassCreate {

    @ApiModelProperty(value = "班级名称",required = true)
    @NotBlank(message = "班级名称不能为空")
    private String className;

    @ApiModelProperty("备注")
    private String remark;

}

在mapping里面转

MsClass to(MsClassCreate create);

统一返回实体类

添加的返回值是boolean,为了适配,也能够返回一些信息,可以自己在core那里搞一个返回的实体类

package com.mashang.elearing.core;

import io.swagger.annotations.ApiModel;
import lombok.Data;

@ApiModel("操作响应对象")
@Data
public class Result<T> {

    private Integer code;

    private String msg;

    private T data;

    public Result(Integer code, String msg, T data) {
        this.code = code;
        this.msg = msg;
        this.data = data;
    }

    public static Result success(Object data){
        return new Result(200,"操作成功",data);
    }

    public static Result success(){
        return new Result(200,"操作成功",null);
    }

    public static Result error(){
        return new Result(500,"操作失败",null);
    }

    public static Result error(String msg){
        return new Result(500,msg,null);
    }

    public static Result to(boolean rs){
        return rs ? success() : error();
    }
    public static Result to(int rs){
        return rs > 0? success() : error();
    }
}

操作完后只需要知道成功与失败,不需要返回具体信息

自动填充类

创建一个handle包,里面创建FiledHanlder(用来自动填充不需要传的字段)

createBy和updateBy是用户的账号

package com.mashang.elearing.handler;

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import com.ruoyi.common.utils.SecurityUtils;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;

import java.util.Date;

@Component
public class FieldHandler implements MetaObjectHandler {
    /**
     * 插入时的填充策略
     *
     * @param metaObject
     */
    @Override
    public void insertFill(MetaObject metaObject) {
        this.setFieldValByName("createTime", new Date(), metaObject);
        this.setFieldValByName("updateTime", new Date(), metaObject);
        this.setFieldValByName("createBy", SecurityUtils.getUsername(),metaObject);
        this.setFieldValByName("updateBy", SecurityUtils.getUsername(),metaObject);
    }

    /**
     * 更新时的填充策略
     *
     * @param metaObject
     */
    @Override
    public void updateFill(MetaObject metaObject) {
        this.setFieldValByName("updateTime", new Date(), metaObject);
        this.setFieldValByName("updateBy", SecurityUtils.getUsername(),metaObject);
    }

}

然后在实体类上加上注解,以后这些字段有需要的话就自动填充

在MsClass添加自动填充

package com.mashang.elearing.domain;


import com.baomidou.mybatisplus.annotation.FieldFill;
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import lombok.Data;

import java.util.Date;

@Data
public class MsClass {

  @TableId(type = IdType.AUTO)
  private Long classId;
  private String className;


  private String delFlag;

  @TableField(fill = FieldFill.INSERT)
  private String createBy;

  @TableField(fill = FieldFill.INSERT)
  private Date createTime;

  @TableField(fill = FieldFill.INSERT_UPDATE)
  private String updateBy;

  @TableField(fill = FieldFill.INSERT_UPDATE)
  private Date updateTime;

  private String remark;

}

一些小规范

导入swagger参数验证的依赖@Validated,防止一些空值传入

<dependency>
      <groupId>org.hibernate.validator</groupId>
      <artifactId>hibernate-validator</artifactId>
      <version>6.2.3.Final</version>
      <scope>compile</scope>
    </dependency>

@Notblank:不能为空也不能为空字符串

添加接口的最终代码

    @ApiOperation("添加")
    @PostMapping
//    @RequestBody以json的格式传
    public Result create(@RequestBody @Validated MsClassCreate create){

        MsClass msClass = MsClassMapping.INSTANCE.to(create);
//        msClass.setCreateTime(new Date());
//        msClass.setCreateBy(getUsername());   //有自动填充就不需要自习设置
        return Result.to(msClassService.save(msClass));
    }

修改接口

参照添加接口,更改参数，在mapping里转化。updateById传入的MsClass对象,但是msclass里的内容不是都需要给前端的,所以需要转化将MsClassDtlVo转成MsClass

第一步:

在domain的params包下创建需要的实体类MsClassDtlVo

package com.mashang.elearing.domain.params.clazz;

import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

import javax.validation.constraints.NotBlank;
import javax.validation.constraints.NotNull;

@ApiModel("班级修改模型")
@Data
public class MsClassUpdate {


    @NotNull(message = "班级id不能为空")
    private Long classId;

    @ApiModelProperty(value = "班级名称",required = true)
    @NotBlank(message = "班级名称不能为空")
    private String className;

    @ApiModelProperty("备注")
    private String remark;

}

修改,classId和班级名称都是必传,要用@Validated验证

第二步:

跟之前一样,需要在mapping里面转

修改接口需要的是MsClass,将传入的MsClassUpdate转成MsClass

MsClass to(MsClassUpdate update);

最后代码

@ApiOperation("修改")
    @PutMapping
    //@RequestBody以json的格式传
    public Result update(@RequestBody @Validated MsClassUpdate update){

        MsClass msClass = MsClassMapping.INSTANCE.to(update);

        return Result.to(msClassService.updateById(msClass));
    }

要再写查询接口,每次点击修改,要把之前的信息查出来

查询详情接口

package com.mashang.elearing.domain.vo;

import com.baomidou.mybatisplus.annotation.TableId;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

@ApiModel("班级详情模型")
@Data
public class MsClassDtlVo {

    @ApiModelProperty("班级主键")
    private  Long classId;

    @ApiModelProperty("班级名称")
    private String className;

    @ApiModelProperty("备注")
    private String remark;
}

第一步

查询出来的是MsClass对象,然后把再把它转成MsClassDtlVo

第二步

在domain的Vo创建MsClassDtlVo

package com.mashang.elearing.domain.vo;

import com.baomidou.mybatisplus.annotation.TableId;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;

@ApiModel("班级详情模型")
@Data
public class MsClassDtlVo {

    @ApiModelProperty("班级主键")
    private  Long classId;

    @ApiModelProperty("班级名称")
    private String className;

    @ApiModelProperty("备注")
    private String remark;
}

第三步

在mapping里的MsClassMapping加上下面这段代码

MsClassDtlVo to(MsClass msClass);

TableId

ById结尾的方法默认用Id属性,如果命名不是id的话,需要去实体类配置

查询详情接口代码

 @ApiOperation("查询详情")
    @GetMapping("/{id}")
    //@RequestBody以json的格式传
    //@PathVariable 把参数放在路径上
    public Result<MsClassDtlVo> getById(@PathVariable Long id){
        //getById  查出来的是Msclass对象,其中不是所有数据都需要返回,可以转成前端需要展现的内容
        //getById返回值是MsClass类型,需要转成MsClassDtlVo
        MsClassDtlVo dtlVo = MsClassMapping.INSTANCE.to(msClassService.getById(id));
        return Result.success(dtlVo);
    }

删除接口

删除接口用的是假删,不是调用removeById,而是用updateById,传入MsClass对象

把MsClass对象的DelFlag 设置成2

只需要返回成功与失败,不需要返回删除了什么内容

 @ApiOperation("删除")
    @DeleteMapping("/{id}")
    public Result delete(@PathVariable Long id){
        MsClass msClass = new MsClass();
        msClass.setClassId(id);
        msClass.setDelFlag("2");
        return Result.to(msClassService.updateById(msClass));
    }