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

package com.template.api;

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(@RequestParam int currentPage, @RequestParam int pageCount, Integer collegeId, Integer majorId, Integer classstrId, String trafficMethod, String name);

    @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(HttpServletResponse response, Integer collegeId, Integer majorId, Integer classstrId, String trafficMethod, String name);


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

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


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

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

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

}