1. 全栈程序员必看首页

校园小助手–智慧成绩统计服务平台

全栈程序员-站长 • • 未分类 • 阅读 65

校园小助手–智慧成绩统计服务平台

校园小助手–智慧成绩统计服务平台

API文档

接口总地址： http://120.78.188.40:8080/

基本功能

登录

url：/login

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名
password String 是 密码

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息

image-20210726194026062

image-20210726194033982

注册

url：/register

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名
password String 是 密码
email String 是 邮箱

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "注册成功！我们已经向您的邮箱发送了邮件，请您及时进行查收。由于网络原因，您收到邮件的时间存在延迟，敬请谅解~");

map.put("code", 0);
map.put("msg", "注册失败！");

忘记密码

url：/resetPassword

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名
password String 是 密码

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "重置成功！");

map.put("code", 0);
map.put("msg", "重置失败！");

用户

用户接口：/user

修改密码

url：/updatePassword

请求方式：post/get

请求参数

名称 类型 必填 说明
password String 是 密码

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "修改成功！");

map.put("code", 0);
map.put("msg", "修改失败！");

更新用户资料

url：/updateUser

请求方式：post/get

请求参数

名称 类型 必填 说明
name String 是 姓名
college String 是 所属学院
email String 是 邮箱

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "修改成功！");

map.put("code", 0);
map.put("msg", "修改失败！");

验证原密码

用于修改密码时，判断用户输入是否为正确的原密码

url：/verifyPassword

请求方式：post/get

请求参数

名称 类型 必填 说明
password String 是 原密码

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "原密码正确！");

map.put("code", 0);
map.put("msg", "原密码不正确！");

注销

url：/logout

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "注销成功！");

获取用户

用于修改用户资料，进行表单回显

url：/getUser

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
user User 用户实体 
public class User {
   
    private String id;
    private String username;//不可修改，表单展示
    private String password;
    private String name;//表单展示
    private String college;//表单展示
    //存放文件地址
    private String filePath;//不可修改，表单展示
    private String email;//表单展示
    //存储容量
    private int storageCapacity;//不可修改，表单展示
}

验证

验证码接口：/captcha

图片

url：/codeImage

请求方式：post/get

注意：

点击验证码图片换验证码时，img 标签 的 onclick 事件里面做的就是改变 img 标签的 src 属性，所以要给 url 带一个随机数，这样每次点击验证码图片时，都会由于 src 改变而重新请求。

$('#codeImg').attr('src',"/kaptcha/codeImage?"+ new Date().getTime());

验证码

url：/code

请求方式：post/get

返回参数

名称 类型 说明
captchaCode String 验证码

邮箱验证码

url：/email

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名
email String 是 邮箱

返回参数

名称 类型 说明
emailCode String 邮箱验证码

验证用户名是否重复

用于注册时，保证用户名唯一

url：/verifyUsername

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "该用户名可使用！");

map.put("code", 0);
map.put("msg", "该用户名已存在！");

验证邮箱是否属于用户

url：/verifyEmail

请求方式：post/get

请求参数

名称 类型 必填 说明
username String 是 用户名
email String 是 邮箱

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "邮箱正确！");

map.put("code", 0);
map.put("msg", "该邮箱不属于该账号！请重新输入！");

文件

文件接口：/user/file

上传

url：/upload

请求方式：post

<div class="a">
    <p>上传文件</p>
    <form action="/file/upload" enctype="multipart/form-data" method="post">
        <input type="file" name="file">
        <input type="submit" value="上传">
    </form>
</div>

请求参数

名称 类型 必填 说明
file CommonsMultipartFile 是 文件

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "上传失败！总存储容量超出50MB，请清理无用的文件");

map.put("code", 0);
map.put("msg", "上传失败！文件类型不符合");

map.put("code", 200);
map.put("msg", "上传成功！");

下载

url：/download

请求方式：post/get

请求参数

