SpringBootWeb案例01：tlias智能学习辅助系统
SpringBootWeb案例（一）——部门管理
1. 准备工作
1.1 需求分析&环境搭建
1.1.1 需求说明
1.部门管理：
部门管理功能开发包括
- 查询部门列表
- 删除部门
- 新增部门
- 修改部门
2.员工管理
员工管理功能开发包括：
- 查询员工列表（分页，条件）
- 删除员工
- 新增员工
- 修改员工
1.1.2 环境搭建
步骤：
第1步：准备数据库表
先建立一个名为tlias的数据库，然后将下面的sql语句执行直接就会得到两种表（dept、emp）
-- 部门管理
create table dept(
id int unsigned primary key auto_increment comment '主键ID',
name varchar(10) not null unique comment '部门名称',
create_time datetime not null comment '创建时间',
update_time datetime not null comment '修改时间'
) comment '部门表';
insert into dept (id, name, create_time, update_time) values(1,'学工部',now(),now()),(2,'教研部',now(),now()),(3,'咨询部',now(),now()), (4,'就业部',now(),now()),(5,'人事部',now(),now());
-- 员工管理(带约束)
create table emp (
id int unsigned primary key auto_increment comment 'ID',
username varchar(20) not null unique comment '用户名',
password varchar(32) default '123456' comment '密码',
name varchar(10) not null comment '姓名',
gender tinyint unsigned not null comment '性别, 说明: 1 男, 2 女',
image varchar(300) comment '图像',
job tinyint unsigned comment '职位, 说明: 1 班主任,2 讲师, 3 学工主管, 4 教研主管, 5 咨询师',
entrydate date comment '入职时间',
dept_id int unsigned comment '部门ID',
create_time datetime not null comment '创建时间',
update_time datetime not null comment '修改时间'
) comment '员工表';
INSERT INTO emp
(id, username, password, name, gender, image, job, entrydate,dept_id, create_time, update_time) VALUES
(1,'jinyong','123456','金庸',1,'1.jpg',4,'2000-01-01',2,now(),now()),
(2,'zhangwuji','123456','张无忌',1,'2.jpg',2,'2015-01-01',2,now(),now()),
(3,'yangxiao','123456','杨逍',1,'3.jpg',2,'2008-05-01',2,now(),now()),
(4,'weiyixiao','123456','韦一笑',1,'4.jpg',2,'2007-01-01',2,now(),now()),
(5,'changyuchun','123456','常遇春',1,'5.jpg',2,'2012-12-05',2,now(),now()),
(6,'xiaozhao','123456','小昭',2,'6.jpg',3,'2013-09-05',1,now(),now()),
(7,'jixiaofu','123456','纪晓芙',2,'7.jpg',1,'2005-08-01',1,now(),now()),
(8,'zhouzhiruo','123456','周芷若',2,'8.jpg',1,'2014-11-09',1,now(),now()),
(9,'dingminjun','123456','丁敏君',2,'9.jpg',1,'2011-03-11',1,now(),now()),
(10,'zhaomin','123456','赵敏',2,'10.jpg',1,'2013-09-05',1,now(),now()),
(11,'luzhangke','123456','鹿杖客',1,'11.jpg',5,'2007-02-01',3,now(),now()),
(12,'hebiweng','123456','鹤笔翁',1,'12.jpg',5,'2008-08-18',3,now(),now()),
(13,'fangdongbai','123456','方东白',1,'13.jpg',5,'2012-11-01',3,now(),now()),
(14,'zhangsanfeng','123456','张三丰',1,'14.jpg',2,'2002-08-01',2,now(),now()),
(15,'yulianzhou','123456','俞莲舟',1,'15.jpg',2,'2011-05-01',2,now(),now()),
(16,'songyuanqiao','123456','宋远桥',1,'16.jpg',2,'2007-01-01',2,now(),now()),
(17,'chenyouliang','123456','陈友谅',1,'17.jpg',NULL,'2015-03-21',NULL,now(),now());
第2步：配置文件application.properties中引入mybatis的配置信息，准备对应的实体类
#数据库连接
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://localhost:3306/tlias
spring.datasource.username=root
spring.datasource.password=root
#开启mybatis的日志输出
mybatis.configuration.logimpl=org.apache.ibatis.logging.stdout.StdOutImpl
#开启数据库表字段 到 实体类属性的驼峰映射
mybatis.configuration.map-underscore-to-camel-case=true
需要注意的是：将数据库的用户和密码设置为自己电脑上的
第3步：准备对应的Mapper、Service(接口、实现类)、Controller基础结构
项目工程结构：
控制层——controller
- DeptController
package cn.shisan.mapper;
import org.springframework.web.bind.annotation.RestController;
//部门管理控制器
@RestController
public class DeptController {
}
- EmpController
package cn.shisan.mapper;
import org.springframework.web.bind.annotation.RestController;
//员工管理控制器
@RestController
public class EmpController {
}
数据访问层——mapper
- DeptMapper
package cn.shisan.mapper;
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface DeptMapper {
}
- EmpMapper
package cn.shisan.mapper;
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface EmpMapper {
}
业务层——Service
- DeptService
package cn.shisan.service;
//部门业务规则
public interface DeptService {
}
- DeptServiceImpl
package cn.shisan.service.impl;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
//部门业务实现类
@Slf4j
@Service
public class DeptServiceImpl implements DeptService {
}
- EmpService
package cn.shisan.service;
//员工业务规则
public interface EmpService {
}
- EmpServiceImpl
package cn.shisan.service.impl;
import cn.shisan.service.EmpService;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
//员工业务实现类
@Slf4j
@Service
public class EmpServiceImpl implements EmpService {
}
- 实体类——pojo
/*部门类*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Dept {
private Integer id;
private String name;
private LocalDateTime createTime;
private LocalDateTime updateTime;
}
/*员工类*/
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Emp {
private Integer id;
private String username;
private String password;
private String name;
private Short gender;
private String image;
private Short job;
private LocalDate entrydate;
private Integer deptId;
private LocalDateTime createTime;
private LocalDateTime updateTime;
}
具体的前后端流程
2. 开发流程
我们在进行功能开发时，都是根据以下流程进行：
- 查看页面原型明确需求
根据页面原型和需求，进行表结构设计、编写接口文档(已提供) - 阅读接口文档
- 思路分析
- 功能接口开发
就是开发后台的业务功能，一个业务功能，我们称为一个接口 - 功能接口测试
功能开发完毕后，先通过Postman进行功能接口测试，测试通过后，再和前端进行联调测
试 - 前后端联调测试
和前端开发人员开发好的前端工程一起测试
2. 部门管理
2.1 查询部门
2.1.1 思路分析
2.1.2 功能开发
DeptController
@Slf4j //定义一个日志记录对象 等价于下面对log对象的定义1.
@RestController
public class DeptController {
// 1.定义一个日志记录对象
// 1.private static Logger log = LoggerFactory.getLogger(DeptController.class);
// @RequestMapping(value = "/depts",method = RequestMethod.GET)//指定请求方式为get
@GetMapping("/depts")// 指定`/depts`路由的请求方式为get 与上一行代码等价
public Result list(){
log.info("查询全部部门数据");
return Result.success();
}
}
在postman中测试一下
查询的5条信息
DeptService
package cn.shisan.service;
import cn.shisan.pojo.Dept;
import org.springframework.stereotype.Service;
import java.util.List;
@Slf4j //定义一个日志记录对象 等价于下面对log对象的定义1.
@RestController
public class DeptController {
// 1.定义一个日志记录对象
// 1.private static Logger log = LoggerFactory.getLogger(DeptController.class);
@Autowired//定义一个Service层对象
private DeptService deptService;
// @RequestMapping(value = "/depts",method = RequestMethod.GET)//指定请求方式为get
@GetMapping("/depts")// 指定`/depts`路由的请求方式为get 与上一行代码等价
public Result list(){
log.info("查询全部部门数据");
// 调用service查询部门数据
List<Dept> deptList = deptService.list();//此时service层中还没定义该方法，需要返回Service层中定义该方法
return Result.success(deptList);
}
}
DeptServiceImpl
@Override
public List<Dept> list() {
return deptMapper.list();
}
DeptMapper
/**
* 查询全部部门信息
*
* @return
*/
@Select("select * from dept")
List<Dept> list();
2.1.3 功能测试
功能开发完成后，我们就可以启动项目，然后打开postman，发起GET请求，访问 ：
http://localh ost:8080/depts
2.1.4 前后端联调
完成了查询部门的功能，我们也通过postman工具测试通过了，下面我们再基于前后端分离的方式进行
接口联调。具体操作如下：
1、 将资料中提供的"前端环境"文件夹中的压缩包，拷贝到一个没有中文不带空格的目录下
2、 拷贝到一个没有中文不带空格的目录后，进行解压（解压到当前目录）
3、 启动nginx
4、 打开浏览器，访问：http://localhost:90
5、 测试：部门管理 - 查询部门列表
2.2 删除部门
查询部门的功能我们搞定了，下面我们开始完成删除部门的功能开发。
2.2.1 思路分析
根据部门的id查询部门信息，需要用@PathVariable 注解 来修饰id
2.2.2 功能开发
DeptController
/**
* 删除部门信息
*
* @return
*/
@DeleteMapping("/{id}")
public Result delete(@PathVariable Integer id) {
log.info("根据id删除部门{}", id);
// 调用service删除部门
deptService.delete(id);
return Result.success();
}
DeptService
/**
* 删除部门
*
* @param id
*/
void delete(Integer id);
DeptServiceImpl
@Override
public void delete(Integer id) {
deptMapper.deleteById(id);
}
DeptMapper
/**
* 根据id删除部门
*
* @param id
*/
@Delete("delete from dept where id = #{id}")
void deleteById(Integer id);
2.2.3 功能测试
删除功能开发完成后，重新启动项目，使用postman，发起DELETE请求：
2.2.4 前后端联调
2.3 新增部门
我们前面已完成了查询部门、删除部门两个功能，也熟悉了开发的流程。下面我们继续完成新增部门功能。
思路分析
2.3.1 功能开发
DeptController
传入的参事是一个对象是需要使用注解@RequestBody来标注形参
/**
* 新增部门信息
*
* @return
*/
@PostMapping
public Result add(@RequestBody Dept dept) {
log.info("新增部门：{}", dept);
// 调用service新增部门
deptService.add(dept);
return Result.success();
}
DeptService
/**
* 新增部门信息
*
* @param dept
*/
void add(Dept dept);
DeptServiceImpl
添加部门信息，需要例外增加部门的创建时间和修改时间为当前的时间
@Override
public void add(Dept dept) {
dept.setCreateTime(LocalDateTime.now());
dept.setUpdateTime(LocalDateTime.now());
deptMapper.insert(dept);
}
DeptMapper
/**
* 新增部门信息
*/
@Insert("insert into dept (name, create_time, update_time) values (#{name},#{createTime},#{updateTime})")
void insert(Dept dept);
2.3.2 功能测试
新增功能开发完成后，重新启动项目，使用postman，发起POST请求：
2.3.3 前后端联调
打开浏览器，测试后端功能接口：
2.4 根据id查询部门
2.4.1 功能开发
DeptController
@GetMapping("/{id}")
public Result select(@PathVariable Integer id) {
log.info("查询部门信息：{}", id);
Dept dept = deptService.selectById(id);
return Result.success(dept);
}
DeptService
/**
* 根据部门id查询
*
* @param id
*/
Dept selectById(Integer id);
DeptServiceImpl
@Override
public Dept selectById(Integer id) {
Dept dept = deptMapper.selectById(id);
return dept;
}
DeptMapper
/**
* 根据部门id查询信息
*
* @param id
*/
@Select("select * from dept where id = #{id}")
Dept selectById(Integer id);
2.5 修改部门信息
2.5.1 功能开发
DeptController
@PutMapping()
public Result update(@RequestBody Dept dept) {
log.info("修改部门信息为：{}", dept);
// 调用service修改部门信息
deptService.update(dept);
return Result.success();
}
DeptService
/**
* 修改部门信息
*
* @param dept
*/
void update(Dept dept);
DeptServiceImpl
这里和前面创建部门信息是一样的，需要更新部门的修改时间
@Override
public void update(Dept dept) {
dept.setUpdateTime(LocalDateTime.now());
deptMapper.update(dept);
}
DeptMapper
/**
* 修改部门
*
* @param dept
*/
@Update("update dept set name = #{name}, update_time = #{updateTime} where id = #{id}")
void update(Dept dept);