pzk6utiap
/
test
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

1

Browse Source
ShenHailiang_branch
shl 9 months ago
parent 1b60ce86be
commit 22d20a181a
62 changed files with 2399 additions and 2284 deletions
Show Stats Download Patch File Download Diff File

13
src-源文件/main/java/com/yf/exam/modules/Constant.java
Unescape View File

@ -1,14 +1,15 @@
package com.yf.exam.modules;
package com.yf.exam.modules; // 包名：表示该类属于 modules 包
/**
* 通用常量
* @author bool
* 通用常量类
* 用于存放项目中使用的常量
* @作者 bool
*/
public class Constant {
/**
* 会话
* 会话常量
* 用于存放 Token 的常量名
*/
public static final String TOKEN = "token";
public static final String TOKEN = "token"; // 定义一个常量 TOKEN，表示会话中的 Token 名称
}

182
src-源文件/main/java/com/yf/exam/modules/repo/controller/RepoController.java
Unescape View File

@ -1,117 +1,113 @@
package com.yf.exam.modules.repo.controller;
package com.yf.exam.modules.repo.controller; // 包名：表示该类属于 repo.controller 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.BaseIdReqDTO;
import com.yf.exam.core.api.dto.BaseIdsReqDTO;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.qu.dto.request.QuRepoBatchReqDTO;
import com.yf.exam.modules.qu.service.QuRepoService;
import com.yf.exam.modules.repo.dto.RepoDTO;
import com.yf.exam.modules.repo.dto.request.RepoReqDTO;
import com.yf.exam.modules.repo.dto.response.RepoRespDTO;
import com.yf.exam.modules.repo.entity.Repo;
import com.yf.exam.modules.repo.service.RepoService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.shiro.authz.annotation.RequiresRoles;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
// 导入所需的类和包
import com.baomidou.mybatisplus.core.metadata.IPage; // 分页元数据接口
import com.yf.exam.core.api.ApiRest; // 统一 API 响应类
import com.yf.exam.core.api.controller.BaseController; // 控制器基类，提供通用控制功能
import com.yf.exam.core.api.dto.BaseIdReqDTO; // 数据传输对象，用于封装单个 ID 请求
import com.yf.exam.core.api.dto.BaseIdsReqDTO; // 数据传输对象，用于封装多个 ID 请求
import com.yf.exam.core.api.dto.PagingReqDTO; // 数据传输对象，用于分页请求
import com.yf.exam.modules.qu.dto.request.QuRepoBatchReqDTO; // 数据传输对象，用于题库批量操作请求
import com.yf.exam.modules.qu.service.QuRepoService; // 服务接口，用于题库的批量操作
import com.yf.exam.modules.repo.dto.RepoDTO; // 数据传输对象，封装题库信息
import com.yf.exam.modules.repo.dto.request.RepoReqDTO; // 数据传输对象，用于题库分页查询请求
import com.yf.exam.modules.repo.dto.response.RepoRespDTO; // 数据传输对象，用于题库分页查询响应
import com.yf.exam.modules.repo.entity.Repo; // 题库实体类
import com.yf.exam.modules.repo.service.RepoService; // 服务接口，用于题库操作
import io.swagger.annotations.Api; // Swagger 注解，用于 API 文档生成
import io.swagger.annotations.ApiOperation; // Swagger 注解，用于定义接口操作说明
import org.apache.shiro.authz.annotation.RequiresRoles; // Shiro 注解，用于权限控制
import org.springframework.beans.BeanUtils; // 工具类，用于对象属性拷贝
import org.springframework.beans.factory.annotation.Autowired; // Spring 注解，用于依赖注入
import org.springframework.web.bind.annotation.RequestBody; // 注解，用于绑定请求体
import org.springframework.web.bind.annotation.RequestMapping; // 注解，用于定义请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 注解，用于指定 HTTP 请求方法
import org.springframework.web.bind.annotation.RestController; // 注解，标识为 REST 控制器
/**
* <p>
* 题库控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:25
*/
@Api(tags={"题库"})
@RestController
@RequestMapping("/exam/api/repo")
public class RepoController extends BaseController {
* <p>
* 题库控制器
* </p>
* 定义用于操作题库的控制器
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:25
*/
@Api(tags = {"题库"}) // Swagger 注解：定义 API 文档中该控制器的标签为“题库”
@RestController // Spring 注解：标识该类为 REST 控制器
@RequestMapping("/exam/api/repo") // 定义请求路径前缀为 /exam/api/repo
public class RepoController extends BaseController { // 题库控制器类，继承基础控制器
@Autowired
@Autowired // 自动注入题库服务
private RepoService baseService;
@Autowired
@Autowired // 自动注入题库批量操作服务
private QuRepoService quRepoService;
/**
* 添加或修改
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "添加或修改")
@RequestMapping(value = "/save", method = { RequestMethod.POST})
public ApiRest save(@RequestBody RepoDTO reqDTO) {
baseService.save(reqDTO);
return super.success();
* 添加或修改题库
* @param reqDTO 请求数据传输对象，包含题库信息
* @return 返回操作结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "添加或修改") // Swagger 注解：定义接口操作说明为“添加或修改”
@RequestMapping(value = "/save", method = {RequestMethod.POST}) // 定义请求路径为 /save，请求方法为 POST
public ApiRest save(@RequestBody RepoDTO reqDTO) { // 添加或修改题库的方法
baseService.save(reqDTO); // 调用服务保存题库信息
return super.success(); // 返回成功结果
}
/**
* 批量删除
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "批量删除")
@RequestMapping(value = "/delete", method = { RequestMethod.POST})
public ApiRest edit(@RequestBody BaseIdsReqDTO reqDTO) {
//根据ID删除
baseService.removeByIds(reqDTO.getIds());
return super.success();
* 批量删除题库
* @param reqDTO 请求数据传输对象，包含待删除的题库 ID 列表
* @return 返回操作结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "批量删除") // Swagger 注解：定义接口操作说明为“批量删除”
@RequestMapping(value = "/delete", method = {RequestMethod.POST}) // 定义请求路径为 /delete，请求方法为 POST
public ApiRest edit(@RequestBody BaseIdsReqDTO reqDTO) { // 批量删除题库的方法
baseService.removeByIds(reqDTO.getIds()); // 根据 ID 列表删除题库
return super.success(); // 返回成功结果
}
/**
* 查找详情
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "查找详情")
@RequestMapping(value = "/detail", method = { RequestMethod.POST})
public ApiRest<RepoDTO> find(@RequestBody BaseIdReqDTO reqDTO) {
Repo entity = baseService.getById(reqDTO.getId());
RepoDTO dto = new RepoDTO();
BeanUtils.copyProperties(entity, dto);
return super.success(dto);
* 查找题库详情
* @param reqDTO 请求数据传输对象，包含待查找的题库 ID
* @return 返回题库详情
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "查找详情") // Swagger 注解：定义接口操作说明为“查找详情”
@RequestMapping(value = "/detail", method = {RequestMethod.POST}) // 定义请求路径为 /detail，请求方法为 POST
public ApiRest<RepoDTO> find(@RequestBody BaseIdReqDTO reqDTO) { // 查找题库详情的方法
Repo entity = baseService.getById(reqDTO.getId()); // 根据 ID 查找题库实体
RepoDTO dto = new RepoDTO(); // 创建题库数据传输对象
BeanUtils.copyProperties(entity, dto); // 将实体属性拷贝到 DTO 中
return super.success(dto); // 返回成功结果，包含题库详情
}
/**
* 分页查找
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
public ApiRest<IPage<RepoRespDTO>> paging(@RequestBody PagingReqDTO<RepoReqDTO> reqDTO) {
//分页查询并转换
IPage<RepoRespDTO> page = baseService.paging(reqDTO);
return super.success(page);
* 分页查找题库
* @param reqDTO 分页请求数据传输对象，包含分页参数和查询条件
* @return 返回分页结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "分页查找") // Swagger 注解：定义接口操作说明为“分页查找”
@RequestMapping(value = "/paging", method = {RequestMethod.POST}) // 定义请求路径为 /paging，请求方法为 POST
public ApiRest<IPage<RepoRespDTO>> paging(@RequestBody PagingReqDTO<RepoReqDTO> reqDTO) { // 分页查找题库的方法
IPage<RepoRespDTO> page = baseService.paging(reqDTO); // 调用服务进行分页查询
return super.success(page); // 返回成功结果，包含分页数据
}
/**
* 批量操作
* @param reqDTO
* @return
* 批量操作题库
* @param reqDTO 请求数据传输对象，包含批量操作的参数
* @return 返回操作结果
*/
@RequiresRoles("sa")
@ApiOperation(value = "批量操作", notes = "批量加入或从题库移除")
@RequestMapping(value = "/batch-action", method = { RequestMethod.POST})
public ApiRest batchAction(@RequestBody QuRepoBatchReqDTO reqDTO) {
//分页查询并转换
quRepoService.batchAction(reqDTO);
return super.success();
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "批量操作", notes = "批量加入或从题库移除") // Swagger 注解：定义接口操作说明为“批量操作”，并提供备注
@RequestMapping(value = "/batch-action", method = {RequestMethod.POST}) // 定义请求路径为 /batch-action，请求方法为 POST
public ApiRest batchAction(@RequestBody QuRepoBatchReqDTO reqDTO) { // 批量操作题库的方法
quRepoService.batchAction(reqDTO); // 调用服务执行批量操作
return super.success(); // 返回成功结果
}
}

61
src-源文件/main/java/com/yf/exam/modules/repo/dto/RepoDTO.java
Unescape View File

@ -1,43 +1,42 @@
package com.yf.exam.modules.repo.dto;
package com.yf.exam.modules.repo.dto; // 包名：表示该类属于 repo.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.util.Date;
import java.io.Serializable; // 导入 Serializable 接口，用于支持序列化
import java.util.Date; // 导入 Date 类，用于处理日期和时间
/**
* <p>
* 题库请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
@Data
@ApiModel(value="题库", description="题库")
public class RepoDTO implements Serializable {
* <p>
* 题库请求类
* </p>
* 定义题库的通用数据传输对象
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "题库", description = "题库") // Swagger 注解，定义该类的 API 模型名称及描述
public class RepoDTO implements Serializable { // 定义类 RepoDTO，实现 Serializable 接口以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "题库ID", required = true) // Swagger 注解，描述该属性为“题库 ID”
private String id; // 定义属性：题库的唯一标识符
@ApiModelProperty(value = "题库ID", required=true)
private String id;
@ApiModelProperty(value = "题库编号", required = true) // Swagger 注解，描述该属性为“题库编号”
private String code; // 定义属性：题库编号
@ApiModelProperty(value = "题库编号", required=true)
private String code;
@ApiModelProperty(value = "题库名称", required = true) // Swagger 注解，描述该属性为“题库名称”
private String title; // 定义属性：题库名称
@ApiModelProperty(value = "题库名称", required=true)
private String title;
@ApiModelProperty(value = "题库备注", required = true) // Swagger 注解，描述该属性为“题库备注”
private String remark; // 定义属性：题库备注信息
@ApiModelProperty(value = "题库备注", required=true)
private String remark;
@ApiModelProperty(value = "创建时间", required = true) // Swagger 注解，描述该属性为“创建时间”
private Date createTime; // 定义属性：题库的创建时间
@ApiModelProperty(value = "创建时间", required=true)
private Date createTime;
@ApiModelProperty(value = "更新时间", required=true)
private Date updateTime;
@ApiModelProperty(value = "更新时间", required = true) // Swagger 注解，描述该属性为“更新时间”
private Date updateTime; // 定义属性：题库的最后更新时间
}

44
src-源文件/main/java/com/yf/exam/modules/repo/dto/request/RepoReqDTO.java
Unescape View File

@ -1,30 +1,30 @@
package com.yf.exam.modules.repo.dto.request;
package com.yf.exam.modules.repo.dto.request; // 包名：表示该类属于 repo.dto.request 包
import com.yf.exam.modules.repo.dto.RepoDTO;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import com.yf.exam.modules.repo.dto.RepoDTO; // 导入 RepoDTO 类，题库数据传输对象
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.util.List;
import java.util.List; // 导入 Java 的 List 接口，用于存储排除的题库 ID 列表
/**
* <p>
* 题库请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
@Data
@ApiModel(value="题库分页请求类", description="题库分页请求类")
public class RepoReqDTO extends RepoDTO {
* <p>
* 题库分页请求类
* </p>
* 定义用于题库分页查询的请求数据传输对象
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "题库分页请求类", description = "题库分页请求类") // Swagger 注解，定义该类的 API 模型名称及描述
public class RepoReqDTO extends RepoDTO { // 定义类 RepoReqDTO，继承自 RepoDTO
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "排除题库ID", required=true)
private List<String> excludes;
@ApiModelProperty(value = "单选题数量", required=true)
private String title;
@ApiModelProperty(value = "排除题库ID", required = true) // Swagger 注解，描述该属性为“需要排除的题库 ID 列表”
private List<String> excludes; // 定义属性：排除的题库 ID 列表
@ApiModelProperty(value = "单选题数量", required = true) // Swagger 注解，描述该属性为“单选题数量”
private String title; // 定义属性：单选题数量（注意：变量名可能存在歧义，建议确认或重命名）
}

46
src-源文件/main/java/com/yf/exam/modules/repo/dto/response/RepoRespDTO.java
Unescape View File

@ -1,31 +1,31 @@
package com.yf.exam.modules.repo.dto.response;
package com.yf.exam.modules.repo.dto.response; // 包名：表示该类属于 repo.dto.response 包
import com.yf.exam.modules.repo.dto.RepoDTO;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import com.yf.exam.modules.repo.dto.RepoDTO; // 导入 RepoDTO 类，题库通用数据传输对象
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
/**
* <p>
* 题库请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
@Data
@ApiModel(value="题库分页响应类", description="题库分页响应类")
public class RepoRespDTO extends RepoDTO {
* <p>
* 题库分页响应类
* </p>
* 定义用于分页查询的题库响应数据传输对象
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "题库分页响应类", description = "题库分页响应类") // Swagger 注解，定义该类的 API 模型名称及描述
public class RepoRespDTO extends RepoDTO { // 定义类 RepoRespDTO，继承自 RepoDTO
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "多选题数量", required=true)
private Integer multiCount;
@ApiModelProperty(value = "多选题数量", required = true) // Swagger 注解，描述该属性为“多选题数量”
private Integer multiCount; // 定义属性：多选题的数量
@ApiModelProperty(value = "单选题数量", required=true)
private Integer radioCount;
@ApiModelProperty(value = "判断题数量", required=true)
private Integer judgeCount;
@ApiModelProperty(value = "单选题数量", required = true) // Swagger 注解，描述该属性为“单选题数量”
private Integer radioCount; // 定义属性：单选题的数量
@ApiModelProperty(value = "判断题数量", required = true) // Swagger 注解，描述该属性为“判断题数量”
private Integer judgeCount; // 定义属性：判断题的数量
}

60
src-源文件/main/java/com/yf/exam/modules/repo/entity/Repo.java
Unescape View File

@ -1,59 +1,59 @@
package com.yf.exam.modules.repo.entity;
package com.yf.exam.modules.repo.entity; // 包名：表示该类属于 repo.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于定义主键类型
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于映射数据库字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于标识主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于映射数据库表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus ActiveRecord 模式基类
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.util.Date;
import java.util.Date; // 导入 Java 的 Date 类，用于表示日期和时间
/**
* <p>
* 题库实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
@Data
@TableName("el_repo")
public class Repo extends Model<Repo> {
private static final long serialVersionUID = 1L;
* <p>
* 题库实体类
* </p>
* 定义题库的数据库实体类
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("el_repo") // MyBatis-Plus 注解，指定该实体类映射的数据库表名为 "el_repo"
public class Repo extends Model<Repo> { // 定义类 Repo，继承 MyBatis-Plus 的 Model 类以支持 ActiveRecord 模式
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
/**
* 题库ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，标识主键字段，并指定主键生成策略为分配 ID
private String id; // 定义字段：题库的唯一标识符
/**
* 题库编号
*/
private String code;
private String code; // 定义字段：题库编号
/**
* 题库名称
*/
private String title;
private String title; // 定义字段：题库名称
/**
* 题库备注
*/
private String remark;
private String remark; // 定义字段：题库备注信息
/**
* 创建时间
*/
@TableField("create_time")
private Date createTime;
@TableField("create_time") // MyBatis-Plus 注解，指定该字段映射数据库中的 "create_time" 列
private Date createTime; // 定义字段：题库的创建时间
/**
* 更新时间
*/
@TableField("update_time")
private Date updateTime;
@TableField("update_time") // MyBatis-Plus 注解，指定该字段映射数据库中的 "update_time" 列
private Date updateTime; // 定义字段：题库的最后更新时间
}

42
src-源文件/main/java/com/yf/exam/modules/repo/mapper/RepoMapper.java
Unescape View File

@ -1,29 +1,29 @@
package com.yf.exam.modules.repo.mapper;
package com.yf.exam.modules.repo.mapper; // 包名：表示该类属于 repo.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.yf.exam.modules.repo.dto.request.RepoReqDTO;
import com.yf.exam.modules.repo.dto.response.RepoRespDTO;
import com.yf.exam.modules.repo.entity.Repo;
import org.apache.ibatis.annotations.Param;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，用于基本的数据库操作
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 分页插件中的 Page 类
import com.yf.exam.modules.repo.dto.request.RepoReqDTO; // 导入用于分页查询的请求数据传输对象 RepoReqDTO
import com.yf.exam.modules.repo.dto.response.RepoRespDTO; // 导入用于分页查询的响应数据传输对象 RepoRespDTO
import com.yf.exam.modules.repo.entity.Repo; // 导入题库实体类 Repo
import org.apache.ibatis.annotations.Param; // 导入 MyBatis 注解，用于标注参数
/**
* <p>
* 题库Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
public interface RepoMapper extends BaseMapper<Repo> {
* <p>
* 题库Mapper
* </p>
* 定义题库的 Mapper 接口，用于执行与题库相关的数据库操作
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
public interface RepoMapper extends BaseMapper<Repo> { // RepoMapper 接口，继承自 MyBatis-Plus 的 BaseMapper，提供常见的数据库操作
/**
* 分页查询题库
* @param page
* @param query
* @return
* @param page 分页对象，包含当前页码和每页大小
* @param query 查询条件，封装了题库分页查询的参数
* @return 返回分页查询结果，包含多个题库的响应数据
*/
IPage<RepoRespDTO> paging(Page page, @Param("query") RepoReqDTO query);
IPage<RepoRespDTO> paging(Page page, @Param("query") RepoReqDTO query); // 自定义分页查询方法，返回题库分页响应数据
}

50
src-源文件/main/java/com/yf/exam/modules/repo/service/RepoService.java
Unescape View File

@ -1,34 +1,34 @@
package com.yf.exam.modules.repo.service;
package com.yf.exam.modules.repo.service; // 包名：表示该类属于 repo.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.repo.dto.RepoDTO;
import com.yf.exam.modules.repo.dto.request.RepoReqDTO;
import com.yf.exam.modules.repo.dto.response.RepoRespDTO;
import com.yf.exam.modules.repo.entity.Repo;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 服务接口，提供通用的数据库操作
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.modules.repo.dto.RepoDTO; // 导入 RepoDTO 类，题库数据传输对象
import com.yf.exam.modules.repo.dto.request.RepoReqDTO; // 导入 RepoReqDTO 类，用于封装分页查询条件
import com.yf.exam.modules.repo.dto.response.RepoRespDTO; // 导入 RepoRespDTO 类，题库分页响应数据传输对象
import com.yf.exam.modules.repo.entity.Repo; // 导入 Repo 实体类，表示题库
/**
* <p>
* 题库业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
public interface RepoService extends IService<Repo> {
* <p>
* 题库业务类
* </p>
* 该接口定义了题库的业务逻辑，继承自 MyBatis-Plus 提供的 IService 接口，简化了数据库操作
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
public interface RepoService extends IService<Repo> { // RepoService 接口，继承 MyBatis-Plus 的 IService，提供常见数据库操作
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<RepoRespDTO> paging(PagingReqDTO<RepoReqDTO> reqDTO);
* 分页查询数据
* @param reqDTO 请求数据传输对象，包含分页信息和查询条件
* @return 返回分页查询结果，包含题库响应数据
*/
IPage<RepoRespDTO> paging(PagingReqDTO<RepoReqDTO> reqDTO); // 分页查询方法，接收分页请求数据对象，并返回分页结果
/**
* 保存
* @param reqDTO
* 保存题库
* @param reqDTO 请求数据传输对象，包含题库信息
*/
void save(RepoDTO reqDTO);
void save(RepoDTO reqDTO); // 保存题库方法，用于保存或更新题库信息
}

62
src-源文件/main/java/com/yf/exam/modules/repo/service/impl/RepoServiceImpl.java
Unescape View File