名称 类型 必填 说明
id String 是 文件id

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "下载成功！");

删除

url：/delete

请求方式：post/get

请求参数

名称 类型 必填 说明
id String 是 文件id

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "删除成功！");
map.put("code", 0);
map.put("msg", "删除失败！文件不存在");

重命名

url：/rename

请求方式：post/get

请求参数

名称 类型 必填 说明
id String 是 文件id
newName String 是 新文件名

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "重命名成功！");
map.put("code", 0);
map.put("msg", "重命名失败！文件不存在");

获取文件集合

url：/getFileList

请求方式：post/get

请求参数

名称 类型 必填 说明
currentPage Integer 是 当前页
pageSize Integer 是 页面大小

如果不需要分页，可以不需要传参

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
data List<File> 文件信息集合 
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("data",files);
private String id;//展示
private String userId;
private String name;//展示
private String filePath;
private int size;
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")//页面写入数据库时格式化
@JSONField(format = "yyyy-MM-dd HH:mm:ss")//数据库导出页面时json格式化
private Date updateTime;//展示
private String showSize;//展示

Excel操作

接口：/user/excel

导入配置文件

url：/importPlanConfig

请求方式：post/get

请求参数

名称 类型 必填 说明
fileName String 是 文件名

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "已经导入配置文件，请勿重新导入！");
map.put("code", 200);
map.put("msg", "导入配置文件成功！");
map.put("code", 0);
map.put("msg", "导入配置文件失败！请重新导入！");

导入更新的配置文件

url：/importUpdatePlanConfig

请求方式：post/get

请求参数

名称 类型 必填 说明
fileName String 是 文件名

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "已经导入更新的配置文件，请勿重新导入！");
map.put("code", 200);
map.put("msg", "导入配置文件成功！");
map.put("code", 0);
map.put("msg", "导入配置文件失败！请重新导入！");

导入专业成绩文件

用于数据处理模块

url：/importStudentCourseResultInfo

请求方式：post/get

请求参数

名称 类型 必填 说明
fileName String 是 文件名
grade String 是 从配置文件的筛选条件中的年级获取

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "未导入配置文件，请先导入配置文件！");
map.put("code", 0);
map.put("msg", "已经导入专业成绩文件，请勿重新导入！");
map.put("code", 200);
map.put("msg", "导入专业成绩文件成功！");
map.put("code", 0);
map.put("msg", "导入专业成绩文件失败！请重新导入！");

导入专业成绩文件

用于更新配置文件模块

url：/importAllStudentCourseResultInfo

请求方式：post/get

请求参数

名称 类型 必填 说明
fileName String 是 文件名

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "未导入配置文件，请先导入配置文件！");
map.put("code", 0);
map.put("msg", "已经导入专业成绩文件，请勿重新导入！");
map.put("code", 200);
map.put("msg", "导入专业成绩文件成功！");
map.put("code", 0);
map.put("msg", "导入专业成绩文件失败！请重新导入！");

获得年级筛选条件

url：/getFilterGrade

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
grade List<String> 年级列表 
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("grade", filterGrade);

获得学期筛选条件

url：/getFilterSemester

请求方式：post/get

请求参数

名称 类型 必填 说明
grade String 是 从配置文件的筛选条件中的年级获取

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
semester List<String> 学期列表 
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("semester", filterSemester);

更新配置文件

url：/updatePlanConfigure

请求方式：post/get

请求参数

名称 类型 必填 说明
grade String 是 筛选年级
semesters String[] 是 筛选学期

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "配置文件更新完成！请在文件列表中下载后核对！");

数据处理

url：/dataProcessing

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "数据处理完成！");
map.put("code", 0);
map.put("msg", "数据处理失败！");

清空配置文件

url：/emptyPlanConfigure

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "专业配置文件数据已清空！请重新导入！");

清空更新的配置文件

url：/emptyUpdatePlanConfigure

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "更新的配置文件数据已清空！请重新导入！");

