六边形架构 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等多个知识点的架构资料)合理利用自己每一分每一秒的时间来学习提升自己,不要再用"没有时间“来掩饰自己思想上的懒惰!趁年轻,使劲拼,给未来的自己一个交代!

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 215,294评论 6 497
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,780评论 3 391
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 161,001评论 0 351
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,593评论 1 289
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,687评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,679评论 1 294
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,667评论 3 415
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,426评论 0 270
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,872评论 1 307
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,180评论 2 331
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,346评论 1 345
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,019评论 5 340
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,658评论 3 323
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,268评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,495评论 1 268
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,275评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,207评论 2 352

推荐阅读更多精彩内容

  • 一. Java基础部分.................................................
    wy_sure阅读 3,810评论 0 11
  • 转载自:Java集合框架实例 1- 介绍 集合是程序和语言的基本思想。应用程序通常都会应用到集合,例如雇员的信息,...
    01_小小鱼_01阅读 395评论 0 1
  • ABP入门系列目录——学习Abp框架之实操演练源码路径:Github-LearningMpaAbp 1. 引言 A...
    圣杰阅读 11,123评论 6 11
  • 峰会视角: 1、峰会诠释,广联达提出数字建筑理念,战略方向及使命目标 2、会议平台对企业和客户价值 3、内容和大咖...
    lala王小妞阅读 80评论 0 0
  • 皇极经世道成篇, 理贯阴阳数千年, 邵子诗吟兴潜史, 伊川垂范击壤先。
    临江先生阅读 187评论 0 1