分布式医疗挂号系统(二) | 开发医院设置微服务模块

本是古典何须时尚 2022-10-22 07:39 9阅读 0赞

> 本系列文章介绍从0开始搭建一个基于分布式的医疗挂号系统。本次四篇文章完成了`医院设置微服务模块`的后端接口，为了方便开发，对`接口的返回结果`、`全局异常`、`全局日志`进行了统一处理。 同时，为了方便进行访问测试，还`整合了Swagger2工具`，这些通用的模块中，除了`全局日志`被放在医院设置微服务模块的配置资源中，其余都统一被抽取在common模块中。具体实现可参考下面文章：
> 
>  *  [医院设置微服务 | 模块搭建][Link 1]
>  *  [医院设置微服务 | 接口开发][Link 2]
>  *  [通用模块 | 整合Swagger2][_ _Swagger2]
>  *  [通用模块 | 统一返回结果、统一异常处理、统一日志处理][Link 3]
> 
> --------------------
> 
> 作者：Hudie  
> 微信公众号/CSDN博客：编程一只蝶  
> 公众号文章会比博客早1到2天，欢迎关注，每天开心~  
> 项目已开源至gitee：[https://gitee.com/guo-qianliang/yygh\_parent][https_gitee.com_guo-qianliang_yygh_parent]  
> 项目已开源至github：[https://github.com/Guoqianliang/yygh\_parent][https_github.com_Guoqianliang_yygh_parent]

### 医院设置微服务接口开发 ###

*  一、框架调用流程
 *  二、医院设置表接口开发
 *   *  1.增
     *   *  (1)增加记录
     *  2.删
     *   *  (1)逻辑删除记录
         *  (2)批量删除记录
     *  3.改
     *   *  (1)修改记录
     *  4.查
     *   *  (1)查询所有记录
         *  (2)条件查询带分页
         *  (3)根据id获取记录
     *  5.锁定和解锁表
     *  6.发送签名密钥

--------------------

# 一、框架调用流程 #

*  从Controller层到Service层  
    Controller层需要调用Service层的方法，我们在其中使用依赖注入(@Autowired注解)将Service的接口装进Spring容器。
 *  从Service层到Mapper层  
    Service层需要调用Mapper层，MyBatis-Plus框架已经将Mapper依赖注入进了Service层，我们只需要分别继承IService接口和ServiceImpl实现类即可。  
    ![使用MyBatis-Plus后的三层调用关系][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);
        }

![增加记录测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70]

## 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);
        }

![逻辑删除测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 1]

### (2)批量删除记录 ###

/** * 2.2 批量删除记录 */
        @DeleteMapping("batchRemove")
        public Result batchRemoveHospitalSet(@RequestBody List<Long> idList) { 
            hospitalSetService.removeByIds(idList);
            return Result.ok();
        }

![批量删除测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 2]

## 3.改 ##

### (1)修改记录 ###

/** * 3 修改记录 */
        @PostMapping("updateHospitalSet")
        public Result updateHospitalSet(@RequestBody HospitalSet updateHospitalSet) { 
            boolean flag = hospitalSetService.updateById(updateHospitalSet);
            return Result.isOKorFail(flag);
        }

![修改测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 3]

## 4.查 ##

### (1)查询所有记录 ###

/** * 4.1 查询所有记录 * @return list */
        @ApiOperation(value = "findAllHospitalSet", notes = "获取所有医院设置信息")
        @GetMapping("findAll")
        public Result findAllHospitalSet() { 
            List<HospitalSet> list = hospitalSetService.list();
            return Result.ok(list);
        }

![查询所有记录测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 4]

### (2)条件查询带分页 ###

> 查询时需要传递参数作为查询条件，可以使用`vo对象`将查询条件进行封装。然后在Controller中获取条件对象，由于带有条件查询带有分页，还需获取分页数据(当前页current、每页记录数limit)

医院设置表的分页查询vo对象：

![查询条件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);
        }

![条件查询带分页测试][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 5]

### (3)根据id获取记录 ###

/** * 4.3根据id获取记录 */
        @GetMapping("getHospSet/{id}")
        public Result getHospSet(@PathVariable Long id) { 
            HospitalSet hospitalSet = hospitalSetService.getById(id);
            return Result.ok(hospitalSet);
        }

![根据id获取记录][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();
        }

![锁定和解锁表医院设置表][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 6]

## 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文档][-API]

[Link 1]: https://blog.csdn.net/weixin_43691058/article/details/115419552?spm=1001.2014.3001.5502
[Link 2]: https://blog.csdn.net/weixin_43691058/article/details/115437742?spm=1001.2014.3001.5502
[_ _Swagger2]: https://blog.csdn.net/weixin_43691058/article/details/115439245?spm=1001.2014.3001.5502
[Link 3]: https://blog.csdn.net/weixin_43691058/article/details/115447130?spm=1001.2014.3001.5502
[https_gitee.com_guo-qianliang_yygh_parent]: https://gitee.com/guo-qianliang/yygh_parent
[https_github.com_Guoqianliang_yygh_parent]: https://github.com/Guoqianliang/yygh_parent
[MyBatis-Plus]: /images/20221022/04ea7c104ada4f7098993981d4e48117.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70]: /images/20221022/1d91c933898b4d128c8f8e2e2a08c571.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 1]: /images/20221022/d11d6cd0b7594d0eb30afe161f864b4a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 2]: /images/20221022/56e852cb3680402f9681ea3d3435bc44.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 3]: /images/20221022/070bf8568a45436982bd8f5826517777.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 4]: /images/20221022/e18ad15c32d146cbad084f32e92f7171.png
[vo]: /images/20221022/71cce47383444dd383a413345fb926d6.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 5]: /images/20221022/18bb6763e0d14dddaff5877e593cdae8.png
[id]: /images/20221022/c1f9dba4ffbd4b398f146327bd149e2b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L3dlaXhpbl80MzY5MTA1OA_size_1_color_FFFFFF_t_70 6]: /images/20221022/fffe09c0b57f45e38b7956daf7106045.png
[-API]: /images/20221022/77ae14207be443a0aef2dccda61b3148.png