清空成绩文件

url：/emptyProfessionalScore

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 200);
map.put("msg", "专业成绩文件数据已清空！请重新导入！");

通过关键词搜索学生成绩情况

url：/searchStudent

请求方式：post/get

请求参数

名称 类型 必填 说明
keyword String 是 关键词

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
data List<StudentOverallResultInfo> 学生信息集合 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 0);
map.put("msg", "未输入任何关键字!");
map.put("code", 0);
map.put("msg", "未找到任何符合条件的记录！");
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("data", studentOverallResultInfos);

public class StudentOverallResultInfo {
   
    @ExcelProperty("学号")
    private String studentId;//展示
    @ExcelProperty("姓名")
    private String name;//展示
    @ExcelProperty("班级")
    private String clazz;//展示
    @ExcelProperty("专业")
    private String professional;//展示
    /** * 修习类别与对应已获得学分 */
    private Map<CourseType, Double> earnedCreditsMap;
    /** * 修习类别是否通过 */
    private Map<CourseType, String> flagMap = new HashMap<>();
    /** * 修习类别对应的课程成绩 */
    private Map<CourseType, List<StudentCourseScoreInfo>> courseScoreInfoMap;

    /** * 每个学期对应的平均绩点 */
    private Map<String, Double> gradePointMap;
    /** * 每种修习类别未修过课程 */
    private Map<CourseType, List<Course>> unrepairedCourseMap;

    /** * 课程对应是否通过 */
    private Map<Course, Boolean> flagCourseMap;
    /** * 判断该学生是否合格 */
    private boolean qualified;//展示

    /** * 平均绩点 */
    private Double gradePointAverage = 0.0;//展示

    /** * 专业排名 */
    private Integer rank = 0;  //展示
}

根据学生id获取修习情况

url：/getStudentPracticeInfo

请求方式：post/get

请求参数

名称 类型 必填 说明
id String 是 学号

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
data List<StudentPracticeInfo> 学生修习情况集合 
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("data", studentPracticeInfoById);

//全部展示
public class StudentPracticeInfo {
   
    @ColumnWidth(11)
    @ExcelProperty("修习类别")
    private String practiceCategory;
    @ColumnWidth(7)
    @ExcelProperty("学分要求")
    private Double credits;
    @ColumnWidth(9)
    @ExcelProperty("已获得学分")
    private Double earnedCredits;
    @ColumnWidth(9)
    @ExcelProperty("所差学分")
    private Double poorCredits;
    @ColumnWidth(7)
    @ExcelProperty("是否通过")
    private String flag;
}

导出学生成绩信息

url：/exportStudent

请求方式：post/get

请求参数

名称 类型 必填 说明
id String 是 学号

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "导出成功！请在文件列表中下载");

获取专业成绩总体分析结果

url：/getPracticeCategoryStatisticsInfo

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息
data List<PracticeCategoryStatisticsInfo> 学生修习情况集合 
map.put("code", 200);
map.put("msg", "获取成功！");
map.put("data", excelServiceImpl.getPracticeCategoryStatisticsInfoList());

public class PracticeCategoryStatisticsInfo {
   
    @ExcelProperty("修习类别")
    private String practiceCategory;
    @ExcelProperty("学分要求")
    private Double credits;
    @ExcelProperty("通过人数")
    private Integer passCount;
}

导出全体学生成绩分析

url：/exportAllStudentResults

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "导出成功！请在文件列表中下载");

导出不合格学生成绩分析

url：/exportOfUnqualifiedStudentResults

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "导出成功！请在文件列表中下载");

导出专业排名分析

url：/exportProfessionalRankings

请求方式：post/get

返回参数

名称 类型 说明
code int 状态码（成功：200，失败：0）
msg String 返回信息 
map.put("code", 0);
map.put("msg", "还未导入更新的配置文件或专业成绩文件!");
map.put("code", 200);
map.put("msg", "导出成功！请在文件列表中下载");
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请发送邮件至 举报，一经查实，本站将立刻删除。

