微服务架构中，二次浅封装实践

落日映苍穹つ 2024-04-08 08:45 17阅读 0赞

## 一、背景简介 ##

分布式系统中存在很多拆分的服务，在不断迭代升级的过程中，会出现如下常见的棘手情况：

某个技术组件版本升级，依赖包升级导致部分语法或者API过期，或者组件修复紧急的漏洞，从而会导致分布式系统下各个服务被动的升级迭代，很容易引发意外的问题；不同的服务中对组件的依赖和版本各不相同，从而导致不兼容问题的出现，很难对版本做统一的管理和维护，一旦出现问题很容易手忙脚乱，引发蝴蝶效应；

所以在复杂的系统中，对于依赖的框架和组件进行统一管理和二次浅封装，可以较大程度降低上述问题的处理成本与风险，同时可以更好的管理和控制技术栈。

## 二、框架浅封装 ##

### 1、浅封装作用 ###

为什么浅封装，核心目的在于统一管理和协调组件的依赖与升级，并对常用方法做一层包装，实际上很多组件使用到的功能点并不多，只是在业务中的使用点很多，这样给组件本身的迭代升级带来了一定的难度：

例如某个组件常用的API中存在巨大风险漏洞，或者替换掉过期的用法，需要对整个系统中涉及的地方做升级，这种操作的成本是非常高的；

如果是对这种常用的组件方法进行二次包装，作为处理业务的工具方法，那么解决上面的问题就相对轻松许多，只要对封装的工具方法升级，服务的依赖升级即可，降低时间成本和风险。

通过浅封装的手段，可以实现两个方面的解耦：

**业务与技术**

技术栈中常用的方法进行二次浅封装，这样可以较大程度的降低业务与技术的耦合，如此可以独立的升级技术栈，扩展功能而不影响业务服务的迭代。

**框架与组件**

不同的框架与组件都需要一定程度的自定义配置，同时分模块管理，在不同的服务中引入特定的依赖，也可以在基础包中做统一依赖，以此实现技术栈的快速组合搭配。

这里说的浅封装，是指包装常规常用的语法，组件本身就是技术层面的深度封装，所以也不可能完全隔开技术栈原生用法。

### 2、统一版本控制 ###

例如微服务架构下，不同的研发组负责不同的业务模块，然而受到开发人员的经验和能力影响，很容易出现不同的服务组件选型不一致，或者相同的组件依赖版本不同，这样很难对系统架构做标准的统一管理。

对于二次封装的方式，可以严格的控制技术栈的迭代扩展，以及版本冲突的问题，通过对二次封装层的统一升级，可以快速实现业务服务的升级，解决不同服务的依赖差异问题。

## 三、实践案例 ##

### 1、案例简介 ###

Java分布式系统中，微服务基础组件（Nacos、Feign、Gateway、Seata）等，系统中间件（Quartz、Redis、Kafka、ElasticSearch，Logstash）等，对常用功能、配置、API等，进行二次浅封装并统一集成管理，以满足日常开发中基础环境搭建与临时工具的快速实现。

*  **butte-flyer** 组件封装的应用案例；
 *  **butte-frame** 常用技术组件二次封装；

### 2、分层架构 ###

整体划分五层：网关层、应用层、业务层、中间件层、基础层，组合成一套分布式系统。

![a6d0f33a0e3d4f09ae05217e396393a2.png][]

服务总览

![c3bfbfe16d384f5db2a89d1f3470d1bc.png][]

### 3、目录结构 ###

在`butte-frame`中对各个技术栈进行二次封装管理，在`butte-flyer`中进行依赖引用。

butte-frame
    ├── frame-base          基础代码块
    ├── frame-jdbc          数据库组件
    ├── frame-core          服务基础依赖
    ├── frame-gateway       路由网关
    ├── frame-nacos         注册与配置中心
    ├── frame-seata         分布式事务
    ├── frame-feign         服务间调用
    ├── frame-security      安全管理
    ├── frame-search        搜索引擎
    ├── frame-redis         缓存管理
    ├── frame-kafka         消息中间件
    ├── frame-quartz        定时任务
    ├── frame-swagger       接口文档
    └── frame-sleuth        链路日志
    
    butte-flyer
    ├── flyer-gateway       网关服务：路由控制
    ├── flyer-facade        门面服务：功能协作接口
    ├── flyer-account       账户服务：用户账户
    ├── flyer-quartz        任务服务：定时任务
    └── flyer-admin         管理服务：后端管理

### 4、技术栈组件 ###

系统常用的技术栈：基础框架、微服务组件、缓存、安全管理、数据库、定时任务、工具依赖等。

![e7a987b7c0eb4668a162d2bd331d4707.png][]

## 四、微服务组件 ##

### 1、Nacos ###

Nacos在整个组件体系中，提供两个核心能力，注册发现：适配微服务注册与发现标准，快速实现动态服务注册发现、元数据管理等，提供微服务组件中最基础的能力；配置中心：统一管理各个服务配置，集中在Nacos中存储管理，隔离多环境的不同配置，并且可以规避线上配置放开的风险；

![ecbd42d880f247aa8cf03214d582de11.png][]

**连接管理**

spring:
      cloud:
        nacos:
          # 配置读取
          config:
            prefix: application
            server-addr: 127.0.0.1:8848
            file-extension: yml
            refresh-enabled: true
          # 注册中心
          discovery:
            server-addr: 127.0.0.1:8848

**配置管理**

*  **bootstrap.yml** ：服务中文件，连接和读取Nacos中配置信息；
 *  **application.yml** ：公共基础配置，这里配置mybatis组件；
 *  **application-dev.yml**

[a6d0f33a0e3d4f09ae05217e396393a2.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/7428e087d9f74382b183e13ae9b1c6b0.png
[c3bfbfe16d384f5db2a89d1f3470d1bc.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/b1b76534b16542059bdefad311b02945.png
[e7a987b7c0eb4668a162d2bd331d4707.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/1f363e1d788b46f388a130e428bc5135.png
[ecbd42d880f247aa8cf03214d582de11.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/04/08/ea73cf90c82e4572aaf89b8f54bddd9d.png