思想と理想の果てに / At the end of thought and ideal

思想と理想の果てに Masanobu Naruse 1

8 1. フレームワーク非依存 2. テスタビリティの確保 3. UI非依存 4. データベース非依存 5.
外部機能非依存

9 1. フレームワーク非依存 2. テスタビリティの確保 3. UI非依存 4. データベース非依存 5.
外部機能非依存

なぜ推すか

13 これはどこに書こう

14 質問された仕様の記述されてる場所が分からないこれはどこに書こう

15 質問された仕様の記述されてる場所が分からないこれはどこに書こう本質的でないことからあなたを解放する

17 今日はスーパーのセール日だ今週はどこに出かけようかな

18 クリーンアーキテクチャを知るフレームワークを作るエピローグ

21 この図の前に

22 まずはこの図 22

23 まずはこの図ヘキサゴナルアーキテクチャ 23

25 ビジネスを中心に見立てそれ以外を交換可能なものとする 25

26 ビジネスを中心に見立てそれ以外を交換可能なものとするプラガプル 26

27 別名ポートアンドアダプター 27

28 別名ポートアンドアダプターポートアダプター 28

29 たとえるなら 29

41 In Software 41

49 アプリケーションを中心に見据えプラガプルを実現 49

50 アプリケーションを中心に見据えプラガプルを実現 50 ビジネスロジックを UIやデータストアの処理に点在させない

54 根底にあるもの 54

55 SOLID 原則 55

56 SOLID 原則 56

57 Dependency Inversion Principle 57

58 58 Business Logic Database Access Module

59 59 Business Logic Database Access Module Change

60 60 Business Logic Database Access Module Change Involve

61 61 Business Logic Database Access Module Data Access Interface

Change

Change Involve

Change Involve Involve

Change Involve Involve leading

72 具体的な実現方法を言及している違いは？

73 具体的な実現方法を言及している具体的な実現方法を言及している

図を詳しく見る 77

80 Enterprise Business Rules Entities

81 Enterprise Business Rules Entities ビジネスルールをカプセル化したオブジェクト ≒ドメインオブジェクト

83 Application Business Rules Use Cases

84 Application Business Rules Use Cases アプリケーションレイヤードメインオブジェクトを束ねあげユースケースを実現する

86 Interface Adapters

87 Controllers Presenters Gateways Interface Adapters

90 Controllers Presenters Gateways Interface Adapters Mock

92 Controller Presenter

96 Controller Presenter Use Case Interactor

97 Controller Presenter Use Case Interactor Use Case Input Port
Use Case Output Port

Use Case Output Port

103 Frameworks & Drivers

104 Frameworks & Drivers 詳細なコードギークなコードビジネスロジックがこれに依存しないようにする

105 Frameworks & Drivers 詳細なコードギークなコードビジネスロジックがこれに依存しないようにする DIP

106 依存の方向

107 依存の方向は内向き内側の変更は外に影響する内側は外側を知らない依存の方向

108 依存の方向は内向き内側の変更は外に影響する内側は外側を知らないドメインロジックで Web とか DB とか UI
とかを扱わない依存の方向

実装例 109

110 110 Controller Presenter Use Case Interactor Use Case Input
Port Use Case Output Port

Use Case Output Port もっと細かく

112 図 22-2 「Clean Architecture 達人に学ぶソフトウェアの構造と設計」（Robert C. Martin）より

115 図 22-2 「Clean Architecture 達人に学ぶソフトウェアの構造と設計」（Robert C. Martin）より上下は逆で用語も少し違うけど
同じ

116 図 22-2 「Clean Architecture 達人に学ぶソフトウェアの構造と設計」（Robert C. Martin）より上下は逆で用語も少し違うけど
同じこれに従って実装

117 １．コードを確認２．処理の流れを確認

122 class UserController { private $inputPort; public function __construct(UserCreateInputPortInterface $inputPort)
{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } アプリケーションが要求するデータに入力を変換

127 DS : Data Structure

128 DS : Data Structure class UserCreateInputData { private $name;
private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } }

131 interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); }