@ -1,39 +1,49 @@
package com.yf.exam.modules.repo.service.impl;
package com.yf.exam.modules.repo.service.impl; // 包名：表示该类属于 repo.service.impl 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.repo.dto.RepoDTO;
import com.yf.exam.modules.repo.dto.request.RepoReqDTO;
import com.yf.exam.modules.repo.dto.response.RepoRespDTO;
import com.yf.exam.modules.repo.entity.Repo;
import com.yf.exam.modules.repo.mapper.RepoMapper;
import com.yf.exam.modules.repo.service.RepoService;
import org.springframework.stereotype.Service;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 服务实现类，用于提供通用的数据库操作
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.repo.dto.RepoDTO; // 导入 RepoDTO，题库数据传输对象
import com.yf.exam.modules.repo.dto.request.RepoReqDTO; // 导入 RepoReqDTO，封装分页查询条件的请求数据传输对象
import com.yf.exam.modules.repo.dto.response.RepoRespDTO; // 导入 RepoRespDTO，题库分页响应数据传输对象
import com.yf.exam.modules.repo.entity.Repo; // 导入 Repo 实体类，表示题库实体
import com.yf.exam.modules.repo.mapper.RepoMapper; // 导入 RepoMapper，数据访问层接口
import com.yf.exam.modules.repo.service.RepoService; // 导入 RepoService，题库服务接口
import org.springframework.stereotype.Service; // 导入 Spring 的 Service 注解，标识该类为服务层组件
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-25 13:23
*/
@Service
public class RepoServiceImpl extends ServiceImpl<RepoMapper, Repo> implements RepoService {
* <p>
* 题库服务实现类
* </p>
* 该类实现了 RepoService 接口，处理题库相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-05-25 13:23
*/
@Service // Spring 注解，标识该类为服务层组件
public class RepoServiceImpl extends ServiceImpl<RepoMapper, Repo> implements RepoService { // 继承 MyBatis-Plus 提供的 ServiceImpl，简化数据库操作
/**
* 分页查询题库
* @param reqDTO 请求数据传输对象，包含分页信息和查询条件
* @return 返回分页查询结果
*/
@Override
public IPage<RepoRespDTO> paging(PagingReqDTO<RepoReqDTO> reqDTO) {
return baseMapper.paging(reqDTO.toPage(), reqDTO.getParams());
return baseMapper.paging(reqDTO.toPage(), reqDTO.getParams()); // 调用 Mapper 的分页查询方法，传入分页信息和查询条件
}
/**
* 添加或修改题库
* @param reqDTO 请求数据传输对象，包含题库信息
*/
@Override
public void save(RepoDTO reqDTO) {
//复制参数
Repo entity = new Repo();
BeanMapper.copy(reqDTO, entity);
this.saveOrUpdate(entity);
// 复制参数，将请求数据传输对象的属性复制到实体类中
Repo entity = new Repo(); // 创建 Repo 实体对象
BeanMapper.copy(reqDTO, entity); // 使用 BeanMapper 工具类复制属性
this.saveOrUpdate(entity); // 调用 MyBatis-Plus 提供的 saveOrUpdate 方法，保存或更新实体
}
}

107
src-源文件/main/java/com/yf/exam/modules/sys/config/controller/SysConfigController.java
Unescape View File

@ -1,70 +1,71 @@
package com.yf.exam.modules.sys.config.controller;
package com.yf.exam.modules.sys.config.controller; // 包名：表示该类属于 sys.config.controller 包
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.BaseIdRespDTO;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.qu.utils.ImageCheckUtils;
import com.yf.exam.modules.sys.config.dto.SysConfigDTO;
import com.yf.exam.modules.sys.config.entity.SysConfig;
import com.yf.exam.modules.sys.config.service.SysConfigService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.shiro.authz.annotation.RequiresRoles;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import com.yf.exam.core.api.ApiRest; // 导入统一的 API 响应类
import com.yf.exam.core.api.controller.BaseController; // 导入控制器基类，提供通用的控制器功能
import com.yf.exam.core.api.dto.BaseIdRespDTO; // 导入基础响应 DTO，用于返回 ID 响应
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.qu.utils.ImageCheckUtils; // 导入图片检查工具类，用于校验图片地址
import com.yf.exam.modules.sys.config.dto.SysConfigDTO; // 导入 SysConfigDTO 类，用于封装系统配置的数据传输对象
import com.yf.exam.modules.sys.config.entity.SysConfig; // 导入 SysConfig 实体类，表示系统配置
import com.yf.exam.modules.sys.config.service.SysConfigService; // 导入 SysConfigService 服务接口
import io.swagger.annotations.Api; // 导入 Swagger 注解，用于 API 文档生成
import io.swagger.annotations.ApiOperation; // 导入 Swagger 注解，用于定义接口操作说明
import org.apache.shiro.authz.annotation.RequiresRoles; // 导入 Shiro 权限控制注解，限制角色访问
import org.springframework.beans.factory.annotation.Autowired; // 导入 Spring 注解，用于依赖注入
import org.springframework.web.bind.annotation.RequestBody; // 导入注解，用于绑定请求体
import org.springframework.web.bind.annotation.RequestMapping; // 导入注解，用于定义请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入注解，用于指定请求方法
import org.springframework.web.bind.annotation.RestController; // 导入注解，标识该类为 REST 控制器
/**
* <p>
* 通用配置控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
@Api(tags={"通用配置"})
@RestController
@RequestMapping("/exam/api/sys/config")
public class SysConfigController extends BaseController {
* <p>
* 通用配置控制器
* </p>
* 提供与系统配置相关的操作接口，包括添加、修改、查找配置等
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
@Api(tags = {"通用配置"}) // Swagger 注解：定义该类的 API 文档标签为“通用配置”
@RestController // Spring 注解：标识该类为 REST 控制器
@RequestMapping("/exam/api/sys/config") // 定义请求路径前缀为 /exam/api/sys/config
public class SysConfigController extends BaseController { // SysConfigController 类，继承自 BaseController，提供通用功能
@Autowired
@Autowired // 自动注入 SysConfigService 服务
private SysConfigService baseService;
@Autowired
@Autowired // 自动注入 ImageCheckUtils 工具类
private ImageCheckUtils imageCheckUtils;
/**
* 添加或修改
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "添加或修改")
@RequestMapping(value = "/save", method = { RequestMethod.POST})
public ApiRest<BaseIdRespDTO> save(@RequestBody SysConfigDTO reqDTO) {
* 添加或修改系统配置
* @param reqDTO 请求数据传输对象，包含系统配置的信息
* @return 返回包含新增或修改的系统配置 ID 的响应
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "添加或修改") // Swagger 注解：定义接口操作说明为“添加或修改”
@RequestMapping(value = "/save", method = { RequestMethod.POST}) // 定义请求路径为 /save，方法为 POST
public ApiRest<BaseIdRespDTO> save(@RequestBody SysConfigDTO reqDTO) { // 定义保存或修改系统配置的方法
//复制参数
SysConfig entity = new SysConfig();
BeanMapper.copy(reqDTO, entity);
// 复制请求参数到实体对象
SysConfig entity = new SysConfig(); // 创建 SysConfig 实体对象
BeanMapper.copy(reqDTO, entity); // 使用 BeanMapper 工具类将 DTO 的属性拷贝到实体对象
// 校验图片地址
imageCheckUtils.checkImage(entity.getBackLogo(), "系统LOGO地址错误！");
// 校验图片地址是否有效
imageCheckUtils.checkImage(entity.getBackLogo(), "系统LOGO地址错误！"); // 检查系统LOGO地址是否有效
baseService.saveOrUpdate(entity);
return super.success(new BaseIdRespDTO(entity.getId()));
baseService.saveOrUpdate(entity); // 调用服务的保存或更新方法
return super.success(new BaseIdRespDTO(entity.getId())); // 返回成功响应，并包含系统配置 ID
}
/**
* 查找详情
* @return
*/
@ApiOperation(value = "查找详情")
@RequestMapping(value = "/detail", method = { RequestMethod.POST})
public ApiRest<SysConfigDTO> find() {
SysConfigDTO dto = baseService.find();
return super.success(dto);
* 查找系统配置详情
* @return 返回系统配置详情
*/
@ApiOperation(value = "查找详情") // Swagger 注解：定义接口操作说明为“查找详情”
@RequestMapping(value = "/detail", method = { RequestMethod.POST}) // 定义请求路径为 /detail，方法为 POST
public ApiRest<SysConfigDTO> find() { // 定义查找系统配置详情的方法
SysConfigDTO dto = baseService.find(); // 调用服务查找系统配置详情
return super.success(dto); // 返回成功响应，包含系统配置详情
}
}

67
src-源文件/main/java/com/yf/exam/modules/sys/config/dto/SysConfigDTO.java
Unescape View File

@ -1,39 +1,38 @@
package com.yf.exam.modules.sys.config.dto;
package com.yf.exam.modules.sys.config.dto; // 包名：表示该类属于 sys.config.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于对象序列化
/**
* <p>
* 通用配置请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
@Data
@ApiModel(value="通用配置", description="通用配置")
public class SysConfigDTO implements Serializable {
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "系统名称")
private String siteName;
@ApiModelProperty(value = "前端LOGO")
private String frontLogo;
@ApiModelProperty(value = "后台LOGO")
private String backLogo;
@ApiModelProperty(value = "版权信息")
private String copyRight;
* <p>
* 通用配置请求类
* </p>
* 该类封装了通用配置的数据传输对象，用于在 API 请求中传递系统配置数据
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "通用配置", description = "通用配置") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysConfigDTO implements Serializable { // 定义 SysConfigDTO 类，实现 Serializable 接口以支持序列化
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：系统配置的唯一标识符
@ApiModelProperty(value = "系统名称") // Swagger 注解：描述该属性为“系统名称”
private String siteName; // 定义字段：系统名称
@ApiModelProperty(value = "前端LOGO") // Swagger 注解：描述该属性为“前端LOGO”
private String frontLogo; // 定义字段：前端展示用的 LOGO 图片地址
@ApiModelProperty(value = "后台LOGO") // Swagger 注解：描述该属性为“后台LOGO”
private String backLogo; // 定义字段：后台管理用的 LOGO 图片地址
@ApiModelProperty(value = "版权信息") // Swagger 注解：描述该属性为“版权信息”
private String copyRight; // 定义字段：版权信息
}

59
src-源文件/main/java/com/yf/exam/modules/sys/config/entity/SysConfig.java
Unescape View File

@ -1,53 +1,54 @@
package com.yf.exam.modules.sys.config.entity;
package com.yf.exam.modules.sys.config.entity; // 包名：表示该类属于 sys.config.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于定义主键类型
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于映射数据库字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于标识主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于映射数据库表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus ActiveRecord 模式基类
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
/**
* <p>
* 通用配置实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
@Data
@TableName("sys_config")
public class SysConfig extends Model<SysConfig> {
private static final long serialVersionUID = 1L;
* <p>
* 通用配置实体类
* </p>
* 表示系统配置的数据模型，映射数据库表 `sys_config`
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("sys_config") // MyBatis-Plus 注解，指定该实体类映射数据库表名为 `sys_config`
public class SysConfig extends Model<SysConfig> { // SysConfig 类继承自 MyBatis-Plus 的 Model 类，启用 ActiveRecord 模式
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
/**
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，标识主键字段，并指定主键生成策略为分配 ID
private String id; // 定义字段：系统配置的唯一标识符
/**
* 系统名称
*/
@TableField("site_name")
private String siteName;
@TableField("site_name") // MyBatis-Plus 注解，指定该字段映射数据库中的 "site_name" 列
private String siteName; // 定义字段：系统名称
/**
* 前端LOGO
*/
@TableField("front_logo")
private String frontLogo;
@TableField("front_logo") // MyBatis-Plus 注解，指定该字段映射数据库中的 "front_logo" 列
private String frontLogo; // 定义字段：前端展示的 LOGO 图片地址
/**
* 后台LOGO
*/
@TableField("back_logo")
private String backLogo;
@TableField("back_logo") // MyBatis-Plus 注解，指定该字段映射数据库中的 "back_logo" 列
private String backLogo; // 定义字段：后台管理系统的 LOGO 图片地址
/**
* 版权信息
*/
@TableField("copy_right")
private String copyRight;
@TableField("copy_right") // MyBatis-Plus 注解，指定该字段映射数据库中的 "copy_right" 列
private String copyRight; // 定义字段：版权信息
}

24
src-源文件/main/java/com/yf/exam/modules/sys/config/mapper/SysConfigMapper.java
Unescape View File

@ -1,16 +1,18 @@
package com.yf.exam.modules.sys.config.mapper;
package com.yf.exam.modules.sys.config.mapper; // 包名：表示该类属于 sys.config.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yf.exam.modules.sys.config.entity.SysConfig;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，用于基本的数据库操作
import com.yf.exam.modules.sys.config.entity.SysConfig; // 导入 SysConfig 实体类，表示系统配置
/**
* <p>
* 通用配置Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
public interface SysConfigMapper extends BaseMapper<SysConfig> {
* <p>
* 通用配置Mapper
* </p>
* 该接口继承自 MyBatis-Plus 的 BaseMapper，提供通用的数据库操作
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
public interface SysConfigMapper extends BaseMapper<SysConfig> { // SysConfigMapper 接口，继承自 MyBatis-Plus 的 BaseMapper
// 该接口继承了 BaseMapper<SysConfig>，因此自动具备了 CRUD 方法，无需手动实现
}

29
src-源文件/main/java/com/yf/exam/modules/sys/config/service/SysConfigService.java
Unescape View File

@ -1,22 +1,23 @@
package com.yf.exam.modules.sys.config.service;
package com.yf.exam.modules.sys.config.service; // 包名：表示该类属于 sys.config.service 包
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.modules.sys.config.dto.SysConfigDTO;
import com.yf.exam.modules.sys.config.entity.SysConfig;
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 提供的 IService 接口，提供通用的数据库操作
import com.yf.exam.modules.sys.config.dto.SysConfigDTO; // 导入 SysConfigDTO 类，封装系统配置的数据传输对象
import com.yf.exam.modules.sys.config.entity.SysConfig; // 导入 SysConfig 实体类，表示系统配置
/**
* <p>
* 通用配置业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
public interface SysConfigService extends IService<SysConfig> {
* <p>
* 通用配置业务类
* </p>
* 该接口定义了与系统配置相关的业务逻辑方法
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
public interface SysConfigService extends IService<SysConfig> { // SysConfigService 接口继承 MyBatis-Plus 的 IService 接口，提供 CRUD 操作
/**
* 查找配置信息
* @return
* @return 返回系统配置的 DTO 对象
*/
SysConfigDTO find();
SysConfigDTO find(); // 定义查找系统配置信息的方法，返回一个 SysConfigDTO 对象
}

56
src-源文件/main/java/com/yf/exam/modules/sys/config/service/impl/SysConfigServiceImpl.java
Unescape View File

@ -1,34 +1,44 @@
package com.yf.exam.modules.sys.config.service.impl;
package com.yf.exam.modules.sys.config.service.impl; // 包名：表示该类属于 sys.config.service.impl 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.sys.config.dto.SysConfigDTO;
import com.yf.exam.modules.sys.config.entity.SysConfig;
import com.yf.exam.modules.sys.config.mapper.SysConfigMapper;
import com.yf.exam.modules.sys.config.service.SysConfigService;
import org.springframework.stereotype.Service;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl 类，用于提供常见的数据库操作
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.sys.config.dto.SysConfigDTO; // 导入 SysConfigDTO 类，封装系统配置的数据传输对象
import com.yf.exam.modules.sys.config.entity.SysConfig; // 导入 SysConfig 实体类，表示系统配置
import com.yf.exam.modules.sys.config.mapper.SysConfigMapper; // 导入 SysConfigMapper，数据访问层接口
import com.yf.exam.modules.sys.config.service.SysConfigService; // 导入 SysConfigService，系统配置服务接口
import org.springframework.stereotype.Service; // 导入 Spring 注解，用于标识该类为服务层组件
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-17 09:12
*/
@Service
public class SysConfigServiceImpl extends ServiceImpl<SysConfigMapper, SysConfig> implements SysConfigService {
* <p>
* 语言设置 服务实现类
* </p>
* 该类实现了 SysConfigService 接口，提供与系统配置相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-17 09:12
*/
@Service // Spring 注解，标识该类为服务层组件
public class SysConfigServiceImpl extends ServiceImpl<SysConfigMapper, SysConfig> implements SysConfigService { // 继承 MyBatis-Plus 的 ServiceImpl 类，简化数据库操作
/**
* 查找系统配置详情
* @return 返回系统配置的 DTO 对象
*/
@Override
public SysConfigDTO find() {
// 创建 QueryWrapper 对象，用于构建查询条件
QueryWrapper<SysConfig> wrapper = new QueryWrapper<>();
wrapper.last(" LIMIT 1");
wrapper.last(" LIMIT 1"); // 限制查询结果为一条记录
SysConfig entity = this.getOne(wrapper, false);
SysConfigDTO dto = new SysConfigDTO();
BeanMapper.copy(entity, dto);
return dto;
// 使用 getOne 方法查询系统配置的第一条记录
SysConfig entity = this.getOne(wrapper, false); // false 表示不抛出异常，如果没有结果会返回 null
// 将查询到的实体对象复制到 DTO 对象
SysConfigDTO dto = new SysConfigDTO(); // 创建 SysConfigDTO 对象
BeanMapper.copy(entity, dto); // 使用 BeanMapper 工具类将 SysConfig 实体对象的属性复制到 DTO 中
return dto; // 返回系统配置 DTO
}
}

230
src-源文件/main/java/com/yf/exam/modules/sys/depart/controller/SysDepartController.java
Unescape View File

@ -1,150 +1,136 @@
package com.yf.exam.modules.sys.depart.controller;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.BaseIdReqDTO;
import com.yf.exam.core.api.dto.BaseIdsReqDTO;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO;
import com.yf.exam.modules.sys.depart.dto.request.DepartSortReqDTO;
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO;
import com.yf.exam.modules.sys.depart.entity.SysDepart;
import com.yf.exam.modules.sys.depart.service.SysDepartService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.shiro.authz.annotation.RequiresRoles;
import org.springframework.beans.BeanUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import java.util.List;
package com.yf.exam.modules.sys.depart.controller; // 包名：表示该类属于 sys.depart.controller 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.yf.exam.core.api.ApiRest; // 导入统一的 API 响应类
import com.yf.exam.core.api.controller.BaseController; // 导入控制器基类，提供通用的控制器功能
import com.yf.exam.core.api.dto.BaseIdReqDTO; // 导入基本请求 DTO，用于单个 ID 请求
import com.yf.exam.core.api.dto.BaseIdsReqDTO; // 导入基本请求 DTO，用于多个 ID 请求
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO; // 导入 SysDepartDTO 数据传输对象
import com.yf.exam.modules.sys.depart.dto.request.DepartSortReqDTO; // 导入部门排序请求 DTO
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO; // 导入部门树状结构响应 DTO
import com.yf.exam.modules.sys.depart.entity.SysDepart; // 导入 SysDepart 实体类，表示部门
import com.yf.exam.modules.sys.depart.service.SysDepartService; // 导入部门服务接口
import io.swagger.annotations.Api; // 导入 Swagger 注解，用于 API 文档生成
import io.swagger.annotations.ApiOperation; // 导入 Swagger 注解，用于定义接口操作说明
import org.apache.shiro.authz.annotation.RequiresRoles; // 导入 Shiro 权限控制注解，限制角色访问
import org.springframework.beans.BeanUtils; // 导入 Spring 的 BeanUtils，用于对象属性拷贝
import org.springframework.beans.factory.annotation.Autowired; // 导入 Spring 注解，用于依赖注入
import org.springframework.web.bind.annotation.RequestBody; // 导入注解，用于绑定请求体
import org.springframework.web.bind.annotation.RequestMapping; // 导入注解，用于定义请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入注解，用于指定请求方法
import org.springframework.web.bind.annotation.RestController; // 导入注解，标识该类为 REST 控制器
/**
* <p>
* 部门信息控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
@Api(tags={"部门信息"})
@RestController
@RequestMapping("/exam/api/sys/depart")
public class SysDepartController extends BaseController {
@Autowired
* <p>
* 部门信息控制器
* </p>
* 提供与部门相关的操作接口，包括添加、修改、删除、查找等
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
@Api(tags = {"部门信息"}) // Swagger 注解：定义该类的 API 文档标签为“部门信息”
@RestController // Spring 注解：标识该类为 REST 控制器
@RequestMapping("/exam/api/sys/depart") // 定义请求路径前缀为 /exam/api/sys/depart
public class SysDepartController extends BaseController { // SysDepartController 类，继承自 BaseController，提供通用功能
@Autowired // 自动注入 SysDepartService 服务
private SysDepartService baseService;
/**
* 添加或修改
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "添加或修改")
@RequestMapping(value = "/save", method = { RequestMethod.POST})
public ApiRest save(@RequestBody SysDepartDTO reqDTO) {
baseService.save(reqDTO);
return super.success();
* 添加或修改部门
* @param reqDTO 请求数据传输对象，包含部门信息
* @return 返回操作结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "添加或修改") // Swagger 注解：定义接口操作说明为“添加或修改”
@RequestMapping(value = "/save", method = {RequestMethod.POST}) // 定义请求路径为 /save，方法为 POST
public ApiRest save(@RequestBody SysDepartDTO reqDTO) { // 添加或修改部门的方法
baseService.save(reqDTO); // 调用服务保存或更新部门信息
return super.success(); // 返回成功响应
}
/**
* 批量删除
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "批量删除")
@RequestMapping(value = "/delete", method = { RequestMethod.POST})
public ApiRest edit(@RequestBody BaseIdsReqDTO reqDTO) {
//根据ID删除
baseService.removeByIds(reqDTO.getIds());
return super.success();
* 批量删除部门
* @param reqDTO 请求数据传输对象，包含待删除的部门 ID 列表
* @return 返回操作结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "批量删除") // Swagger 注解：定义接口操作说明为“批量删除”
@RequestMapping(value = "/delete", method = {RequestMethod.POST}) // 定义请求路径为 /delete，方法为 POST
public ApiRest edit(@RequestBody BaseIdsReqDTO reqDTO) { // 批量删除部门的方法
baseService.removeByIds(reqDTO.getIds()); // 根据 ID 列表删除部门
return super.success(); // 返回成功响应
}
/**
* 查找详情
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "查找详情")
@RequestMapping(value = "/detail", method = { RequestMethod.POST})
public ApiRest<SysDepartDTO> find(@RequestBody BaseIdReqDTO reqDTO) {
SysDepart entity = baseService.getById(reqDTO.getId());
SysDepartDTO dto = new SysDepartDTO();
BeanUtils.copyProperties(entity, dto);
return super.success(dto);
* 查找部门详情
* @param reqDTO 请求数据传输对象，包含部门 ID
* @return 返回部门详情
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "查找详情") // Swagger 注解：定义接口操作说明为“查找详情”
@RequestMapping(value = "/detail", method = {RequestMethod.POST}) // 定义请求路径为 /detail，方法为 POST
public ApiRest<SysDepartDTO> find(@RequestBody BaseIdReqDTO reqDTO) { // 查找部门详情的方法
SysDepart entity = baseService.getById(reqDTO.getId()); // 根据 ID 查找部门实体
SysDepartDTO dto = new SysDepartDTO(); // 创建部门数据传输对象
BeanUtils.copyProperties(entity, dto); // 将实体对象属性拷贝到 DTO 对象
return super.success(dto); // 返回成功响应，包含部门详情
}
/**
* 分页查找
* @param reqDTO
* @return
*/
@RequiresRoles("sa")
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
public ApiRest<IPage<SysDepartTreeDTO>> paging(@RequestBody PagingReqDTO<SysDepartDTO> reqDTO) {
//分页查询并转换
IPage<SysDepartTreeDTO> page = baseService.paging(reqDTO);
return super.success(page);
* 分页查找部门
* @param reqDTO 分页请求数据传输对象，包含分页信息和查询条件
* @return 返回分页查询结果
*/
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "分页查找") // Swagger 注解：定义接口操作说明为“分页查找”
@RequestMapping(value = "/paging", method = {RequestMethod.POST}) // 定义请求路径为 /paging，方法为 POST
public ApiRest<IPage<SysDepartTreeDTO>> paging(@RequestBody PagingReqDTO<SysDepartDTO> reqDTO) { // 分页查找部门的方法
IPage<SysDepartTreeDTO> page = baseService.paging(reqDTO); // 调用服务进行分页查询
return super.success(page); // 返回成功响应，包含分页数据
}
/**
* 查找列表，每次最多返回200条数据
* @param reqDTO
* @return
* 查找部门列表，每次最多返回200条数据
* @param reqDTO 请求数据传输对象，包含查询条件
* @return 返回部门列表
*/
@RequiresRoles("sa")
@ApiOperation(value = "查找列表")
@RequestMapping(value = "/list", method = { RequestMethod.POST})
public ApiRest<List<SysDepartDTO>> list(@RequestBody SysDepartDTO reqDTO) {
//分页查询并转换
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>();
//转换并返回
List<SysDepart> list = baseService.list(wrapper);
//转换数据
List<SysDepartDTO> dtoList = BeanMapper.mapList(list, SysDepartDTO.class);
return super.success(dtoList);
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "查找列表") // Swagger 注解：定义接口操作说明为“查找列表”
@RequestMapping(value = "/list", method = {RequestMethod.POST}) // 定义请求路径为 /list，方法为 POST
public ApiRest<List<SysDepartDTO>> list(@RequestBody SysDepartDTO reqDTO) { // 查找部门列表的方法
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>(); // 创建查询条件
List<SysDepart> list = baseService.list(wrapper); // 获取部门列表
List<SysDepartDTO> dtoList = BeanMapper.mapList(list, SysDepartDTO.class); // 将部门实体列表转换为 DTO 列表
return super.success(dtoList); // 返回成功响应，包含部门列表
}
/**
* 树列表
* @return
* 查找部门树状结构
* @return 返回部门树状结构
*/
@RequiresRoles("sa")
@ApiOperation(value = "树列表")
@RequestMapping(value = "/tree", method = { RequestMethod.POST})
public ApiRest<List<SysDepartTreeDTO>> tree() {
List<SysDepartTreeDTO> dtoList = baseService.findTree();
return super.success(dtoList);
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "树列表") // Swagger 注解：定义接口操作说明为“树列表”
@RequestMapping(value = "/tree", method = {RequestMethod.POST}) // 定义请求路径为 /tree，方法为 POST
public ApiRest<List<SysDepartTreeDTO>> tree() { // 查找部门树状结构的方法
List<SysDepartTreeDTO> dtoList = baseService.findTree(); // 获取部门树状结构
return super.success(dtoList); // 返回成功响应，包含部门树状结构
}
/**
* 分类排序
* @param reqDTO
* @return
* 部门排序
* @param reqDTO 请求数据传输对象，包含排序信息
* @return 返回操作结果
*/
@RequiresRoles("sa")
@ApiOperation(value = "分类排序")
@RequestMapping(value = "/sort", method = { RequestMethod.POST})
public ApiRest sort(@RequestBody DepartSortReqDTO reqDTO) {
baseService.sort(reqDTO.getId(), reqDTO.getSort());
return super.success();
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "分类排序") // Swagger 注解：定义接口操作说明为“分类排序”
@RequestMapping(value = "/sort", method = {RequestMethod.POST}) // 定义请求路径为 /sort，方法为 POST
public ApiRest sort(@RequestBody DepartSortReqDTO reqDTO) { // 部门排序的方法
baseService.sort(reqDTO.getId(), reqDTO.getSort()); // 调用服务进行排序
return super.success(); // 返回成功响应
}
}

59
src-源文件/main/java/com/yf/exam/modules/sys/depart/dto/SysDepartDTO.java
Unescape View File

