ADRの概要

Action-Domain-Responder
ソフトウェアアーキテクチャパターンの1つ
MVCの改良版

MVCと違うところ

1つのアクションに対して、そのリクエストからレスポンスを定義する。

MVCの場合

例えばMVC実装だと、1つのコントローラーに

index
insert
update
delete

などアクションを複数定義する。

ADRの場合

1クラス1アクションにより

シンプルなリクエスト→レスポンスの流れ
1クラスの責務が明確

構成

Action

リクエストを受け取り、ドメインの処理結果をレスポンダに渡す

Domain

必要な処理を行い結果を返す
ビジネスロジックはここに含まれる

Responder

ドメインの処理結果を受け取り、必要な準備を行いレスポンスを返す

実装例

PHP/Laravel

Actionクラス

Controllerクラスを継承
コンストラクタでドメインオブジェクトとレスポンダオブジェクトを注入
レスポンダに渡す処理をinvoke(マジックメソッド）で定義

class HogeIndexAction extends Controller
{
  protected $domain;
  protected $responder;

  public fucntion __construct(
    Domain $domain,
    Responder $responder
  ) {
    $this->domain = $domain;
    $this->responder = $responder;
  }

  public function __invoke(Request $request): Response
  {
    return $this->responder->response(
      $this->domain->get()
    );
  }
}

Domainクラス

class HogeIndexDomain
{
  public function get()
  {
    /*
     * ビジネスロジック等
     *
     */

    // 処理したデータを返す
    return ['hoge' => 'fuga'];
  }
}

Responderクラス

class HogeIndexResponder
{
  protected $response;
  protected $view;

  public function __construct(Response $response, ViewFactory $view)
  {
    $this->response = $response;
    $this->view = $view;
  }

  public function response($data): Response
  {
    if (empty($data)) {
      // 404ステータスコードと共にエラー表示
    }

    // 取得したデータをセットしたviewを返す
    $this->response->setContent(
      $this->view->make('hoge.index', ['hoge' => $data])
    );
    return $this->response;
  }
}

参考

LaravelでのADR（Action-domain-responder）実装