134 class UserCreateInteractor implements UserCreateInputPortInterface { private $repository; private $outputPort;
public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); } ... }

140 interface UserRepositoryInterface { function find(UserId $id): User; function save(User
$user); function delete(User $user); }

$user); function delete(User $user); }

$user); function delete(User $user); } Gateways

145 class UserRepository implements UserRepositoryInterface { public function save(User $user)
{ DB::table('users') ->updateOrInsert( ['id' => $user->getId()], ['name' => $user->getName()] ); } public function find(UserId $id) { $user = DB::table('users')->where('id', $id->getValue())->first(); return new User($id, $user->name); } ... } オブジェクトの永続化・再構築ができればなんでもいい

148 class User { private $id; private $name private $role;
public function __construct( UserId $id, UserName $name, UserRole $role ) { if (is_null($id)) throw new ¥Exception(); if (is_null($name)) throw new ¥Exception(); if (is_null($role)) throw new ¥Exception(); $this->id = $id; $this->name = $name; $this->role = $role; } ... public function changeName(UserName $name) { if (is_null($name)) throw new ¥Exception(); $this->name = $name; } }

public function __construct( UserId $id, UserName $name, UserRole $role ) { if (is_null($id)) throw new ¥Exception(); if (is_null($name)) throw new ¥Exception(); if (is_null($role)) throw new ¥Exception(); $this->id = $id; $this->name = $name; $this->role = $role; } ... public function changeName(UserName $name) { if (is_null($name)) throw new ¥Exception(); $this->name = $name; } } class UserName { private $value; public function __construct(string $value) { if (is_null($value)) throw new ¥Exception(); if (strlen($value) < 3) throw new ¥Exception(); if (strlen($value) > 10) throw new ¥Exception(); $this->value = $value; } public function getValue(): string { return $this->value; } }

public function __construct( UserId $id, UserName $name, UserRole $role ) { if (is_null($id)) throw new ¥Exception(); if (is_null($name)) throw new ¥Exception(); if (is_null($role)) throw new ¥Exception(); $this->id = $id; $this->name = $name; $this->role = $role; } ... public function changeName(UserName $name) { if (is_null($name)) throw new ¥Exception(); $this->name = $name; } } class UserName { private $value; public function __construct(string $value) { if (is_null($value)) throw new ¥Exception(); if (strlen($value) < 3) throw new ¥Exception(); if (strlen($value) > 10) throw new ¥Exception(); $this->value = $value; } public function getValue(): string { return $this->value; } } データモデルとは異なる

153 class UserCreateOutputData { private $createdId; public function __construct(string $createdId)
{ $this->createdId = $createdId; } public function getCreatedId(): string { return $this->createdId; } }

156 interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); }

159 class UserCreatePresenter implements UserCreateOutputPortInterface { private $middleware; public function
__construct(ClarcMiddleware $middleware) { $this->middleware = $middleware; } public function output(UserCreateOutputData $outputData) { $viewModel = new UserCreateViewModel($outputData); $this->middleware->setData(view('user.create', compact('viewModel'))); } }

162 class UserCreateViewModel { private $createdId; public function __construct(UserCreateOutputData $source)
{ $this->createdId = $source->getCreatedId(); } public function getCreatedId(): string { return $this->createdId; } }

163 class UserCreateViewModel { private $createdId; public function __construct(UserCreateOutputData $source)
{ $this->createdId = $source->getCreatedId(); } public function getCreatedId(): string { return $this->createdId; } } <h1>Test</h1> {{$viewModel->getCreatedId()}}

