六角架構
執行時,核心可以經介面去呼叫資料庫;程式碼的依賴卻一律由外指向內,核心不認識任何具體技術。
判準:接上測試輸入與假轉接,核心能否不靠真實資料庫、介面或外部服務,獨立執行並驗證其業務規則。
- 成立條件
- 同一個核心要被人、測試、批次等多種方式驅動,或外部技術需要抽換時。
- 證據強度
- 概念框架;已對照來源本身
- 失效樣貌
- 介面遷就工具而非核心,或用在不需抽換的地方:多了一層,卻沒換來任何彈性。
圖中箭頭只畫程式碼依賴,不畫執行時的呼叫順序。
左側主動側發起要求,右側被動側由核心呼叫。
底部以一次資料庫存取為例,對照兩種方向。
層系為概念示意,不畫成六邊,不含任何量測數字。 放大看圖 ▸轉發 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。
新書架開架時通知我
開架通知只在新書架開架或閱讀規則變更時寄出。