前言
俗话说,养兵千日,用兵一时,经过了前面多章的学习和摸索,是时候正式开始动手了。那么我们就来做一个用户管理的基本功能,来熟悉springboot后端开发流程。但是在写代码之前我们首先需要定义HTTP接口,然后按照接口进行编码调试。本篇先定义用户管理基本功能的HTTP接口,供大家参考。
一、数据库表定义
还是以前面的后端代码框架为基础,先重新定义数据库表users
DROP TABLE users;
– 用户表
create table users (
id int unsigned primary key auto_increment comment ‘ID’,
username varchar(20) not null unique comment ‘用户名’,
password varchar(32) comment ‘密码’,
nickname varchar(10) default ‘’ comment ‘昵称’,
email varchar(128) default ‘’ comment ‘邮箱’,
create_time datetime not null comment ‘创建时间’,
create_user int unsigned not null comment ‘创建人’
) comment ‘用户表’;
然后插入一条初始记录以便于登录。
INSERT INTO users (id, username, password, nickname, email, create_time, create_user) VALUES (1, ‘admin’, ‘25d55ad283aa400af464c76d713c07ad’, ‘张三’, ‘zhangsan@126.com’,‘2024-01-01 00:00:00’,0);
注意:
1、application.yml中mybatis的log-impl配置可以设置如下,表示mapper中的sql语句可以在控制台打印出来,以方便调试。
2、如果数据库中有时间格式的参数,需要关闭驼峰命名,否则时间格式参数返回为null。
二、接口定义
根据以上数据库表users,来定义HTTP访问接口。
1.登录
1.1、基本信息
请求路径:/user/login
请求方式:POST
接口描述:该接口用于用户登录
1.2、请求参数
请求参数格式:x-www-form-urlencoded
请求参数说明:
参数名称 | 说明 | 类型 | 是否必须 | 备注 |
---|---|---|---|---|
username | 用户名 | string | 必须 | 5~16位非空字符 |
password | 密码 | string | 必须 | 5~16位非空字符 |