阿里巴巴分层应用架构实践

2024-06-03 10:49| 来源: 网络整理| 查看: 265

本项目使用分层架构构建，分层架构是《阿里巴巴Java开发手册》推荐使用的一种面向数据模型的架构风格，默认上层依赖于下层，例如 Web 层依赖 Service 层、Service 层又依赖 DAO 层，在垂直业务领域能够满足单一职责原则，通过 Maven 多模块化的开发模式，可以帮助降低复杂应用场景的系统熵值，提升系统开发和运维效率。您可以访问 GitHub 查阅源码。

组件构成

eden-demo-layer-api：API层，对外以 jar 包的形式提供接口。eden-demo-layer-dao：数据持久层，与底层 MySQL、Elasticsearch、MongoDB 等进行数据交互。eden-demo-layer-service：业务逻辑服务层。eden-demo-layer-manager：通用业务处理层，对第三方平台进行接口封装，对 Service 层通用能力的下沉，如缓存方案、中间件通用处理，与 DAO 层交互，对多个 DAO 的组合复用。eden-demo-layer-web：请求处理层，对访问控制进行转发，各类基本参数校验，或者不复用的业务简单处理等。eden-demo-layer-start：程序启动入口，统一管理应用的配置和交付。运行流程

在这里插入图片描述

如何构建

由于 Spring Boot 2.4.x 和 Spring Boot 3.0.x 在架构层面有很大的变更，因此笔者采取跟 Spring Boot 版本号一致的分支:

2.4.x 分支适用于 Spring Boot 2.4.x，最低支持 JDK 1.8。2.7.x 分支适用于 Spring Boot 2.7.x，最低支持 JDK 11。3.0.x 分支适用于 Spring Boot 3.0.x，最低支持 JDK 17。

本项目默认使用 Maven 来构建，最快的使用方式是 git clone 到本地。为了简化不必要的技术细节，本项目依赖 eden-architect，在项目的根目录执行 mvn install -T 4C 完成本项目的构建。

如何启动快速体验

本项目默认设置了 local 环境运行，所有外部的组件依赖均为关闭状态。

在项目目录下运行 mvn install（如果不想运行测试，可以加上 -DskipTests 参数）。进入 eden-demo-layer-start 目录，执行 mvn spring-boot:run 或者启动 LayerApplication 类。运行成功的话，可以看到 Spring Boot 启动成功的界面。本应用中已经实现了一个简单的 RestController 接口，可以点击演示接口进行调试。由于目前的主流是前后端分离开发，请按需实现页面。访问 http://localhost:8082 将跳转到 404 页面。在这里插入图片描述

微调配置

开启配置中心：推荐使用 Nacos 组件，您可以查阅 Nacos Quick Start 快速搭建，请根据您的 Nacos 地址修改配置文件：bootstrap-dev.yml，调整以下内容：

spring: cloud: nacos: discovery: # 注册中心 enabled: true # 默认关闭，请按需开启 config: # 配置中心 enabled: true # 默认关闭，请按需开启

修改默认的数据源：本项目默认使用 H2 内存数据库启动，基于 Liquibase 在项目启动时自动初始化 SQL 脚本。如果您使用的是外部的 MySQL 数据库，可以从此处调整下数据库的连接信息：application-local.yml，请删除任何与 H2 有关的配置。

spring: # h2: # 内存数据库 # console: # enabled: true # 线上环境请勿设置 # path: /h2-console # settings: # trace: false # web-allow-others: false datasource: # 数据源管理 username: password: url: jdbc:mysql://host:port/schema?rewriteBatchedStatements=true&useSSL=false&useOldAliasMetadataBehavior=true&useUnicode=true&serverTimezone=GMT%2B8 driver-class-name: com.mysql.cj.jdbc.Driver

此外，本项目还罗列了 Redis 缓存、RocketMQ 消息队列、ShardingSphere 分库分表等常用组件的使用方案，默认通过 xxx.enabled 关闭自动配置。您可以根据实际情况开启配置，直接完成组件的集成。

如何部署 JAR 程序部署

在项目根目录执行以下命令，生成 JAR 可执行程序。

mvn -T 4C -U package mvn -T 4C deploy # 可选项，发布依赖到私服 Jib 镜像部署

Google Jib 插件允许您在没有安装 Docker 下完成镜像的构建。

mvn -T 4C -U package mvn -pl eden-demo-layer-start jib:build -Djib.disableUpdateChecks=true -DskipTests Docker 容器部署

本项目使用了 Spring Boot 的镜像分层特性优化了镜像的构建效率，请确保正确安装了 Docker 工具，然后执行以下命令。

docker build -f docker/Dockerfile -t eden-demo-layer:{tag} . Helm 打包部署

以应用为中心，建议使用 Helm 统一管理所需部署的 K8s 资源描述文件，请参考以下命令完成应用的安装和卸载。

helm install eden-demo-layer ./helm # 部署资源 helm uninstall eden-demo-layer # 卸载资源版本规范

项目的版本号格式为 x.y.z 的形式，其中 x 的数值类型为数字，从 0 开始取值，且不限于 0~9 这个范围。项目处于孵化器阶段时，第一位版本号固定使用 0，即版本号为 0.x.x 的格式。

孵化版本：0.0.1-SNAPSHOT开发版本：1.0.0-SNAPSHOT发布版本：1.0.0