[译] 六边形架构 Java 实现

(给 ImportNew 加星标,提高Java技能)

编译:唐尤华

链接:shipilev.net/jvm-anatomy-park/2-transparent-huge-pages/

六边形架构是一种设计风格,通过分层实现核心逻辑与外部对象隔离。其核心逻辑是业务模块,外部元素是整合点,比如数据库、外部 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. 总结

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

示例代码可在 [GitHub][1] 中找到。

[1]:https://github.com/RajeshBhojwani/hexagonal.git

推荐阅读

(点击标题可跳转阅读)

避免使用 -XX : +UseGCLogFileRotation

低延迟 Java(1):介绍

用 Java 实现 Stream 高效混排与 Spliterator

看完本文有收获?请转发分享给更多人

关注「ImportNew」,提升Java技能

[译] 六边形架构 Java 实现

喜欢就点一下「好看」呗~

原文 

https://mp.weixin.qq.com/s/RfUDjekgI9NT6AHGPILzDQ

本站部分文章源于互联网,本着传播知识、有益学习和研究的目的进行的转载,为网友免费提供。如有著作权人或出版方提出异议,本站将立即删除。如果您对文章转载有任何疑问请告之我们,以便我们及时纠正。

PS:推荐一个微信公众号: askHarries 或者qq群:474807195,里面会分享一些资深架构师录制的视频录像:有Spring,MyBatis,Netty源码分析,高并发、高性能、分布式、微服务架构的原理,JVM性能优化这些成为架构师必备的知识体系。还能领取免费的学习资源,目前受益良多

转载请注明原文出处:Harries Blog™ » [译] 六边形架构 Java 实现

赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址