本系列文章介绍从0开始搭建一个基于分布式的医疗挂号系统。本次四篇文章完成了
医院设置微服务模块的后端接口，为了方便开发，对接口的返回结果、全局异常、全局日志进行了统一处理。 同时，为了方便进行访问测试，还整合了Swagger2工具，这些通用的模块中，除了全局日志被放在医院设置微服务模块的配置资源中，其余都统一被抽取在common模块中。具体实现可参考下面文章：
- 医院设置微服务 | 模块搭建
- 医院设置微服务 | 接口开发
- 通用模块 | 整合Swagger2
- 通用模块 | 统一返回结果、统一异常处理、统一日志处理
作者：Hudie
微信公众号/CSDN博客：编程一只蝶
项目已开源至gitee：https://gitee.com/guo-qianliang/yygh_parent
项目已开源至github：https://github.com/Guoqianliang/yygh_parent
一、框架调用流程
从Controller层到Service层
Controller层需要调用Service层的方法，我们在其中使用依赖注入(@Autowired注解)将Service的接口装进Spring容器。-
从Service层到Mapper层
Service层需要调用Mapper层，MyBatis-Plus框架已经将Mapper依赖注入进了Service层，我们只需要分别继承IService<T>接口和ServiceImpl实现类即可。
使用MyBatis-Plus后的三层调用关系
二、医院设置表接口开发
1.增
(1)增加记录
具体代码说明：
- 参数中使用@RequestBody注解表示使用JSON格式传递参数，默认是required=true，表示不能为空。
- 代码中首先将记录的状态设置为1表示该记录可用，然后使用MD5加密算法设置签名密钥，关于MD5加密算法会在接下来的文章中详细介绍。
/**
* 1 增加记录
*/
@PostMapping("saveHospitalSet")
public Result saveHospitalSet(@RequestBody HospitalSet hospitalSet) {
// 设置状态字段 (1:可以使用,0：不能使用)
hospitalSet.setStatus(1);
// 设置签名密钥字段(使用MD5加密)
hospitalSet.setSignKey(MD5.encrypt(System.currentTimeMillis() + "" + new Random().nextInt(1000)));
// 调用方法执行添加
boolean flag = hospitalSetService.save(hospitalSet);
return Result.isOKorFail(flag);
}
增加记录测试
2.删
(1)逻辑删除记录
/**
* 2.1 逻辑删除记录
*/
@ApiOperation(value = "removeHospSer", notes = "逻辑删除医院设置")
@DeleteMapping(value = "{id}")
public Result removeHospSer(@PathVariable Long id) {
boolean flag = hospitalSetService.removeById(id);
return Result.isOKorFail(flag);
}
逻辑删除测试
(2)批量删除记录
/**
* 2.2 批量删除记录
*/
@DeleteMapping("batchRemove")
public Result batchRemoveHospitalSet(@RequestBody List<Long> idList) {
hospitalSetService.removeByIds(idList);
return Result.ok();
}
批量删除测试
3.改
(1)修改记录
/**
* 3 修改记录
*/
@PostMapping("updateHospitalSet")
public Result updateHospitalSet(@RequestBody HospitalSet updateHospitalSet) {
boolean flag = hospitalSetService.updateById(updateHospitalSet);
return Result.isOKorFail(flag);
}
修改测试
4.查
(1)查询所有记录
/**
* 4.1 查询所有记录
* @return list
*/
@ApiOperation(value = "findAllHospitalSet", notes = "获取所有医院设置信息")
@GetMapping("findAll")
public Result findAllHospitalSet() {
List<HospitalSet> list = hospitalSetService.list();
return Result.ok(list);
}
查询所有记录测试
(2)条件查询带分页
查询时需要传递参数作为查询条件，可以使用
vo对象将查询条件进行封装。然后在Controller中获取条件对象，由于带有条件查询带有分页，还需获取分页数据(当前页current、每页记录数limit)
医院设置表的分页查询vo对象：
查询条件vo对象
具体代码说明：
- findPageHospSet方法传入
三个参数，①当前页current ②每页大小limit ③条件查询的vo对象分页步骤是：①创建page对象、②创建QueryWrapper对象、③调用方法执行分页查询条件是医院名称或医院编号，对医院名称进行模糊查询，对医院编号进行等值查询，需要注意对这两个值进行判空处理。@RequestBody(required = false)注解表示使用JSON格式传递参数，然后把JSON数据的值放到对象中去，required = false表示这个值可以为空。使用此参数要将提交方式改为POST，因为GET方式得不到值。
/**
* 4.2 条件查询带分页
* 根据医院名称或编号查询
*/
@PostMapping("findPage/{current}/{limit}")
public Result findPageHospSet(@PathVariable long current,
@PathVariable long limit,
@RequestBody(required = false) HospitalSetQueryVo hospitalSetQueryVo) {
// 1. 创建page对象。传递当前页、每页记录数
Page<HospitalSet> page = new Page(current, limit);
// 2. 创建QueryWrapper对象.
QueryWrapper<HospitalSet> queryWrapper = new QueryWrapper<>();
// 2.1 对医院名称和医院编号进行判空
String hosname = hospitalSetQueryVo.getHosname();
String hoscode = hospitalSetQueryVo.getHoscode();
if (!StringUtils.isEmpty(hosname)) {
queryWrapper.like("hosname", hospitalSetQueryVo.getHosname());
}
if (!StringUtils.isEmpty(hoscode)) {
queryWrapper.eq("hoscode", hospitalSetQueryVo.getHoscode());
}
// 3. 调用方法执行分页。(参数是上面两个对象)
Page<HospitalSet> pageHospitalSet = hospitalSetService.page(page, queryWrapper);
// 返回结果
return Result.ok(pageHospitalSet);
}
条件查询带分页测试
(3)根据id获取记录
/**
* 4.3根据id获取记录
*/
@GetMapping("getHospSet/{id}")
public Result getHospSet(@PathVariable Long id) {
HospitalSet hospitalSet = hospitalSetService.getById(id);
return Result.ok(hospitalSet);
}
根据id获取记录
5.锁定和解锁表
针对表中的status字段：
- status=1时表示解锁
- status=0时表示锁定
只有医院设置表的状态为解锁状态时，才能进行和医院系统的对接，从而进行数据的操作。
/**
* 医院设置表锁定和解锁
*/
@ApiOperation(value = "lockHospitalSet 医院设置表锁定和解锁")
@PutMapping("lockHospitalSet/{id}/{status}")
public Result lockHospitalSet(@PathVariable Long id,
@PathVariable Integer status) {
// 根据id查询医院设置信息
HospitalSet hospitalSet = hospitalSetService.getById(id);
// 设置状态
hospitalSet.setStatus(status);
// 调用更新方法
hospitalSetService.updateById(hospitalSet);
return Result.ok();
}
锁定和解锁表医院设置表
6.发送签名密钥
发送签名密钥，即短信接口，由于调用短信接口较为复杂，后面会有专门的文章进行介绍，这里暂时只写好框架。具体开发流程可参考后续文章。
/**
* 发送签名密钥
*/
@ApiOperation(value = "sendKeyHospitalSet 发送签名密匙")
@PutMapping("sendKey/{id}")
public Result sendKeyHospitalSet(@PathVariable Long id) {
HospitalSet hospitalSet = hospitalSetService.getById(id);
// 签名密钥
String signKey = hospitalSet.getSignKey();
// 医院编号
String hoscode = hospitalSet.getHoscode();
// TODO 发送短信
return Result.ok();
}
至此，医院设置微服务后端接口开发已经完成了，通过swagger可以查看到我们开发的所有方法：
后台管理系统-API文档