@ -1,42 +1,41 @@
package com.yf.exam.modules.sys.depart.dto;
package com.yf.exam.modules.sys.depart.dto; // 包名：表示该类属于 sys.depart.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象序列化
/**
* <p>
* 部门信息数据传输类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
@Data
@ApiModel(value="部门信息", description="部门信息")
public class SysDepartDTO implements Serializable {
* <p>
* 部门信息数据传输类
* </p>
* 用于传递部门相关的数据
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "部门信息", description = "部门信息") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysDepartDTO implements Serializable { // 实现 Serializable 接口以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：部门的唯一标识符
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "1公司2部门", required = true) // Swagger 注解：描述该属性为“1公司2部门”，并标记为必填
private Integer deptType; // 定义字段：部门类型，1 表示公司，2 表示部门
@ApiModelProperty(value = "1公司2部门", required=true)
private Integer deptType;
@ApiModelProperty(value = "所属上级", required = true) // Swagger 注解：描述该属性为“所属上级”，并标记为必填
private String parentId; // 定义字段：上级部门的 ID
@ApiModelProperty(value = "所属上级", required=true)
private String parentId;
@ApiModelProperty(value = "部门名称", required = true) // Swagger 注解：描述该属性为“部门名称”，并标记为必填
private String deptName; // 定义字段：部门名称
@ApiModelProperty(value = "部门名称", required=true)
private String deptName;
@ApiModelProperty(value = "部门编码", required=true)
private String deptCode;
@ApiModelProperty(value = "排序", required=true)
private Integer sort;
@ApiModelProperty(value = "部门编码", required = true) // Swagger 注解：描述该属性为“部门编码”，并标记为必填
private String deptCode; // 定义字段：部门的唯一编码，用于标识部门
@ApiModelProperty(value = "排序", required = true) // Swagger 注解：描述该属性为“排序”，并标记为必填
private Integer sort; // 定义字段：部门排序序号，用于定义显示顺序
}

41
src-源文件/main/java/com/yf/exam/modules/sys/depart/dto/request/DepartSortReqDTO.java
Unescape View File

@ -1,28 +1,29 @@
package com.yf.exam.modules.sys.depart.dto.request;
package com.yf.exam.modules.sys.depart.dto.request; // 包名：表示该类属于 sys.depart.dto.request 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于对象序列化
/**
* <p>
* 部门排序请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-03-14 10:37
*/
@Data
@ApiModel(value="部门排序请求类", description="部门排序请求类")
public class DepartSortReqDTO implements Serializable {
* <p>
* 部门排序请求类
* </p>
* 封装部门排序请求的数据传输对象
*
* @作者 聪明笨狗
* @版本 2020-03-14 10:37
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "部门排序请求类", description = "部门排序请求类") // Swagger 注解：定义该类的 API 模型名称和描述
public class DepartSortReqDTO implements Serializable { // 实现 Serializable 接口以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "分类ID")
private String id;
@ApiModelProperty(value = "分类ID") // Swagger 注解：描述该属性为“分类ID”
private String id; // 定义字段：分类的唯一标识符
@ApiModelProperty(value = "排序，0下降，1上升")
private Integer sort;
@ApiModelProperty(value = "排序，0下降，1上升") // Swagger 注解：描述该属性为“排序”，0 表示下降，1 表示上升
private Integer sort; // 定义字段：排序方式，0 为下降排序，1 为上升排序
}

41
src-源文件/main/java/com/yf/exam/modules/sys/depart/dto/response/SysDepartTreeDTO.java
Unescape View File

@ -1,28 +1,27 @@
package com.yf.exam.modules.sys.depart.dto.response;
package com.yf.exam.modules.sys.depart.dto.response; // 包名：表示该类属于 sys.depart.dto.response 包
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO; // 导入 SysDepartDTO 类，表示部门的基本信息
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.util.List;
import java.util.List; // 导入 List 接口，用于存储子部门列表
/**
* <p>
* 部门树结构响应类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
@Data
@ApiModel(value="部门树结构响应类", description="部门树结构响应类")
public class SysDepartTreeDTO extends SysDepartDTO {
* <p>
* 部门树结构响应类
* </p>
* 用于返回树形结构的部门数据
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "部门树结构响应类", description = "部门树结构响应类") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysDepartTreeDTO extends SysDepartDTO { // 继承 SysDepartDTO，扩展支持树形结构
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "子列表", required=true)
private List<SysDepartTreeDTO> children;
@ApiModelProperty(value = "子列表", required = true) // Swagger 注解：描述该属性为“子列表”，标记为必填
private List<SysDepartTreeDTO> children; // 定义字段：子部门列表，支持递归嵌套表示树形结构
}

84
src-源文件/main/java/com/yf/exam/modules/sys/depart/entity/SysDepart.java
Unescape View File

@ -1,59 +1,59 @@
package com.yf.exam.modules.sys.depart.entity;
package com.yf.exam.modules.sys.depart.entity; // 包名：表示该类属于 sys.depart.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于定义主键类型
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于映射数据库字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于标识主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于映射数据库表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus 的 Model 基类，用于支持 ActiveRecord 模式
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
/**
* <p>
* 部门信息实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
@Data
@TableName("sys_depart")
public class SysDepart extends Model<SysDepart> {
* <p>
* 部门信息实体类
* </p>
* 表示数据库中部门信息的实体类，与 `sys_depart` 表对应
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("sys_depart") // MyBatis-Plus 注解，指定该类映射的数据库表名为 `sys_depart`
public class SysDepart extends Model<SysDepart> { // 继承 MyBatis-Plus 的 Model 类，支持 ActiveRecord 模式
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
/**
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，指定主键字段及其生成策略为 ASSIGN_ID
private String id; // 部门的唯一标识符
/**
* 1公司2部门
*/
@TableField("dept_type")
private Integer deptType;
* 1公司2部门
*/
@TableField("dept_type") // MyBatis-Plus 注解，指定该字段映射数据库中的 `dept_type` 列
private Integer deptType; // 部门类型，1 表示公司，2 表示部门
/**
* 所属上级
*/
@TableField("parent_id")
private String parentId;
* 所属上级
*/
@TableField("parent_id") // MyBatis-Plus 注解，指定该字段映射数据库中的 `parent_id` 列
private String parentId; // 上级部门的 ID，用于定义层级关系
/**
* 部门名称
*/
@TableField("dept_name")
private String deptName;
* 部门名称
*/
@TableField("dept_name") // MyBatis-Plus 注解，指定该字段映射数据库中的 `dept_name` 列
private String deptName; // 部门的名称，用于显示和标识部门
/**
* 部门编码
*/
@TableField("dept_code")
private String deptCode;
* 部门编码
*/
@TableField("dept_code") // MyBatis-Plus 注解，指定该字段映射数据库中的 `dept_code` 列
private String deptCode; // 部门的唯一编码，用于标识部门
/**
* 排序
*/
private Integer sort;
* 排序
*/
private Integer sort; // 排序字段，用于定义部门显示的顺序
}

41
src-源文件/main/java/com/yf/exam/modules/sys/depart/mapper/SysDepartMapper.java
Unescape View File

@ -1,28 +1,29 @@
package com.yf.exam.modules.sys.depart.mapper;
package com.yf.exam.modules.sys.depart.mapper; // 包名：表示该类属于 sys.depart.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO;
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO;
import com.yf.exam.modules.sys.depart.entity.SysDepart;
import org.apache.ibatis.annotations.Param;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，用于提供基础的数据库操作
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的分页接口
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 的分页插件中的 Page 类
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO; // 导入部门数据传输对象，用于封装查询条件
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO; // 导入部门树形结构响应对象
import com.yf.exam.modules.sys.depart.entity.SysDepart; // 导入部门实体类
import org.apache.ibatis.annotations.Param; // 导入 MyBatis 注解，用于标注参数
/**
* <p>
* 部门信息Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
public interface SysDepartMapper extends BaseMapper<SysDepart> {
* <p>
* 部门信息Mapper
* </p>
* 定义部门信息的数据库操作接口
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
public interface SysDepartMapper extends BaseMapper<SysDepart> { // SysDepartMapper 接口，继承 MyBatis-Plus 的 BaseMapper
/**
* 部门树分页
* @param page
* @param query
* @return
* @param page 分页对象，包含当前页码和每页大小
* @param query 查询条件，封装了部门查询的参数
* @return 返回分页结果，包含部门树形结构数据
*/
IPage<SysDepartTreeDTO> paging(Page page, @Param("query") SysDepartDTO query);
IPage<SysDepartTreeDTO> paging(Page page, @Param("query") SysDepartDTO query); // 自定义分页查询方法，返回部门树形结构的分页数据
}

78
src-源文件/main/java/com/yf/exam/modules/sys/depart/service/SysDepartService.java
Unescape View File

@ -1,62 +1,62 @@
package com.yf.exam.modules.sys.depart.service;
package com.yf.exam.modules.sys.depart.service; // 包名：表示该接口属于 sys.depart.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO;
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO;
import com.yf.exam.modules.sys.depart.entity.SysDepart;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的分页接口，用于返回分页查询结果
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，用于提供通用的数据库操作
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO; // 导入 SysDepartDTO 数据传输对象，用于封装部门数据
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO; // 导入 SysDepartTreeDTO 类，用于表示部门树形结构
import com.yf.exam.modules.sys.depart.entity.SysDepart; // 导入 SysDepart 实体类，表示部门
import java.util.List;
import java.util.List; // 导入 List 接口，用于存储部门 ID 或部门列表
/**
* <p>
* 部门信息业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
public interface SysDepartService extends IService<SysDepart> {
* <p>
* 部门信息业务类
* </p>
* 该接口定义了与部门相关的业务逻辑操作，如保存、分页查询、排序、查找部门树等
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
public interface SysDepartService extends IService<SysDepart> { // SysDepartService 接口继承 MyBatis-Plus 的 IService 接口，提供 CRUD 操作
/**
* 保存
* @param reqDTO
* 保存部门信息
* @param reqDTO 部门数据传输对象
*/
void save(SysDepartDTO reqDTO);
void save(SysDepartDTO reqDTO); // 保存部门信息方法，接收部门数据传输对象
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<SysDepartTreeDTO> paging(PagingReqDTO<SysDepartDTO> reqDTO);
* 分页查询部门树形结构
* @param reqDTO 分页请求数据传输对象，包含分页信息和查询条件
* @return 返回分页查询结果，包含部门树形结构数据
*/
IPage<SysDepartTreeDTO> paging(PagingReqDTO<SysDepartDTO> reqDTO); // 分页查询部门树的方法
/**
* 查找部门树结构
* @return
* 查找所有部门的树形结构
* @return 返回所有部门的树形结构列表
*/
List<SysDepartTreeDTO> findTree();
List<SysDepartTreeDTO> findTree(); // 查找所有部门树的方法，返回树形结构数据
/**
* 查找部门树
* @param ids
* @return
* 查找指定部门ID列表下的部门树
* @param ids 部门ID列表，用于筛选特定部门的树形结构
* @return 返回部门树形结构列表
*/
List<SysDepartTreeDTO> findTree(List<String> ids);
List<SysDepartTreeDTO> findTree(List<String> ids); // 查找指定部门ID列表下的部门树的方法
/**
* 排序
* @param id
* @param sort
* 排序部门
* @param id 部门ID
* @param sort 排序方式，0为上升，1为下降
*/
void sort(String id, Integer sort);
void sort(String id, Integer sort); // 排序部门的方法，支持上升和下降排序
/**
* 获取某个部门ID下的所有子部门ID
* @param id
* @return
* @param id 部门ID
* @return 返回该部门下所有子部门的ID列表
*/
List<String> listAllSubIds( String id);
List<String> listAllSubIds(String id); // 获取某个部门下所有子部门ID的方法
}

275
src-源文件/main/java/com/yf/exam/modules/sys/depart/service/impl/SysDepartServiceImpl.java
Unescape View File

