backend_dormitory/src/main/java/com/template/api/WelcomeStudentControllerAPI.java

package com.template.api;

import com.template.model.pojo.WelcomeStudent;
import com.template.model.request.InfoCollectionRequest;
import com.template.model.request.InsertStudentRequest;
import com.template.model.request.RegisterRequest;
import com.template.model.request.updateStudentRequest;
import com.template.model.result.CommonResult;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import org.springframework.validation.BindingResult;
import org.springframework.validation.annotation.Validated;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.multipart.MultipartFile;

import javax.servlet.http.HttpServletResponse;
import java.io.IOException;
import java.text.ParseException;

@RequestMapping("/api/welcomeStudent")
@Api(tags = {"WelcomeStudentController"}, value = "学生信息管理")
public interface WelcomeStudentControllerAPI {

    @PostMapping(value = "/insertStudentInfo")
    @ApiOperation(value = "添加学生信息", notes = "添加学生信息", httpMethod = "POST")
    CommonResult insertStudentInfo(@Validated @RequestBody InsertStudentRequest isr, BindingResult bindingResult) throws Exception;

    @PostMapping(value = "/updateStudentInfo")
    @ApiOperation(value = "编辑学生信息", notes = "编辑学生信息", httpMethod = "POST")
    CommonResult updateStudentInfo(@Validated @RequestBody updateStudentRequest usr, BindingResult bindingResult) throws Exception;

    @GetMapping(value = "/queryPageStudents")
    @ApiOperation(value = "学生信息分页数据", notes = "学生信息分页数据", httpMethod = "GET")
    CommonResult queryPageStudents(@RequestAttribute String userId, @RequestParam int currentPage, @RequestParam int pageCount, Integer collegeId, Integer majorId, Integer classstrId, String trafficMethod, String name, String fillStatus, Integer isRegistered, Integer isPay, Integer isCheck, String school, String batchValue, Integer carNumber,Integer yearId) throws ParseException;

    @GetMapping(value = "/queryStudentDetail")
    @ApiOperation(value = "学生信息明细数据", notes = "学生信息明细数据", httpMethod = "GET")
    CommonResult queryStudentDetail(@RequestParam int id);

    @PostMapping(value = "/infoCollection")
    @ApiOperation(value = "学生信息采集", notes = "学生信息采集", httpMethod = "POST")
    CommonResult infoCollection(@Validated @RequestBody InfoCollectionRequest icr, BindingResult bindingResult) throws Exception;

    @GetMapping(value = "/deleteStudentInfo")
    @ApiOperation(value = "删除学生信息", notes = "删除学生信息", httpMethod = "GET")
    CommonResult deleteStudentInfo(@RequestParam int id) throws Exception;

    @PostMapping(value = "/importStudentExcel")
    @ApiOperation(value = "导入学生基本信息数据", notes = "导入学生基本信息数据", httpMethod = "POST")
    CommonResult importStudentExcel(@RequestParam("file") MultipartFile file) throws IOException, ParseException;

    @GetMapping(value = "/downloadStudentExcel")
    @ApiOperation(value = "学生信息导出模板", notes = "学生信息导出模板", httpMethod = "GET")
    CommonResult downloadStudentExcel();

    @GetMapping(value = "/welcomeStudentExport")
    @ApiOperation(value = "导出学生信息数据", notes = "导出学生信息数据", httpMethod = "GET")
    void welcomeStudentExport(@RequestAttribute String userId, HttpServletResponse response, Integer collegeId, Integer majorId, Integer classstrId, String trafficMethod, String name, String fillStatus, Integer isRegistered, Integer isPay, Integer isCheck, String school, String batchValue, Integer carNumber,Integer yearId) throws ParseException;


    @GetMapping(value = "/studentOverview")
    @ApiOperation(value = "学生总览", notes = "学生总览", httpMethod = "GET")
    CommonResult studentOverview(Integer collegeId, Integer yearId) throws ParseException;

    @GetMapping(value = "/studentRegister")
    @ApiOperation(value = "新生报到情况", notes = "新生报到情况", httpMethod = "GET")
    CommonResult studentRegister(Integer collegeId, Integer yearId) throws ParseException;

    @GetMapping(value = "/studentTraffic")
    @ApiOperation(value = "学生交通方式", notes = "学生交通方式", httpMethod = "GET")
    CommonResult studentTraffic(Integer collegeId, Integer yearId) throws ParseException;

    @GetMapping(value = "/studentSexRatio")
    @ApiOperation(value = "学生性别比例", notes = "学生性别比例", httpMethod = "GET")
    CommonResult studentSexRatio(Integer yearId) throws ParseException;

    @GetMapping(value = "/studentStay")
    @ApiOperation(value = "学生住宿情况", notes = "学生住宿情况", httpMethod = "GET")
    CommonResult studentStay(Integer yearId) throws ParseException;

    @GetMapping(value = "/queryStudentByToken")
    @ApiOperation(value = "学生住宿情况", notes = "学生住宿情况", httpMethod = "GET")
    CommonResult queryStudentByToken(@RequestAttribute String userId);

    @GetMapping(value = "/queryStudentInfo")
    @ApiOperation(value = "查询学生信息", notes = "查询学生信息", httpMethod = "GET")
    CommonResult queryStudentInfo(@RequestParam String admissNum);

    @PostMapping(value = "/isRegistered")
    @ApiOperation(value = "是否已报到", notes = "是否已报到", httpMethod = "POST")
    CommonResult isRegistered(@RequestBody WelcomeStudent welcomeStudent);

    @GetMapping(value = "/levelRegister")
    @ApiOperation(value = "层次报到情况", notes = "层次报到情况", httpMethod = "GET")
    CommonResult levelRegister(Integer collegeId, Integer yearId) throws ParseException;
}