当前位置： 首页 > news >正文

【OJ项目】深入剖析题目接口控制器：功能、实现与应用

news 2025/8/26 16:30:30

《深入剖析题目接口控制器：功能、实现与应用》

一、引言

在在线编程平台或竞赛系统中，题目管理和提交是核心功能之一。QuestionController 类作为控制器层，承担着处理与题目相关的各种请求的重要职责，包括题目的增删改查、题目提交等操作。本文将详细剖析该类的代码，深入理解其功能和实现细节。

二、类概述

QuestionController 类使用 Spring 的 @RestController 注解，表明它是一个 RESTful 风格的控制器，用于处理 HTTP 请求。它位于 / 根路径下，提供了一系列与题目相关的接口。该类依赖于 QuestionService、UserFeignClient 和 QuestionSubmitService 等服务，通过这些服务来完成具体的业务逻辑。

@RestController
@RequestMapping("/")
@Slf4j
public class QuestionController {@Resourceprivate QuestionService questionService;@Resourceprivate UserFeignClient userFeignClient;@Resourceprivate QuestionSubmitService questionSubmitService;private final static Gson GSON = new Gson();// ... 具体方法 ...
}

三、增删改查功能实现

3.1 创建题目

@PostMapping("/add")
public BaseResponse<Long> addQuestion(@RequestBody QuestionAddRequest questionAddRequest, HttpServletRequest request) {if (questionAddRequest == null) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Question question = new Question();BeanUtils.copyProperties(questionAddRequest, question);List<String> tags = questionAddRequest.getTags();if (tags != null) {question.setTags(GSON.toJson(tags));}List<JudgeCase> judgeCase = questionAddRequest.getJudgeCase();if (judgeCase != null) {question.setJudgeCase(GSON.toJson(judgeCase));}JudgeConfig judgeConfig = questionAddRequest.getJudgeConfig();if (judgeConfig != null) {question.setJudgeConfig(GSON.toJson(judgeConfig));}questionService.validQuestion(question, true);User loginUser = userFeignClient.getLoginUser(request);question.setUserId(loginUser.getId());question.setFavourNum(0);question.setThumbNum(0);boolean result = questionService.save(question);ThrowUtils.throwIf(!result, ErrorCode.OPERATION_ERROR);long newQuestionId = question.getId();return ResultUtils.success(newQuestionId);
}
  • 功能：处理创建题目的请求，将用户提交的题目信息保存到数据库中。
  • 实现步骤：
    1. 检查请求参数是否为空，若为空则抛出参数错误异常。
    2. 将 QuestionAddRequest 对象的属性复制到 Question 对象中。
    3. 对题目标签、测试用例和判题配置进行 JSON 序列化处理。
    4. 调用 questionService 的 validQuestion 方法对题目信息进行校验。
    5. 获取当前登录用户的信息，并将用户 ID 关联到题目中。
    6. 初始化题目点赞数和收藏数为 0。
    7. 调用 questionService 的 save 方法保存题目信息，若保存失败则抛出操作错误异常。
    8. 返回新创建题目的 ID。

3.2 删除题目

@PostMapping("/delete")
public BaseResponse<Boolean> deleteQuestion(@RequestBody DeleteRequest deleteRequest, HttpServletRequest request) {if (deleteRequest == null || deleteRequest.getId() <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}User user = userFeignClient.getLoginUser(request);long id = deleteRequest.getId();// 判断是否存在Question oldQuestion = questionService.getById(id);ThrowUtils.throwIf(oldQuestion == null, ErrorCode.NOT_FOUND_ERROR);// 仅本人或管理员可删除if (!oldQuestion.getUserId().equals(user.getId()) && !userFeignClient.isAdmin(user)) {throw new BusinessException(ErrorCode.NO_AUTH_ERROR);}boolean b = questionService.removeById(id);return ResultUtils.success(b);
}
  • 功能：处理删除题目的请求，从数据库中删除指定 ID 的题目。
  • 实现步骤：
    1. 检查请求参数是否合法，若不合法则抛出参数错误异常。
    2. 获取当前登录用户的信息。
    3. 根据题目 ID 查询题目信息，若题目不存在则抛出未找到错误异常。
    4. 检查当前用户是否有删除权限，只有题目创建者或管理员才能删除题目，若没有权限则抛出无权限错误异常。
    5. 调用 questionService 的 removeById 方法删除题目信息，并返回删除结果。

