【JavaWeb】新生报道案例前端详细使用(模拟前后端通过接口文档对接)

这是一个JavaWeb小案例的详细实现过程,本文是前端文件的使用与模拟的接口文档,博客的上篇在这里:https://blog.csdn.net/weixin_43760020/article/details/105228035
博客的下篇在这里:https://blog.csdn.net/weixin_43760020/article/details/105292962
假设现在正在进行前后端分离的开发,此时前端已经写好,需要我们根据前端编写的接口文档用Java 进行后端开发。

一、前端编写的接口文档:

注意区分请求参数和响应结果。

一共三个接口,通过JSON数据格式进行交互。如下:

1、接口一

  • 方法描述:新生登录
  • URL地址:http://localhost:9601/reactLogin/login
  • 请求方式:post
  • 请求参数
字段 说明 类型 是否必填 备注
newstuname 新生姓名 String
newstuid 新生学号 long 这是新生登录表的学号
  • 请求参数示例
{
   
	newstuname: "博格巴", 
	newstuid: 202109601260
}
  • 响应结果
    约定:
    若验证登录成功,返回整型 1。
    否则为失败,返回整型 0。
//登录成功,响应结果示例
{
   
	data:1
}

//登录失败,响应结果示例:
{
   
	data:0
}

2、接口二

  • 方法描述:初始化新生报道页
  • URL地址:http://localhost:9601/reactLogin/initReport
  • 请求方式:post
  • 请求参数
字段 说明 类型 是否必填 备注
r_id 新生学号 long 这是新生登录表的学号
  • 请求参数示例
{
   
	r_id: 202109601260
}
  • 响应结果
字段 说明 类型 是否必填 备注
r_id 新生学号 long 这是新生报道表的学号
newstuname 新生姓名 String
sex 性别 String
major 专业 String
classes 班级 String
province 省份 String
telephone 电话 String
to_date 到校日期 Date 日期只有年月日(YYYY-MM-DD)
to_time 到校时间 Date 时间只有时和分(HH-MM)
transport 交通方式 String
transport_num 车次/航班 String
trsp_remark 行程备注 String
is_loan 是否贷款 short 约定:若贷款则为1,未贷款则为0
loan_amount 贷款金额 BigDecimal 注意:涉及金钱不可使用double类型
loan_pay 贷款缴纳 BigDecimal
pay_way 缴费方式 String
pay_remark 贷款备注 String
is_photo 是否有贷款回执照片 short 约定:有照片则为1,无照片则为0
rec_people 接待人 String
rec_phone 接待人电话 String
以下示例中的所有字段均不能省略(一个都不能少),但除了字段 r_id(学号)外,字段值均可为NULL。
//响应结果示例
{
   
	data:{
   
		classes: "智能Q181"
		is_loan: 0
		is_photo: 0
		loan_amount: null
		loan_pay: null
		major: "人工智能"
		newstuname: "博格巴"
		pay_remark: ""
		pay_way: ""
		province: "曼彻斯特"
		r_id: 202109601260
		rec_people: "索尔斯克亚"
		rec_phone: "15278145893"
		sex: "男"
		telephone: "18278145093"
		to_date: "2020-03-29"
		to_time: "23:37"
		transport: "火车"
		transport_num: "测试数据"
		trsp_remark: "测试数据"
	}
}

3、接口三

  • 方法描述:新生提交填写的个人信息
  • URL地址:http://localhost:9601/reactLogin/report
  • 请求方式:post
  • 请求参数