发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/114419.html原文链接：https://javaforall.net

赞 (0)
全栈程序员-站长的头像全栈程序员-站长
0 0


相关推荐

  • Js如何防止页面后退（使浏览器后退按钮失效）[通俗易懂]

    Js如何防止页面后退（使浏览器后退按钮失效）[通俗易懂]

    Js如何防止页面后退（使浏览器后退按钮失效）[通俗易懂]以下代码仅供参考：&lt;scripttype="text/javascript"&gt; $(function(){//防止页面后退history.pushState(null,null,"localhost:8080");window.addEventListener(‘popstate’,function(){…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年7月25日
  • <span role="heading" aria-level="2">discuz论坛更换域名,搬家步骤

    discuz论坛更换域名,搬家步骤

    discuz论坛更换域名,搬家步骤搬家步骤具体如下：1、打包数据库文件保存到本地。2、打包网站根目录所有程序（discuz）保存到本地。3、上传网站程序包和数据库包到新的空间，将数据库上传到新的服务器中。4、找到config

    全栈程序员-站长的头像 全栈程序员-站长
    2022年7月1日
  • 小程序 轮播图之自动适应宽高度

    小程序 轮播图之自动适应宽高度

    小程序 轮播图之自动适应宽高度以微信小程序为例:wxml文件:<!–1.轮播图外层容器swiper2.每一个轮播项swiper-item3.swiper标签存在默认样式1.width100%2.height150pximage存在默认宽度和高度320*2403.swiper高度无法实现由内容撑开4.先找出来原图的宽度和高度等比例给swiper定宽度和高度原图的宽度和高度750x300swiper宽度/.

    全栈程序员-站长的头像 全栈程序员-站长
    2022年5月21日
  • sklearn.metrics.auc_auc值计算公式

    sklearn.metrics.auc_auc值计算公式

    sklearn.metrics.auc_auc值计算公式fromsklearnimportcross_validation,metricsfromsklearnimportsvmtrain_data,train_target=load(filename)#自定义加载数据函数，返回的是训练数据的数据项和标签项train_x,test_x,train_y,test_y=cross_validation.train_test_split

    全栈程序员-站长的头像 全栈程序员-站长
    2022年10月7日
  • 多线程之旅(10)_QueueUserWorkItem和UnsafeQueueUserWorkItem的区别「建议收藏」

    多线程之旅(10)_QueueUserWorkItem和UnsafeQueueUserWorkItem的区别「建议收藏」

    多线程之旅(10)_QueueUserWorkItem和UnsafeQueueUserWorkItem的区别「建议收藏」这是个比较冷门的点，是我在写多线程之旅(2)_创建一个属于自己的精简线程池_线程调度策略——附C#源码这篇文章时，发现在做线程队列时，官方选用的是UnsafeQueueUserWorkItem，而不是常见的QueueUserWorkItem，所以后续我就对这两个方法调查一番，发现资料也不多，总结一下。一、官方定义首先看一下官方的定义：来源：https://docs.microsof…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年9月24日
  • layui弹出层html,layer弹出层「建议收藏」

    layui弹出层html,layer弹出层「建议收藏」

    layui弹出层html,layer弹出层「建议收藏」layer弹出层，怎么只让他弹出一次.在线等我昨天用这个插件的时候也有这个问题，弹出内容大了就居不了中。这是组件不完美的地方，他设置了top和left值，而且是固定的。这种弹出层都是绝对定位的所以没办法用margin：auto0神马的居中。解决方案主要两种：1.修改在浏览器里面调试模式。jquerylayer怎么弹出指定的html内元素一个基本的弹出层应该满足以下需CSS布局HTML小编…

    全栈程序员-站长的头像 全栈程序员-站长
    2022年7月13日

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

关注全栈程序员社区公众号