在线学习平台-项目搭建
在线学习平台-需求分析
若依的基本使用
通过分析可知,班级模块的结构会比较简单,可以先从班级模块入手
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的内容
@Autowiredprivate 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,不是MsClassPageVoLambdaQueryWrapper<MsClass> qw = new LambdaQueryWrapper();//模糊查询,没传参数的时候不执行qw.like(StringUtils.isNotEmpty(className),MsClass::getClassName,className);qw.ne(MsClass::getDelFlag,"2");//假删后的内容不需要查出来//按降序来显示,最近添加的放在最上面qw.orderByDesc(MsClass::getCreateTime);//page对象,这里的实体类是MsClass,不是MsClassPageVoPage<MsClass> page = msClassService.page(new Page<>(pager.getPageNum(),pager.getPageSize()),qw);//这个时候再把MsClass转成MsClassPageVoList<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*/@Overridepublic 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*/@Overridepublic 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类型,需要转成MsClassDtlVoMsClassDtlVo 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));}