用户管理
添加功能增强
新增属性
若依里的用户模块(SysUser)是没有课程这一属性的,要实现我们自己的课程分页查询功能
这个位置传入的实体类SysUser要加上classId,记得加上get、set方法
更改sql语句
ctrl + 鼠标左键不断点进去,查看调用位置
加入swagger文档:
package com.ruoyi.web.controller.system.SysUserController加上Api(tags = "用户管理")
在add方法上加ApiOperation("用户添加")
user_name是账号,nick_name才是昵称
所需参数
修改功能增强
和添加操作一样,需要在sql语句那边加上classId属性
查询功能
修改之前要写上先写查询功能
也和添加操作一样,一直点到sql语句的位置
课程模块:
班级名称和教师名称是采用关联的方式得到
前期准备:
先在domain自动生成实体类MsCourse
用lombok代替get、set方法,数据类型都改成包装类
设置实体类的自动递增、主键、自动填充
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 com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;import java.util.Date;@Data
public class MsCourse {@TableId(type = IdType.AUTO)private Long courseId;private String courseName;private String courseCover;private Long classId;private Long teacherId;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)//设置返回格式@JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")private Date updateTime;private String remark;}
分页查询课程
先在package com.mashang.elearing.domain.vo;生成对应的Vo
package com.mashang.elearing.domain.vo;import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;@ApiModel("查询课程分页")
@Data
public class MsCoursePageVo {@ApiModelProperty("课程id")private Long courseId;@ApiModelProperty("课程名称")private String courseName;@ApiModelProperty("课程封面")private String courseCover;@ApiModelProperty("班级id")private Long classId;@ApiModelProperty("班级名称")private String className;@ApiModelProperty("教师名称")private String teacherName;@ApiModelProperty("教师id")private Long teacherId;@ApiModelProperty("备注")private String remark;}
因为是关联查询,不能用MyBatis-Plus,只能老实用MyBatis
package com.mashang.elearing.mapper;在这个位置建一个接口MsCourseMapper
在resources下面建一个文件夹(directory)mapper,在mapper下建一个xml-MsCourseMapper,这一个xml里面要绑定上面的MsCourseMapper
第一步:
在package com.mashang.elearing.mapper里继承BaseMapper<MsCourse>,再写一个方法
//分页需要传入page对象和条件构造器对象,两个参数要用@Param区别,// 导入的都是mybatis-plus里的对象//@Param是导自于ibatis里的Page<MsCoursePageVo> page(@Param("page")Page<MsCoursePageVo> page,@Param(Constants.WRAPPER)Wrapper wrapper);
第二步:
去对应的xml实现这个方法
第三步
在service层建一个 IMsCourseService 继承 IService<MsCourse>
在serivce层下的impl包下建一个MsCourseServiceImpl 继承(extends) ServiceImpl<MsCouseMapper,MsCourse> 再 实现自己的 IMsCourseService接口
第四步
在IMsCourseSerive写上对应的方法
//Pager里面放了 pageNum,和pageSize,支持通过教师id和名称来搜索//教师id是用下拉框来实现的//班级名称是用模糊查询来实现的Page<MsCoursePageVo> page(Pager pager,Long teacherId,String courseName);
第五步
去MsCourseServiceImpl去实现这个方法
记得要注入Mapper层的对象
@Autowiredprivate MsCourseMapper msCourseMapper;@Overridepublic Page<MsCoursePageVo> page(Pager pager, Long teacherId, String courseName) {//拿到page对象Page<MsCoursePageVo> p = new Page<>(pager.getPageNum(),pager.getPageSize());//拿到构造器对象,这里只能用普通的QueryWrapper//关联查询不能使用lamdaQueryWrapperQueryWrapper<MsCoursePageVo> qw = new QueryWrapper<>();qw.ne("t1.del_flag",2);qw.eq(teacherId != null,"t1.teacher_id",teacherId);qw.like(StringUtils.isNotEmpty(courseName),"t1.course_name",courseName);qw.orderByDesc("t1.create_time");//page方法需要一个page对象和条件构造器对象return msCourseMapper.page(p,qw);}
按降序排列,把新增二点放在最前面
第六步:
创建控制层MsCourseController,控制层上记得写上@Api和@ApiOperation
固定写法@RestController和@RequestMapping("/course")记得写上
然后注入的是IMsCourseService
//这里注入的是Service层的那个接口@Autowiredprivate IMSCourseService msCourseService;@ApiOperation("分页查询")@GetMapping("/list")//TableData是用来返回分页数据的//@Validated参数验证,分页页码和条数必填public TableData<MsCoursePageVo> page(@Validated Pager pager, Long teacherId, String courseName){//msCourseService.page返回的是一个分页的Page对象Page<MsCoursePageVo> page = msCourseService.page(pager, teacherId, courseName);//注意这里返回的是集合List<MsCoursePageVo> records = page.getRecords();long total = page.getTotal();return TableData.success(records,total);}
添加接口
课程需要courseCover、courseName、classId、teacherId(下拉框)
设置要添加的的参数实体类
在params包下创建添加的实体类
com.mashang.elearing.domain.params.course;
package com.mashang.elearing.domain.params.course;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 MsCourseCreate {//课程Id可以在设置自动递增,courseId不用填@ApiModelProperty(value = "课程名称",required = true) //这里的required只是建议@NotBlank(message = "课程名称不能为空") //这里的NotBlank是必须的private String courseName;//NotBlank一般用于字符串//NotNull一般用于 Long@ApiModelProperty(value = "课程封面",required = true)@NotBlank(message = "封面不能为空")private String courseCover;@ApiModelProperty(value = "班级id",required = true)@NotNull(message = "班级id不能为空")private Long classId;@ApiModelProperty(value = "教师id",required = true)@NotNull(message = "教师id不能为null")private Long teacherId;@ApiModelProperty("备注")private String remark;}
添加调用的是save方法,传入的是MsCourse,需要将MsCourseCreate转成MsCourse
传参转化
在com.mashang.elearing.mapping包下建一个接口MsCourseMapping
MsCourseMapping INSTANCE = Mappers.getMapper(MsCourseMapping.class);List<MsClassPageVo> to(List<MsClass> msClasses);
代码
@ApiOperation("课程添加")@PostMappingpublic Result create(@RequestBody @Validated MsCourseCreate courseCreate){MsCourse msCourse = MsCourseMapping.INSTANCE.to(courseCreate);return Result.to(msCourseService.save(msCourse));}
修改接口
修改相较于添加,要多传入一个课程Id,courseId为主键
设置要修改的参数实体类
赋值添加接口的传参,在com.mashang.elearing.domain.params.course这个这个位置创建一个
MsCourseUpdate实体类,加上课程Id,其他和添加接口一致
传参转化
MsCourse to(MsCourseUpdate update);
代码
@ApiOperation("课程修改")@PutMapping//Json的形式传、并且需要参数验证public Result update(@RequestBody @Validated MsCourseUpdate update){MsCourse msCourse = MsCourseMapping.INSTANCE.to(update);return Result.to(msCourseService.updateById(msCourse));}
删除接口
删除采用的是假山,调用的是UpdateById
@ApiOperation("课程删除")@DeleteMapping("/{courseId}")// @PathVariable参数放在路径上public Result delete(@PathVariable Long courseId){MsCourse msCourse = new MsCourse();msCourse.setCourseId(courseId);msCourse.setDelFlag("2");return Result.to(msCourseService.updateById(msCourse));}
查询详情接口
一些没必要的字段不用查询出来,同样需要转
在com.mashang.elearing.domain.vo创建对应的Vo
package com.mashang.elearing.domain.vo;import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;@ApiModel("查询课程详情")
@Data
public class MsCourseDtlVo {@ApiModelProperty("课程id")private Long courseId;@ApiModelProperty("课程名称")private String courseName;@ApiModelProperty("课程封面")private String courseCover;@ApiModelProperty("班级id")private Long classId;@ApiModelProperty("班级名称")private String className;@ApiModelProperty("教师名称")private String teacherName;@ApiModelProperty("教师id")private Long teacherId;@ApiModelProperty("备注")private String remark;}
将MsCourse转成MsCourseDtlVo
MsCourseDtlVo to(MsCourse msCourse);