快捷導(dǎo)航

實(shí)戰(zhàn)分布式醫(yī)療掛號系統(tǒng)之設(shè)置微服務(wù)搭建醫(yī)院模塊

更新時(shí)間：2022年04月24日 15:41:13 作者：Hudie.

這篇文章主要為大家介紹了實(shí)戰(zhàn)分布式醫(yī)療掛號系統(tǒng)之搭建醫(yī)院設(shè)置微服務(wù)模塊，有需要的朋友可以借鑒參考下，希望能夠有所幫助，祝大家多多進(jìn)步，早日升職加薪

文章導(dǎo)讀

本系列文章介紹從0開始搭建一個(gè)基于分布式的醫(yī)療掛號系統(tǒng)。本次四篇文章完成了醫(yī)院設(shè)置微服務(wù)模塊的后端接口，為了方便開發(fā)，對接口的返回結(jié)果、全局異常、全局日志進(jìn)行了統(tǒng)一處理。同時(shí)，為了方便進(jìn)行訪問測試，還整合了Swagger2工具，這些通用的模塊中，除了全局日志被放在醫(yī)院設(shè)置微服務(wù)模塊的配置資源中，其余都統(tǒng)一被抽取在common模塊中。具體實(shí)現(xiàn)可參考下面文章：

醫(yī)院設(shè)置微服務(wù) | 接口開發(fā)

通用模塊 | 整合Swagger2

通用模塊 | 統(tǒng)一返回結(jié)果、統(tǒng)一異常處理、統(tǒng)一日志處理

項(xiàng)目已開源至 https://github.com/Guoqianliang/yygh_parent

一、項(xiàng)目模塊劃分圖

本系列文章開始介紹從0開始搭建一個(gè)《基于分布式的醫(yī)療掛號系統(tǒng)》，下圖是初步模塊劃分圖，可根據(jù)此圖在IDEA中創(chuàng)建出項(xiàng)目初步結(jié)構(gòu)。其中父工程是一個(gè)Spring工程，父模塊是Maven工程，注意兩者都需要使用pom方式進(jìn)行打包。

初步模塊劃分圖

二、開發(fā)前的準(zhǔn)備工作

1.醫(yī)院設(shè)置數(shù)據(jù)庫表設(shè)計(jì)

在《基于分布式的醫(yī)療預(yù)約掛號系統(tǒng)》中，醫(yī)院設(shè)置表yygh_hosp主要是用來保存每個(gè)醫(yī)院的一些基本信息，每個(gè)醫(yī)院的信息就是一條記錄。這條記錄中保存了醫(yī)院編號、接口調(diào)用相關(guān)的簽名等等。

只有開通了醫(yī)院設(shè)置，才可以進(jìn)行醫(yī)院記錄的上傳。所以，在醫(yī)院設(shè)置模塊部分，我們所開發(fā)的功能就是基于單表的一個(gè)CRUD、發(fā)送簽名信息等基本功能。

