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

文章导读

本系列文章介绍从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实现类即可。

使用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 = "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可以查看到我们开发的所有方法：

后台管理系统-API文档

频道导航