实战分布式医疗挂号系统之设置微服务接口开发模块实战分布式医疗挂号系统之设

文章导读
一、框架调用流程
二、医院设置表接口开发

1.增
2.删

(1)逻辑删除记录
(2)批量删除记录

3.改

(1)修改记录

4.查

(1)查询所有记录
(2)条件查询带分页
(3)根据id获取记录

5.锁定和解锁表

6.发送签名密钥

文章导读本系列文章介绍从0开始搭建一个基于分布式的医疗挂号系统。本次四篇文章完成了医院设置微服务模块的后端接口，为了方便开发，对接口的返回结果、全局异常、全局日志进行了统一处理。同时，为了方便进行访问测试，还整合了Swagger2工具，这些通用的模块中，除了全局日志被放在医院设置微服务模块的配置资源中，其余都统一被抽取在common模块中。具体实现可参考下面文章：
医院设置微服务 | 模块搭建
医院设置微服务 | 接口开发
通用模块 | 整合Swagger2
通用模块 | 统一返回结果、统一异常处理、统一日志处理
项目已开源至https://github.com/Guoqianliang/yygh_parent
【实战分布式医疗挂号系统之设置微服务接口开发模块】
一、框架调用流程

从Controller层到Service层

Controller层需要调用Service层的方法，我们在其中使用依赖注入(@Autowired注解)将Service的接口装进Spring容器。

从Service层到Mapper层

Service层需要调用Mapper层，MyBatis-Plus框架已经将Mapper依赖注入进了Service层，我们只需要分别继承IService接口和ServiceImpl实现类即可。

文章图片

二、医院设置表接口开发
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 = "https://www.it610.com/article/removeHospSer", notes = "逻辑删除医院设置")@DeleteMapping(value = "https://www.it610.com/article/{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 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 = "https://www.it610.com/article/findAllHospitalSet", notes = "获取所有医院设置信息")@GetMapping("findAll")public Result findAllHospitalSet() {List list = hospitalSetService.list(); return Result.ok(list); }

文章图片

(2)条件查询带分页查询时需要传递参数作为查询条件，可以使用vo对象将查询条件进行封装。然后在Controller中获取条件对象，由于带有条件查询带有分页，还需获取分页数据(当前页current、每页记录数limit)
医院设置表的分页查询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 page = new Page(current, limit); // 2. 创建QueryWrapper对象.QueryWrapper 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 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); }

文章图片

5.锁定和解锁表
针对表中的status字段：

status=1时表示解锁
status=0时表示锁定

只有医院设置表的状态为解锁状态时，才能进行和医院系统的对接，从而进行数据的操作。

/*** 医院设置表锁定和解锁*/@ApiOperation(value = "https://www.it610.com/article/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 = "https://www.it610.com/article/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(); }

至此，医院设置微服务后端接口开发已经完成了，通过swagger可以查看到我们开发的所有方法：