3.3 更新题目（仅管理员）

@PostMapping("/update")
@AuthCheck(mustRole = UserConstant.ADMIN_ROLE)
public BaseResponse<Boolean> updateQuestion(@RequestBody QuestionUpdateRequest questionUpdateRequest) {if (questionUpdateRequest == null || questionUpdateRequest.getId() <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Question question = new Question();BeanUtils.copyProperties(questionUpdateRequest, question);List<String> tags = questionUpdateRequest.getTags();if (tags != null) {question.setTags(GSON.toJson(tags));}List<JudgeCase> judgeCase = questionUpdateRequest.getJudgeCase();if (judgeCase != null) {question.setJudgeCase(GSON.toJson(judgeCase));}JudgeConfig judgeConfig = questionUpdateRequest.getJudgeConfig();if (judgeConfig != null) {question.setJudgeConfig(GSON.toJson(judgeConfig));}// 参数校验questionService.validQuestion(question, false);long id = questionUpdateRequest.getId();// 判断是否存在Question oldQuestion = questionService.getById(id);ThrowUtils.throwIf(oldQuestion == null, ErrorCode.NOT_FOUND_ERROR);boolean result = questionService.updateById(question);return ResultUtils.success(result);
}
  • 功能：处理更新题目的请求，只有管理员才能执行此操作。
  • 实现步骤：
    1. 检查请求参数是否合法，若不合法则抛出参数错误异常。
    2. 将 QuestionUpdateRequest 对象的属性复制到 Question 对象中。
    3. 对题目标签、测试用例和判题配置进行 JSON 序列化处理。
    4. 调用 questionService 的 validQuestion 方法对题目信息进行校验。
    5. 根据题目 ID 查询题目信息，若题目不存在则抛出未找到错误异常。
    6. 调用 questionService 的 updateById 方法更新题目信息，并返回更新结果。

3.4 根据 ID 获取题目

@GetMapping("/get")
public BaseResponse<Question> getQuestionById(long id, HttpServletRequest request) {if (id <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Question question = questionService.getById(id);if (question == null) {throw new BusinessException(ErrorCode.NOT_FOUND_ERROR);}User loginUser = userFeignClient.getLoginUser(request);// 不是本人或管理员，不能直接获取所有信息if (!question.getUserId().equals(loginUser.getId()) && !userFeignClient.isAdmin(loginUser)) {throw new BusinessException(ErrorCode.NO_AUTH_ERROR);}return ResultUtils.success(question);
}
  • 功能：根据题目 ID 获取题目信息，只有题目创建者或管理员才能获取完整信息。
  • 实现步骤：
    1. 检查题目 ID 是否合法，若不合法则抛出参数错误异常。
    2. 根据题目 ID 查询题目信息，若题目不存在则抛出未找到错误异常。
    3. 获取当前登录用户的信息。
    4. 检查当前用户是否有获取完整信息的权限，若没有权限则抛出无权限错误异常。
    5. 返回题目信息。

3.5 根据 ID 获取脱敏后的题目信息

@GetMapping("/get/vo")
public BaseResponse<QuestionVO> getQuestionVOById(long id, HttpServletRequest request) {if (id <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Question question = questionService.getById(id);if (question == null) {throw new BusinessException(ErrorCode.NOT_FOUND_ERROR);}return ResultUtils.success(questionService.getQuestionVO(question, request));
}
  • 功能：根据题目 ID 获取脱敏后的题目信息，适用于普通用户查看。
  • 实现步骤：
    1. 检查题目 ID 是否合法，若不合法则抛出参数错误异常。
    2. 根据题目 ID 查询题目信息，若题目不存在则抛出未找到错误异常。
    3. 调用 questionService 的 getQuestionVO 方法获取脱敏后的题目信息并返回。

3.6 分页获取题目列表（封装类）

@PostMapping("/list/page/vo")
public BaseResponse<Page<QuestionVO>> listQuestionVOByPage(@RequestBody QuestionQueryRequest questionQueryRequest,HttpServletRequest request) {long current = questionQueryRequest.getCurrent();long size = questionQueryRequest.getPageSize();// 限制爬虫ThrowUtils.throwIf(size > 20, ErrorCode.PARAMS_ERROR);Page<Question> questionPage = questionService.page(new Page<>(current, size),questionService.getQueryWrapper(questionQueryRequest));return ResultUtils.success(questionService.getQuestionVOPage(questionPage, request));
}
  • 功能：分页获取题目列表，并返回封装后的题目信息（QuestionVO）。
  • 实现步骤：
    1. 从请求参数中获取当前页码和每页数量。
    2. 检查每页数量是否超过限制，若超过则抛出参数错误异常，防止爬虫过度请求。
    3. 调用 questionService 的 page 方法进行分页查询。
    4. 调用 questionService 的 getQuestionVOPage 方法将查询结果封装为 QuestionVO 并返回。

3.7 分页获取当前用户创建的题目列表

@PostMapping("/my/list/page/vo")
public BaseResponse<Page<QuestionVO>> listMyQuestionVOByPage(@RequestBody QuestionQueryRequest questionQueryRequest,HttpServletRequest request) {if (questionQueryRequest == null) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}User loginUser = userFeignClient.getLoginUser(request);questionQueryRequest.setUserId(loginUser.getId());long current = questionQueryRequest.getCurrent();long size = questionQueryRequest.getPageSize();// 限制爬虫ThrowUtils.throwIf(size > 20, ErrorCode.PARAMS_ERROR);Page<Question> questionPage = questionService.page(new Page<>(current, size),questionService.getQueryWrapper(questionQueryRequest));return ResultUtils.success(questionService.getQuestionVOPage(questionPage, request));
}
  • 功能：分页获取当前用户创建的题目列表，并返回封装后的题目信息（QuestionVO）。
  • 实现步骤：
    1. 检查请求参数是否为空，若为空则抛出参数错误异常。
    2. 获取当前登录用户的信息，并将用户 ID 设置到查询请求中。
    3. 从请求参数中获取当前页码和每页数量。
    4. 检查每页数量是否超过限制，若超过则抛出参数错误异常，防止爬虫过度请求。
    5. 调用 questionService 的 page 方法进行分页查询。
    6. 调用 questionService 的 getQuestionVOPage 方法将查询结果封装为 QuestionVO 并返回。

3.8 分页获取题目列表（仅管理员）

@PostMapping("/list/page")
@AuthCheck(mustRole = UserConstant.ADMIN_ROLE)
public BaseResponse<Page<Question>> listQuestionByPage(@RequestBody QuestionQueryRequest questionQueryRequest,HttpServletRequest request) {long current = questionQueryRequest.getCurrent();long size = questionQueryRequest.getPageSize();Page<Question> questionPage = questionService.page(new Page<>(current, size),questionService.getQueryWrapper(questionQueryRequest));return ResultUtils.success(questionPage);
}
  • 功能：分页获取题目列表，只有管理员才能执行此操作。
  • 实现步骤：
    1. 从请求参数中获取当前页码和每页数量。
    2. 调用 questionService 的 page 方法进行分页查询。
    3. 返回查询结果。

四、其他功能实现

4.1 编辑题目（用户）

@PostMapping("/edit")
public BaseResponse<Boolean> editQuestion(@RequestBody QuestionEditRequest questionEditRequest, HttpServletRequest request) {if (questionEditRequest == null || questionEditRequest.getId() <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}Question question = new Question();BeanUtils.copyProperties(questionEditRequest, question);List<String> tags = questionEditRequest.getTags();if (tags != null) {question.setTags(GSON.toJson(tags));}List<JudgeCase> judgeCase = questionEditRequest.getJudgeCase();if (judgeCase != null) {question.setJudgeCase(GSON.toJson(judgeCase));}JudgeConfig judgeConfig = questionEditRequest.getJudgeConfig();if (judgeConfig != null) {question.setJudgeConfig(GSON.toJson(judgeConfig));}// 参数校验questionService.validQuestion(question, false);User loginUser = userFeignClient.getLoginUser(request);long id = questionEditRequest.getId();// 判断是否存在Question oldQuestion = questionService.getById(id);ThrowUtils.throwIf(oldQuestion == null, ErrorCode.NOT_FOUND_ERROR);// 仅本人或管理员可编辑if (!oldQuestion.getUserId().equals(loginUser.getId()) && !userFeignClient.isAdmin(loginUser)) {throw new BusinessException(ErrorCode.NO_AUTH_ERROR);}boolean result = questionService.updateById(question);return ResultUtils.success(result);
}
  • 功能：处理编辑题目的请求，只有题目创建者或管理员才能执行此操作。
  • 实现步骤：
    1. 检查请求参数是否合法，若不合法则抛出参数错误异常。
    2. 将 QuestionEditRequest 对象的属性复制到 Question 对象中。
    3. 对题目标签、测试用例和判题配置进行 JSON 序列化处理。
    4. 调用 questionService 的 validQuestion 方法对题目信息进行校验。
    5. 获取当前登录用户的信息。
    6. 根据题目 ID 查询题目信息，若题目不存在则抛出未找到错误异常。
    7. 检查当前用户是否有编辑权限，若没有权限则抛出无权限错误异常。
    8. 调用 questionService 的 updateById 方法更新题目信息，并返回更新结果。

4.2 提交题目

@PostMapping("/question_submit/do")
public BaseResponse<Long> doQuestionSubmit(@RequestBody QuestionSubmitAddRequest questionSubmitAddRequest,HttpServletRequest request) {if (questionSubmitAddRequest == null || questionSubmitAddRequest.getQuestionId() <= 0) {throw new BusinessException(ErrorCode.PARAMS_ERROR);}// 登录才能提交final User loginUser = userFeignClient.getLoginUser(request);long questionSubmitId = questionSubmitService.doQuestionSubmit(questionSubmitAddRequest, loginUser);return ResultUtils.success(questionSubmitId);
}
  • 功能：处理提交题目的请求，用户必须登录才能提交。
  • 实现步骤：
    1. 检查请求参数是否合法，若不合法则抛出参数错误异常。
    2. 获取当前登录用户的信息。
    3. 调用 questionSubmitService 的 doQuestionSubmit 方法处理题目提交，并返回提交记录的 ID。

4.3 分页获取题目提交列表

@PostMapping("/question_submit/list/page")
public BaseResponse<Page<QuestionSubmitVO>> listQuestionSubmitByPage(@RequestBody QuestionSubmitQueryRequest questionSubmitQueryRequest,HttpServletRequest request) {long current = questionSubmitQueryRequest.getCurrent();long size = questionSubmitQueryRequest.getPageSize();// 从数据库中查询原始的题目提交分页信息Page<QuestionSubmit> questionSubmitPage = questionSubmitService.page(new Page<>(current, size),questionSubmitService.getQueryWrapper(questionSubmitQueryRequest));final User loginUser = userFeignClient.getLoginUser(request);// 返回脱敏信息return ResultUtils.success(questionSubmitService.getQuestionSubmitVOPage(questionSubmitPage, loginUser));
}
  • 功能：分页获取题目提交列表
http://www.lryc.cn/news/537038.html

相关文章：

  • 周考考题（学习自用）
  • 【matlab】大小键盘对应的Kbname
  • LabVIEW与小众设备集成
  • Android 系统Service流程
  • Gartner预测2025年网络安全正在进入AI动荡时期：软件供应链和基础设施技术堆栈中毒将占针对企业使用的人工智能恶意攻击的 70% 以上
  • 华为最新OD机试真题-最长子字符串的长度（一）-Python-OD统一考试（E卷）
  • HAL库框架学习总结
  • 基于Spring Integration的ESB与Kettle结合实现实时数据处理技术
  • qt QOpenGLContext详解
  • 探索顶级汽车软件解决方案：驱动行业变革的关键力量
  • Deepseek R1模型本地化部署+API接口调用详细教程：释放AI生产力
  • DeepSeek 概述与本地化部署【详细流程】
  • FFmpeg Video options
  • 从51到STM32：PWM平滑迁移方案
  • openCV中如何实现滤波
  • BGP配置华为——路由汇总
  • 机器学习核心算法解析
  • 【C++学习篇】C++11
  • SQLite 数据库：优点、语法与快速入门指南
  • 数据结构——二叉树（2025.2.12）
  • 图神经网络简介
  • 小程序报错The JavaScript function Pointer_stringify(ptrToSomeCString)
  • DeepSeek 与网络安全：AI 驱动的智能防御
  • Redission看门狗
  • LeetCode 热题 100_组合总和（58_39_中等_C++）（递归（回溯））
  • 使用PHP爬虫获取1688商品分类：实战案例指南
  • Nginx location 和 proxy_pass 配置详解
  • 云创智城充电系统：基于 SpringCloud 的高可用、可扩展架构详解-多租户、多协议兼容、分账与互联互通功能实现
  • AIP-143 标准代号
  • 机器视觉--数字图像格式