backend/src/main/java/nju/seec/helper/controller/QuizController.java

package nju.seec.helper.controller;

import nju.seec.helper.aspect.auth.Auth;
import nju.seec.helper.aspect.auth.LoginUser;
import nju.seec.helper.controller.response.PageResponse;
import nju.seec.helper.dto.groups.Create;
import nju.seec.helper.dto.groups.Modify;
import nju.seec.helper.dto.quiz.QuizDTO;
import nju.seec.helper.dto.quiz.QuizStudentAnswerDTO;
import nju.seec.helper.enums.QuizState;
import nju.seec.helper.enums.UserType;
import nju.seec.helper.service.QuizService;
import nju.seec.helper.service.QuizStudentAnswerService;
import nju.seec.helper.vo.QuizStudentAnswerStatisticVO;
import nju.seec.helper.vo.quiz.QuizStudentAnswerVO;
import nju.seec.helper.vo.quiz.QuizVO;
import org.springframework.data.domain.Pageable;
import org.springframework.data.web.PageableDefault;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;

/**
 * 测试
 *
 * @author xst
 * <p>
 * updated by cst
 * @doc http://47.100.18.120:3000/SEEC-BOK/API-DOC/src/master/helper/api/Quiz-%e6%b5%8b%e8%af%95.md
 */
@RestController
@RequestMapping("/api/quiz")
public class QuizController {
    private final QuizService quizService;
    private final QuizStudentAnswerService quizStudentAnswerService;

    public QuizController(QuizService quizService, QuizStudentAnswerService quizStudentAnswerService) {
        this.quizService = quizService;
        this.quizStudentAnswerService = quizStudentAnswerService;
    }

    /**
     * 基于课件获取测试列表
     */
    @Auth(roles = {UserType.TEACHER, UserType.STUDENT}, message = "获得测试列表")
    @GetMapping("/slide/{slideId}")
    public PageResponse<QuizVO> getQuizzesBySlide(LoginUser user,
                                                  @PathVariable Long slideId,
                                                  @RequestParam(required = false, defaultValue = "") String key,
                                                  @PageableDefault(Integer.MAX_VALUE) Pageable pageable) {
        switch (user.getType()) {
            case TEACHER:
                return PageResponse.of(quizService.teacherGetQuizzesBySlide(user, slideId, key, pageable));
            case STUDENT:
                return PageResponse.of(quizService.studentGetQuizzesBySlide(user, slideId, key, pageable));
            default:
                return PageResponse.empty();
        }
    }

    /**
     * 基于状态获取测试列表
     */
    @Auth(roles = UserType.STUDENT, message = "获取测试列表")
    @GetMapping("/state")
    public PageResponse<QuizVO> getQuizzesByState(LoginUser user,
                                                  QuizState state,
                                                  @RequestParam(required = false, defaultValue = "") String key,
                                                  @PageableDefault(Integer.MAX_VALUE) Pageable pageable) {
        switch (user.getType()) {
            case STUDENT:
                return PageResponse.of(quizService.studentGetQuizzesByState(user, state, key, pageable));
            default:
                return PageResponse.empty();
        }
    }

    /**
     * 获得某一测试的详细内容
     */
    @Auth(roles = {UserType.STUDENT, UserType.TEACHER}, message = "获得测试")
    @GetMapping("/{quizId}")
    public QuizVO getOneQuiz(LoginUser user, @PathVariable("quizId") Long quizId) {
        return quizService.getOneQuiz(user, quizId);
    }

    /**
     * 创建测试
     */
    @Auth(roles = {UserType.TEACHER}, message = "创建测试")
    @PostMapping
    public QuizVO createQuiz(LoginUser user, @Validated(Create.class) @RequestBody QuizDTO quizDTO) {
        return quizService.createQuiz(user, quizDTO);
    }

    /**
     * 修改测试 (仅限未开始时可以修改)
     */
    @Auth(roles = {UserType.TEACHER}, message = "修改测试")
    @PutMapping("/{quizId}")
    public QuizVO updateQuiz(LoginUser user, @PathVariable Long quizId, @Validated(Modify.class) @RequestBody QuizDTO quizDTO) {
        return quizService.modifyQuiz(user, quizId, quizDTO);
    }

    /**
     * 删除测试 (伪删除)
     */
    @Auth(roles = {UserType.TEACHER}, message = "删除测试")
    @DeleteMapping("/{quizId}")
    public void deleteQuiz(LoginUser user, @PathVariable("quizId") String quizId) {
        quizService.deleteQuiz(user, Long.valueOf(quizId));
    }

    @Auth(roles = {UserType.STUDENT}, message = "提交作答")
    @PostMapping("/{quizId}/student-answer")
    public QuizStudentAnswerVO submitQuizStudentAnswer(LoginUser user, @PathVariable Long quizId, @RequestBody QuizStudentAnswerDTO quizStudentAnswerDTO) {
        return quizStudentAnswerService.submitQuizStudentAnswer(user, quizId, quizStudentAnswerDTO);
    }

    /**
     * 老师获取某一测试学生的作答列表
     *
     * @param user
     * @param quizId
     * @return
     */
    @Auth(roles = {UserType.TEACHER}, message = "获取学生作答")
    @GetMapping("/{quizId}/student-answers")
    public PageResponse<QuizStudentAnswerVO> getQuizStudentAnswers(LoginUser user, @PathVariable Long quizId, @PageableDefault(size = Integer.MAX_VALUE) Pageable pageable) {
        return PageResponse.of(quizStudentAnswerService.getQuizStudentAnswers(user, quizId, pageable));
    }

    /**
     * 学生获取某一测试自己的作答
     *
     * @param user
     * @param quizId
     * @return
     */
    @Auth(roles = {UserType.STUDENT}, message = "获取作答")
    @GetMapping("/{quizId}/student-answer")
    public QuizStudentAnswerVO getOneQuizStudentAnswer(LoginUser user, @PathVariable Long quizId) {
        return quizStudentAnswerService.getQuizStudentAnswer(user, quizId);
    }

    @Auth(roles = {UserType.TEACHER}, message = "获取测试统计消息")
    @GetMapping("/{quizId}/statistic")
    public QuizStudentAnswerStatisticVO getQuizStatistic(LoginUser user, @PathVariable Long quizId) {
        return quizStudentAnswerService.getQuizStudentAnswerStatistic(user, quizId);
    }
}