# 創(chuàng)建數(shù)據(jù)庫: yygh_hosp
CREATE DATABASE IF NOT EXISTS `yygh_hosp` CHARACTER SET utf8mb4;
USE `yygh_hosp`;
# 創(chuàng)建表:hospital_set
CREATE TABLE `hospital_set` (
  `id` BIGINT(20) NOT NULL AUTO_INCREMENT COMMENT '編號',
  `hosname` VARCHAR(100) DEFAULT NULL COMMENT '醫(yī)院名稱',
  `hoscode` VARCHAR(30) DEFAULT NULL COMMENT '醫(yī)院編號',
  `api_url` VARCHAR(100) DEFAULT NULL COMMENT 'api基礎(chǔ)路徑',
  `sign_key` VARCHAR(50) DEFAULT NULL COMMENT '簽名秘鑰',
  `contacts_name` VARCHAR(20) DEFAULT NULL COMMENT '聯(lián)系人',
  `contacts_phone` VARCHAR(11) DEFAULT NULL COMMENT '聯(lián)系人手機(jī)',
  `status` TINYINT(3) NOT NULL DEFAULT '0' COMMENT '狀態(tài)',
  `create_time` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `update_time` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新時(shí)間',
  `is_deleted` TINYINT(3) NOT NULL DEFAULT '0' COMMENT '邏輯刪除(1:已刪除，0:未刪除)',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_hoscode` (`hoscode`) COMMENT '唯一約束(醫(yī)院編號必須唯一)'
) ENGINE=INNODB AUTO_INCREMENT=2 DEFAULT CHARSET=utf8 COMMENT='醫(yī)院設(shè)置表';

創(chuàng)建好后的數(shù)據(jù)庫表如下：

醫(yī)院信息表

2.搭建醫(yī)院設(shè)置微服務(wù)模塊

在servie父模塊中創(chuàng)建service_hosp模塊，為service_hosp模塊添加如下配置信息：

# 服務(wù)端口
server.port=8201
# 服務(wù)名
spring.application.name=service-hosp
# 環(huán)境設(shè)置：dev、test、prod
spring.profiles.active=dev
# mysql數(shù)據(jù)庫連接
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.url=jdbc:mysql://[ip地址]:3306/yygh_hosp?characterEncoding=utf-8&useSSL=false
spring.datasource.username=[數(shù)據(jù)庫名稱]
spring.datasource.password=[數(shù)據(jù)庫密碼]
#返回json的全局時(shí)間格式
spring.jackson.date-format=yyyy-MM-dd HH:mm:ss
spring.jackson.time-zone=GMT+8

并為此微服務(wù)模塊創(chuàng)建啟動類：

package com.gql.yygh.hosp;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
/**
 * @Description: 啟動類
 * @author Guoqianliang
 * @date 20:17 - 2021/4/3
 */
@SpringBootApplication
public class ServiceHospApplication {
    public static void main(String[] args) {
        SpringApplication.run(ServiceHospApplication.class, args);
    }
}

在測試前，將service模塊中下圖所示的三個(gè)依賴注釋掉，這些現(xiàn)在還用不到。若不注釋，啟動時(shí)項(xiàng)目會報(bào)錯。

需要被注釋的依賴

運(yùn)行此微服務(wù)，發(fā)現(xiàn)項(xiàng)目成功啟動：

微服務(wù)啟動成功

至此，醫(yī)院設(shè)置數(shù)據(jù)庫表，以及醫(yī)院微服務(wù)模塊搭建成功，后續(xù)就可以在此基礎(chǔ)上進(jìn)行接口的編寫了。

三、醫(yī)院設(shè)置微服務(wù)模塊開發(fā)

步驟1：生成表對應(yīng)的實(shí)體類

此處在編寫實(shí)體類時(shí)使用了一個(gè)父子類來做映射，這樣做是為了將公用的字段給抽取出來。

在繼承中，子類繼承父類就擁有了父類的全部非私有屬性。

與yygh_hosp數(shù)據(jù)庫表對應(yīng)的實(shí)體類

步驟2：創(chuàng)建Mapper

MyBatis-Plus在Mapper層為我們提供了一個(gè)BaseMapper<T>接口，繼承這個(gè)接口，即可獲得CRUD功能。

Mapper層

mapper一般對應(yīng)一個(gè)xml配置文件，下面對xml的開發(fā)規(guī)范進(jìn)行補(bǔ)充：

mapper接口的地址通過.xml中的namespace屬性引入。mapper接口中方法名和.xml中id一致。mapper接口中方法輸入?yún)?shù)類型和.xml中statement的parameterType指定的類型一致。mapper接口中方法返回值類型和.xml中statement的resultType指定的類型一致。

由于Mapperapper是一個(gè)接口，接口動態(tài)生成實(shí)現(xiàn)類的對象默認(rèn)是找不到的，需要添加MapperScan才能找到動態(tài)生成的對象?？梢詫apperScan寫在啟動類上，也可以如下所示編寫一個(gè)配置類進(jìn)行統(tǒng)一管理。

package com.gql.yygh.hosp.config;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Configuration;
/**
 * @Description: 醫(yī)院配置
 * @author Guoqianliang
 * @date 9:42 - 2021/4/4
 */
@Configuration
@MapperScan("com.gql.yygh.hosp.mapper")
public class HospConfig {
}

步驟3：創(chuàng)建Service

MyBatis-Plus在Service層為我們提供了一個(gè)IService接口和一個(gè)ServiceImpl實(shí)現(xiàn)類，我們的Service接口繼承IService接口、我們的實(shí)現(xiàn)類繼承ServiceImpl實(shí)現(xiàn)類。就可以讓MyBatis-Plus在Service層幫我們?nèi)フ{(diào)用Mapper，直接使用封裝號的baseMapper就能完成調(diào)用。

Service層

步驟4：創(chuàng)建Controller

創(chuàng)建Controller，在其中裝配Service即可，后續(xù)在Controller中調(diào)用Service層的方法，進(jìn)而調(diào)用數(shù)據(jù)庫即可實(shí)現(xiàn)功能。

/**
 * @Description: Controller
 * @author Guoqianliang
 * @date 0:16 - 2021/4/4
 */
@RestController
@RequestMapping("/admin/hosp/hospitalSet")
public class HospitalSetController {
    /**
     * 注入Service
     */
    @Autowired
    private HospitalSetService hospitalSetService;
}

四、測試開發(fā)環(huán)境

為了驗(yàn)證環(huán)境的正確性，下面對微服務(wù)整體進(jìn)行測試，我們在Controller中編寫一個(gè)查詢數(shù)據(jù)庫所有信息的方法。

/**
 * @Description: Controller
 * @author Guoqianliang
 * @date 0:16 - 2021/4/4
 */
@RestController
@RequestMapping("/admin/hosp/hospitalSet")
public class HospitalSetController {
    /**
     * 注入Service
     */
    @Autowired
    private HospitalSetService hospitalSetService;
}

手動在yygh_hosp數(shù)據(jù)庫hospital_set表中添加一條記錄：

添加一條記錄進(jìn)行測試