ヘキサゴナルアーキテクチャとは何ですか？どのように構成され、動作しますか？

Question

IT Interview Practice · Accepted Answer

## ヘキサゴナルアーキテクチャとは？

**ヘキサゴナルアーキテクチャ**は、業務のコアを中心にアプリケーションを構成し、ユーザーインターフェース、データベース、外部サービスなどの詳細からコアを切り離します。コアは**ポートとアダプター**を介してそれらとつながるため、ポート＆アダプター（Ports & Adapters）とも呼ばれます。

目的は、外部の技術が変わっても業務ルールを安定させることです。六角形はアプリケーションの境界を表しており、構成要素が六つ必要という意味ではありません。

## コア、ポート、アダプターは何をしますか？

- **業務のコア：** 注文の作成、合計の計算、割引の適用条件の確認など、主な操作とルールを含みます。
- **ポート：** コアが提供する操作、または必要とする操作を定義します。たとえば、コアは注文を作成する操作を提供し、注文を保存する操作を必要とします。ポートは通常、コード上の関数やインターフェースで表します。
- **アダプター：** 特定の技術をポートに接続します。HTTPアダプターはウェブサイトのリクエストを受け取り、データベースアダプターはSQLで注文を保存します。

コアは何を行う必要があるかを把握し、アダプターは通信に使う技術を扱います。アプリケーションの起動コードが、適切なアダプターをコアに接続します。

## 例：注文を作成する

顧客が注文すると、HTTPアダプターは受信データを注文作成操作への呼び出しに変換します。コアは注文を検証し、合計を計算して、永続化ポートを通じて保存を要求します。設定されたデータベースアダプターがクエリを実行し、結果を返します。

計算ルールはコア内にあり、HTTP処理のコードもSQLも含みません。このルールをテストする際は、開発者がデータをメモリに保存するアダプターを渡すことで、実際のデータベースに接続せずにテストを実行できます。

コマンドラインの注文ツールを追加する場合、別の入力アダプターを通じて同じ注文作成操作を呼び出せます。開発者は、新しいツールのために計算ルールを書き直す必要はありません。

## 利点

- **業務ルールをテストしやすい：** 代替アダプターからテストデータを提供できるため、外部システムに依存せずにルールを確認できます。
- **複数の入口で操作を共有できる：** ウェブサイト、定期実行ジョブ、コマンドラインツールが同じ業務のコアを利用できます。
- **連携の変更範囲を絞りやすい：** コアとの契約が変わらなければ、データベースライブラリの置き換えは主にそのアダプターに影響します。

## 制約

- **接続のためのコードが増える：** ポート、アダプター、設定という構成要素が増えるため、ごく小さなアプリケーションでは不要な場合があります。
- **アダプターの置き換えだけですべての変更に対応できるわけではない：** 計算方法や機能が異なるデータソースでは、契約とビジネスロジックの変更が必要になることがあります。実際のアダプターについても、接続先のシステムに対してテストする必要があります。

## どのような場合に使いますか？

ヘキサゴナルアーキテクチャは、業務ルールを十分にテストする必要があるアプリケーション、複数の入口を持つアプリケーション、外部連携が頻繁に変わるアプリケーションに適しています。モノリス内でも、個々のマイクロサービス内でもコードの整理に使えます。アプリケーションをサービスに分割することは必須ではありません。

ヘキサゴナルアーキテクチャとは？

コア、ポート、アダプターは何をしますか？

例：注文を作成する

利点

制約

どのような場合に使いますか？

関連する質問