@ -1,227 +1,233 @@
package com.yf.exam.modules.sys.depart.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO;
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO;
import com.yf.exam.modules.sys.depart.entity.SysDepart;
import com.yf.exam.modules.sys.depart.mapper.SysDepartMapper;
import com.yf.exam.modules.sys.depart.service.SysDepartService;
import org.apache.commons.lang3.StringUtils;
import org.springframework.stereotype.Service;
import org.springframework.util.CollectionUtils;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;
package com.yf.exam.modules.sys.depart.service.impl; // 包名：表示该类属于 sys.depart.service.impl 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 分页插件中的 Page 类
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl 类，用于提供通用的数据库操作
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.sys.depart.dto.SysDepartDTO; // 导入 SysDepartDTO 类，封装部门数据传输对象
import com.yf.exam.modules.sys.depart.dto.response.SysDepartTreeDTO; // 导入 SysDepartTreeDTO 类，用于部门树形结构
import com.yf.exam.modules.sys.depart.entity.SysDepart; // 导入 SysDepart 实体类，表示部门
import com.yf.exam.modules.sys.depart.mapper.SysDepartMapper; // 导入部门的 Mapper 接口，用于数据库交互
import com.yf.exam.modules.sys.depart.service.SysDepartService; // 导入部门服务接口
import org.apache.commons.lang3.StringUtils; // 导入 Apache Commons Lang3 库中的 StringUtils，用于字符串操作
import org.springframework.stereotype.Service; // 导入 Spring 注解，用于标识该类为服务层组件
import org.springframework.util.CollectionUtils; // 导入 Spring 的 CollectionUtils 工具类，用于集合操作
import java.util.ArrayList; // 导入 ArrayList 类，用于列表数据存储
import java.util.HashMap; // 导入 HashMap 类，用于映射键值对
import java.util.List; // 导入 List 接口，用于存储列表数据
import java.util.Map; // 导入 Map 接口，用于映射键值对
/**
* <p>
* 部门信息业务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-02 17:25
*/
@Service
public class SysDepartServiceImpl extends ServiceImpl<SysDepartMapper, SysDepart> implements SysDepartService {
* <p>
* 部门信息业务实现类
* </p>
* 该类实现了 SysDepartService 接口，提供与部门相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-09-02 17:25
*/
@Service // Spring 注解，标识该类为服务层组件
public class SysDepartServiceImpl extends ServiceImpl<SysDepartMapper, SysDepart> implements SysDepartService { // 继承 MyBatis-Plus 的 ServiceImpl 类，简化数据库操作
/**
* 0标识为顶级分类
*/
private static final String ROOT_TAG = "0";
private static final String ROOT_TAG = "0"; // 顶级部门标识符
/**
* 保存或更新部门信息
* @param reqDTO 部门数据传输对象
*/
@Override
public void save(SysDepartDTO reqDTO) {
// 如果部门ID为空，生成部门编码
if(StringUtils.isBlank(reqDTO.getId())) {
this.fillCode(reqDTO);
}else{
reqDTO.setSort(null);
reqDTO.setDeptCode(null);
this.fillCode(reqDTO); // 填充部门编码
} else {
reqDTO.setSort(null); // 如果有ID，则清空排序字段
reqDTO.setDeptCode(null); // 清空部门编码
}
SysDepart entity = new SysDepart();
BeanMapper.copy(reqDTO, entity);
this.saveOrUpdate(entity);
SysDepart entity = new SysDepart(); // 创建部门实体对象
BeanMapper.copy(reqDTO, entity); // 将 DTO 数据拷贝到实体对象
this.saveOrUpdate(entity); // 保存或更新部门信息
}
/**
* 分页查询部门树形结构
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询结果
*/
@Override
public IPage<SysDepartTreeDTO> paging(PagingReqDTO<SysDepartDTO> reqDTO) {
// 创建分页对象
Page query = new Page(reqDTO.getCurrent(), reqDTO.getSize());
// 请求参数
// 获取查询条件
SysDepartDTO params = reqDTO.getParams();
//转换结果
// 执行分页查询
IPage<SysDepartTreeDTO> pageData = baseMapper.paging(query, params);
return pageData;
}
return pageData; // 返回分页结果
}
/**
* 查找所有部门树
* @return 返回部门树形结构
*/
@Override
public List<SysDepartTreeDTO> findTree() {
return this.findTree(null);
return this.findTree(null); // 默认查找所有部门
}
/**
* 查找指定ID的部门树
* @param ids 部门ID列表
* @return 返回部门树形结构
*/
@Override
public List<SysDepartTreeDTO> findTree(List<String> ids) {
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>(); // 创建查询条件
wrapper.lambda().orderByAsc(SysDepart::getSort); // 按照排序字段升序排列
QueryWrapper<SysDepart> wrapper = new QueryWrapper();
wrapper.lambda().orderByAsc(SysDepart::getSort);
// 如果传入了部门ID列表，递归获取所有父级部门
if(!CollectionUtils.isEmpty(ids)){
List<String> fullIds = new ArrayList<>();
List<String> fullIds = new ArrayList<>(); // 用于存储所有父部门ID
for(String id: ids){
this.cycleAllParent(fullIds, id);
this.cycleAllParent(fullIds, id); // 递归获取所有父部门ID
}
if(!CollectionUtils.isEmpty(fullIds)){
wrapper.lambda().in(SysDepart::getId, fullIds);
wrapper.lambda().in(SysDepart::getId, fullIds); // 根据部门ID列表查询
}
}
//全部列表
List<SysDepart> list = this.list(wrapper);
List<SysDepartTreeDTO> dtoList = BeanMapper.mapList(list, SysDepartTreeDTO.class);
//子结构的列表
Map<String,List<SysDepartTreeDTO>> map = new HashMap<>(16);
// 获取所有部门数据
List<SysDepart> list = this.list(wrapper);
List<SysDepartTreeDTO> dtoList = BeanMapper.mapList(list, SysDepartTreeDTO.class); // 将部门实体列表转换为部门树形结构DTO列表
// 构建子部门的映射关系
Map<String, List<SysDepartTreeDTO>> map = new HashMap<>(16);
for(SysDepartTreeDTO item: dtoList){
//如果存在
// 如果当前部门已经有子部门，直接添加
if(map.containsKey(item.getParentId())){
map.get(item.getParentId()).add(item);
continue;
}
//增加新的结构
// 如果没有子部门，则新建一个子部门列表
List<SysDepartTreeDTO> a = new ArrayList<>();
a.add(item);
map.put(item.getParentId(), a);
}
//注意，第0级为顶级的
// 获取顶级部门（parentId 为 ROOT_TAG）
List<SysDepartTreeDTO> topList = map.get(ROOT_TAG);
if(!CollectionUtils.isEmpty(topList)){
for(SysDepartTreeDTO item: topList){
this.fillChildren(map, item);
this.fillChildren(map, item); // 填充子部门
}
}
return topList;
return topList; // 返回顶级部门及其子部门树
}
/**
* 排序部门
* @param id 部门ID
* @param sort 排序方式，0为上升，1为下降
*/
@Override
public void sort(String id, Integer sort) {
SysDepart depart = this.getById(id);
SysDepart depart = this.getById(id); // 获取部门实体
SysDepart exchange = null;
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>();
// 同级排序
wrapper.lambda()
.eq(SysDepart::getParentId, depart.getParentId());
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>(); // 创建查询条件
// 根据部门的父ID查询同级别的部门
wrapper.lambda().eq(SysDepart::getParentId, depart.getParentId());
wrapper.last("LIMIT 1");
// 上升
// 上升排序
if(sort == 0){
// 同级排序
wrapper.lambda()
.lt(SysDepart::getSort, depart.getSort())
.orderByDesc(SysDepart::getSort);
exchange = this.getOne(wrapper, false);
wrapper.lambda().lt(SysDepart::getSort, depart.getSort()).orderByDesc(SysDepart::getSort); // 查找排序小于当前部门的部门
exchange = this.getOne(wrapper, false); // 获取交换部门
}
// 下降
// 下降排序
if(sort == 1){
// 同级排序
wrapper.lambda()
.gt(SysDepart::getSort, depart.getSort())
.orderByAsc(SysDepart::getSort);
exchange = this.getOne(wrapper, false);
wrapper.lambda().gt(SysDepart::getSort, depart.getSort()).orderByAsc(SysDepart::getSort); // 查找排序大于当前部门的部门
exchange = this.getOne(wrapper, false); // 获取交换部门
}
if(exchange!=null) {
// 如果找到了交换的部门，进行交换排序
if(exchange != null) {
SysDepart a = new SysDepart();
a.setId(id);
a.setSort(exchange.getSort());
SysDepart b = new SysDepart();
b.setId(exchange.getId());
b.setSort(depart.getSort());
this.updateById(a);
this.updateById(b);
this.updateById(a); // 更新部门a的排序
this.updateById(b); // 更新部门b的排序
}
}
/**
* 获取部门编号
* @param reqDTO
* @return
* 填充部门编码
* @param reqDTO 部门数据传输对象
*/
private void fillCode(SysDepartDTO reqDTO){
// 前缀
String code = "";
if(StringUtils.isNotBlank(reqDTO.getParentId())
&& !ROOT_TAG.equals(reqDTO.getParentId())){
// 获取上级部门编码
if(StringUtils.isNotBlank(reqDTO.getParentId()) && !ROOT_TAG.equals(reqDTO.getParentId())){
SysDepart parent = this.getById(reqDTO.getParentId());
code = parent.getDeptCode();
code = parent.getDeptCode(); // 获取上级部门的编码
}
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysDepart::getParentId, reqDTO.getParentId()).orderByDesc(SysDepart::getSort); // 查询同级部门
// 同级排序
wrapper.lambda()
.eq(SysDepart::getParentId, reqDTO.getParentId())
.orderByDesc(SysDepart::getSort);
wrapper.last("LIMIT 1");
SysDepart depart = this.getOne(wrapper, false);
if(depart !=null){
code += this.formatCode(depart.getSort()+1);
reqDTO.setSort(depart.getSort()+1);
}else{
code += this.formatCode(1);
reqDTO.setSort(1);
if(depart != null){
code += this.formatCode(depart.getSort() + 1); // 根据排序生成部门编码
reqDTO.setSort(depart.getSort() + 1); // 设置部门的排序
} else {
code += this.formatCode(1); // 如果没有同级部门，则从1开始
reqDTO.setSort(1); // 设置部门的排序为1
}
reqDTO.setDeptCode(code);
reqDTO.setDeptCode(code); // 设置部门编码
}
/**
* 根式化加0
* @param sort
* @return
* 格式化部门编码
* @param sort 排序值
* @return 返回格式化后的部门编码
*/
private String formatCode(Integer sort){
if(sort < 10){
return "A0"+sort;
return "A0" + sort; // 排序小于10时，返回带前导零的编码
}
return "A"+sort;
return "A" + sort; // 排序大于或等于10时，返回正常编码
}
/**
* 递归去做填充数据
* @param map
* @param item
* 填充子部门列表
* @param map 部门映射关系
* @param item 当前部门对象
*/
private void fillChildren(Map<String,List<SysDepartTreeDTO>> map, SysDepartTreeDTO item){
private void fillChildren(Map<String, List<SysDepartTreeDTO>> map, SysDepartTreeDTO item){
//设置子类
if(map.containsKey(item.getId())){
@ -229,60 +235,61 @@ public class SysDepartServiceImpl extends ServiceImpl<SysDepartMapper, SysDepart
List<SysDepartTreeDTO> children = map.get(item.getId());
if(!CollectionUtils.isEmpty(children)){
for(SysDepartTreeDTO sub: children){
this.fillChildren(map, sub);
this.fillChildren(map, sub); // 递归填充子部门
}
}
item.setChildren(children);
item.setChildren(children); // 设置子部门列表
}
}
/**
* 获取所有子部门的ID列表
* @param id 部门ID
* @return 返回所有子部门的ID列表
*/
@Override
public List<String> listAllSubIds( String id){
public List<String> listAllSubIds(String id){
List<String> ids = new ArrayList<>();
this.cycleAllSubs(ids, id);
this.cycleAllSubs(ids, id); // 递归获取所有子部门的ID
return ids;
}
/**
* 递归所有子级别ID
* @param list
* @param id
* 递归获取所有子部门的ID
* @param list 用于存储子部门ID的列表
* @param id 当前部门ID
*/
private void cycleAllSubs(List<String> list, String id){
// 添加ID
// 添加当前部门ID
list.add(id);
QueryWrapper<SysDepart> wrapper = new QueryWrapper<>();
wrapper.lambda()
.eq(SysDepart::getParentId, id)
.orderByDesc(SysDepart::getSort);
.orderByDesc(SysDepart::getSort); // 查询当前部门的所有子部门
List<SysDepart> subList = this.list(wrapper);
if(!CollectionUtils.isEmpty(subList)){
for(SysDepart item: subList){
this.cycleAllSubs(list, item.getId());
this.cycleAllSubs(list, item.getId()); // 递归查询子部门
}
}
}
/**
* 递归所有子级别ID
* @param list
* @param id
* 递归获取所有父部门的ID
* @param list 用于存储父部门ID的列表
* @param id 当前部门ID
*/
private void cycleAllParent(List<String> list, String id){
// 往上递归获得父类
// 往上递归获取父部门
list.add(id);
SysDepart depart = this.getById(id);
if(StringUtils.isNotBlank(depart.getParentId())
&& !ROOT_TAG.equals(depart.getParentId())){
this.cycleAllParent(list, depart.getParentId());
if(StringUtils.isNotBlank(depart.getParentId()) && !ROOT_TAG.equals(depart.getParentId())){
this.cycleAllParent(list, depart.getParentId()); // 递归查询父部门
}
}
}

41
src-源文件/main/java/com/yf/exam/modules/sys/system/mapper/SysDictMapper.java
Unescape View File

@ -1,29 +1,30 @@
package com.yf.exam.modules.sys.system.mapper;
package com.yf.exam.modules.sys.system.mapper; // 包名：表示该接口属于 sys.system.mapper 包
import org.apache.ibatis.annotations.Mapper;
import org.apache.ibatis.annotations.Param;
import org.apache.ibatis.annotations.Mapper; // 导入 MyBatis 的 @Mapper 注解，表示这是一个 Mapper 接口
import org.apache.ibatis.annotations.Param; // 导入 MyBatis 的 @Param 注解，用于指定参数名称
/**
* <p>
* 机主信息Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-08-22 13:46
*/
@Mapper
* <p>
* 机主信息Mapper
* </p>
* 该接口用于操作数据字典，提供查找数据字典的方法
*
* @作者 聪明笨狗
* @版本 2020-08-22 13:46
*/
@Mapper // MyBatis 注解，表示该接口为 Mapper 接口，MyBatis 会自动生成相应的实现
public interface SysDictMapper {
/**
* 查找数据字典
* @param table
* @param text
* @param key
* @param value
* @return
* @param table 数据表名称
* @param text 字段文本
* @param key 字段键值
* @param value 字段值
* @return 返回字典数据的对应值
*/
String findDict(@Param("table") String table,
@Param("text") String text,
@Param("key") String key,
@Param("value") String value);
String findDict(@Param("table") String table, // 使用 @Param 注解绑定 SQL 参数名
@Param("text") String text, // 绑定 SQL 参数 text
@Param("key") String key, // 绑定 SQL 参数 key
@Param("value") String value); // 绑定 SQL 参数 value
}

28
src-源文件/main/java/com/yf/exam/modules/sys/system/service/SysDictService.java
Unescape View File

@ -1,21 +1,25 @@
package com.yf.exam.modules.sys.system.service;
package com.yf.exam.modules.sys.system.service; // 包名：表示该接口属于 sys.system.service 包
/**
* 数据字典工具类
* @author bool
* 提供与数据字典相关的业务方法
*
* @作者 bool
*/
public interface SysDictService {
public interface SysDictService { // 定义 SysDictService 接口，提供数据字典的服务
/**
* 查找数据字典
* @param table
* @param text
* @param key
* @param value
* @return
* 根据给定的表、字段文本、键和值查找数据字典中的对应数据
*
* @param table 数据表名称
* @param text 字段文本，用于描述字段内容
* @param key 字段键值，用于匹配字典数据
* @param value 字段值，用于匹配字典数据
* @return 返回数据字典中的对应值
*/
String findDict(String table,
String text,
String key,
String value);
String findDict(String table, // 表示字典数据的表名
String text, // 字段文本，用于描述字段
String key, // 字段的键
String value); // 字段的值，查询条件之一
}

27
src-源文件/main/java/com/yf/exam/modules/sys/system/service/impl/SysDictServiceImpl.java
Unescape View File

@ -1,21 +1,30 @@
package com.yf.exam.modules.sys.system.service.impl;
package com.yf.exam.modules.sys.system.service.impl; // 包名：表示该类属于 sys.system.service.impl 包
import com.yf.exam.modules.sys.system.mapper.SysDictMapper;
import com.yf.exam.modules.sys.system.service.SysDictService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import com.yf.exam.modules.sys.system.mapper.SysDictMapper; // 导入 SysDictMapper 接口，用于操作数据字典
import com.yf.exam.modules.sys.system.service.SysDictService; // 导入 SysDictService 接口，定义数据字典的业务逻辑
import org.springframework.beans.factory.annotation.Autowired; // 导入 Spring 的 @Autowired 注解，用于自动注入依赖
import org.springframework.stereotype.Service; // 导入 Spring 的 @Service 注解，用于标识该类为服务层组件
/**
* SysDictServiceImpl 类提供了数据字典的业务逻辑实现
* @author bool
*/
@Service
public class SysDictServiceImpl implements SysDictService {
@Service // Spring 注解，标识该类为服务层组件
public class SysDictServiceImpl implements SysDictService { // 实现 SysDictService 接口
@Autowired
@Autowired // 自动注入 SysDictMapper
private SysDictMapper sysDictMapper;
/**
* 查找数据字典
* @param table 数据表名称
* @param text 字段文本
* @param key 字段键值
* @param value 字段值
* @return 返回字典数据的对应值
*/
@Override
public String findDict(String table, String text, String key, String value) {
return sysDictMapper.findDict(table, text, key, value);
return sysDictMapper.findDict(table, text, key, value); // 调用 Mapper 层的方法查找字典数据
}
}

98
src-源文件/main/java/com/yf/exam/modules/sys/user/controller/SysRoleController.java
Unescape View File

@ -1,77 +1,75 @@
package com.yf.exam.modules.sys.user.controller;
package com.yf.exam.modules.sys.user.controller; // 包名：表示该类属于 sys.user.controller 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.modules.sys.user.dto.SysRoleDTO;
import com.yf.exam.modules.sys.user.entity.SysRole;
import com.yf.exam.modules.sys.user.service.SysRoleService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.shiro.authz.annotation.RequiresRoles;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.yf.exam.core.api.ApiRest; // 导入统一的 API 响应类
import com.yf.exam.core.api.controller.BaseController; // 导入基类控制器，提供通用功能
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象属性拷贝
import com.yf.exam.modules.sys.user.dto.SysRoleDTO; // 导入 SysRoleDTO 数据传输对象
import com.yf.exam.modules.sys.user.entity.SysRole; // 导入 SysRole 实体类，表示角色
import com.yf.exam.modules.sys.user.service.SysRoleService; // 导入 SysRoleService 服务接口
import io.swagger.annotations.Api; // 导入 Swagger 注解，用于定义 API 文档
import io.swagger.annotations.ApiOperation; // 导入 Swagger 注解，用于描述接口操作
import org.apache.shiro.authz.annotation.RequiresRoles; // 导入 Shiro 注解，用于权限控制，限制访问角色
import org.springframework.beans.factory.annotation.Autowired; // 导入 Spring 注解，用于自动注入依赖
import org.springframework.web.bind.annotation.RequestBody; // 导入注解，用于绑定请求体
import org.springframework.web.bind.annotation.RequestMapping; // 导入注解，用于定义请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入注解，用于指定请求方法
import org.springframework.web.bind.annotation.RestController; // 导入注解，标识该类为 REST 控制器
import java.util.List;
import java.util.List; // 导入 List 接口，用于存储角色列表
/**
* <p>
* 管理用户控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
* 该类用于处理角色管理相关的请求
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Api(tags = {"管理用户"})
@RestController
@RequestMapping("/exam/api/sys/role")
public class SysRoleController extends BaseController {
@Api(tags = {"管理用户"}) // Swagger 注解：定义该类的 API 文档标签为“管理用户”
@RestController // Spring 注解：标识该类为 REST 控制器，处理 HTTP 请求
@RequestMapping("/exam/api/sys/role") // 定义请求路径前缀为 /exam/api/sys/role
public class SysRoleController extends BaseController { // SysRoleController 继承自 BaseController，提供通用功能
@Autowired
@Autowired // 自动注入 SysRoleService 服务
private SysRoleService baseService;
/**
* 分页查找
* @param reqDTO
* @return
* 分页查找角色信息
* @param reqDTO 分页请求数据传输对象，包含分页信息和查询条件
* @return 返回分页查询结果，包含角色数据
*/
@RequiresRoles("sa")
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "分页查找") // Swagger 注解：描述接口操作为“分页查找”
@RequestMapping(value = "/paging", method = { RequestMethod.POST}) // 请求路径为 /paging，方法为 POST
public ApiRest<IPage<SysRoleDTO>> paging(@RequestBody PagingReqDTO<SysRoleDTO> reqDTO) {
//分页查询并转换
IPage<SysRoleDTO> page = baseService.paging(reqDTO);
return super.success(page);
// 调用服务层进行分页查询，并返回角色数据
IPage<SysRoleDTO> page = baseService.paging(reqDTO);
return super.success(page); // 返回成功响应，包含分页数据
}
/**
* 查找列表，每次最多返回200条数据
* @return
* 查找所有角色列表，每次最多返回200条数据
* @return 返回角色列表
*/
@RequiresRoles("sa")
@ApiOperation(value = "查找列表")
@RequestMapping(value = "/list", method = { RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "查找列表") // Swagger 注解：描述接口操作为“查找列表”
@RequestMapping(value = "/list", method = { RequestMethod.POST}) // 请求路径为 /list，方法为 POST
public ApiRest<List<SysRoleDTO>> list() {
//分页查询并转换
QueryWrapper<SysRole> wrapper = new QueryWrapper<>();
// 创建查询条件
QueryWrapper<SysRole> wrapper = new QueryWrapper<>();
//转换并返回
List<SysRole> list = baseService.list(wrapper);
// 获取所有角色数据
List<SysRole> list = baseService.list(wrapper);
//转换数据
// 将角色实体数据转换为角色数据传输对象
List<SysRoleDTO> dtoList = BeanMapper.mapList(list, SysRoleDTO.class);
return super.success(dtoList);
return super.success(dtoList); // 返回成功响应，包含角色列表
}
}

227
src-源文件/main/java/com/yf/exam/modules/sys/user/controller/SysUserController.java
Unescape View File

@ -1,182 +1,185 @@
package com.yf.exam.modules.sys.user.controller;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.BaseIdsReqDTO;
import com.yf.exam.core.api.dto.BaseStateReqDTO;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.sys.user.dto.SysUserDTO;
import com.yf.exam.modules.sys.user.dto.request.SysUserLoginReqDTO;
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO;
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO;
import com.yf.exam.modules.sys.user.entity.SysUser;
import com.yf.exam.modules.sys.user.service.SysUserService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.apache.shiro.authz.annotation.RequiresRoles;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.http.HttpServletRequest;
package com.yf.exam.modules.sys.user.controller; // 包名：表示该类属于 sys.user.controller 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.yf.exam.core.api.ApiRest; // 导入统一的 API 响应类
import com.yf.exam.core.api.controller.BaseController; // 导入基类控制器，提供通用功能
import com.yf.exam.core.api.dto.BaseIdsReqDTO; // 导入基本请求 DTO，用于处理多个 ID 请求
import com.yf.exam.core.api.dto.BaseStateReqDTO; // 导入基本状态请求 DTO，用于更新状态
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO
import com.yf.exam.modules.sys.user.dto.SysUserDTO; // 导入 SysUserDTO 数据传输对象
import com.yf.exam.modules.sys.user.dto.request.SysUserLoginReqDTO; // 导入 SysUserLoginReqDTO 登录请求 DTO
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO; // 导入 SysUserSaveReqDTO 保存请求 DTO
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO; // 导入 SysUserLoginDTO 登录响应 DTO
import com.yf.exam.modules.sys.user.entity.SysUser; // 导入 SysUser 实体类，表示系统用户
import com.yf.exam.modules.sys.user.service.SysUserService; // 导入 SysUserService 服务接口
import io.swagger.annotations.Api; // 导入 Swagger 注解，用于定义 API 文档
import io.swagger.annotations.ApiOperation; // 导入 Swagger 注解，用于描述接口操作
import org.apache.shiro.authz.annotation.RequiresRoles; // 导入 Shiro 注解，用于角色权限控制
import org.springframework.beans.factory.annotation.Autowired; // 导入 Spring 注解，用于自动注入依赖
import org.springframework.web.bind.annotation.CrossOrigin; // 导入 Spring 注解，用于启用跨域请求
import org.springframework.web.bind.annotation.RequestBody; // 导入 Spring 注解，用于请求体绑定
import org.springframework.web.bind.annotation.RequestMapping; // 导入 Spring 注解，用于指定请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入 Spring 注解，用于指定请求方法
import org.springframework.web.bind.annotation.RequestParam; // 导入 Spring 注解，用于请求参数绑定
import org.springframework.web.bind.annotation.RestController; // 导入 Spring 注解，标识该类为 REST 控制器
import javax.servlet.http.HttpServletRequest; // 导入 HttpServletRequest 类，用于获取 HTTP 请求
/**
* <p>
* 管理用户控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
* 该类用于处理用户相关的请求，包括登录、注册、修改用户资料等
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Api(tags = {"管理用户"})
@RestController
@RequestMapping("/exam/api/sys/user")
public class SysUserController extends BaseController {
@Api(tags = {"管理用户"}) // Swagger 注解：定义该类的 API 文档标签为“管理用户”
@RestController // Spring 注解：标识该类为 REST 控制器，处理 HTTP 请求
@RequestMapping("/exam/api/sys/user") // 定义请求路径前缀为 /exam/api/sys/user
public class SysUserController extends BaseController { // SysUserController 类继承 BaseController，提供通用功能
@Autowired
@Autowired // 自动注入 SysUserService 服务
private SysUserService baseService;
/**
* 用户登录
* @return
* @param reqDTO 登录请求 DTO，包含用户名和密码
* @return 返回用户登录信息
*/
@CrossOrigin
@ApiOperation(value = "用户登录")
@RequestMapping(value = "/login", method = {RequestMethod.POST})
@CrossOrigin // 允许跨域请求
@ApiOperation(value = "用户登录") // Swagger 注解：描述接口操作为“用户登录”
@RequestMapping(value = "/login", method = {RequestMethod.POST}) // 请求路径为 /login，方法为 POST
public ApiRest<SysUserLoginDTO> login(@RequestBody SysUserLoginReqDTO reqDTO) {
SysUserLoginDTO respDTO = baseService.login(reqDTO.getUsername(), reqDTO.getPassword());
return super.success(respDTO);
SysUserLoginDTO respDTO = baseService.login(reqDTO.getUsername(), reqDTO.getPassword()); // 调用服务层的登录方法
return super.success(respDTO); // 返回成功响应，包含用户登录信息
}
/**
* 用户登录
* @return
* 用户登出
* @param request HTTP 请求对象，用于获取请求头中的 token
* @return 返回成功响应
*/
@CrossOrigin
@ApiOperation(value = "用户登录")
@RequestMapping(value = "/logout", method = {RequestMethod.POST})
@CrossOrigin // 允许跨域请求
@ApiOperation(value = "用户登出") // Swagger 注解：描述接口操作为“用户登出”
@RequestMapping(value = "/logout", method = {RequestMethod.POST}) // 请求路径为 /logout，方法为 POST
public ApiRest logout(HttpServletRequest request) {
String token = request.getHeader("token");
System.out.println("+++++当前会话为："+token);
baseService.logout(token);
return super.success();
String token = request.getHeader("token"); // 获取请求头中的 token
System.out.println("+++++当前会话为：" + token); // 打印当前会话的 token
baseService.logout(token); // 调用服务层的登出方法
return super.success(); // 返回成功响应
}
/**
* 获取会话
* @return
* 获取当前会话信息
* @param token 会话 token
* @return 返回当前会话信息
*/
@ApiOperation(value = "获取会话")
@RequestMapping(value = "/info", method = {RequestMethod.POST})
@ApiOperation(value = "获取会话") // Swagger 注解：描述接口操作为“获取会话”
@RequestMapping(value = "/info", method = {RequestMethod.POST}) // 请求路径为 /info，方法为 POST
public ApiRest info(@RequestParam("token") String token) {
SysUserLoginDTO respDTO = baseService.token(token);
return success(respDTO);
SysUserLoginDTO respDTO = baseService.token(token); // 根据 token 获取当前会话信息
return success(respDTO); // 返回会话信息
}
/**
* 修改用户资料
* @return
* @param reqDTO 用户资料 DTO，包含修改后的用户信息
* @return 返回成功响应
*/
@ApiOperation(value = "修改用户资料")
@RequestMapping(value = "/update", method = {RequestMethod.POST})
@ApiOperation(value = "修改用户资料") // Swagger 注解：描述接口操作为“修改用户资料”
@RequestMapping(value = "/update", method = {RequestMethod.POST}) // 请求路径为 /update，方法为 POST
public ApiRest update(@RequestBody SysUserDTO reqDTO) {
baseService.update(reqDTO);
return success();
baseService.update(reqDTO); // 调用服务层的更新方法
return success(); // 返回成功响应
}
/**
* 保存或修改系统用户
* @return
* @param reqDTO 用户保存或修改请求 DTO
* @return 返回成功响应
*/
@RequiresRoles("sa")
@ApiOperation(value = "保存或修改")
@RequestMapping(value = "/save", method = {RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "保存或修改") // Swagger 注解：描述接口操作为“保存或修改”
@RequestMapping(value = "/save", method = {RequestMethod.POST}) // 请求路径为 /save，方法为 POST
public ApiRest save(@RequestBody SysUserSaveReqDTO reqDTO) {
baseService.save(reqDTO);
return success();
baseService.save(reqDTO); // 调用服务层的保存方法
return success(); // 返回成功响应
}
/**
* 批量删除
* @param reqDTO
* @return
* 批量删除用户
* @param reqDTO 批量删除请求 DTO，包含待删除用户的 ID 列表
* @return 返回成功响应
*/
@RequiresRoles("sa")
@ApiOperation(value = "批量删除")
@RequestMapping(value = "/delete", method = { RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "批量删除") // Swagger 注解：描述接口操作为“批量删除”
@RequestMapping(value = "/delete", method = {RequestMethod.POST}) // 请求路径为 /delete，方法为 POST
public ApiRest edit(@RequestBody BaseIdsReqDTO reqDTO) {
//根据ID删除
baseService.removeByIds(reqDTO.getIds());
return super.success();
baseService.removeByIds(reqDTO.getIds()); // 根据 ID 列表删除用户
return super.success(); // 返回成功响应
}
/**
* 分页查找
* @param reqDTO
* @return
* 分页查找用户
* @param reqDTO 分页请求 DTO，包含分页信息和查询条件
* @return 返回分页查询结果
*/
@RequiresRoles("sa")
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "分页查找") // Swagger 注解：描述接口操作为“分页查找”
@RequestMapping(value = "/paging", method = {RequestMethod.POST}) // 请求路径为 /paging，方法为 POST
public ApiRest<IPage<SysUserDTO>> paging(@RequestBody PagingReqDTO<SysUserDTO> reqDTO) {
//分页查询并转换
// 调用服务层的分页查询方法
IPage<SysUserDTO> page = baseService.paging(reqDTO);
return super.success(page);
return super.success(page); // 返回成功响应，包含分页数据
}
/**
* 修改状态
* @param reqDTO
* @return
* 修改用户状态
* @param reqDTO 状态请求 DTO，包含用户 ID 列表和状态
* @return 返回成功响应
*/
@RequiresRoles("sa")
@ApiOperation(value = "修改状态")
@RequestMapping(value = "/state", method = { RequestMethod.POST})
@RequiresRoles("sa") // 权限控制：要求用户具有 "sa" 角色
@ApiOperation(value = "修改状态") // Swagger 注解：描述接口操作为“修改状态”
@RequestMapping(value = "/state", method = {RequestMethod.POST}) // 请求路径为 /state，方法为 POST
public ApiRest state(@RequestBody BaseStateReqDTO reqDTO) {
// 条件
// 构建查询条件：排除 admin 用户
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
wrapper.lambda()
.in(SysUser::getId, reqDTO.getIds())
.ne(SysUser::getUserName, "admin");
.in(SysUser::getId, reqDTO.getIds()) // 根据 ID 列表查询
.ne(SysUser::getUserName, "admin"); // 排除用户名为 admin 的用户
SysUser record = new SysUser();
record.setState(reqDTO.getState());
baseService.update(record, wrapper);
record.setState(reqDTO.getState()); // 设置用户状态
baseService.update(record, wrapper); // 更新状态
return super.success();
return super.success(); // 返回成功响应
}
/**
* 保存或修改系统用户
* @return
* 用户注册
* @param reqDTO 用户注册请求 DTO，包含用户注册信息
* @return 返回用户登录信息
*/
@ApiOperation(value = "学员注册")
@RequestMapping(value = "/reg", method = {RequestMethod.POST})
@ApiOperation(value = "学员注册") // Swagger 注解：描述接口操作为“学员注册”
@RequestMapping(value = "/reg", method = {RequestMethod.POST}) // 请求路径为 /reg，方法为 POST
public ApiRest<SysUserLoginDTO> reg(@RequestBody SysUserDTO reqDTO) {
SysUserLoginDTO respDTO = baseService.reg(reqDTO);
return success(respDTO);
SysUserLoginDTO respDTO = baseService.reg(reqDTO); // 调用服务层的注册方法
return success(respDTO); // 返回注册后的用户登录信息
}
/**
* 快速注册，如果手机号存在则登录，不存在就注册
* @return
* 快速注册
* @param reqDTO 用户注册请求 DTO，包含用户信息
* @return 返回用户登录信息
*/
@ApiOperation(value = "快速注册")
@RequestMapping(value = "/quick-reg", method = {RequestMethod.POST})
@ApiOperation(value = "快速注册") // Swagger 注解：描述接口操作为“快速注册”
@RequestMapping(value = "/quick-reg", method = {RequestMethod.POST}) // 请求路径为 /quick-reg，方法为 POST
public ApiRest<SysUserLoginDTO> quick(@RequestBody SysUserDTO reqDTO) {
SysUserLoginDTO respDTO = baseService.quickReg(reqDTO);
return success(respDTO);
SysUserLoginDTO respDTO = baseService.quickReg(reqDTO); // 调用服务层的快速注册方法
return success(respDTO); // 返回快速注册后的用户登录信息
}
}

47
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/SysRoleDTO.java
Unescape View File

@ -1,30 +1,29 @@
package com.yf.exam.modules.sys.user.dto;
package com.yf.exam.modules.sys.user.dto; // 包名：表示该类属于 sys.user.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
/**
* <p>
* 角色请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="角色", description="角色")
public class SysRoleDTO implements Serializable {
* <p>
* 角色请求类
* </p>
* 用于封装角色请求的数据，包括角色的ID和名称
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "角色", description = "角色") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysRoleDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "角色ID", required=true)
private String id;
@ApiModelProperty(value = "角色名称", required=true)
private String roleName;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "角色ID", required = true) // Swagger 注解：描述该属性为“角色ID”，并标记为必填
private String id; // 定义字段：角色的唯一标识符
@ApiModelProperty(value = "角色名称", required = true) // Swagger 注解：描述该属性为“角色名称”，并标记为必填
private String roleName; // 定义字段：角色的名称
}

77
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/SysUserDTO.java
Unescape View File

@ -1,55 +1,54 @@
package com.yf.exam.modules.sys.user.dto;
package com.yf.exam.modules.sys.user.dto; // 包名：表示该类属于 sys.user.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.util.Date;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
import java.util.Date; // 导入 Date 类，用于表示日期和时间
/**
* <p>
* 管理用户请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="管理用户", description="管理用户")
public class SysUserDTO implements Serializable {
* <p>
* 管理用户请求类
* </p>
* 用于封装管理员用户的相关数据，包括用户的基本信息
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "管理用户", description = "管理用户") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：用户的唯一标识符
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "用户名", required = true) // Swagger 注解：描述该属性为“用户名”，并标记为必填
private String userName; // 定义字段：管理员的用户名，用于登录和身份验证
@ApiModelProperty(value = "用户名", required=true)
private String userName;
@ApiModelProperty(value = "真实姓名", required = true) // Swagger 注解：描述该属性为“真实姓名”，并标记为必填
private String realName; // 定义字段：管理员的真实姓名
@ApiModelProperty(value = "真实姓名", required=true)
private String realName;
@ApiModelProperty(value = "密码", required = true) // Swagger 注解：描述该属性为“密码”，并标记为必填
private String password; // 定义字段：管理员的密码
@ApiModelProperty(value = "密码", required=true)
private String password;
@ApiModelProperty(value = "密码盐", required = true) // Swagger 注解：描述该属性为“密码盐”，并标记为必填
private String salt; // 定义字段：用于加密密码的盐值
@ApiModelProperty(value = "密码盐", required=true)
private String salt;
@ApiModelProperty(value = "角色列表", required = true) // Swagger 注解：描述该属性为“角色列表”，并标记为必填
private String roleIds; // 定义字段：用户的角色ID列表，用于权限控制
@ApiModelProperty(value = "角色列表", required=true)
private String roleIds;
@ApiModelProperty(value = "部门ID", required = true) // Swagger 注解：描述该属性为“部门ID”，并标记为必填
private String departId; // 定义字段：用户所属的部门ID
@ApiModelProperty(value = "部门ID", required=true)
private String departId;
@ApiModelProperty(value = "创建时间", required = true) // Swagger 注解：描述该属性为“创建时间”，并标记为必填
private Date createTime; // 定义字段：管理员账号的创建时间
@ApiModelProperty(value = "创建时间", required=true)
private Date createTime;
@ApiModelProperty(value = "更新时间", required = true) // Swagger 注解：描述该属性为“更新时间”，并标记为必填
private Date updateTime; // 定义字段：管理员账号的最后更新时间
@ApiModelProperty(value = "更新时间", required=true)
private Date updateTime;
@ApiModelProperty(value = "状态", required=true)
private Integer state;
@ApiModelProperty(value = "状态", required = true) // Swagger 注解：描述该属性为“状态”，并标记为必填
private Integer state; // 定义字段：管理员账号的状态，如启用或禁用
}

53
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/SysUserRoleDTO.java
Unescape View File

@ -1,33 +1,32 @@
package com.yf.exam.modules.sys.user.dto;
package com.yf.exam.modules.sys.user.dto; // 包名：表示该类属于 sys.user.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
/**
* <p>
* 用户角色请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="用户角色", description="用户角色")
public class SysUserRoleDTO implements Serializable {
* <p>
* 用户角色请求类
* </p>
* 用于封装用户角色信息的请求数据，包括用户与角色的映射关系
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "用户角色", description = "用户角色") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserRoleDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "用户ID", required=true)
private String userId;
@ApiModelProperty(value = "角色ID", required=true)
private String roleId;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：用户角色关系的唯一标识符
@ApiModelProperty(value = "用户ID", required = true) // Swagger 注解：描述该属性为“用户ID”，并标记为必填
private String userId; // 定义字段：用户的唯一标识符，关联到特定的用户
@ApiModelProperty(value = "角色ID", required = true) // Swagger 注解：描述该属性为“角色ID”，并标记为必填
private String roleId; // 定义字段：角色的唯一标识符，关联到特定的角色
}

42
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/request/SysUserLoginReqDTO.java
Unescape View File

@ -1,29 +1,29 @@
package com.yf.exam.modules.sys.user.dto.request;
package com.yf.exam.modules.sys.user.dto.request; // 包名：表示该类属于 sys.user.dto.request 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
/**
* <p>
* 管理员登录请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="管理员登录请求类", description="管理员登录请求类")
public class SysUserLoginReqDTO implements Serializable {
* <p>
* 管理员登录请求类
* </p>
* 用于封装管理员登录请求的数据，包括用户名和密码
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "管理员登录请求类", description = "管理员登录请求类") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserLoginReqDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "用户名", required=true)
private String username;
@ApiModelProperty(value = "用户名", required = true) // Swagger 注解：描述该属性为“用户名”，并标记为必填
private String username; // 定义字段：用户名，登录时使用
@ApiModelProperty(value = "密码", required=true)
private String password;
@ApiModelProperty(value = "密码", required = true) // Swagger 注解：描述该属性为“密码”，并标记为必填
private String password; // 定义字段：密码，登录时使用
}

76
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/request/SysUserSaveReqDTO.java
Unescape View File

@ -1,43 +1,43 @@
package com.yf.exam.modules.sys.user.dto.request;
package com.yf.exam.modules.sys.user.dto.request; // 包名：表示该类属于 sys.user.dto.request 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.util.List;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
import java.util.List; // 导入 List 接口，用于存储角色列表
/**
* <p>
* 管理员登录请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="管理员保存请求类", description="管理员保存请求类")
public class SysUserSaveReqDTO implements Serializable {
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "用户名", required=true)
private String userName;
@ApiModelProperty(value = "头像", required=true)
private String avatar;
@ApiModelProperty(value = "真实姓名", required=true)
private String realName;
@ApiModelProperty(value = "密码", required=true)
private String password;
@ApiModelProperty(value = "部门", required=true)
private String departId;
@ApiModelProperty(value = "角色列表", required=true)
private List<String> roles;
* <p>
* 管理员保存请求类
* </p>
* 用于封装保存管理员信息的请求数据
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "管理员保存请求类", description = "管理员保存请求类") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserSaveReqDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：管理员的唯一标识符，通常用于更新操作
@ApiModelProperty(value = "用户名", required = true) // Swagger 注解：描述该属性为“用户名”，并标记为必填
private String userName; // 定义字段：管理员的用户名，用于登录
@ApiModelProperty(value = "头像", required = true) // Swagger 注解：描述该属性为“头像”，并标记为必填
private String avatar; // 定义字段：管理员的头像 URL
@ApiModelProperty(value = "真实姓名", required = true) // Swagger 注解：描述该属性为“真实姓名”，并标记为必填
private String realName; // 定义字段：管理员的真实姓名
@ApiModelProperty(value = "密码", required = true) // Swagger 注解：描述该属性为“密码”，并标记为必填
private String password; // 定义字段：管理员的登录密码
@ApiModelProperty(value = "部门", required = true) // Swagger 注解：描述该属性为“部门”，并标记为必填
private String departId; // 定义字段：管理员所属的部门ID
@ApiModelProperty(value = "角色列表", required = true) // Swagger 注解：描述该属性为“角色列表”，并标记为必填
private List<String> roles; // 定义字段：管理员的角色列表，每个角色的 ID 组成的列表
}

38
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/request/SysUserTokenReqDTO.java
Unescape View File

@ -1,26 +1,26 @@
package com.yf.exam.modules.sys.user.dto.request;
package com.yf.exam.modules.sys.user.dto.request; // 包名：表示该类属于 sys.user.dto.request 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
/**
* <p>
* 会话检查请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="会话检查请求类", description="会话检查请求类")
public class SysUserTokenReqDTO implements Serializable {
* <p>
* 会话检查请求类
* </p>
* 用于封装会话检查请求的数据，包含会话的 token 信息
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "会话检查请求类", description = "会话检查请求类") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserTokenReqDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "用户名", required=true)
private String token;
@ApiModelProperty(value = "用户名", required = true) // Swagger 注解：描述该属性为“用户名”，并标记为必填
private String token; // 定义字段：会话的 token，用于标识当前会话
}

78
src-源文件/main/java/com/yf/exam/modules/sys/user/dto/response/SysUserLoginDTO.java
Unescape View File

@ -1,55 +1,55 @@
package com.yf.exam.modules.sys.user.dto.response;
package com.yf.exam.modules.sys.user.dto.response; // 包名：表示该类属于 sys.user.dto.response 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于定义 API 模型
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述 API 模型的属性
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.io.Serializable;
import java.util.Date;
import java.util.List;
import java.io.Serializable; // 导入 Serializable 接口，用于支持对象的序列化
import java.util.Date; // 导入 Date 类，用于表示日期和时间
import java.util.List; // 导入 List 接口，用于存储角色列表
/**
* <p>
* 管理用户请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@ApiModel(value="管理用户登录响应类", description="管理用户登录响应类")
public class SysUserLoginDTO implements Serializable {
* <p>
* 管理用户登录响应类
* </p>
* 用于封装管理员登录后的响应数据，包括用户信息和登录令牌
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@ApiModel(value = "管理用户登录响应类", description = "管理用户登录响应类") // Swagger 注解：定义该类的 API 模型名称和描述
public class SysUserLoginDTO implements Serializable { // 实现 Serializable 接口，以支持序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "ID", required = true) // Swagger 注解：描述该属性为“ID”，并标记为必填
private String id; // 定义字段：管理员的唯一标识符
@ApiModelProperty(value = "用户名", required=true)
private String userName;
@ApiModelProperty(value = "用户名", required = true) // Swagger 注解：描述该属性为“用户名”，并标记为必填
private String userName; // 定义字段：管理员的用户名
@ApiModelProperty(value = "真实姓名", required=true)
private String realName;
@ApiModelProperty(value = "真实姓名", required = true) // Swagger 注解：描述该属性为“真实姓名”，并标记为必填
private String realName; // 定义字段：管理员的真实姓名
@ApiModelProperty(value = "角色列表", required=true)
private String roleIds;
@ApiModelProperty(value = "角色列表", required = true) // Swagger 注解：描述该属性为“角色列表”，并标记为必填
private String roleIds; // 定义字段：管理员的角色ID列表，用于权限控制
@ApiModelProperty(value = "部门ID", required=true)
private String departId;
@ApiModelProperty(value = "部门ID", required = true) // Swagger 注解：描述该属性为“部门ID”，并标记为必填
private String departId; // 定义字段：管理员所属部门的ID
@ApiModelProperty(value = "创建时间", required=true)
private Date createTime;
@ApiModelProperty(value = "创建时间", required = true) // Swagger 注解：描述该属性为“创建时间”，并标记为必填
private Date createTime; // 定义字段：管理员账号的创建时间
@ApiModelProperty(value = "更新时间", required=true)
private Date updateTime;
@ApiModelProperty(value = "更新时间", required = true) // Swagger 注解：描述该属性为“更新时间”，并标记为必填
private Date updateTime; // 定义字段：管理员账号的最后更新时间
@ApiModelProperty(value = "状态", required=true)
private Integer state;
@ApiModelProperty(value = "状态", required = true) // Swagger 注解：描述该属性为“状态”，并标记为必填
private Integer state; // 定义字段：管理员账号的状态，如启用或禁用
@ApiModelProperty(value = "角色列表", required=true)
private List<String> roles;
@ApiModelProperty(value = "角色列表", required = true) // Swagger 注解：描述该属性为“角色列表”，并标记为必填
private List<String> roles; // 定义字段：管理员角色的列表，每个角色的名称或ID
@ApiModelProperty(value = "登录令牌", required=true)
private String token;
@ApiModelProperty(value = "登录令牌", required = true) // Swagger 注解：描述该属性为“登录令牌”，并标记为必填
private String token; // 定义字段：管理员登录后的令牌，用于身份验证
}

60
src-源文件/main/java/com/yf/exam/modules/sys/user/entity/SysRole.java
Unescape View File

@ -1,36 +1,38 @@
package com.yf.exam.modules.sys.user.entity;
package com.yf.exam.modules.sys.user.entity; // 包名：表示该类属于 sys.user.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于指定主键生成策略
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于指定表字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于指定表主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于指定表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus 扩展的 Model 类，支持 ActiveRecord 模式
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
/**
* <p>
* 角色实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@TableName("sys_role")
public class SysRole extends Model<SysRole> {
* <p>
* 角色实体类
* </p>
* 该类用于封装角色实体的数据，与数据库中的 `sys_role` 表对应
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("sys_role") // MyBatis-Plus 注解，指定该实体类对应数据库表名为 "sys_role"
public class SysRole extends Model<SysRole> { // SysRole 类继承自 Model 类，支持 ActiveRecord 模式
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
private static final long serialVersionUID = 1L;
/**
* 角色ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
* 角色ID
* 主键，使用 MyBatis-Plus 的自增策略
*/
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，指定主键字段及生成策略
private String id; // 定义字段：角色的唯一标识符
/**
* 角色名称
*/
@TableField("role_name")
private String roleName;
* 角色名称
* 对应数据库中的 "role_name" 字段
*/
@TableField("role_name") // MyBatis-Plus 注解，指定该字段对应数据库中的 "role_name" 字段
private String roleName; // 定义字段：角色的名称
}

84
src-源文件/main/java/com/yf/exam/modules/sys/user/entity/SysUser.java
Unescape View File

@ -1,83 +1,93 @@
package com.yf.exam.modules.sys.user.entity;
package com.yf.exam.modules.sys.user.entity; // 包名：表示该类属于 sys.user.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于指定主键生成策略
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于指定表字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于指定表主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于指定表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus 扩展的 Model 类，支持 ActiveRecord 模式
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
import java.util.Date;
import java.util.Date; // 导入 Date 类，用于表示日期和时间
/**
* <p>
* 管理用户实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@TableName("sys_user")
public class SysUser extends Model<SysUser> {
* <p>
* 管理用户实体类
* </p>
* 该类用于封装管理员用户的数据，与数据库中的 `sys_user` 表对应
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("sys_user") // MyBatis-Plus 注解，指定该实体类对应数据库表名为 "sys_user"
public class SysUser extends Model<SysUser> { // SysUser 类继承自 Model 类，支持 ActiveRecord 模式
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
/**
* ID
* 主键，使用 MyBatis-Plus 的自增策略
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，指定主键字段及生成策略
private String id; // 定义字段：用户的唯一标识符
/**
* 用户名
* 对应数据库中的 "user_name" 字段
*/
@TableField("user_name")
private String userName;
@TableField("user_name") // MyBatis-Plus 注解，指定该字段对应数据库中的 "user_name" 字段
private String userName; // 定义字段：管理员的用户名，用于登录和身份验证
/**
* 真实姓名
* 对应数据库中的 "real_name" 字段
*/
@TableField("real_name")
private String realName;
@TableField("real_name") // MyBatis-Plus 注解，指定该字段对应数据库中的 "real_name" 字段
private String realName; // 定义字段：管理员的真实姓名
/**
* 密码
* 存储管理员的密码
*/
private String password;
private String password; // 定义字段：管理员的登录密码
/**
* 密码盐
* 用于加密密码的盐值
*/
private String salt;
private String salt; // 定义字段：用于加密密码的盐值
/**
* 角色列表
* 对应数据库中的 "role_ids" 字段，存储角色的ID列表
*/
@TableField("role_ids")
private String roleIds;
@TableField("role_ids") // MyBatis-Plus 注解，指定该字段对应数据库中的 "role_ids" 字段
private String roleIds; // 定义字段：用户的角色ID列表，用于权限控制
/**
* 部门ID
* 对应数据库中的 "depart_id" 字段
*/
@TableField("depart_id")
private String departId;
@TableField("depart_id") // MyBatis-Plus 注解，指定该字段对应数据库中的 "depart_id" 字段
private String departId; // 定义字段：管理员所属的部门ID
/**
* 创建时间
* 对应数据库中的 "create_time" 字段
*/
@TableField("create_time")
private Date createTime;
@TableField("create_time") // MyBatis-Plus 注解，指定该字段对应数据库中的 "create_time" 字段
private Date createTime; // 定义字段：管理员账号的创建时间
/**
* 更新时间
* 对应数据库中的 "update_time" 字段
*/
@TableField("update_time")
private Date updateTime;
@TableField("update_time") // MyBatis-Plus 注解，指定该字段对应数据库中的 "update_time" 字段
private Date updateTime; // 定义字段：管理员账号的最后更新时间
/**
* 状态
* 表示管理员账号的状态，如启用或禁用
*/
private Integer state;
private Integer state; // 定义字段：管理员账号的状态（如启用或禁用）
}

71
src-源文件/main/java/com/yf/exam/modules/sys/user/entity/SysUserRole.java
Unescape View File

@ -1,42 +1,45 @@
package com.yf.exam.modules.sys.user.entity;
package com.yf.exam.modules.sys.user.entity; // 包名：表示该类属于 sys.user.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于指定主键生成策略
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于指定表字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于指定表主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于指定表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus 扩展的 Model 类，支持 ActiveRecord 模式
import lombok.Data; // 导入 Lombok 注解，用于自动生成 Getter、Setter、toString 等方法
/**
* <p>
* 用户角色实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Data
@TableName("sys_user_role")
public class SysUserRole extends Model<SysUserRole> {
* <p>
* 用户角色实体类
* </p>
* 该类用于封装用户角色的关系数据，与数据库中的 `sys_user_role` 表对应
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Data // Lombok 注解，自动生成 Getter、Setter 和其他方法
@TableName("sys_user_role") // MyBatis-Plus 注解，指定该实体类对应数据库表名为 "sys_user_role"
public class SysUserRole extends Model<SysUserRole> { // SysUserRole 类继承自 Model 类，支持 ActiveRecord 模式
private static final long serialVersionUID = 1L; // 序列化版本号，用于序列化和反序列化的一致性检查
private static final long serialVersionUID = 1L;
/**
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
* ID
* 主键，使用 MyBatis-Plus 的自增策略
*/
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，指定主键字段及生成策略
private String id; // 定义字段：用户角色关系的唯一标识符
/**
* 用户ID
*/
@TableField("user_id")
private String userId;
* 用户ID
* 对应数据库中的 "user_id" 字段
*/
@TableField("user_id") // MyBatis-Plus 注解，指定该字段对应数据库中的 "user_id" 字段
private String userId; // 定义字段：用户的唯一标识符，关联到特定的用户
/**
* 角色ID
*/
@TableField("role_id")
private String roleId;
* 角色ID
* 对应数据库中的 "role_id" 字段
*/
@TableField("role_id") // MyBatis-Plus 注解，指定该字段对应数据库中的 "role_id" 字段
private String roleId; // 定义字段：角色的唯一标识符，关联到特定的角色
}

24
src-源文件/main/java/com/yf/exam/modules/sys/user/mapper/SysRoleMapper.java
Unescape View File

@ -1,15 +1,17 @@
package com.yf.exam.modules.sys.user.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yf.exam.modules.sys.user.entity.SysRole;
package com.yf.exam.modules.sys.user.mapper; // 包名：表示该类属于 sys.user.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，提供基本的数据库操作方法
import com.yf.exam.modules.sys.user.entity.SysRole; // 导入 SysRole 实体类，表示角色实体
/**
* <p>
* 角色Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysRoleMapper extends BaseMapper<SysRole> {
* <p>
* 角色Mapper
* </p>
* 该接口继承自 MyBatis-Plus 的 BaseMapper，用于提供对 `SysRole` 实体的数据库操作
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysRoleMapper extends BaseMapper<SysRole> { // 继承 MyBatis-Plus 的 BaseMapper，自动提供对 SysRole 实体的 CRUD 操作
}

23
src-源文件/main/java/com/yf/exam/modules/sys/user/mapper/SysUserMapper.java
Unescape View File

@ -1,16 +1,17 @@
package com.yf.exam.modules.sys.user.mapper;
package com.yf.exam.modules.sys.user.mapper; // 包名：表示该类属于 sys.user.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yf.exam.modules.sys.user.entity.SysUser;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，提供基本的数据库操作方法
import com.yf.exam.modules.sys.user.entity.SysUser; // 导入 SysUser 实体类，表示管理员用户实体
/**
* <p>
* 管理用户Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysUserMapper extends BaseMapper<SysUser> {
* <p>
* 管理用户Mapper
* </p>
* 该接口继承自 MyBatis-Plus 的 BaseMapper，用于提供对 `SysUser` 实体的数据库操作
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysUserMapper extends BaseMapper<SysUser> { // 继承 MyBatis-Plus 的 BaseMapper，自动提供对 SysUser 实体的 CRUD 操作
}

23
src-源文件/main/java/com/yf/exam/modules/sys/user/mapper/SysUserRoleMapper.java
Unescape View File

@ -1,16 +1,17 @@
package com.yf.exam.modules.sys.user.mapper;
package com.yf.exam.modules.sys.user.mapper; // 包名：表示该类属于 sys.user.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yf.exam.modules.sys.user.entity.SysUserRole;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，提供基本的数据库操作方法
import com.yf.exam.modules.sys.user.entity.SysUserRole; // 导入 SysUserRole 实体类，表示用户角色实体
/**
* <p>
* 用户角色Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysUserRoleMapper extends BaseMapper<SysUserRole> {
* <p>
* 用户角色Mapper
* </p>
* 该接口继承自 MyBatis-Plus 的 BaseMapper，用于提供对 `SysUserRole` 实体的数据库操作
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysUserRoleMapper extends BaseMapper<SysUserRole> { // 继承 MyBatis-Plus 的 BaseMapper，自动提供对 SysUserRole 实体的 CRUD 操作
}

39
src-源文件/main/java/com/yf/exam/modules/sys/user/service/SysRoleService.java
Unescape View File

@ -1,25 +1,26 @@
package com.yf.exam.modules.sys.user.service;
package com.yf.exam.modules.sys.user.service; // 包名：表示该类属于 sys.user.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.modules.sys.user.dto.SysRoleDTO;
import com.yf.exam.modules.sys.user.entity.SysRole;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，提供基本的服务方法
import com.yf.exam.modules.sys.user.dto.SysRoleDTO; // 导入 SysRoleDTO 数据传输对象，用于封装角色数据
import com.yf.exam.modules.sys.user.entity.SysRole; // 导入 SysRole 实体类，表示角色
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO，用于封装分页请求参数
/**
* <p>
* 角色业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysRoleService extends IService<SysRole> {
* <p>
* 角色业务类
* </p>
* 该接口定义了与角色相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysRoleService extends IService<SysRole> { // 继承 MyBatis-Plus 的 IService 接口，提供基本的 CRUD 操作
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<SysRoleDTO> paging(PagingReqDTO<SysRoleDTO> reqDTO);
* 分页查询数据
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询的结果
*/
IPage<SysRoleDTO> paging(PagingReqDTO<SysRoleDTO> reqDTO); // 定义分页查询方法，返回角色的分页数据
}

73
src-源文件/main/java/com/yf/exam/modules/sys/user/service/SysUserRoleService.java
Unescape View File

@ -1,61 +1,64 @@
package com.yf.exam.modules.sys.user.service;
package com.yf.exam.modules.sys.user.service; // 包名：表示该类属于 sys.user.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.modules.sys.user.dto.SysUserRoleDTO;
import com.yf.exam.modules.sys.user.entity.SysUserRole;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，提供基本的服务方法
import com.yf.exam.modules.sys.user.dto.SysUserRoleDTO; // 导入 SysUserRoleDTO 数据传输对象，用于封装用户角色数据
import com.yf.exam.modules.sys.user.entity.SysUserRole; // 导入 SysUserRole 实体类，表示用户角色
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO，用于封装分页请求参数
import java.util.List;
import java.util.List; // 导入 List 接口，用于存储多个角色ID
/**
* <p>
* 用户角色业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysUserRoleService extends IService<SysUserRole> {
* <p>
* 用户角色业务类
* </p>
* 该接口定义了与用户角色相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysUserRoleService extends IService<SysUserRole> { // 继承 MyBatis-Plus 的 IService 接口，提供基本的 CRUD 操作
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<SysUserRoleDTO> paging(PagingReqDTO<SysUserRoleDTO> reqDTO);
* 分页查询数据
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询的结果
*/
IPage<SysUserRoleDTO> paging(PagingReqDTO<SysUserRoleDTO> reqDTO); // 定义分页查询用户角色数据的方法，返回角色的分页数据
/**
* 查找用户角色列表
* @param userId
* @return
* @param userId 用户ID
* @return 返回该用户的角色ID列表
*/
List<String> listRoles(String userId);
List<String> listRoles(String userId); // 根据用户ID查找该用户的角色ID列表
/**
* 保存全部角色
* @param userId
* @param ids
* @return
* @param userId 用户ID
* @param ids 角色ID列表
* @return 返回角色ID的拼接字符串
*/
String saveRoles(String userId, List<String> ids);
String saveRoles(String userId, List<String> ids); // 保存指定用户的角色
/**
* 是否学生
* @param userId
* @return
* @param userId 用户ID
* @return 返回用户是否为学生，true表示是学生，false表示不是学生
*/
boolean isStudent(String userId);
boolean isStudent(String userId); // 判断指定用户是否为学生
/**
* 是否老师
* @param userId 用户ID
* @return 返回用户是否为老师，true表示是老师，false表示不是老师
*/
boolean isTeacher(String userId);
boolean isTeacher(String userId); // 判断指定用户是否为老师
/**
* 是否管理
* @param userId
* @return
* 是否管理员
* @param userId 用户ID
* @return 返回用户是否为管理员，true表示是管理员，false表示不是管理员
*/
boolean isAdmin(String userId);
boolean isAdmin(String userId); // 判断指定用户是否为管理员
}

79
src-源文件/main/java/com/yf/exam/modules/sys/user/service/SysUserService.java
Unescape View File

@ -1,72 +1,75 @@
package com.yf.exam.modules.sys.user.service;
package com.yf.exam.modules.sys.user.service; // 包名：表示该类属于 sys.user.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.modules.sys.user.dto.SysUserDTO;
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO;
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO;
import com.yf.exam.modules.sys.user.entity.SysUser;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，提供基本的服务方法
import com.yf.exam.modules.sys.user.dto.SysUserDTO; // 导入 SysUserDTO 数据传输对象，用于封装用户数据
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO; // 导入 SysUserSaveReqDTO 请求 DTO，用于保存用户信息
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO; // 导入 SysUserLoginDTO 响应 DTO，用于返回登录信息
import com.yf.exam.modules.sys.user.entity.SysUser; // 导入 SysUser 实体类，表示管理员用户
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO，用于封装分页请求参数
/**
* <p>
* 管理用户业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
public interface SysUserService extends IService<SysUser> {
* <p>
* 管理用户业务类
* </p>
* 该接口定义了与管理用户相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
public interface SysUserService extends IService<SysUser> { // 继承 MyBatis-Plus 的 IService 接口，提供基本的 CRUD 操作
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<SysUserDTO> paging(PagingReqDTO<SysUserDTO> reqDTO);
* 分页查询数据
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询的结果
*/
IPage<SysUserDTO> paging(PagingReqDTO<SysUserDTO> reqDTO); // 定义分页查询用户数据的方法，返回用户的分页数据
/**
* 登录
* @param userName
* @param password
* @return
* @param userName 用户名
* @param password 密码
* @return 返回登录信息，包括 token 等数据
*/
SysUserLoginDTO login(String userName, String password);
SysUserLoginDTO login(String userName, String password); // 实现用户登录，验证用户名和密码
/**
* 获取管理会话
* @param token
* @return
* @param token 用户的 JWT token
* @return 返回用户的登录信息和角色信息
*/
SysUserLoginDTO token(String token);
SysUserLoginDTO token(String token); // 根据 token 获取用户的会话信息并验证
/**
* 退出登录
* @param token
* @param token 用户的 JWT token
*/
void logout(String token);
void logout(String token); // 退出登录，销毁当前会话
/**
* 修改用户资料
* @param reqDTO
* @param reqDTO 用户资料数据传输对象
*/
void update(SysUserDTO reqDTO);
void update(SysUserDTO reqDTO); // 修改用户资料，包括密码等信息
/**
* 保存添加系统用户
* @param reqDTO
* @param reqDTO 保存用户信息的请求数据传输对象
*/
void save(SysUserSaveReqDTO reqDTO);
void save(SysUserSaveReqDTO reqDTO); // 保存或更新系统用户
/**
* 用户注册
* @param reqDTO
* @param reqDTO 注册用户的数据传输对象
* @return 返回用户登录信息和 token
*/
SysUserLoginDTO reg(SysUserDTO reqDTO);
SysUserLoginDTO reg(SysUserDTO reqDTO); // 用户注册，保存用户信息并返回登录数据
/**
* 快速注册
* @param reqDTO
* @param reqDTO 快速注册用户的数据传输对象
* @return 返回用户登录信息和 token
*/
SysUserLoginDTO quickReg(SysUserDTO reqDTO);
SysUserLoginDTO quickReg(SysUserDTO reqDTO); // 快速注册，如果用户已存在则直接登录，否则进行注册
}

