面向組合編程 (COP) 實戰：用 Qi4j 重燃領域建模與架構治理希望

OOP 領域建模的困境

長期以來，用 OOP 物件集建模領域概念的目標未獲充分實現。根本問題：現實中同一實體在不同情境下擁有多重身份。如筆者身兼開發者、講師、銀行客戶、校友，不同情境需透過不同介面互動，但本質是同一個體。OOP 若強行建模，要麼建立多個類別，要麼塞進單一類別導致臃腫，難以表達動態身份切換。

COP 解決方案：Mixin 與 Composite

Mixin（混入）為普通 Java 類別，實作特定介面，構成 Composite 介面的一部分。Composite 以 Java 介面宣告，用 `@Mixins` 註解指定所需 Mixin，用 `extends` 關鍵字聲明暴露的領域介面。如此在集中位置明確定義 Composite 結構與行為。

橫切關注點保留在獨立實作類別（關注點分離），裝配方式集中在 Java 介面宣告。透過 `extends` 重用父介面宣告，修改父介面自動傳播至子 Composite，避免重複維護。達成雙贏：實作類別單一職責，Composite 開發者全權掌控組合內容。

程式碼範例：建模「我」

@Mixins({DeveloperMixin.class, SpeakerMixin.class, AlumniMixin.class})
public interface HumanComposite
    extends Developer, Speaker, Alumni, Composite
{}

Qi4j 執行期構造 Composite 實例，將客戶端呼叫路由至特定 Mixin 實例。客戶端視其為普通 Java 物件（但擁有更多介面）。領域介面（如 `Developer`）為普通介面，實作為簡單 Java 類別。身份由 Composite 實例定義而非 Mixin，引用可在系統傳遞並轉型為情境所需介面。新增領域只需擴展 Composite。多重繼承與基礎類別復用問題迎刃而解。

LMM 分層模組隱喻與 Qi4j 結構支援

傳統 LMM (Layered Modules Metaphor) 圖表僅停留在紙面，難以強制執行。Qi4j 以代碼顯式建模應用結構，規範開發者行為：

• 結構規則：啟動時靜態宣告；所有 Composite/Service 歸屬 Module，Module 歸屬 Layer，Layer 有嚴格上下層關係（無循環），共同構成應用。
• 存取規則：Module 可存取同層所有 Module；Layer 僅存取直接下層（禁止跳層）。
• 可見性：Composite 預設僅 Module 內可見，可顯式宣告 Layer 間或跨 Layer 可見。類似 Java `public`/`private`。

結構在代碼中的應用

• 領域代碼無需知悉結構，透過 `@Structure` 註解注入 `CompositeBuilderFactory`，僅允許實例化結構中可見的 Composite。
• 服務查找：同 Module 唯一服務無需額外裝配，服務解析更隱含，配置極簡。服務聲明於 `Bread` Module，每個實例受鄰近客戶端約束。

應用結構生成：從簡單到複雜

• 最簡啟動： `ApplicationBuilder.newApplication().newModule()...` 建立單層單模組應用。
• SingletonAssembler： 單層單模組工具類。
• 多層結構： `newApplication(Assembly[][][])` 參數建立「千層餅式」分層（首尾層除外皆有上下層）。
• 複雜結構： 傳遞 `ApplicationAssembly` 實例，迭代建立 `LayerAssembly`、`ModuleAssembly`。

顯式結構化的雙重收益

1. 就近存取：越近的 Composite 優先級越高、越易存取；外部無法存取 Module/Layer 內私有 Composite。服務解析更隱含，裝配配置大幅減少。
2. 架構強制執行：每個應用擁有靜態結構組合，可由工具抽取展示，無需單獨維護文檔。架構師輕鬆追蹤開發者遵循情況，快速發現違規。

總結

Qi4j 證明 COP 可行：以傳統 OOP 實作 Composite，更好分離關注點，提升代碼品質與復用性。顯式建模應用結構（通常僅在紙面），落實架構執行、消除服務互賴，幫助構建大規模系統，避免被自身「重量」壓垮。COP 與 Qi4j 思想多源自前人實踐與框架精華，將舊有智慧應用於新環境，正是軟體開發與生活的共同哲學。