https://xinqilin.github.io/tags/clean-architecture/ Recent content in Clean Architecture on Bill.Lin's Notes Hugo zh-tw Mon, 15 Jan 2024 00:00:00 +0800 https://xinqilin.github.io/post/architecture/hexagonal-architecture/ Mon, 15 Jan 2024 00:00:00 +0800 https://xinqilin.github.io/post/architecture/hexagonal-architecture/ <h2 id="核心概念">核心概念</h2> <p>六角形架構（Hexagonal Architecture），又稱 Ports &amp; Adapters，由 Alistair Cockburn 提出。</p> <p><strong>核心原則</strong>：應用程式核心（Domain + Application）不依賴任何基礎設施細節。資料庫、HTTP、Kafka 等都是「外部細節」，透過 Port（介面）與核心溝通。</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt"> 1 </span><span class="lnt"> 2 </span><span class="lnt"> 3 </span><span class="lnt"> 4 </span><span class="lnt"> 5 </span><span class="lnt"> 6 </span><span class="lnt"> 7 </span><span class="lnt"> 8 </span><span class="lnt"> 9 </span><span class="lnt">10 </span><span class="lnt">11 </span><span class="lnt">12 </span><span class="lnt">13 </span><span class="lnt">14 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-fallback" data-lang="fallback"><span class="line"><span class="cl"> ┌─────────────────────────────────┐ </span></span><span class="line"><span class="cl"> HTTP ───────►│ Input Adapter (Controller) │ </span></span><span class="line"><span class="cl"> Kafka ──────►│ │ </span></span><span class="line"><span class="cl"> │ ┌───────────────────────────┐ │ </span></span><span class="line"><span class="cl"> │ │ Application (Use Cases) │ │ </span></span><span class="line"><span class="cl"> │ │ ┌─────────────────────┐ │ │ </span></span><span class="line"><span class="cl"> │ │ │ Domain │ │ │ </span></span><span class="line"><span class="cl"> │ │ │ (Pure Java) │ │ │ </span></span><span class="line"><span class="cl"> │ │ └─────────────────────┘ │ │ </span></span><span class="line"><span class="cl"> │ └───────────────────────────┘ │ </span></span><span class="line"><span class="cl"> │ │ </span></span><span class="line"><span class="cl"> │ Output Adapter (Repository) │───► MySQL </span></span><span class="line"><span class="cl"> │ Output Adapter (EventPublisher)│───► Kafka </span></span><span class="line"><span class="cl"> └─────────────────────────────────┘ </span></span></code></pre></td></tr></table> </div> </div><p>依賴方向：<strong>Adapters → Application → Domain</strong>。Domain 不認識任何 Adapter。</p>