64
src-源文件/main/java/com/yf/exam/modules/sys/user/service/impl/SysRoleServiceImpl.java
Unescape View File

@ -1,42 +1,46 @@
package com.yf.exam.modules.sys.user.service.impl;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.TypeReference;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.modules.sys.user.dto.SysRoleDTO;
import com.yf.exam.modules.sys.user.entity.SysRole;
import com.yf.exam.modules.sys.user.mapper.SysRoleMapper;
import com.yf.exam.modules.sys.user.service.SysRoleService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import org.springframework.stereotype.Service;
package com.yf.exam.modules.sys.user.service.impl; // 包名：表示该类属于 sys.user.service.impl 包
import com.alibaba.fastjson.JSON; // 导入 Fastjson 库，用于 JSON 处理
import com.alibaba.fastjson.TypeReference; // 导入 Fastjson 的 TypeReference，用于泛型类型的转换
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 分页类
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl，实现基本的服务层操作
import com.yf.exam.modules.sys.user.dto.SysRoleDTO; // 导入 SysRoleDTO 数据传输对象，用于封装角色数据
import com.yf.exam.modules.sys.user.entity.SysRole; // 导入 SysRole 实体类，表示角色
import com.yf.exam.modules.sys.user.mapper.SysRoleMapper; // 导入 SysRoleMapper，用于数据库操作
import com.yf.exam.modules.sys.user.service.SysRoleService; // 导入 SysRoleService 服务接口
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO
import org.springframework.stereotype.Service; // 导入 Spring 的 Service 注解，标识该类为服务层组件
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Service
public class SysRoleServiceImpl extends ServiceImpl<SysRoleMapper, SysRole> implements SysRoleService {
* <p>
* 语言设置 服务实现类
* </p>
* 该类实现了 SysRoleService 接口，提供了角色相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Service // 标识该类为服务层组件
public class SysRoleServiceImpl extends ServiceImpl<SysRoleMapper, SysRole> implements SysRoleService { // 继承 MyBatis-Plus 的 ServiceImpl，自动提供基础的 CRUD 操作
@Override
public IPage<SysRoleDTO> paging(PagingReqDTO<SysRoleDTO> reqDTO) {
public IPage<SysRoleDTO> paging(PagingReqDTO<SysRoleDTO> reqDTO) { // 重写分页查询方法
//创建分页对象
// 创建分页对象，设置当前页和每页显示的条数
IPage<SysRole> query = new Page<>(reqDTO.getCurrent(), reqDTO.getSize());
//查询条件
// 创建查询条件对象（此处没有具体条件，查询所有数据）
QueryWrapper<SysRole> wrapper = new QueryWrapper<>();
//获得数据
// 查询数据，获取分页结果
IPage<SysRole> page = this.page(query, wrapper);
//转换结果
IPage<SysRoleDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysRoleDTO>>(){});
// 将查询结果转换为 SysRoleDTO 类型的分页结果
IPage<SysRoleDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysRoleDTO>>() {});
// 返回分页数据
return pageData;
}
}
}

