本页由繁体中文版自动转换
六角架构
执行时,核心可以经介面去呼叫资料库;程式码的依赖却一律由外指向内,核心不认识任何具体技术。
判准:接上测试输入与假转接,核心能否不靠真实资料库、介面或外部服务,独立执行并验证其业务规则。
- 成立条件
- 同一个核心要被人、测试、批次等多种方式驱动,或外部技术需要抽换时。
- 证据强度
- 概念框架;已对照来源本身
- 失效样貌
- 介面迁就工具而非核心,或用在不需抽换的地方:多了一层,却没换来任何弹性。
图中箭头只画程式码依赖,不画执行时的呼叫顺序。
左侧主动侧发起要求,右侧被动侧由核心呼叫。
底部以一次资料库存取为例,对照两种方向。
层系为概念示意,不画成六边,不含任何量测数字。 放大看图 ▸转发 PNG ▸
一、发生什么事
作者当年要处理的病症很具体,而且与测试有关:业务逻辑渗进了介面层,于是系统没办法被自动化测试驱动,也很难从「人来操作」切换到「批次跑」或「另一个程式来呼叫」。
根因是依赖的方向错了:核心去认识了具体技术(某个资料库驱动、某个介面框架)。一旦如此,你要测核心就得先把那些技术架起来。
这套架构把方向反过来:介面由核心定义,技术只在外围写转接[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。介面是核心定义的、与技术无关的一段「有目的的对话」,分两种:一种说明外界可以要核心做什么,一种说明核心需要外界提供什么。两侧转接与介面的关系因此不同:主动侧的转接把网页请求、命令列等输入转成对核心的呼叫;被动侧的转接依核心定义的介面写成,把核心的要求转成资料库查询或外部服务的呼叫。
最容易混淆的是两种方向。执行一次需要资料的操作时,呼叫由核心经介面往外,到资料库转接,再到资料库,结果沿原路回到核心。程式码的依赖却反过来:是资料库转接依照核心的介面写成,核心从不引用它。所以核心里写的是「储存这篇文章」,而不是某个资料库用户端的插入指令;要测核心,接一个记忆体内的假转接即可。
作者原文的意图那句话值得逐字留着:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。
Cockburn 2005 年的报告强调对称:图上没有上层下层,资料库与使用者介面同样只是接在某个介面上的外部技术。主动侧(推核心的:人、测试、批次)与被动侧(被核心呼叫的:资料库、外部系统)的区别,在于谁发起、主导这段对话,不在架构层级[1]Cockburn, A. (2005, September 4). The Hexagonal (Ports & Adapters) Architecture. HaT Technical Report 2005.02, v0.9. alistair.cockburn.us/hexagonal-architecture/. 书目经官方记录核对。主张已对照全文核实。意图逐字:让一个应用能同等地被使用者、程式、自动化测试或批次脚本驱动,并且能在脱离其最终执行期装置与资料库的情况下开发与测试。。但对称只在架构图上成立:作者 2020 年受访时自述,驱动侧与被驱动侧的转接终究无法写成同一种,他追求的完全对称因此落空[5]Garrido de Paz, J. M. (2020, September 9). Interview with Alistair Cockburn. jmgarridopaz.github.io/content/interviewalistair.html. 书目经官方记录核对。主张已对照全文核实。作者受访自述(第一人称):1994 年在物件导向程式设计课的讲义上第一次画出六边形;最初发表时没有 Ports and Adapters 这个名字;2005 年 6 月才想通六边的每一面就是一个介面(port),同月在 wiki 上建立以 Ports and Adapters 为名的页面。他想通的是介面与转接,不是对称性。他也说,驱动侧与被驱动侧的转接终究无法写成同一种,完全对称的追求因此落空。。
二、为什么这对你重要
把「技术」换成「工具与模型」,这页就变成一个很实际的建议:你的判准不该绑定某个工具。
现在很多人的工作流是反过来的:判准长在工具里。提示词写在某个平台的专案设定里、分类规则写在某个笔记软体的栏位里、检查清单存在某个服务的模板里。这在单一工具好用时完全没问题,直到你要换工具、或要用第二个工具做同一件事、或那个工具改了它的功能。
这套架构的做法是把方向反过来:判准写在你自己的地方,用你自己的语汇宣告「我需要什么样的输入与输出」,然后每个工具各写一层薄薄的接法。换工具时你只换接法,判准不动。反过来,若你只在一个工具里做这件事、也没打算换,先把判准写清楚就够,不必急着替它搭接法。
它同时给你一个可验证的判准,这是这页最有价值的部分。不是问「我有没有解耦」(这个问题没有答案),而是问:我的判准能不能在没有任何特定工具的情况下被说清楚、被人执行。 如果你的分类规则要靠某个软体的栏位才讲得通,那它已经绑死了。
反过来也要提防那个假解耦。在工具外面包一层,但那层的形状完全照着工具长:例如你的规格里写满某个平台的专有名词。这在形式上是多了一层,在实质上什么都没换到,因为换工具时那层要整个重写。介面的形状必须由核心决定,这是原则里最容易被跳过的一句。
Lab 实测 有实测才写
本节点暂无实测。
- 常见转述「六边代表六个层或六种介面」:六边只是画图方便,作者选它是为了留出空间画多个介面,不受一维分层图的限制。纠结边数是抓错重点。名称方面,Cockburn 2005 年的报告以 Ports and Adapters 为模式名,六边形架构列为别名;据作者 2020 年受访自述,六边形 1994 年已画出,2005 年 6 月才改以 Ports and Adapters 为名。原文也把它写成转接器模式的一种特定用法,并列出几个相近的既有模式,故本站标作者为提出者兼命名者,不标为无前例的首创。 #
- 常见转述「洋葱架构与整洁架构是这套的衍生版」:三者同家族、不同作者、各自命名,共享的是依赖只向内这个原则。作者归属不可混。 #
如何阅读来源注记 「书目经…核对」指作者、年份、题名与出版项已确认;不代表该来源的主张已被核对。「对照全文核实」指主张已与来源文本本身比对。 定义版本:2026-09-20。
新书架开架时通知我
开架通知只在新书架开架或阅读规则变更时寄出。