```markdown

# 超越边界：构建优雅的六边形架构（Hexagonal Architecture）
 hex-arch-kotlin-spring-bootReference JVM multi module project for a reactive micro service and lambda using a hexagonal architecture, DDD, Kotlin, Spring Boot, Quarkus, Lambda, Gradle.项目地址:https://gitcode.com/gh_mirrors/he/hex-arch-kotlin-spring-boot 




![Build Status](https://travis-ci.org/dustinsand/hex-arch-kotlin-spring-boot.svg?branch=master)

**六边形架构（又称端口与适配器架构或清洁架构）** 是一种设计理念，旨在让应用程序能够被用户、程序、自动化测试和批处理脚本等不同来源驱动，而开发过程可以在隔离环境中进行。

这种架构方法的核心是将应用程序设计为与运行时设备和数据库无关，使得它能够在不考虑外部环境的情况下，通过适配器与各种技术和平台交互。

## 项目简介

该项目提供了一个示例，展示如何在微服务（Spring Boot）和原生二进制AWS Lambda（Quarkus）中应用六边形架构，且两者共享相同的多模块代码库。简洁的代码是为了突出如何组织包结构以实现六边形架构，并实践相关概念。

## 技术分析

该架构着重于以下几个关键点：

1. **可维护性** - 一致的软件结构易于理解和导航。
2. **分离关注点** - 通过层次化责任来划分不同的组件。
3. **进化式设计** - 容易修改，组件间松耦合。
4. **平台无关性** - 可用于JVM、Go、.Net、Python等多种平台的应用程序。
5. **框架独立** - 架构不依赖任何特定框架，开发者可以自由选择最适合的工具。
6. **用户界面独立** - 用户界面变化不会影响业务逻辑。
7. **数据库独立** - 数据存储方案可以轻松替换，不影响业务规则。
8. **模块化** - 减少复杂依赖关系，降低核心域对象迁移到其他上下文的难度。
9. **可测试性** - 可以在不涉及UI、数据库、Web服务器或其他外部元素的情况下对业务规则进行测试。
10. **干净代码** - 结构受到了《清洁代码》思想的影响。

## 应用场景

此架构适用于需要高可扩展性、低耦合度和长期维护的微服务或云原生应用。无论是在Spring Boot环境下提供REST API服务，还是在AWS Lambda上执行无服务器计算，都能够灵活地调整技术栈而不影响核心业务逻辑。

## 项目特点

- **应用核心** - 内部六边形包含了业务逻辑，完全不了解对外的技术实现。它声明了实现用例所需的端口，而技术细节由适配器处理。
- **端口与适配器** - 端口位于内部边缘，定义了应用核心的需求。适配器则实现了这些接口，使用所选技术与外界通信。

项目采用Gradle多模块结构，方便代码复用和模块化管理。主要有以下模块：

- `voter-application-core` - 六边形内核，包括领域模型和服务层。
    - **领域模型** - 隔离于技术复杂性，专注于业务逻辑。可以独立变更而不会影响外围层。
    - **服务层** - 包含业务逻辑，协调实体和值对象执行业务操作。

## 总结

六边形架构是一种强大的设计模式，强调业务规则与技术实现之间的分离，使得代码更加清晰、可测试和适应性强。通过这个开源项目，你可以直观地学习到如何在实际项目中运用这一理念，为你的应用程序带来更高效、更可持续的发展路径。

立即加入，一起探索六边形架构的魅力！

这篇文章详细介绍了六边形架构的设计理念，项目的技术实施以及它的应用场景和特点。通过阅读，读者可以了解到如何在一个多模块项目中实现六边形架构，并将其应用于微服务和无服务器计算中。此外，项目的特点和优势也促使开发者们尝试并运用这一架构来提升他们的软件质量。

hex-arch-kotlin-spring-bootReference JVM multi module project for a reactive micro service and lambda using a hexagonal architecture, DDD, Kotlin, Spring Boot, Quarkus, Lambda, Gradle.项目地址:https://gitcode.com/gh_mirrors/he/hex-arch-kotlin-spring-boot