124
src-源文件/main/java/com/yf/exam/modules/sys/user/service/impl/SysUserRoleServiceImpl.java
Unescape View File

@ -1,128 +1,144 @@
package com.yf.exam.modules.sys.user.service.impl;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.TypeReference;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.modules.sys.user.dto.SysUserRoleDTO;
import com.yf.exam.modules.sys.user.entity.SysUserRole;
import com.yf.exam.modules.sys.user.mapper.SysUserRoleMapper;
import com.yf.exam.modules.sys.user.service.SysUserRoleService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import org.springframework.stereotype.Service;
import org.springframework.util.CollectionUtils;
import org.springframework.util.StringUtils;
import java.util.ArrayList;
import java.util.List;
package com.yf.exam.modules.sys.user.service.impl; // 包名：表示该类属于 sys.user.service.impl 包
import com.alibaba.fastjson.JSON; // 导入 Fastjson 库，用于 JSON 处理
import com.alibaba.fastjson.TypeReference; // 导入 Fastjson 的 TypeReference，用于泛型类型的转换
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 分页类
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl 类，提供基础的数据库操作
import com.yf.exam.modules.sys.user.dto.SysUserRoleDTO; // 导入 SysUserRoleDTO 数据传输对象，用于封装用户角色数据
import com.yf.exam.modules.sys.user.entity.SysUserRole; // 导入 SysUserRole 实体类，表示用户角色
import com.yf.exam.modules.sys.user.mapper.SysUserRoleMapper; // 导入 SysUserRoleMapper，用于数据库操作
import com.yf.exam.modules.sys.user.service.SysUserRoleService; // 导入 SysUserRoleService 服务接口
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO
import org.springframework.stereotype.Service; // 导入 Spring 的 Service 注解，标识该类为服务层组件
import org.springframework.util.CollectionUtils; // 导入 Spring 的 CollectionUtils 工具类，用于判断集合是否为空
import org.springframework.util.StringUtils; // 导入 Spring 的 StringUtils 工具类，用于判断字符串是否为空
import java.util.ArrayList; // 导入 ArrayList 类，用于创建列表
import java.util.List; // 导入 List 接口，用于存储角色列表
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Service
public class SysUserRoleServiceImpl extends ServiceImpl<SysUserRoleMapper, SysUserRole> implements SysUserRoleService {
* <p>
* 用户角色服务实现类
* </p>
* 该类实现了 SysUserRoleService 接口，提供了用户角色相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Service // 标识该类为服务层组件
public class SysUserRoleServiceImpl extends ServiceImpl<SysUserRoleMapper, SysUserRole> implements SysUserRoleService { // 继承 MyBatis-Plus 的 ServiceImpl，自动提供基础的 CRUD 操作
@Override
public IPage<SysUserRoleDTO> paging(PagingReqDTO<SysUserRoleDTO> reqDTO) {
public IPage<SysUserRoleDTO> paging(PagingReqDTO<SysUserRoleDTO> reqDTO) { // 实现分页查询方法
//创建分页对象
// 创建分页对象，设置当前页和每页显示的条数
IPage<SysUserRole> query = new Page<>(reqDTO.getCurrent(), reqDTO.getSize());
//查询条件
// 创建查询条件对象
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
//获得数据
// 查询数据，获取分页结果
IPage<SysUserRole> page = this.page(query, wrapper);
//转换结果
IPage<SysUserRoleDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysUserRoleDTO>>(){});
// 将查询结果转换为 SysUserRoleDTO 类型的分页结果
IPage<SysUserRoleDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysUserRoleDTO>>() {});
// 返回分页数据
return pageData;
}
}
@Override
public List<String> listRoles(String userId) {
public List<String> listRoles(String userId) { // 根据用户ID获取该用户的角色列表
// 创建查询条件对象，筛选出指定用户的角色
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUserRole::getUserId, userId);
// 查询角色列表
List<SysUserRole> list = this.list(wrapper);
List<String> roles = new ArrayList<>();
if(!CollectionUtils.isEmpty(list)){
for(SysUserRole item: list){
// 如果查询结果不为空，将角色ID添加到列表中
if (!CollectionUtils.isEmpty(list)) {
for (SysUserRole item : list) {
roles.add(item.getRoleId());
}
}
// 返回角色ID列表
return roles;
}
@Override
public String saveRoles(String userId, List<String> ids) {
public String saveRoles(String userId, List<String> ids) { // 保存用户角色方法
// 删除全部角色
// 删除该用户所有角色
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUserRole::getUserId, userId);
this.remove(wrapper);
if(!CollectionUtils.isEmpty(ids)){
// 如果角色列表不为空，保存新的角色
if (!CollectionUtils.isEmpty(ids)) {
List<SysUserRole> list = new ArrayList<>();
String roleIds = null;
for(String item: ids){
// 将角色ID列表转为 SysUserRole 实体对象列表
for (String item : ids) {
SysUserRole role = new SysUserRole();
role.setRoleId(item);
role.setUserId(userId);
list.add(role);
if(StringUtils.isEmpty(roleIds)){
if (StringUtils.isEmpty(roleIds)) {
roleIds = item;
}else{
roleIds+=","+item;
} else {
roleIds += "," + item; // 将角色ID拼接成字符串
}
}
// 批量保存角色数据
this.saveBatch(list);
return roleIds;
return roleIds; // 返回拼接后的角色ID字符串
}
return "";
return ""; // 如果角色列表为空，返回空字符串
}
@Override
public boolean isStudent(String userId) {
public boolean isStudent(String userId) { // 检查用户是否为学生
// 学生角色
// 查询用户是否拥有学生角色
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUserRole::getUserId, userId)
.eq(SysUserRole::getRoleId, "student");
// 如果查询结果数量大于0，则表示该用户是学生
return this.count(wrapper) > 0;
}
@Override
public boolean isTeacher(String userId) {
// 学生角色
public boolean isTeacher(String userId) { // 检查用户是否为教师
// 查询用户是否拥有教师角色
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUserRole::getUserId, userId)
.eq(SysUserRole::getRoleId, "teacher");
// 如果查询结果数量大于0，则表示该用户是教师
return this.count(wrapper) > 0;
}
@Override
public boolean isAdmin(String userId) {
// 学生角色
public boolean isAdmin(String userId) { // 检查用户是否为管理员
// 查询用户是否拥有管理员角色（角色ID为 "sa"）
QueryWrapper<SysUserRole> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUserRole::getUserId, userId)
.eq(SysUserRole::getRoleId, "sa");
// 如果查询结果数量大于0，则表示该用户是管理员
return this.count(wrapper) > 0;
}
}

226
src-源文件/main/java/com/yf/exam/modules/sys/user/service/impl/SysUserServiceImpl.java
Unescape View File

@ -1,176 +1,185 @@
package com.yf.exam.modules.sys.user.service.impl;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.TypeReference;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.IdWorker;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.api.ApiError;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.core.enums.CommonState;
import com.yf.exam.core.exception.ServiceException;
import com.yf.exam.core.utils.BeanMapper;
import com.yf.exam.core.utils.passwd.PassHandler;
import com.yf.exam.core.utils.passwd.PassInfo;
import com.yf.exam.ability.shiro.jwt.JwtUtils;
import com.yf.exam.modules.sys.user.dto.SysUserDTO;
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO;
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO;
import com.yf.exam.modules.sys.user.entity.SysUser;
import com.yf.exam.modules.sys.user.mapper.SysUserMapper;
import com.yf.exam.modules.sys.user.service.SysUserRoleService;
import com.yf.exam.modules.sys.user.service.SysUserService;
import com.yf.exam.modules.user.UserUtils;
import org.apache.commons.lang3.StringUtils;
import org.apache.shiro.SecurityUtils;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;
import org.springframework.util.CollectionUtils;
import java.util.ArrayList;
import java.util.List;
package com.yf.exam.modules.sys.user.service.impl; // 包名：表示该类属于 sys.user.service.impl 包
import com.alibaba.fastjson.JSON; // 导入 Fastjson 库，用于 JSON 处理
import com.alibaba.fastjson.TypeReference; // 导入 Fastjson 的 TypeReference，用于泛型类型的转换
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.baomidou.mybatisplus.core.toolkit.IdWorker; // 导入 MyBatis-Plus 的 IdWorker，用于生成唯一ID
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 分页类
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl 类，提供基础的数据库操作
import com.yf.exam.core.api.ApiError; // 导入 ApiError 用于错误码定义
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO
import com.yf.exam.core.enums.CommonState; // 导入公共状态枚举，定义正常与异常状态
import com.yf.exam.core.exception.ServiceException; // 导入 ServiceException，用于抛出自定义异常
import com.yf.exam.core.utils.BeanMapper; // 导入 BeanMapper 工具类，用于对象之间的属性拷贝
import com.yf.exam.core.utils.passwd.PassHandler; // 导入 PassHandler 用于密码处理
import com.yf.exam.core.utils.passwd.PassInfo; // 导入 PassInfo 用于存储密码和盐
import com.yf.exam.ability.shiro.jwt.JwtUtils; // 导入 JwtUtils 用于生成和验证 JWT
import com.yf.exam.modules.sys.user.dto.SysUserDTO; // 导入 SysUserDTO 数据传输对象，用于封装用户数据
import com.yf.exam.modules.sys.user.dto.request.SysUserSaveReqDTO; // 导入 SysUserSaveReqDTO 请求 DTO，用于保存用户信息
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO; // 导入 SysUserLoginDTO 响应 DTO，用于返回登录信息
import com.yf.exam.modules.sys.user.entity.SysUser; // 导入 SysUser 实体类，表示管理员用户
import com.yf.exam.modules.sys.user.mapper.SysUserMapper; // 导入 SysUserMapper，用于数据库操作
import com.yf.exam.modules.sys.user.service.SysUserRoleService; // 导入 SysUserRoleService 服务接口，用于角色操作
import com.yf.exam.modules.sys.user.service.SysUserService; // 导入 SysUserService 服务接口，用于用户操作
import com.yf.exam.modules.user.UserUtils; // 导入 UserUtils 工具类，用于获取当前用户信息
import org.apache.commons.lang3.StringUtils; // 导入 StringUtils 工具类，用于判断字符串是否为空
import org.apache.shiro.SecurityUtils; // 导入 Shiro 的 SecurityUtils，用于获取和处理用户会话
import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于自动注入依赖
import org.springframework.stereotype.Service; // 导入 Spring 的 Service 注解，标识该类为服务层组件
import org.springframework.transaction.annotation.Transactional; // 导入 Spring 的事务注解，支持事务管理
import org.springframework.util.CollectionUtils; // 导入 Spring 的 CollectionUtils 工具类，用于判断集合是否为空
import java.util.ArrayList; // 导入 ArrayList 类，用于创建列表
import java.util.List; // 导入 List 接口，用于存储角色列表
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-04-13 16:57
*/
@Service
public class SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> implements SysUserService {
* <p>
* 用户服务实现类
* </p>
* 该类实现了 SysUserService 接口，提供了与用户相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-04-13 16:57
*/
@Service // 标识该类为服务层组件
public class SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> implements SysUserService { // 继承 MyBatis-Plus 的 ServiceImpl，自动提供基础的 CRUD 操作
@Autowired
private SysUserRoleService sysUserRoleService;
private SysUserRoleService sysUserRoleService; // 注入 SysUserRoleService，用于用户角色管理
@Override
public IPage<SysUserDTO> paging(PagingReqDTO<SysUserDTO> reqDTO) {
public IPage<SysUserDTO> paging(PagingReqDTO<SysUserDTO> reqDTO) { // 实现分页查询方法
//创建分页对象
// 创建分页对象，设置当前页和每页显示的条数
IPage<SysUser> query = new Page<>(reqDTO.getCurrent(), reqDTO.getSize());
//查询条件
// 创建查询条件对象
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
SysUserDTO params = reqDTO.getParams();
if(params!=null){
if(!StringUtils.isBlank(params.getUserName())){
// 根据传入的参数设置查询条件
if (params != null) {
if (!StringUtils.isBlank(params.getUserName())) {
wrapper.lambda().like(SysUser::getUserName, params.getUserName());
}
if(!StringUtils.isBlank(params.getRealName())){
if (!StringUtils.isBlank(params.getRealName())) {
wrapper.lambda().like(SysUser::getRealName, params.getRealName());
}
}
//获得数据
// 查询数据，获取分页结果
IPage<SysUser> page = this.page(query, wrapper);
//转换结果
IPage<SysUserDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysUserDTO>>(){});
// 将查询结果转换为 SysUserDTO 类型的分页结果
IPage<SysUserDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<SysUserDTO>>() {});
// 返回分页数据
return pageData;
}
}
@Override
public SysUserLoginDTO login(String userName, String password) {
public SysUserLoginDTO login(String userName, String password) { // 用户登录方法
// 查询用户是否存在
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUser::getUserName, userName);
SysUser user = this.getOne(wrapper, false);
if(user == null){
throw new ServiceException(ApiError.ERROR_90010002);
if (user == null) {
throw new ServiceException(ApiError.ERROR_90010002); // 用户不存在，抛出异常
}
// 被禁用
if(user.getState().equals(CommonState.ABNORMAL)){
throw new ServiceException(ApiError.ERROR_90010005);
// 检查用户是否被禁用
if (user.getState().equals(CommonState.ABNORMAL)) {
throw new ServiceException(ApiError.ERROR_90010005); // 用户被禁用，抛出异常
}
boolean check = PassHandler.checkPass(password,user.getSalt(), user.getPassword());
if(!check){
throw new ServiceException(ApiError.ERROR_90010002);
// 校验密码
boolean check = PassHandler.checkPass(password, user.getSalt(), user.getPassword());
if (!check) {
throw new ServiceException(ApiError.ERROR_90010002); // 密码不正确，抛出异常
}
// 设置 JWT token 并返回登录信息
return this.setToken(user);
}
@Override
public SysUserLoginDTO token(String token) {
public SysUserLoginDTO token(String token) { // 根据 token 获取用户会话信息
// 获得会话
// 获取 token 中的用户名
String username = JwtUtils.getUsername(token);
// 校验结果
// 校验 token 是否有效
boolean check = JwtUtils.verify(token, username);
if(!check){
throw new ServiceException(ApiError.ERROR_90010002);
if (!check) {
throw new ServiceException(ApiError.ERROR_90010002); // token 无效，抛出异常
}
// 查询用户信息
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUser::getUserName, username);
SysUser user = this.getOne(wrapper, false);
if(user == null){
throw new ServiceException(ApiError.ERROR_10010002);
if (user == null) {
throw new ServiceException(ApiError.ERROR_10010002); // 用户不存在，抛出异常
}
// 被禁用
if(user.getState().equals(CommonState.ABNORMAL)){
throw new ServiceException(ApiError.ERROR_90010005);
// 检查用户是否被禁用
if (user.getState().equals(CommonState.ABNORMAL)) {
throw new ServiceException(ApiError.ERROR_90010005); // 用户被禁用，抛出异常
}
// 设置 JWT token 并返回登录信息
return this.setToken(user);
}
@Override
public void logout(String token) {
public void logout(String token) { // 用户登出方法
// 仅退出当前会话
// 退出当前会话
SecurityUtils.getSubject().logout();
}
@Override
public void update(SysUserDTO reqDTO) {
String pass = reqDTO.getPassword();
if(!StringUtils.isBlank(pass)){
PassInfo passInfo = PassHandler.buildPassword(pass);
SysUser user = this.getById(UserUtils.getUserId());
user.setPassword(passInfo.getPassword());
user.setSalt(passInfo.getSalt());
this.updateById(user);
}
public void update(SysUserDTO reqDTO) { // 更新用户信息
String pass = reqDTO.getPassword();
if (!StringUtils.isBlank(pass)) {
// 如果提供了新密码，则更新密码
PassInfo passInfo = PassHandler.buildPassword(pass);
SysUser user = this.getById(UserUtils.getUserId());
user.setPassword(passInfo.getPassword());
user.setSalt(passInfo.getSalt());
this.updateById(user); // 更新用户数据
}
}
@Transactional(rollbackFor = Exception.class)
@Transactional(rollbackFor = Exception.class) // 启用事务管理，保证数据一致性
@Override
public void save(SysUserSaveReqDTO reqDTO) {
public void save(SysUserSaveReqDTO reqDTO) { // 保存或修改用户信息
List<String> roles = reqDTO.getRoles();
if(CollectionUtils.isEmpty(roles)){
throw new ServiceException(ApiError.ERROR_90010003);
if (CollectionUtils.isEmpty(roles)) {
throw new ServiceException(ApiError.ERROR_90010003); // 角色列表不能为空，抛出异常
}
// 保存基本信息
SysUser user = new SysUser();
BeanMapper.copy(reqDTO, user);
// 添加模式
if(StringUtils.isBlank(user.getId())){
// 添加模式，生成新的 ID
if (StringUtils.isBlank(user.getId())) {
user.setId(IdWorker.getIdStr());
}
// 修改密码
if(!StringUtils.isBlank(reqDTO.getPassword())){
// 如果提供了密码，则加密并保存
if (!StringUtils.isBlank(reqDTO.getPassword())) {
PassInfo pass = PassHandler.buildPassword(reqDTO.getPassword());
user.setPassword(pass.getPassword());
user.setSalt(pass.getSalt());
@ -179,23 +188,23 @@ public class SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> impl
// 保存角色信息
String roleIds = sysUserRoleService.saveRoles(user.getId(), roles);
user.setRoleIds(roleIds);
this.saveOrUpdate(user);
this.saveOrUpdate(user); // 保存或更新用户信息
}
@Transactional(rollbackFor = Exception.class)
@Transactional(rollbackFor = Exception.class) // 启用事务管理
@Override
public SysUserLoginDTO reg(SysUserDTO reqDTO) {
public SysUserLoginDTO reg(SysUserDTO reqDTO) { // 用户注册方法
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUser::getUserName, reqDTO.getUserName());
int count = this.count(wrapper);
if(count > 0){
throw new ServiceException(1, "用户名已存在，换一个吧！");
if (count > 0) {
throw new ServiceException(1, "用户名已存在，换一个吧！"); // 用户名已存在，抛出异常
}
// 保存用户
SysUser user = new SysUser();
user.setId(IdWorker.getIdStr());
@ -212,21 +221,22 @@ public class SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> impl
user.setRoleIds(roleIds);
this.save(user);
// 返回生成的 token
return this.setToken(user);
}
@Override
public SysUserLoginDTO quickReg(SysUserDTO reqDTO) {
public SysUserLoginDTO quickReg(SysUserDTO reqDTO) { // 快速注册方法
QueryWrapper<SysUser> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(SysUser::getUserName, reqDTO.getUserName());
wrapper.last(" LIMIT 1 ");
SysUser user = this.getOne(wrapper);
if(user!=null){
return this.setToken(user);
if (user != null) {
return this.setToken(user); // 如果用户已存在，直接返回登录信息
}
return this.reg(reqDTO);
return this.reg(reqDTO); // 如果用户不存在，进行注册
}
@ -235,16 +245,16 @@ public class SysUserServiceImpl extends ServiceImpl<SysUserMapper, SysUser> impl
* @param user
* @return
*/
private SysUserLoginDTO setToken(SysUser user){
private SysUserLoginDTO setToken(SysUser user) { // 生成并设置用户的 JWT token
SysUserLoginDTO respDTO = new SysUserLoginDTO();
BeanMapper.copy(user, respDTO);
// 生成Token
// 生成 JWT token
String token = JwtUtils.sign(user.getUserName());
respDTO.setToken(token);
// 填充角色
// 填充角色信息
List<String> roles = sysUserRoleService.listRoles(user.getId());
respDTO.setRoles(roles);

54
src-源文件/main/java/com/yf/exam/modules/user/UserUtils.java
Unescape View File

@ -1,56 +1,56 @@
package com.yf.exam.modules.user;
package com.yf.exam.modules.user; // 包名：表示该类属于 user 包
import com.yf.exam.core.api.ApiError;
import com.yf.exam.core.exception.ServiceException;
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO;
import org.apache.shiro.SecurityUtils;
import com.yf.exam.core.api.ApiError; // 导入 ApiError 类，定义 API 错误码
import com.yf.exam.core.exception.ServiceException; // 导入 ServiceException 类，定义自定义服务异常
import com.yf.exam.modules.sys.user.dto.response.SysUserLoginDTO; // 导入用户登录响应 DTO 类
import org.apache.shiro.SecurityUtils; // 导入 Shiro 的 SecurityUtils 类，用于获取当前登录用户的信息
/**
* 用户静态工具类
* @author bool
* 提供当前登录用户的相关工具方法
* @作者 bool
*/
public class UserUtils {
/**
* 获取当前登录用户的ID
* @param throwable
* @return
* @param throwable 如果发生异常，是否抛出异常
* @return 当前登录用户的ID
*/
public static String getUserId(boolean throwable){
public static String getUserId(boolean throwable) { // 获取当前登录用户 ID 的方法
try {
// 使用 Shiro 获取当前用户的主体对象，然后从中提取用户 ID
return ((SysUserLoginDTO) SecurityUtils.getSubject().getPrincipal()).getId();
}catch (Exception e){
if(throwable){
throw new ServiceException(ApiError.ERROR_10010002);
} catch (Exception e) { // 捕获异常
if (throwable) { // 如果 throwable 为 true，则抛出自定义服务异常
throw new ServiceException(ApiError.ERROR_10010002); // 异常码：10010002
}
return null;
return null; // 如果发生异常且 throwable 为 false，则返回 null
}
}
/**
* 获取当前登录用户的ID
* @param throwable
* @return
* @param throwable 如果发生异常，是否抛出异常
* @return 当前登录用户的ID
*/
public static boolean isAdmin(boolean throwable){
public static boolean isAdmin(boolean throwable) { // 判断当前用户是否为管理员的方法
try {
SysUserLoginDTO dto = ((SysUserLoginDTO) SecurityUtils.getSubject().getPrincipal());
return dto.getRoles().contains("sa");
}catch (Exception e){
if(throwable){
throw new ServiceException(ApiError.ERROR_10010002);
SysUserLoginDTO dto = ((SysUserLoginDTO) SecurityUtils.getSubject().getPrincipal()); // 获取当前用户的登录信息
return dto.getRoles().contains("sa"); // 判断用户角色中是否包含管理员角色 "sa"
} catch (Exception e) { // 捕获异常
if (throwable) { // 如果 throwable 为 true，则抛出自定义服务异常
throw new ServiceException(ApiError.ERROR_10010002); // 异常码：10010002
}
}
return false;
return false; // 如果发生异常且 throwable 为 false，则返回 false
}
/**
* 获取当前登录用户的ID，默认是会抛异常的
* @return
* @return 当前登录用户的ID
*/
public static String getUserId(){
return getUserId(true);
public static String getUserId() { // 默认抛出异常的获取用户 ID 方法
return getUserId(true); // 调用带有 throwable 参数的方法，默认抛出异常
}
}

109
src-源文件/main/java/com/yf/exam/modules/user/book/controller/UserBookController.java
Unescape View File

@ -1,76 +1,79 @@
package com.yf.exam.modules.user.book.controller;
package com.yf.exam.modules.user.book.controller; // 包名：表示该类属于 user.book.controller 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.BaseIdRespDTO;
import com.yf.exam.core.api.dto.BaseIdsReqDTO;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.user.book.dto.UserBookDTO;
import com.yf.exam.modules.user.book.service.UserBookService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 分页接口
import com.yf.exam.core.api.ApiRest; // 导入 ApiRest 类，定义接口返回的统一格式
import com.yf.exam.core.api.controller.BaseController; // 导入 BaseController 基础控制器类，提供一些基础功能
import com.yf.exam.core.api.dto.BaseIdRespDTO; // 导入 BaseIdRespDTO 数据传输对象，用于返回 ID 响应
import com.yf.exam.core.api.dto.BaseIdsReqDTO; // 导入 BaseIdsReqDTO 数据传输对象，用于接收 ID 列表请求
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入 PagingReqDTO 数据传输对象，用于分页请求
import com.yf.exam.modules.user.book.dto.UserBookDTO; // 导入 UserBookDTO 数据传输对象，用于封装错题本数据
import com.yf.exam.modules.user.book.service.UserBookService; // 导入 UserBookService 服务接口，用于处理业务逻辑
import io.swagger.annotations.Api; // 导入 Swagger 的 Api 注解，用于生成 API 文档
import io.swagger.annotations.ApiOperation; // 导入 Swagger 的 ApiOperation 注解，用于描述 API 操作
import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于自动注入依赖
import org.springframework.web.bind.annotation.RequestBody; // 导入 RequestBody 注解，用于接收请求体数据
import org.springframework.web.bind.annotation.RequestMapping; // 导入 RequestMapping 注解，用于映射请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入 RequestMethod 枚举，表示请求方法类型
import org.springframework.web.bind.annotation.RestController; // 导入 RestController 注解，表示这是一个控制器类
/**
* <p>
* 错题本控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
@Api(tags={"错题本"})
@RestController
@RequestMapping("/exam/api/user/wrong-book")
public class UserBookController extends BaseController {
* <p>
* 错题本控制器
* </p>
* 该控制器处理与错题本相关的 API 请求
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
@Api(tags={"错题本"}) // 为这个控制器定义一个标签，用于生成 API 文档
@RestController // 标识该类为 Spring 的控制器类，自动注入到 Spring 上下文
@RequestMapping("/exam/api/user/wrong-book") // 设置该类的请求路径前缀
public class UserBookController extends BaseController { // 继承自 BaseController，享受基础功能
@Autowired
private UserBookService baseService;
private UserBookService baseService; // 注入 UserBookService，用于处理错题本的相关逻辑
/**
* 批量删除
* @param reqDTO
* @return
*/
@ApiOperation(value = "批量删除")
@RequestMapping(value = "/delete", method = { RequestMethod.POST})
public ApiRest delete(@RequestBody BaseIdsReqDTO reqDTO) {
//根据ID删除
* 批量删除
* @param reqDTO 请求数据传输对象，包含多个 ID
* @return 返回成功的响应
*/
@ApiOperation(value = "批量删除") // 为该方法生成 Swagger 的文档描述
@RequestMapping(value = "/delete", method = { RequestMethod.POST }) // 映射 POST 请求路径 "/delete"
public ApiRest delete(@RequestBody BaseIdsReqDTO reqDTO) { // 接收请求体中的 ID 列表
// 根据 ID 删除错题本数据
baseService.removeByIds(reqDTO.getIds());
return super.success();
return super.success(); // 返回成功的响应
}
/**
* 分页查找
* @param reqDTO
* @return
*/
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
public ApiRest<IPage<UserBookDTO>> paging(@RequestBody PagingReqDTO<UserBookDTO> reqDTO) {
* 分页查找
* @param reqDTO 请求数据传输对象，包含分页参数和查询条件
* @return 返回分页查询的结果
*/
@ApiOperation(value = "分页查找") // 为该方法生成 Swagger 的文档描述
@RequestMapping(value = "/paging", method = { RequestMethod.POST }) // 映射 POST 请求路径 "/paging"
public ApiRest<IPage<UserBookDTO>> paging(@RequestBody PagingReqDTO<UserBookDTO> reqDTO) { // 接收分页请求数据
//分页查询并转换
// 调用服务层的分页查询方法
IPage<UserBookDTO> page = baseService.paging(reqDTO);
return super.success(page);
return super.success(page); // 返回分页查询的结果
}
/**
* 查找列表，每次最多返回200条数据
* @param reqDTO
* @return
* @param reqDTO 请求数据传输对象，包含考试 ID 和题目 ID
* @return 返回下一题的 ID
*/
@ApiOperation(value = "查找列表")
@RequestMapping(value = "/next", method = { RequestMethod.POST})
public ApiRest<BaseIdRespDTO> nextQu(@RequestBody UserBookDTO reqDTO) {
//转换并返回
@ApiOperation(value = "查找列表") // 为该方法生成 Swagger 的文档描述
@RequestMapping(value = "/next", method = { RequestMethod.POST }) // 映射 POST 请求路径 "/next"
public ApiRest<BaseIdRespDTO> nextQu(@RequestBody UserBookDTO reqDTO) { // 接收包含考试 ID 和题目 ID 的请求数据
// 调用服务层的 findNext 方法查找下一题
String quId = baseService.findNext(reqDTO.getExamId(), reqDTO.getQuId());
return super.success(new BaseIdRespDTO(quId));
return super.success(new BaseIdRespDTO(quId)); // 返回下一题的 ID
}
}

75
src-源文件/main/java/com/yf/exam/modules/user/book/dto/UserBookDTO.java
Unescape View File

@ -1,52 +1,51 @@
package com.yf.exam.modules.user.book.dto;
package com.yf.exam.modules.user.book.dto; // 包名：表示该类属于 user.book.dto 包
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import io.swagger.annotations.ApiModel; // 导入 Swagger 的 ApiModel 注解，用于生成 API 文档中的模型描述
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 的 ApiModelProperty 注解，用于描述模型的属性
import lombok.Data; // 导入 Lombok 的 Data 注解，自动生成 getters、setters、toString 等方法
import java.io.Serializable;
import java.util.Date;
import java.io.Serializable; // 导入 Serializable 接口，用于对象序列化
import java.util.Date; // 导入 Date 类，用于处理日期数据
/**
* <p>
* 错题本请求类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
@Data
@ApiModel(value="错题本", description="错题本")
public class UserBookDTO implements Serializable {
* <p>
* 错题本请求类
* </p>
* 用于封装错题本相关的数据请求
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
@Data // Lombok 注解，自动生成常用的 getter、setter、toString、equals 和 hashCode 方法
@ApiModel(value="错题本", description="错题本") // Swagger 注解，定义该类用于描述错题本
public class UserBookDTO implements Serializable { // 实现 Serializable 接口，支持对象序列化
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 定义序列化版本 UID
@ApiModelProperty(value = "ID", required=true) // Swagger 注解，描述属性的含义和是否必填
private String id; // 错题本 ID
@ApiModelProperty(value = "ID", required=true)
private String id;
@ApiModelProperty(value = "考试ID", required=true) // Swagger 注解，描述考试 ID
private String examId; // 关联的考试 ID
@ApiModelProperty(value = "考试ID", required=true)
private String examId;
@ApiModelProperty(value = "用户ID", required=true) // Swagger 注解，描述用户 ID
private String userId; // 关联的用户 ID
@ApiModelProperty(value = "用户ID", required=true)
private String userId;
@ApiModelProperty(value = "题目ID", required=true) // Swagger 注解，描述题目 ID
private String quId; // 关联的题目 ID
@ApiModelProperty(value = "题目ID", required=true)
private String quId;
@ApiModelProperty(value = "加入时间", required=true) // Swagger 注解，描述错题本的加入时间
private Date createTime; // 错题本加入时间
@ApiModelProperty(value = "加入时间", required=true)
private Date createTime;
@ApiModelProperty(value = "最近错误时间", required=true) // Swagger 注解，描述最近一次错误的时间
private Date updateTime; // 最近一次错题的时间
@ApiModelProperty(value = "最近错误时间", required=true)
private Date updateTime;
@ApiModelProperty(value = "错误次数", required=true) // Swagger 注解，描述错题的错误次数
private Integer wrongCount; // 错题的错误次数
@ApiModelProperty(value = "错误时间", required=true)
private Integer wrongCount;
@ApiModelProperty(value = "题目标题", required=true) // Swagger 注解，描述题目标题
private String title; // 题目的标题
@ApiModelProperty(value = "题目标题", required=true)
private String title;
@ApiModelProperty(value = "错题序号", required=true)
private Integer sort;
}
@ApiModelProperty(value = "错题序号", required=true) // Swagger 注解，描述错题的序号
private Integer sort; // 错题的序号，用于排序
}

72
src-源文件/main/java/com/yf/exam/modules/user/book/entity/UserBook.java
Unescape View File

@ -1,78 +1,78 @@
package com.yf.exam.modules.user.book.entity;
package com.yf.exam.modules.user.book.entity; // 包名：表示该类属于 user.book.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 的 IdType，用于设置 ID 类型
import com.baomidou.mybatisplus.annotation.TableField; // 导入 TableField 注解，用于标识表字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 TableId 注解，用于标识表的主键
import com.baomidou.mybatisplus.annotation.TableName; // 导入 TableName 注解，用于标识表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 Model 类，用于支持 Active Record 模式
import lombok.Data; // 导入 Lombok 的 Data 注解，自动生成 getter、setter、toString 等方法
import java.util.Date;
import java.util.Date; // 导入 Date 类，用于处理日期类型数据
/**
* <p>
* 错题本实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
@Data
@TableName("el_user_book")
public class UserBook extends Model<UserBook> {
* <p>
* 错题本实体类
* </p>
* 该类表示错题本数据表中的记录
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
@Data // Lombok 注解，自动为类生成 getter、setter、toString、equals 和 hashCode 方法
@TableName("el_user_book") // 表示该类对应数据库中的 el_user_book 表
public class UserBook extends Model<UserBook> { // 继承自 MyBatis-Plus 的 Model 类，支持 Active Record 模式
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本 UID
/**
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
@TableId(value = "id", type = IdType.ASSIGN_ID) // 设置表的主键 ID 类型为 ASSIGN_ID，表示数据库自增长
private String id; // 错题本记录的 ID
/**
* 考试ID
*/
@TableField("exam_id")
private String examId;
@TableField("exam_id") // 映射数据库表的 exam_id 字段
private String examId; // 关联的考试 ID
/**
* 用户ID
*/
@TableField("user_id")
private String userId;
@TableField("user_id") // 映射数据库表的 user_id 字段
private String userId; // 关联的用户 ID
/**
* 题目ID
*/
@TableField("qu_id")
private String quId;
@TableField("qu_id") // 映射数据库表的 qu_id 字段
private String quId; // 关联的题目 ID
/**
* 加入时间
*/
@TableField("create_time")
private Date createTime;
@TableField("create_time") // 映射数据库表的 create_time 字段
private Date createTime; // 错题加入时间
/**
* 最近错误时间
*/
@TableField("update_time")
private Date updateTime;
@TableField("update_time") // 映射数据库表的 update_time 字段
private Date updateTime; // 最近一次错误的时间
/**
* 错误时间
*/
@TableField("wrong_count")
private Integer wrongCount;
@TableField("wrong_count") // 映射数据库表的 wrong_count 字段
private Integer wrongCount; // 错误的次数
/**
* 题目标题
*/
private String title;
private String title; // 题目的标题
/**
* 错题序号
*/
private Integer sort;
private Integer sort; // 错题的序号，用于排序
}

23
src-源文件/main/java/com/yf/exam/modules/user/book/mapper/UserBookMapper.java
Unescape View File

@ -1,16 +1,17 @@
package com.yf.exam.modules.user.book.mapper;
package com.yf.exam.modules.user.book.mapper; // 包名：表示该接口属于 user.book.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.yf.exam.modules.user.book.entity.UserBook;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，提供基本的 CRUD 操作
import com.yf.exam.modules.user.book.entity.UserBook; // 导入 UserBook 实体类，表示错题本数据
/**
* <p>
* 错题本Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
public interface UserBookMapper extends BaseMapper<UserBook> {
* <p>
* 错题本Mapper
* </p>
* 该接口用于操作错题本相关的数据，继承 MyBatis-Plus 提供的 BaseMapper
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
public interface UserBookMapper extends BaseMapper<UserBook> { // 继承 MyBatis-Plus 的 BaseMapper 接口，自动具备对 UserBook 实体的基本 CRUD 操作
}

57
src-源文件/main/java/com/yf/exam/modules/user/book/service/UserBookService.java
Unescape View File

@ -1,40 +1,41 @@
package com.yf.exam.modules.user.book.service;
package com.yf.exam.modules.user.book.service; // 包名：表示该接口属于 user.book.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.user.book.dto.UserBookDTO;
import com.yf.exam.modules.user.book.entity.UserBook;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，提供常用的 CRUD 操作
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求数据传输对象
import com.yf.exam.modules.user.book.dto.UserBookDTO; // 导入错题本 DTO 类，用于封装错题本的数据
import com.yf.exam.modules.user.book.entity.UserBook; // 导入错题本实体类，映射数据库中的错题本表
/**
* <p>
* 错题本业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
public interface UserBookService extends IService<UserBook> {
* <p>
* 错题本业务类
* </p>
* 提供与错题本相关的业务逻辑方法
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
public interface UserBookService extends IService<UserBook> { // 继承 MyBatis-Plus 的 IService 接口，提供基本的 CRUD 操作
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<UserBookDTO> paging(PagingReqDTO<UserBookDTO> reqDTO);
* 分页查询错题本数据
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询结果
*/
IPage<UserBookDTO> paging(PagingReqDTO<UserBookDTO> reqDTO); // 分页查询错题本数据
/**
* 加入错题本
* @param quId
* @param examId
* 将错题添加到错题本
* @param examId 考试 ID
* @param quId 题目 ID
*/
void addBook(String examId, String quId);
void addBook(String examId, String quId); // 将指定的错题添加到错题本
/**
* 查找第一个错题
* @param quId
* @param examId
* @return
* 查找下一个错题
* @param quId 当前题目 ID
* @param examId 当前考试 ID
* @return 返回下一个错题的 ID
*/
String findNext(String examId, String quId);
String findNext(String examId, String quId); // 查找下一个错题 ID
}

176
src-源文件/main/java/com/yf/exam/modules/user/book/service/impl/UserBookServiceImpl.java
Unescape View File

@ -1,155 +1,153 @@
package com.yf.exam.modules.user.book.service.impl;
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.TypeReference;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.qu.entity.Qu;
import com.yf.exam.modules.qu.service.QuService;
import com.yf.exam.modules.user.UserUtils;
import com.yf.exam.modules.user.book.dto.UserBookDTO;
import com.yf.exam.modules.user.book.entity.UserBook;
import com.yf.exam.modules.user.book.mapper.UserBookMapper;
import com.yf.exam.modules.user.book.service.UserBookService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import org.springframework.util.StringUtils;
package com.yf.exam.modules.user.book.service.impl; // 包名：表示该类属于 user.book.service.impl 包
import com.alibaba.fastjson.JSON; // 导入 fastjson，用于将对象转换为 JSON 字符串
import com.alibaba.fastjson.TypeReference; // 导入 TypeReference 用于反序列化复杂类型
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper 类，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 的分页插件
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 的 ServiceImpl 基类
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求的 DTO 类
import com.yf.exam.modules.qu.entity.Qu; // 导入题目实体类
import com.yf.exam.modules.qu.service.QuService; // 导入题目服务接口
import com.yf.exam.modules.user.UserUtils; // 导入用户工具类，用于获取当前用户信息
import com.yf.exam.modules.user.book.dto.UserBookDTO; // 导入错题本 DTO
import com.yf.exam.modules.user.book.entity.UserBook; // 导入错题本实体类
import com.yf.exam.modules.user.book.mapper.UserBookMapper; // 导入错题本 Mapper 类
import com.yf.exam.modules.user.book.service.UserBookService; // 导入错题本服务接口
import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于自动注入依赖
import org.springframework.stereotype.Service; // 导入 Service 注解，标识该类为 Spring 服务层组件
import org.springframework.util.StringUtils; // 导入 StringUtils 工具类，用于字符串操作
/**
* <p>
* 语言设置 服务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-05-27 17:56
*/
@Service
public class UserBookServiceImpl extends ServiceImpl<UserBookMapper, UserBook> implements UserBookService {
* <p>
* 错题本服务实现类
* </p>
* 实现了错题本相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-05-27 17:56
*/
@Service // 标识该类为 Spring 的服务类
public class UserBookServiceImpl extends ServiceImpl<UserBookMapper, UserBook> implements UserBookService { // 继承 MyBatis-Plus 的 ServiceImpl，实现 UserBookService 接口
@Autowired
private QuService quService;
private QuService quService; // 注入题目服务，用于获取题目内容
@Override
public IPage<UserBookDTO> paging(PagingReqDTO<UserBookDTO> reqDTO) {
public IPage<UserBookDTO> paging(PagingReqDTO<UserBookDTO> reqDTO) { // 分页查询错题本数据
//创建分页对象
// 创建分页对象
Page query = new Page<>(reqDTO.getCurrent(), reqDTO.getSize());
//查询条件
// 查询条件
QueryWrapper<UserBook> wrapper = new QueryWrapper<>();
// 查找用户的错题
wrapper.lambda().eq(UserBook::getUserId, UserUtils.getUserId(true));
UserBookDTO params = reqDTO.getParams();
if(params!=null){
if(!StringUtils.isEmpty(params.getTitle())){
if(params != null) {
// 根据题目标题查询
if(!StringUtils.isEmpty(params.getTitle())) {
wrapper.lambda().like(UserBook::getTitle, params.getTitle());
}
if(!StringUtils.isEmpty(params.getExamId())){
// 根据考试 ID 查询
if(!StringUtils.isEmpty(params.getExamId())) {
wrapper.lambda().eq(UserBook::getExamId, params.getExamId());
}
}
//获得数据
// 执行分页查询
IPage<UserBook> page = this.page(query, wrapper);
//转换结果
IPage<UserBookDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<UserBookDTO>>(){});
// 转换结果为 DTO
IPage<UserBookDTO> pageData = JSON.parseObject(JSON.toJSONString(page), new TypeReference<Page<UserBookDTO>>() {});
return pageData;
}
}
@Override
public void addBook(String examId, String quId) {
public void addBook(String examId, String quId) { // 添加错题到错题本
QueryWrapper<UserBook> wrapper = new QueryWrapper<>();
wrapper.lambda()
.eq(UserBook::getUserId, UserUtils.getUserId())
.eq(UserBook::getExamId, examId)
.eq(UserBook::getQuId, quId);
.eq(UserBook::getUserId, UserUtils.getUserId()) // 查找当前用户的错题
.eq(UserBook::getExamId, examId) // 查找特定考试的错题
.eq(UserBook::getQuId, quId); // 查找特定题目的错题
//查找已有的错题信息
// 查找已有的错题信息
UserBook book = this.getOne(wrapper, false);
// 问题
// 获取题目信息
Qu qu = quService.getById(quId);
if (book == null) {
if (book == null) { // 如果错题本中没有该题目，则添加
book = new UserBook();
book.setExamId(examId);
book.setUserId(UserUtils.getUserId());
book.setTitle(qu.getContent());
book.setUserId(UserUtils.getUserId()); // 设置当前用户的 ID
book.setTitle(qu.getContent()); // 设置题目内容
book.setQuId(quId);
book.setWrongCount(1);
Integer maxSort = this.findMaxSort(examId, UserUtils.getUserId());
book.setSort(maxSort+1);
this.save(book);
} else {
book.setWrongCount(book.getWrongCount()+1);
this.updateById(book);
book.setWrongCount(1); // 错误次数初始化为 1
Integer maxSort = this.findMaxSort(examId, UserUtils.getUserId()); // 查找当前用户的最大排序号
book.setSort(maxSort + 1); // 设置错题的排序号
this.save(book); // 保存错题记录
} else { // 如果错题本中已有该题目，则更新错误次数
book.setWrongCount(book.getWrongCount() + 1); // 错误次数加 1
this.updateById(book); // 更新错题记录
}
}
@Override
public String findNext(String examId, String quId) {
public String findNext(String examId, String quId) { // 查找下一个错题
Integer sort = 999999;
if(!StringUtils.isEmpty(quId)){
if(!StringUtils.isEmpty(quId)) {
QueryWrapper<UserBook> wrapper = new QueryWrapper<>();
wrapper.lambda()
.eq(UserBook::getUserId, UserUtils.getUserId())
.eq(UserBook::getExamId, examId)
.eq(UserBook::getQuId, quId);
wrapper.last(" ORDER BY `sort` DESC");
.eq(UserBook::getUserId, UserUtils.getUserId()) // 查找当前用户的错题
.eq(UserBook::getExamId, examId) // 查找特定考试的错题
.eq(UserBook::getQuId, quId); // 查找特定题目的错题
wrapper.last(" ORDER BY `sort` DESC"); // 按照排序降序排列
UserBook last = this.getOne(wrapper, false);
if(last!=null){
sort = last.getSort();
if(last != null) {
sort = last.getSort(); // 获取当前错题的排序号
}
}
QueryWrapper<UserBook> wrapper = new QueryWrapper<>();
wrapper.lambda()
.eq(UserBook::getUserId, UserUtils.getUserId())
.eq(UserBook::getExamId, examId)
.lt(UserBook::getSort, sort);
wrapper.last(" ORDER BY `sort` DESC");
UserBook next = this.getOne(wrapper, false);
if(next != null){
return next.getQuId();
.eq(UserBook::getUserId, UserUtils.getUserId()) // 查找当前用户的错题
.eq(UserBook::getExamId, examId) // 查找特定考试的错题
.lt(UserBook::getSort, sort); // 查找排序号小于当前错题的错题
wrapper.last(" ORDER BY `sort` DESC"); // 按照排序降序排列
UserBook next = this.getOne(wrapper, false); // 查找下一个错题
if(next != null) {
return next.getQuId(); // 返回下一个错题的 ID
}
return null;
return null; // 如果没有下一个错题，返回 null
}
/**
* 查找最大的排序
* @param userId
* @return
* @param examId 考试 ID
* @param userId 用户 ID
* @return 返回最大的排序号
*/
private Integer findMaxSort(String examId, String userId){
private Integer findMaxSort(String examId, String userId) { // 查找当前用户在某个考试中的最大排序号
QueryWrapper<UserBook> wrapper = new QueryWrapper<>();
wrapper.lambda()
.eq(UserBook::getExamId, examId)
.eq(UserBook::getUserId, userId);
wrapper.last(" ORDER BY `sort` DESC");
.eq(UserBook::getExamId, examId) // 查找特定考试的错题
.eq(UserBook::getUserId, userId); // 查找当前用户的错题
wrapper.last(" ORDER BY `sort` DESC"); // 按照排序号降序排列
UserBook book = this.getOne(wrapper, false);
if(book == null){
return 0;
UserBook book = this.getOne(wrapper, false); // 获取最大排序号的错题
if(book == null) {
return 0; // 如果没有错题，返回 0
}
return book.getSort();
return book.getSort(); // 返回最大排序号
}
}

91
src-源文件/main/java/com/yf/exam/modules/user/exam/controller/UserExamController.java
Unescape View File

@ -1,65 +1,64 @@
package com.yf.exam.modules.user.exam.controller;
package com.yf.exam.modules.user.exam.controller; // 包名：表示该类属于 user.exam.controller 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.yf.exam.core.api.ApiRest;
import com.yf.exam.core.api.controller.BaseController;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO;
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO;
import com.yf.exam.modules.user.exam.service.UserExamService;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.yf.exam.core.api.ApiRest; // 导入 API 响应封装类，用于统一返回格式
import com.yf.exam.core.api.controller.BaseController; // 导入基础控制器类，提供通用的接口方法
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO 类，用于封装分页参数
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO; // 导入用户考试请求 DTO 类，用于封装考试查询参数
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO; // 导入用户考试响应 DTO 类，用于封装查询结果
import com.yf.exam.modules.user.exam.service.UserExamService; // 导入用户考试服务接口，用于处理考试相关的业务逻辑
import io.swagger.annotations.Api; // 导入 Swagger 注解，用于生成 API 文档中的标签
import io.swagger.annotations.ApiOperation; // 导入 Swagger 注解，用于描述接口方法
import org.springframework.beans.factory.annotation.Autowired; // 导入 Autowired 注解，用于自动注入依赖
import org.springframework.web.bind.annotation.RequestBody; // 导入 RequestBody 注解，用于绑定请求体参数
import org.springframework.web.bind.annotation.RequestMapping; // 导入 RequestMapping 注解，用于映射请求路径
import org.springframework.web.bind.annotation.RequestMethod; // 导入 RequestMethod 枚举，用于指定请求方法类型
import org.springframework.web.bind.annotation.RestController; // 导入 RestController 注解，标识该类为 RESTful 风格的控制器
/**
* <p>
* 考试记录控制器
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Api(tags={"考试记录"})
@RestController
@RequestMapping("/exam/api/user/exam")
public class UserExamController extends BaseController {
* <p>
* 考试记录控制器
* </p>
* 用于处理用户的考试记录相关请求
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Api(tags={"考试记录"}) // Swagger 注解，定义该类在 API 文档中的标签
@RestController // 标识该类为 RESTful 风格的控制器
@RequestMapping("/exam/api/user/exam") // 映射请求路径，所有接口都以 "/exam/api/user/exam" 开头
public class UserExamController extends BaseController { // 继承 BaseController，提供基础的响应方法
@Autowired
private UserExamService baseService;
private UserExamService baseService; // 自动注入 UserExamService 服务，处理考试记录相关业务
/**
* 分页查找
* @param reqDTO
* @return
* 分页查找考试记录
* @param reqDTO 分页请求数据传输对象
* @return 返回分页查询的考试记录结果
*/
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/paging", method = { RequestMethod.POST})
public ApiRest<IPage<UserExamRespDTO>> paging(@RequestBody PagingReqDTO<UserExamReqDTO> reqDTO) {
@ApiOperation(value = "分页查找") // Swagger 注解，描述接口方法的作用
@RequestMapping(value = "/paging", method = { RequestMethod.POST}) // 映射 POST 请求路径 "/exam/api/user/exam/paging"
public ApiRest<IPage<UserExamRespDTO>> paging(@RequestBody PagingReqDTO<UserExamReqDTO> reqDTO) { // 接收分页请求，返回分页结果
//分页查询并转换
// 调用服务层方法进行分页查询，并将结果转换为响应 DTO
IPage<UserExamRespDTO> page = baseService.paging(reqDTO);
return super.success(page);
return super.success(page); // 调用父类的 success 方法返回查询结果
}
/**
* 分页查找
* @param reqDTO
* @return
*/
@ApiOperation(value = "分页查找")
@RequestMapping(value = "/my-paging", method = { RequestMethod.POST})
public ApiRest<IPage<UserExamRespDTO>> myPaging(@RequestBody PagingReqDTO<UserExamReqDTO> reqDTO) {
* 分页查找用户自己的考试记录
* @param reqDTO 分页请求数据传输对象
* @return 返回用户的分页考试记录
*/
@ApiOperation(value = "分页查找") // Swagger 注解，描述接口方法的作用
@RequestMapping(value = "/my-paging", method = { RequestMethod.POST}) // 映射 POST 请求路径 "/exam/api/user/exam/my-paging"
public ApiRest<IPage<UserExamRespDTO>> myPaging(@RequestBody PagingReqDTO<UserExamReqDTO> reqDTO) { // 接收分页请求，返回用户的分页考试记录
//分页查询并转换
// 调用服务层方法进行分页查询，并将结果转换为响应 DTO
IPage<UserExamRespDTO> page = baseService.myPaging(reqDTO);
return super.success(page);
return super.success(page); // 调用父类的 success 方法返回查询结果
}
}

114
src-源文件/main/java/com/yf/exam/modules/user/exam/dto/UserExamDTO.java
Unescape View File

@ -1,50 +1,72 @@
package com.yf.exam.modules.user.exam.dto;
package com.yf.exam.modules.user.exam.dto; // 包名：表示该类属于 user.exam.dto 包
import com.yf.exam.core.annon.Dict;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import java.util.Date;
import java.io.Serializable;
import com.yf.exam.core.annon.Dict; // 导入 Dict 注解，用于字段的字典数据转换
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于生成 API 文档中的描述
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述类字段
import lombok.Data; // 导入 Lombok 的 Data 注解，用于自动生成 getter、setter 等方法
import java.util.Date; // 导入 Date 类，用于处理时间
import java.io.Serializable; // 导入 Serializable 接口，确保该类可以序列化
/**
* <p>
* 考试记录数据传输类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Data
@ApiModel(value="考试记录", description="考试记录")
public class UserExamDTO implements Serializable {
private static final long serialVersionUID = 1L;
private String id;
@ApiModelProperty(value = "用户ID", required=true)
private String userId;
@Dict(dictTable = "el_exam", dicText = "title", dicCode = "id")
@ApiModelProperty(value = "考试ID", required=true)
private String examId;
@ApiModelProperty(value = "考试次数", required=true)
private Integer tryCount;
@ApiModelProperty(value = "最高分数", required=true)
private Integer maxScore;
@ApiModelProperty(value = "是否通过", required=true)
private Boolean passed;
@ApiModelProperty(value = "创建时间")
private Date createTime;
@ApiModelProperty(value = "更新时间")
private Date updateTime;
* <p>
* 考试记录数据传输类
* </p>
* 用于封装考试记录相关数据
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Data // Lombok 注解，自动为类生成 getter、setter、toString 等方法
@ApiModel(value="考试记录", description="考试记录") // Swagger 注解，描述该类的作用，生成 API 文档时使用
public class UserExamDTO implements Serializable { // 实现 Serializable 接口，使该类可以序列化
private static final long serialVersionUID = 1L; // 序列化版本 UID
/**
* 用户ID
*/
private String id; // 用户ID字段
/**
* 用户ID
*/
@ApiModelProperty(value = "用户ID", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String userId; // 用户ID字段
/**
* 考试ID
*/
@Dict(dictTable = "el_exam", dicText = "title", dicCode = "id") // 使用 Dict 注解，指定字典表及映射字段
@ApiModelProperty(value = "考试ID", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String examId; // 考试ID字段
/**
* 考试次数
*/
@ApiModelProperty(value = "考试次数", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private Integer tryCount; // 考试次数字段
/**
* 最高分数
*/
@ApiModelProperty(value = "最高分数", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private Integer maxScore; // 最高分数字段
/**
* 是否通过
*/
@ApiModelProperty(value = "是否通过", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private Boolean passed; // 是否通过字段
/**
* 创建时间
*/
@ApiModelProperty(value = "创建时间") // Swagger 注解，描述字段的作用
private Date createTime; // 创建时间字段
/**
* 更新时间
*/
@ApiModelProperty(value = "更新时间") // Swagger 注解，描述字段的作用
private Date updateTime; // 更新时间字段
}

56
src-源文件/main/java/com/yf/exam/modules/user/exam/dto/request/UserExamReqDTO.java
Unescape View File

@ -1,30 +1,34 @@
package com.yf.exam.modules.user.exam.dto.request;
package com.yf.exam.modules.user.exam.dto.request; // 包名：表示该类属于 user.exam.dto.request 包
import com.yf.exam.modules.user.exam.dto.UserExamDTO;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import com.yf.exam.modules.user.exam.dto.UserExamDTO; // 导入 UserExamDTO 类，作为父类，包含通用的考试记录信息
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于生成 API 文档中的描述
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述类字段
import lombok.Data; // 导入 Lombok 的 Data 注解，用于自动生成 getter、setter 等方法
/**
* <p>
* 考试记录数据传输类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Data
@ApiModel(value="考试记录", description="考试记录")
public class UserExamReqDTO extends UserExamDTO {
private static final long serialVersionUID = 1L;
@ApiModelProperty(value = "考试名称", required=true)
private String title;
@ApiModelProperty(value = "人员名称", required=true)
private String realName;
* <p>
* 考试记录数据传输类
* </p>
* 用于封装请求中的考试记录数据
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Data // Lombok 注解，自动为类生成 getter、setter、toString 等方法
@ApiModel(value="考试记录", description="考试记录") // Swagger 注解，描述该类的作用，生成 API 文档时使用
public class UserExamReqDTO extends UserExamDTO { // 继承 UserExamDTO 类，扩展额外的请求字段
private static final long serialVersionUID = 1L; // 序列化版本 UID
/**
* 考试名称
*/
@ApiModelProperty(value = "考试名称", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String title; // 考试名称字段
/**
* 人员名称
*/
@ApiModelProperty(value = "人员名称", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String realName; // 人员名称字段
}

49
src-源文件/main/java/com/yf/exam/modules/user/exam/dto/response/UserExamRespDTO.java
Unescape View File

@ -1,29 +1,34 @@
package com.yf.exam.modules.user.exam.dto.response;
package com.yf.exam.modules.user.exam.dto.response; // 包名：表示该类属于 user.exam.dto.response 包
import com.yf.exam.modules.user.exam.dto.UserExamDTO;
import io.swagger.annotations.ApiModel;
import io.swagger.annotations.ApiModelProperty;
import lombok.Data;
import com.yf.exam.modules.user.exam.dto.UserExamDTO; // 导入 UserExamDTO 类，作为父类，包含通用的考试记录信息
import io.swagger.annotations.ApiModel; // 导入 Swagger 注解，用于生成 API 文档中的描述
import io.swagger.annotations.ApiModelProperty; // 导入 Swagger 注解，用于描述类字段
import lombok.Data; // 导入 Lombok 的 Data 注解，用于自动生成 getter、setter 等方法
/**
* <p>
* 考试记录数据传输类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Data
@ApiModel(value="考试记录", description="考试记录")
public class UserExamRespDTO extends UserExamDTO {
* <p>
* 考试记录数据传输类
* </p>
* 用于封装响应中的考试记录数据
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Data // Lombok 注解，自动为类生成 getter、setter、toString 等方法
@ApiModel(value="考试记录", description="考试记录") // Swagger 注解，描述该类的作用，生成 API 文档时使用
public class UserExamRespDTO extends UserExamDTO { // 继承 UserExamDTO 类，扩展额外的响应字段
private static final long serialVersionUID = 1L;
private static final long serialVersionUID = 1L; // 序列化版本 UID
/**
* 考试名称
*/
@ApiModelProperty(value = "考试名称", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String title; // 考试名称字段
@ApiModelProperty(value = "考试名称", required=true)
private String title;
@ApiModelProperty(value = "人员名称", required=true)
private String realName;
/**
* 人员名称
*/
@ApiModelProperty(value = "人员名称", required=true) // Swagger 注解，描述字段的作用，设置为必填项
private String realName; // 人员名称字段
}

117
src-源文件/main/java/com/yf/exam/modules/user/exam/entity/UserExam.java
Unescape View File

@ -1,69 +1,72 @@
package com.yf.exam.modules.user.exam.entity;
package com.yf.exam.modules.user.exam.entity; // 包名：表示该类属于 user.exam.entity 包
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.extension.activerecord.Model;
import lombok.Data;
import java.util.Date;
import com.baomidou.mybatisplus.annotation.IdType; // 导入 MyBatis-Plus 注解，用于指定主键策略
import com.baomidou.mybatisplus.annotation.TableField; // 导入 MyBatis-Plus 注解，用于指定数据库表字段
import com.baomidou.mybatisplus.annotation.TableId; // 导入 MyBatis-Plus 注解，用于指定主键字段
import com.baomidou.mybatisplus.annotation.TableName; // 导入 MyBatis-Plus 注解，用于指定数据库表名
import com.baomidou.mybatisplus.extension.activerecord.Model; // 导入 MyBatis-Plus 提供的 Model 类，用于增强实体类
import lombok.Data; // 导入 Lombok 注解，用于自动生成 getter、setter 等方法
import java.util.Date; // 导入 Date 类，用于处理时间
/**
* <p>
* 考试记录实体类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Data
@TableName("el_user_exam")
public class UserExam extends Model<UserExam> {
* <p>
* 考试记录实体类
* </p>
* 用于映射数据库中的考试记录表
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Data // Lombok 注解，自动为类生成 getter、setter、toString 等方法
@TableName("el_user_exam") // MyBatis-Plus 注解，指定该实体类对应的数据库表名为 "el_user_exam"
public class UserExam extends Model<UserExam> { // 继承 Model 类，提供额外的 MyBatis-Plus 功能
private static final long serialVersionUID = 1L; // 序列化版本 UID
private static final long serialVersionUID = 1L;
@TableId(value = "id", type = IdType.ASSIGN_ID)
private String id;
/**
* 用户ID
*/
@TableField("user_id")
private String userId;
* ID
*/
@TableId(value = "id", type = IdType.ASSIGN_ID) // MyBatis-Plus 注解，指定主键字段为 "id"，主键类型为 "ASSIGN_ID"
private String id; // ID字段
/**
* 考试ID
*/
@TableField("exam_id")
private String examId;
* 用户ID
*/
@TableField("user_id") // MyBatis-Plus 注解，指定数据库字段 "user_id" 对应实体类的 "userId" 字段
private String userId; // 用户ID字段
/**
* 考试次数
*/
@TableField("try_count")
private Integer tryCount;
* 考试ID
*/
@TableField("exam_id") // MyBatis-Plus 注解，指定数据库字段 "exam_id" 对应实体类的 "examId" 字段
private String examId; // 考试ID字段
/**
* 最高分数
*/
@TableField("max_score")
private Integer maxScore;
* 考试次数
*/
@TableField("try_count") // MyBatis-Plus 注解，指定数据库字段 "try_count" 对应实体类的 "tryCount" 字段
private Integer tryCount; // 考试次数字段
/**
* 是否通过
*/
private Boolean passed;
* 最高分数
*/
@TableField("max_score") // MyBatis-Plus 注解，指定数据库字段 "max_score" 对应实体类的 "maxScore" 字段
private Integer maxScore; // 最高分数字段
/**
* 是否通过
*/
private Boolean passed; // 是否通过字段
/**
* 创建时间
*/
@TableField("create_time")
private Date createTime;
* 创建时间
*/
@TableField("create_time") // MyBatis-Plus 注解，指定数据库字段 "create_time" 对应实体类的 "createTime" 字段
private Date createTime; // 创建时间字段
/**
* 更新时间
*/
@TableField("update_time")
private Date updateTime;
* 更新时间
*/
@TableField("update_time") // MyBatis-Plus 注解，指定数据库字段 "update_time" 对应实体类的 "updateTime" 字段
private Date updateTime; // 更新时间字段
}

44
src-源文件/main/java/com/yf/exam/modules/user/exam/mapper/UserExamMapper.java
Unescape View File

@ -1,29 +1,29 @@
package com.yf.exam.modules.user.exam.mapper;
package com.yf.exam.modules.user.exam.mapper; // 包名：表示该类属于 user.exam.mapper 包
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO;
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO;
import com.yf.exam.modules.user.exam.entity.UserExam;
import org.apache.ibatis.annotations.Param;
import com.baomidou.mybatisplus.core.mapper.BaseMapper; // 导入 MyBatis-Plus 的 BaseMapper 接口，提供基本的数据库操作
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.plugins.pagination.Page; // 导入 MyBatis-Plus 的 Page 类，用于分页查询
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO; // 导入用户考试请求 DTO 类，用于封装分页查询请求
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO; // 导入用户考试响应 DTO 类，用于封装分页查询结果
import com.yf.exam.modules.user.exam.entity.UserExam; // 导入用户考试实体类，用于映射数据库表
import org.apache.ibatis.annotations.Param; // 导入 MyBatis 的 Param 注解，用于标注方法参数
/**
* <p>
* 考试记录Mapper
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
public interface UserExamMapper extends BaseMapper<UserExam> {
* <p>
* 考试记录Mapper
* </p>
* 用于处理考试记录的数据访问层操作
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
public interface UserExamMapper extends BaseMapper<UserExam> { // 继承 BaseMapper 提供基础的增删改查功能
/**
* 我的考试分页
* @param page
* @param query
* @return
* 我的考试分页查询
* @param page 分页对象，用于控制查询的页数和每页的数据量
* @param query 查询参数，封装了分页和查询条件
* @return 返回分页查询的结果
*/
IPage<UserExamRespDTO> paging(Page page, @Param("query") UserExamReqDTO query);
IPage<UserExamRespDTO> paging(Page page, @Param("query") UserExamReqDTO query); // 自定义分页查询方法，返回分页结果
}

60
src-源文件/main/java/com/yf/exam/modules/user/exam/service/UserExamService.java
Unescape View File

@ -1,43 +1,43 @@
package com.yf.exam.modules.user.exam.service;
package com.yf.exam.modules.user.exam.service; // 包名：表示该类属于 user.exam.service 包
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO;
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO;
import com.yf.exam.modules.user.exam.entity.UserExam;
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.IService; // 导入 MyBatis-Plus 的 IService 接口，提供基础服务接口
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO 类，用于封装分页查询请求
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO; // 导入用户考试请求 DTO 类
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO; // 导入用户考试响应 DTO 类
import com.yf.exam.modules.user.exam.entity.UserExam; // 导入用户考试实体类，用于映射数据库表
/**
* <p>
* 考试记录业务类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
public interface UserExamService extends IService<UserExam> {
/**
* 分页查询数据
* @param reqDTO
* @return
*/
IPage<UserExamRespDTO> paging(PagingReqDTO<UserExamReqDTO> reqDTO);
* <p>
* 考试记录业务类
* </p>
* 提供用户考试记录相关的业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
public interface UserExamService extends IService<UserExam> { // 继承 IService 接口，提供对 UserExam 实体的增删改查功能
/**
* 分页查询数据
* @param reqDTO
* @return
* @param reqDTO 分页请求 DTO，封装了分页查询参数
* @return 返回分页查询的结果
*/
IPage<UserExamRespDTO> myPaging(PagingReqDTO<UserExamReqDTO> reqDTO);
IPage<UserExamRespDTO> paging(PagingReqDTO<UserExamReqDTO> reqDTO); // 用于分页查询考试记录
/**
* 分页查询数据，针对当前用户
* @param reqDTO 分页请求 DTO，封装了分页查询参数
* @return 返回分页查询的结果
*/
IPage<UserExamRespDTO> myPaging(PagingReqDTO<UserExamReqDTO> reqDTO); // 用于分页查询当前用户的考试记录
/**
* 考试完成后加入成绩
* @param userId
* @param examId
* @param score
* @param passed
* @param userId 用户ID
* @param examId 考试ID
* @param score 用户得分
* @param passed 用户是否通过考试
*/
void joinResult(String userId, String examId, Integer score, boolean passed);
void joinResult(String userId, String examId, Integer score, boolean passed); // 记录用户考试结果
}

113
src-源文件/main/java/com/yf/exam/modules/user/exam/service/impl/UserExamServiceImpl.java
Unescape View File

@ -1,88 +1,87 @@
package com.yf.exam.modules.user.exam.service.impl;
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper;
import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.yf.exam.core.api.dto.PagingReqDTO;
import com.yf.exam.modules.user.UserUtils;
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO;
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO;
import com.yf.exam.modules.user.exam.entity.UserExam;
import com.yf.exam.modules.user.exam.mapper.UserExamMapper;
import com.yf.exam.modules.user.exam.service.UserExamService;
import org.springframework.stereotype.Service;
import java.util.Date;
package com.yf.exam.modules.user.exam.service.impl; // 包名：表示该类属于 user.exam.service.impl 包
import com.baomidou.mybatisplus.core.conditions.query.QueryWrapper; // 导入 MyBatis-Plus 的 QueryWrapper，用于构建查询条件
import com.baomidou.mybatisplus.core.metadata.IPage; // 导入 MyBatis-Plus 的 IPage 接口，用于分页查询
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; // 导入 MyBatis-Plus 提供的 ServiceImpl 类，提供基础的服务层实现
import com.yf.exam.core.api.dto.PagingReqDTO; // 导入分页请求 DTO 类，用于封装分页查询请求
import com.yf.exam.modules.user.UserUtils; // 导入 UserUtils 工具类，用于获取当前用户的 ID
import com.yf.exam.modules.user.exam.dto.request.UserExamReqDTO; // 导入用户考试请求 DTO 类
import com.yf.exam.modules.user.exam.dto.response.UserExamRespDTO; // 导入用户考试响应 DTO 类
import com.yf.exam.modules.user.exam.entity.UserExam; // 导入用户考试实体类，用于映射数据库表
import com.yf.exam.modules.user.exam.mapper.UserExamMapper; // 导入用户考试 Mapper 类，提供数据库操作
import com.yf.exam.modules.user.exam.service.UserExamService; // 导入用户考试服务接口
import org.springframework.stereotype.Service; // 导入 Service 注解，标识该类为服务层组件
import java.util.Date; // 导入 Date 类，用于处理时间
/**
* <p>
* 考试记录业务实现类
* </p>
*
* @author 聪明笨狗
* @since 2020-09-21 15:13
*/
@Service
public class UserExamServiceImpl extends ServiceImpl<UserExamMapper, UserExam> implements UserExamService {
* <p>
* 考试记录业务实现类
* </p>
* 实现了 UserExamService 接口，提供考试记录相关业务逻辑
*
* @作者 聪明笨狗
* @版本 2020-09-21 15:13
*/
@Service // 标识该类为 Spring 服务层组件
public class UserExamServiceImpl extends ServiceImpl<UserExamMapper, UserExam> implements UserExamService { // 继承 ServiceImpl 类，提供基础的增删改查功能，并实现 UserExamService 接口
@Override
public IPage<UserExamRespDTO> paging(PagingReqDTO<UserExamReqDTO> reqDTO) {
public IPage<UserExamRespDTO> paging(PagingReqDTO<UserExamReqDTO> reqDTO) { // 分页查询方法
//转换结果
// 使用 MyBatis-Plus 提供的 paging 方法进行分页查询，并转换为响应 DTO 类型
IPage<UserExamRespDTO> pageData = baseMapper.paging(reqDTO.toPage(), reqDTO.getParams());
return pageData;
return pageData; // 返回分页查询结果
}
@Override
public IPage<UserExamRespDTO> myPaging(PagingReqDTO<UserExamReqDTO> reqDTO) {
public IPage<UserExamRespDTO> myPaging(PagingReqDTO<UserExamReqDTO> reqDTO) { // 我的考试分页查询方法
UserExamReqDTO params = reqDTO.getParams();
UserExamReqDTO params = reqDTO.getParams(); // 获取请求参数
if(params==null){
// 如果没有传入参数，则初始化为空的 UserExamReqDTO 对象
if(params == null) {
params = new UserExamReqDTO();
}
params.setUserId(UserUtils.getUserId());
params.setUserId(UserUtils.getUserId()); // 设置当前用户的 ID
//转换结果
// 使用 MyBatis-Plus 提供的 paging 方法进行分页查询，并转换为响应 DTO 类型
IPage<UserExamRespDTO> pageData = baseMapper.paging(reqDTO.toPage(), params);
return pageData;
return pageData; // 返回分页查询结果
}
@Override
public void joinResult(String userId, String examId, Integer score, boolean passed) {
public void joinResult(String userId, String examId, Integer score, boolean passed) { // 记录考试结果的方法
//查询条件
// 构建查询条件，查找用户的考试记录
QueryWrapper<UserExam> wrapper = new QueryWrapper<>();
wrapper.lambda().eq(UserExam::getUserId, userId)
.eq(UserExam::getExamId, examId);
wrapper.lambda().eq(UserExam::getUserId, userId) // 查询条件：用户 ID
.eq(UserExam::getExamId, examId); // 查询条件：考试 ID
UserExam record = this.getOne(wrapper, false);
if(record == null){
UserExam record = this.getOne(wrapper, false); // 查找匹配的记录
if(record == null) { // 如果记录不存在，则创建新记录
record = new UserExam();
record.setCreateTime(new Date());
record.setUpdateTime(new Date());
record.setUserId(userId);
record.setExamId(examId);
record.setMaxScore(score);
record.setPassed(passed);
this.save(record);
record.setCreateTime(new Date()); // 设置创建时间
record.setUpdateTime(new Date()); // 设置更新时间
record.setUserId(userId); // 设置用户 ID
record.setExamId(examId); // 设置考试 ID
record.setMaxScore(score); // 设置最大分数
record.setPassed(passed); // 设置是否通过
this.save(record); // 保存新记录
return;
}
// 修复低分数不加入统计问题
record.setTryCount(record.getTryCount()+1);
record.setUpdateTime(new Date());
// 如果记录存在，则更新该记录
record.setTryCount(record.getTryCount() + 1); // 增加考试次数
record.setUpdateTime(new Date()); // 更新更新时间
if(record.getMaxScore() < score){
record.setMaxScore(score);
record.setPassed(passed);
// 如果当前分数高于记录中的最大分数，则更新最大分数
if(record.getMaxScore() < score) {
record.setMaxScore(score); // 更新最大分数
record.setPassed(passed); // 更新是否通过
}
this.updateById(record);
this.updateById(record); // 更新记录
}
}

Write Preview
Loading…
Cancel
Save