六边形架构 Java 实现 - 好文

六边形架构是一种设计风格，通过分层实现核心逻辑与外部对象隔离。其核心逻辑是业务模块，外部元素是整合点，比如数据库、外部
API、界面等。它将软件分为内部与外部，内部包含了核心业务逻辑与领域层（所谓分层架构），外部包含界面、数据库、消息传递及其他内容。内部与外部通过端口和适配器相互通信。

*译注：六边形架构（Hexagonal Architecture）由Alistair Cockburn 提出，解决了传统的分层架构所带来的问题。*

1. 优点

* 使用六边形架构开发的软件与通道独立，因此能支持多通道
* 易于置换入站和出站整合点
* 测试软件变得更简单，因为可以很容易地模拟集成点

2. Java 实现

按照上面的描述，六边形架构更多地是围绕端口和适配器开展工作。在 Java 中，用 interface 定义端口，实现类作为适配器。下面用一个简单的
Spring Boot 应用示例了解如何应用六边形架构。

示例应用主要功能是创建并查看雇员信息，核心业务逻辑在 `EmployeeService` 中实现，领域对象定义为 `Employee`
，这些都可以看做内部模块。
**EmployeeService.java** ```java @Service public class EmployeeService {
@Autowired private EmployeeRepositoryPort employeeRepository; public void
create(String name, String role, long salary){ employeeRepository.create(name,
role, salary); } public Employee view(Integer userId){ return
employeeRepository.getEmployee(userId); } } ```

**Employee.java** ```java @Entity @Table(name = "employee") public class
Employee{ @Id @GeneratedValue @Column(name = "id") private Integer id;
@Column(name = "name", nullable = false) private String name; @Column(name =
"role", nullable = false) private String role; @Column(name = "salary",
nullable = false) private long salary; // Setter、Getter 方法 } ```

现在，示例应用可以通过 REST
或消息机制提供服务。创建实现了 `EmployeeUIPort` 接口的`EmployeeControllerAdapter` 类提供 REST 服务。
**EmployeeControllerAdapter.java** ```java RestController
@RequestMapping("/employees/") public class EmployeeControllerAdapter
implements EmployeeUIPort{ @Autowired private EmployeeService employeeService;
@Override public void create(@RequestBody Employee request) {
employeeService.create(request.getName(), request.getRole(),
request.getSalary()); } @Override public Employee view(@PathVariable Integer
id) { Employee employee = employeeService.view(id); return employee; } } ```

```java public interface EmployeeUIPort { @PostMapping("create") public void
create(@RequestBody Employee request); @GetMapping("view/{id}") public Employee
view(@PathVariable Integer userId); } ```

作为业务逻辑的一部分，`EmployeeService` 还需要调用外部 DB
集成点。因此，我们创建了`EmployeeRepositoryPort` 以及实现了该接口的 `EmployeeServiceAdapter`。
**EmployeeServiceAdapter.java** ```java @Service public class
EmployeeServiceAdapter implements EmployeeRepositoryPort { @PersistenceContext
private EntityManager entityManager; @Transactional @Override public void
create(String name, String role, long salary) { Employee employee = new
Employee(); employee.setName(name); employee.setRole(role);
employee.setSalary(salary); entityManager.persist(employee); } @Override public
Employee getEmployee(Integer userId) { return
entityManager.find(Employee.class, userId); } } ```

**EmployeeRepositoryPort.java** ```java public interface
EmployeeRepositoryPort { void create(String name, String role, long salary);
Employee getEmployee(Integer userId); } ```

至此，我们可以看到 `EmployeeService` 是如何使用 `EmployeeUIPort` 端口提供服务，通过
`EmployeeRepositoryPort` 调用 DB 并通过
`EmployeeControllerAdapter`和`EmployeeServiceAdapter` 提供 REST API 服务。

3. 总结

总结一下，六边形架构是一种将应用划分成内外两部分的设计方法。通过内部公开的端口与外部实现的适配器进行沟通。应用这种方法，在保持核心用例代码不变的情况下，可以服务多个通道、支持多种不同协议。
不仅如此，它还能有效提高应用程序的可测性。尽管如此，不建议在整个应用中完全实现六边形架构，而是有选择地使用接口与适配器。

欢迎工作一到五年的Java工程师朋友们加入Java程序员开发： 721575865

群内提供免费的Java架构学习资料（里面有高可用、高并发、高性能及分布式、Jvm性能调优、Spring源码，MyBatis，Netty,Redis,Kafka,Mysql,Zookeeper,Tomcat,Docker,Dubbo,Nginx等多个知识点的架构资料）合理利用自己每一分每一秒的时间来学习提升自己，不要再用"没有时间“来掩饰自己思想上的懒惰！趁年轻，使劲拼，给未来的自己一个交代！

热门工具换一换