166 Flow of Control class UserController { private $inputPort; public
function __construct(UserCreateInputPortInterface $inputPort) { $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string {

167 Flow of Control Create class UserController { private $inputPort;
public function __construct(UserCreateInputPortInterface $inputPort) { $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string {

168 Flow of Control Call class UserController { private $inputPort;
public function __construct(UserCreateInputPortInterface $inputPort) { $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string {

169 Flow of Control

170 Flow of Control interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData);
}

171 Flow of Control Delegate interface UserCreateInputPortInterface { function handle(UserCreateInputData
$inputData); }

172 Flow of Control

173 Flow of Control class UserCreateInteractor implements UserCreateInputPortInterface { private
$repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

174 Flow of Control Create class UserCreateInteractor implements UserCreateInputPortInterface {
private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

175 Flow of Control Call class UserCreateInteractor implements UserCreateInputPortInterface {
private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

176 Flow of Control interface UserRepositoryInterface { function find(UserId $id):
User; function save(User $user); function delete(User $user); }

177 Flow of Control Delegate interface UserRepositoryInterface { function find(UserId
$id): User; function save(User $user); function delete(User $user); }

178 Flow of Control class UserRepository implements UserRepositoryInterface { ...
public function save(User $user) { DB::table('users') ->updateOrInsert( ['id' => $user->getId()], ['name' => $user->getName()] ); } public function find(UserId $id) { $user = DB::table('users')->where('id', $id->getValue())->first(); return new User($id, $user->name); } }

179 Flow of Control Access class UserRepository implements UserRepositoryInterface {
... public function save(User $user) { DB::table('users') ->updateOrInsert( ['id' => $user->getId()], ['name' => $user->getName()] ); } public function find(UserId $id) { $user = DB::table('users')->where('id', $id->getValue())->first(); return new User($id, $user->name); } }

180 Flow of Control class UserCreateInteractor implements UserCreateInputPortInterface { ...
public function handle(UserCreateInputData $input { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

181 Flow of Control Create class UserCreateInteractor implements UserCreateInputPortInterface {
... public function handle(UserCreateInputData $input { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

182 Flow of Control Call class UserCreateInteractor implements UserCreateInputPortInterface {
... public function handle(UserCreateInputData $input { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); $this->repository->save($user); $outputdata = new UserCreateOutputData($id); $this->outputPort->output($outputdata); }

183 Flow of Control

184 Flow of Control interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData);
}

185 Flow of Control Delegate interface UserCreateOutputPortInterface { function output(UserCreateOutputData
$outputData); }

メリット

187 処理（InputPort）や出力（OutputPort）を差し替えられる 187 interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData);
} interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); }

Change Involve Involve leading 主導権をビジネスロジックに

代償

190 Browser Server Request Response

191 Browser Server interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); }
Request Response

Request Response

193 193 LaraClean OutputPort を使わない（実践＝ Web に適応）

194 194 LaraClean OutputPort を使わない（実践＝ Web に適応）理想が現実に負けた気分

195 In programming

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) );

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); } class UserCreateOutputData { private $createdId; public function __construct(string $createdId) { $this->createdId = $createdId; } public function getCreatedId(): string { return $this->createdId; } }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); } class UserCreateOutputData { private $createdId; public function __construct(string $createdId) { $this->createdId = $createdId; } public function getCreatedId(): string { return $this->createdId; } } class UserCreatePresenter implements UserCreateOutputPor { private $middleware; public function __construct(ClarcMiddleware $middlew { $this->middleware = $middleware; } public function output(UserCreateOutputData $outputD { $viewModel = new UserCreateViewModel($outputData $this->middleware->setData(view('view_resource', } }

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); } class UserCreateOutputData { private $createdId; public function __construct(string $createdId) { $this->createdId = $createdId; } public function getCreatedId(): string { return $this->createdId; } } class UserCreatePresenter implements UserCreateOutputPor { private $middleware; public function __construct(ClarcMiddleware $middlew { $this->middleware = $middleware; } public function output(UserCreateOutputData $outputD { $viewModel = new UserCreateViewModel($outputData $this->middleware->setData(view('view_resource', } } class UserCreateViewModel { private $createdId; public function __construct(UserCreateOutputData { $this->createdId = $source->getCreatedId(); } public function getCreatedId(): string { return $this->createdId; } }

204 204

205 205

206 206 クリーンアーキテクチャを知るフレームワークを作るエピローグ

前提の確認 207

208 フレームワークとは 208

209 ソフトウェアフレームワーク（英: software framework）とは、プログラミングにおいて、アプリケーションプログラム等に必要な一般的な機能が、あらかじめ別に実装されたものである。 209

210 ソフトウェアフレームワーク（英: software framework）とは、プログラミングにおいて、アプリケーションプログラム等に必要な一般的な機能が、あらかじめ別に実装されたものである。 210

211 必要な物…… 211

212 212

213 213 easy

214 214 スキャフォールディング機能 easy

君のフレームワークはどこから？

217 217 スキャフォールディング機能を作るためのライブラリ easy

ログラムを作るためのプププログラムを作るためのログラム

220 220

222 222

223 223 スキャフォールディング機能 easy

225 225

226 226 プログラムソースを生成するプログラム

227 227 /** * Class MyTestClass * @package nrslib */
class MyTestClass { /** @var string */ private $testField; /** @var string */ public $testField2; /** * MyTestClass constructor. * @param string $testField */ public function __construct(string $testField) { $this->testField = $testField; } /** * @param string $test * @param string $test2 */ public function test(string $test, string $test { } /** * */ private function test2() { $testField = 1; } } Programming

228 228

229 229

230 230 クラスを定義するには class と書きます。

231 231

232 232

233 233 https://github.com/nrslib/cfg

234 234 $meta = new ClassMeta("MyTestClass", "nrslib"); $meta->setupClass() ->setConstructor(function ($define)
{ $define->addArgument('testField', 'string') ->addBody('$this->testField = $testField;'); }); $meta->setupFields() ->addField('testField', 'string') ->addField('testField2', 'string', AccessLevel::public()); $meta->setupMethods() ->addMethod('test', function($define) { $define->setAccessLevel(AccessLevel::public()) ->addArgument('test', 'string') ->addArgument('test2', 'string'); }) ->addMethod('test2', function($define) { $define->addBody('$testField = 1;'); }); $compiler = new ClassCompiler(); $source = $compiler->compile($meta);

235 235 /** * Class MyTestClass * @package nrslib */
class MyTestClass { /** @var string */ private $testField; /** @var string */ public $testField2; /** * MyTestClass constructor. * @param string $testField */ public function __construct(string $testField) { $this->testField = $testField; } /** * @param string $test * @param string $test2 */ public function test(string $test, string $test2) { } /** * */ private function test2() { $testField = 1; } }

240 240 <?php namespace nrslib¥Cfg¥Templates¥Classes; ... require_once "Helper.php"; ?> <?=
"<?php" ?> namespace <?= $class->getNamespace(); ?>; <?php Helper::usingBlock($class); ?> /** * Class <?= $class->getName(); ?> * @package <?= $class->getNamespace(); ?> */ class <?= $class->getName(); ?><?php extendsBlock($class); ?><?php implem { <?php fieldBlock($fieldsSetting); ?> <?php constructorBlock($class, $class->getConstructor()); ?> <?php methodBlock($methodsSetting); ?> }

"<?php" ?> namespace <?= $class->getNamespace(); ?>; <?php Helper::usingBlock($class); ?> /** * Class <?= $class->getName(); ?> * @package <?= $class->getNamespace(); ?> */ class <?= $class->getName(); ?><?php extendsBlock($class); ?><?php implem { <?php fieldBlock($fieldsSetting); ?> <?php constructorBlock($class, $class->getConstructor()); ?> <?php methodBlock($methodsSetting); ?> } twig / smarty / blade 使えよ

"<?php" ?> namespace <?= $class->getNamespace(); ?>; <?php Helper::usingBlock($class); ?> /** * Class <?= $class->getName(); ?> * @package <?= $class->getNamespace(); ?> */ class <?= $class->getName(); ?><?php extendsBlock($class); ?><?php implem { <?php fieldBlock($fieldsSetting); ?> <?php constructorBlock($class, $class->getConstructor()); ?> <?php methodBlock($methodsSetting); ?> } twig / smarty / blade 使えよそれな

247 247

248 248 PHP ってテンプレートエンジンだったんだね

249 249 っていうの作ったんです

250 250 っていうの作ったんですそういうのあるで

251 251 https://github.com/nikic/PHP-Parser

スキャフォールディング機能を作る

254 254 セルフホスティング

255 フレームワーク非依存

256 256

257 257 スキャフォールディングもクリーンアーキテクチャの構成で作っちゃえよ

258 258 スキャフォールディングもクリーンアーキテクチャの構成で作っちゃえよ

259 259 スキャフォールディングもクリーンアーキテクチャの構成で作っちゃえよ常に理想を追うのですクリーンアーキテクチャの理想を追いなさい

260 260 https://github.com/nrslib/clarc-php-core

261 261

262 262 $classRenderer = new ClassRenderer(); $interfaceRenderer = new InterfaceRenderer();
$presenter = new UseCaseCreateTestPresenter(); $controllerBuilder = new DefaultControllerSourceFileBuilder($classRenderer); $presenterBuilder = new DefaultPresenterSourceFileBuilder($classRenderer); $interactor = new UseCaseCreateInteractor( $presenter, $classRenderer, $interfaceRenderer, $controllerBuilder, $presenterBuilder); $namespace = 'nrslib¥¥Test'; $inputData = new UseCaseCreateInputData( new UseCaseCreateNamespaceData( $namespace . '¥¥A', $namespace . '¥¥B', $namespace . '¥¥C', $namespace . '¥¥D', $namespace . '¥¥E', $namespace . '¥¥F'), new UseCaseSchema('Test', 'MyAction'), [ new TypeAndName('string', 'inputStringField') ], [ new TypeAndName('string', 'outputStringField') ] ); $interactor->handle($inputData); $outputData = $presenter->outputData;

{ $this->inputPort = $inputPort; } public function create(string $name, string $roleId) { $role = $this->convertRole($roleId); $inputData = new UserCreateInputData($name, $role); $this->inputPort->handle($inputData); } private function convertRole(string $roleId): string { switch ($roleId) { case 'admin': return UserRole::ADMIN; case 'member': return UserRole::MEMBER; default: throw new ¥Exception(); } } } class UserCreateInputData { private $name; private $roleId; public function __construct(string $name, string $roleId) { $this->name = $name; $this->roleId = $roleId; } public function getName(): string { return $this->name; } public function getRoleId(): string { return $this->roleId; } } interface UserCreateInputPortInterface { function handle(UserCreateInputData $inputData); } class UserCreateInteractor implements UserCreateInputPortInterfac { private $repository; private $outputPort; public function __construct( UserRepositoryInterface $repository, UserCreateOutputPortInterface $outputPort) { $this->repository = $repository; $this->outputPort = $outputPort; } public function handle(UserCreateInputData $inputData) { $id = uniqid(); $user = new User ( new UserId($id), new UserName($inputData->getName()), $this->getRole($inputData->getRole()) ); interface UserCreateOutputPortInterface { function output(UserCreateOutputData $outputData); } class UserCreateOutputData { private $createdId; public function __construct(string $createdId) { $this->createdId = $createdId; } public function getCreatedId(): string { return $this->createdId; } } class UserCreatePresenter implements UserCreateOutputPor { private $middleware; public function __construct(ClarcMiddleware $middlew { $this->middleware = $middleware; } public function output(UserCreateOutputData $outputD { $viewModel = new UserCreateViewModel($outputData $this->middleware->setData(view('view_resource', } } class UserCreateViewModel { private $createdId; public function __construct(UserCreateOutputData { $this->createdId = $source->getCreatedId(); } public function getCreatedId(): string { return $this->createdId; } }

WEB で動かそう

Request Response

268 268 思想が先！ http は後！

269 269

270 270 まず最初にすることは MVC を捨てること

271 class UserController extends BaseController { public function create( UserCreateInputPortInterface
$inputPort, Request $request) { $name = $request->input('name'); $roleId = $request->input('roleId'); $inputData = new UserCreateInputData($name, $roleId); $inputPort->handle($inputData); ... 戻り値を無くす } }

275 class UserCreatePresenter implements UserCreateOutputPortInterface { public function output(UserCreateOutputData $outputData)
{ ... どうにかしてビューを描画する } }

276 class UserCreatePresenter implements UserCreateOutputPortInterface { public function output(UserCreateOutputData $outputData)
{ ... どうにかしてビューを描画する } } こっちの方がむしろ Classic MVC に近い

277 戻り値がなくなる

278 278 いい機能ありますよ！

279 Browser Server Request Response

280 Browser Server Request Response Middle ware

281 class ClarcMiddleWare { /** @var mixed */ private $data;
/** @var Router */ private $router; public function __construct(Router $router) { $this->router = $router; } public function setData($data): void { $this->data = $data; } public function handle($request, Closure $next) { $response = $next($request); if ($this->data === null) { return $response; } return $this->router->prepareResponse( $this->router->getCurrentRequest(), $this->data); } }

/** @var Router */ private $router; public function __construct(Router $router) { $this->router = $router; } public function setData($data): void {$this->data = $data; } public function handle($request, Closure $next) { $response = $next($request); if ($this->data === null) { return $response; } return $this->router->prepareResponse( $this->router->getCurrentRequest(), $this->data); } } class UserCreatePresenter implements UserCreateOutputPortInterface { private $middleware; public function __construct(ClarcMiddleware $middleware) { $this->middleware = $middleware; } public function output(UserCreateOutputData $outputData) { $viewModel = new UserCreateViewModel($outputData); $this->middleware->setData( view('user.create', compact('viewModel'))); } }

290 290 やればできるやないか

291 291 よっしゃ、君に乗せたるわ

292 https://github.com/nrslib/clarc-laravel-plugin

293 clarc:make clarc:init Clarc Commands

297 class ClarcInitializeCommand extends ClarcCommand { protected $signature = 'clarc:init';
public function handle() { $this->title('Initialize clarc'); $middlewareFilePath = LaravelConfig::DIR_MIDDLEWARE . 'ClarcMiddl $this->info('Creating file ' . $middlewareFilePath); file_put_contents($middlewareFilePath, ClarcModuleCodes::$middleW $this->info('Wrote ' . realpath($middlewareFilePath)); $this->newline(); $clarcProviderFilePath = LaravelConfig::DIR_PROVIDER . 'ClarcProv $this->info('Creating file' . $clarcProviderFilePath); file_put_contents($clarcProviderFilePath, ClarcModuleCodes::$clar $this->info('Wrote ' . realpath($clarcProviderFilePath)); $this->newline(); $this->info('Please append ClarcProvider to app.php'); } }

298 class ClarcInitializeCommand extends ClarcCommand { protected $signature = 'clarc:init';
public function handle() { $this->title('Initialize clarc'); $middlewareFilePath = LaravelConfig::DIR_MIDDLEWARE . 'ClarcMiddl $this->info('Creating file ' . $middlewareFilePath); file_put_contents($middlewareFilePath, ClarcModuleCodes::$middleW $this->info('Wrote ' . realpath($middlewareFilePath)); $this->newline(); $clarcProviderFilePath = LaravelConfig::DIR_PROVIDER . 'ClarcProv $this->info('Creating file' . $clarcProviderFilePath); file_put_contents($clarcProviderFilePath, ClarcModuleCodes::$clar $this->info('Wrote ' . realpath($clarcProviderFilePath)); $this->newline(); $this->info('Please append ClarcProvider to app.php'); } }

300 300 easy

304 class ClarcMakeCommand extends ClarcCommand { public function handle() {
$this->title('Make usecase'); $this->info('Please input your controller name.'); $controllerName = $this->need('controller name'); $controllerName = ucfirst($controllerName); $this->info('Please input your action name.'); $actionName = $this->need('action name.'); $actionName = ucfirst($actionName); $schema = new UseCaseSchema($controllerName, $actionName); $objectCreatePresenter = new ClarcMakeCommandObjectCreatePresenter($this, $schema); $alreadyRegistered = !$this->checkFiles($controllerName, $actionName, $objectCreateP if ($alreadyRegistered) { $this->info('process ended.'); return; } $this->info('Please select input data fields'); $inputDataFields = $this->askFields(); $this->info('Please select output data fields'); $outputDataFields = $this->askFields(); $this->createClarcObjects($objectCreatePresenter, $controllerName, $actionName, $inp $this->registerDependency($controllerName, $actionName); $this->info('process ended.');

305 private function createClarcObjects( ClarcMakeCommandObjectCreatePresenter $objectCreatePresenter, string $controllerName, string $actionName,
array $inputDataFields, array $outputDataFields) { $objectCreateInteractor = new ClarcObjectCreateInteractor( $objectCreatePresenter, new ClassRenderer(), new InterfaceRenderer() ); $currentControllerContent = $this->getCurrentControllerContent( $controllerName); $objectCreateInputData = new ClarcObjectCreateInputData( $controllerName, $currentControllerContent, $actionName, $inputDataFields, $outputDataFields ); $objectCreateInteractor->handle($objectCreateInputData); }

309 309 easy

310 class ClarcProvider extends ServiceProvider { public function register() {
$this->app->singleton(ClarcMiddleWare::class); $this->registerUseCases(); } private function registerUseCases() { // TestMyAction $this->app->bind( ¥packages¥InputPorts¥Test¥MyAction¥TestMyActionInputPortInterface::class, ¥packages¥Interactors¥Test¥TestMyActionInteractor::class); $this->app->bind( ¥packages¥OutputPorts¥Test¥MyAction¥TestMyActionOutputPortInterface::class, ¥App¥Http¥Presenters¥Test¥TestMyActionPresenter::class); // UserCreate $this->app->bind( ¥packages¥InputPorts¥User¥Create¥UserCreateInputPortInterface::class, ¥packages¥Interactors¥User¥UserCreateInteractor::class); $this->app->bind( ¥packages¥OutputPorts¥User¥Create¥UserCreateOutputPortInterface::class, ¥App¥Http¥Presenters¥User¥UserCreatePresenter::class); } }

クリーンアーキテクチャを知るフレームワークを作るエピローグ？？？ 316

317 はたして

318 これはフレームワークと言えるのだろうか

322 https://github.com/nrslib/clarc-php-concept

機能

324 Scaffolding IoC Container Routing

326 326 easy

328 class Startup { public function configureService( ServiceCollection $serviceCollection) {
$this->registerUsecases($serviceCollection); } private function registerUseCases( ServiceCollection $serviceCollection) { // UserCreate $serviceCollection->addTransient(UserCreateController::class); $serviceCollection->addTransient( UserCreateInputPortInterface::class, UserCreateInteractor::class); $serviceCollection->addTransient( UserCreateOutputPortInterface::class, UserCreatePresenter::class); } }

330 private function getControllerName($server) { $root = $server['DOCUMENT_ROOT']; $url =
parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); $tokens = explode('/', $url); $count = count($tokens); if (!isset($tokens[1])) { throw new ¥Exception($tokens); } $top = ucfirst($tokens[1]); if (!isset($tokens[2])) { throw new ¥Exception($tokens[1]); } $second = ucfirst($tokens[2]); $path = $root . '/app/InterfaceAdapters/Controllers/' . $top . '/' . if ($count === 3 && file_exists($path)) { return 'App¥¥InterfaceAdapters¥¥Controllers¥¥' . $top . '¥¥' . $s } return null; }

parse_url($_SERVER['REQUEST_URI'], PHP_URL_PATH); $tokens = explode('/', $url); $count = count($tokens); if (!isset($tokens[1])) { throw new ¥Exception($tokens); } $top = ucfirst($tokens[1]); if (!isset($tokens[2])) { throw new ¥Exception($tokens[1]); } $second = ucfirst($tokens[2]); $path = $root . '/app/InterfaceAdapters/Controllers/' . $top . '/' . if ($count === 3 && file_exists($path)) { return 'App¥¥InterfaceAdapters¥¥Controllers¥¥' . $top . '¥¥' . $s } S return null; } http://sample.com/{controller}/{action} 以外認めない

クリーンアーキテクチャを知るフレームワークを作るエピローグおまけ 335

336 336

337 337

338 Auther Masanobu Naruse HomePage https://nrslib.com Twitter @nrslib 338

思想と理想の果てに / At the end of thought and ideal

思想と理想の果てに / At the end of thought and ideal

More Decks by nrs

Other Decks in Programming

Featured

Transcript