字段 说明 类型 是否必填 备注
r_id 新生学号 long 这是新生报道表的学号
newstuname 新生姓名 String
sex 性别 String
major 专业 String
classes 班级 String
province 省份 String
telephone 电话 String
to_date 到校日期 Date 日期只有年月日(YYYY-MM-DD)
to_time 到校时间 Date 时间只有时和分(HH-MM)
transport 交通方式 String
transport_num 车次/航班 String
trsp_remark 行程备注 String
is_loan 是否贷款 short 约定:若贷款则为1,未贷款则为0
loan_amount 贷款金额 BigDecimal 注意:涉及金钱不可使用double类型
loan_pay 贷款缴纳 BigDecimal
pay_way 缴费方式 String
pay_remark 贷款备注 String
is_photo 是否有贷款回执照片 short 约定:有照片则为1,无照片则为0
rec_people 接待人 String
rec_phone 接待人电话 String
  • 请求参数示例
{
   
	classes: "智科Q182班"
	is_loan: 1
	is_photo: 0
	loan_amount: 54321
	loan_pay: 123466
	major: "智能科学与技术"
	newstuname: "张伟"
	pay_remark: "微信给过了"
	pay_way: "微信支付"
	province: "北京"
	r_id: 201909601260
	rec_people: "蔡徐坤"
	rec_phone: "18978145893"
	sex: "男"
	telephone: "18278145093"
	to_date: "2020-03-29"
	to_time: "23:35"
	transport: "火车"
	transport_num: "火车晚点"
	trsp_remark: "无"
}
  • 响应结果
    约定:
    若提交成功,返回整型 1。
    若提交失败,返回整型 0。
//登录成功,响应结果示例
{
   
	data:1
}

//登录失败,响应结果示例:
{
   
	data:0
}

二、前端文件详细使用说明

1、如何下载

下载地址:https://github.com/BEIJIU601/NewStuReport

使用过程如下:

解压后得到,

打开,得到

再打开,得到

2、查看发送请求的参数和响应结果

打开后可右键检查,到浏览器控制台查看,打印出来的相关信息:

上面为后端响应成功的示例,若请求后端失败,会提示请求服务器失败,
失败的原因一般为:
1、后端设置的URL不符合前端请求的地址
2、跨域请求失败
3、后端程序出了错

博客的上篇点这里。
博客的下篇点这里。

这是一个菜鸡的JavaWeb小案例,如果你觉得还可以的话,给我的GitHub点个start呗~~
再次放上下载地址:https://github.com/BEIJIU601/NewStuReport

全部评论

相关推荐

评论
点赞
收藏
分享

创作者周榜

更多
正在热议
更多
# 春招至今,你的战绩如何? #
5985次浏览 54人参与
# 你的实习产出是真实的还是包装的? #
1230次浏览 29人参与
# 巨人网络春招 #
11202次浏览 223人参与
# 军工所铁饭碗 vs 互联网高薪资,你会选谁 #
7021次浏览 37人参与
# 简历第一个项目做什么 #
31289次浏览 315人参与
# 当下环境,你会继续卷互联网,还是看其他行业机会 #
186478次浏览 1115人参与
# 米连集团26产品管培生项目 #
4537次浏览 204人参与
# 研究所笔面经互助 #
118776次浏览 577人参与
# 面试紧张时你会有什么表现? #
30415次浏览 188人参与
# 简历中的项目经历要怎么写? #
309499次浏览 4161人参与
# AI时代,哪些岗位最容易被淘汰 #
62599次浏览 741人参与
# 网易游戏笔试 #
6360次浏览 83人参与
# 职能管理面试记录 #
10716次浏览 59人参与
# 把自己当AI,现在最消耗你token的问题是什么? #
6942次浏览 154人参与
# 从哪些方向判断这个offer值不值得去? #
56712次浏览 357人参与
# 你怎么看待AI面试 #
179364次浏览 1177人参与
# 腾讯音乐求职进展汇总 #
160417次浏览 1106人参与
# 小红书求职进展汇总 #
226871次浏览 1356人参与
# 正在春招的你,也参与了去年秋招吗? #
362677次浏览 2631人参与
# 你的房租占工资的比例是多少? #
92140次浏览 896人参与
# 校招笔试 #
467259次浏览 2952人参与
# 机械求职避坑tips #
94409次浏览 567人参与
牛客网
牛客网在线编程
牛客网题解
牛客企业服务