Upgrade to Pro
— share decks privately, control downloads, hide ads and more …
Speaker Deck
Features
Speaker Deck
PRO
Sign in
Sign up for free
Search
Search
Hexagonal Architecture
Search
Chris Fidao
May 16, 2014
Technology
49
200k
Hexagonal Architecture
An explanation on what Hexagonal Architecture is - the decoupling of layers in your code.
Chris Fidao
May 16, 2014
Tweet
Share
More Decks by Chris Fidao
See All by Chris Fidao
Development Environments that Feel Local
fideloper
0
25
Refactoring Terraform - CloudCasts - Scaling EC2
fideloper
0
42
Scaling Laravel - Laracon.net 2018
fideloper
15
1.8k
Linux Environment
fideloper
1
10k
Server Survival
fideloper
29
23k
FileBeat (Won't save you from the JVM)
fideloper
1
290
Powering Your Applications With Nginx
fideloper
9
7.7k
Intro to etcd
fideloper
3
520
Service Oriented Architecture with a little help from NodeJS
fideloper
4
2.2k
Other Decks in Technology
See All in Technology
テスト・設計研修【MIXI 24新卒技術研修】
mixi_engineers
PRO
0
170
LLMアプリケーションの評価の実践と課題 ~PharmaXにおける今後の展望~
pharma_x_tech
2
160
データベース研修 分析向けSQL入門【MIXI 24新卒技術研修】
mixi_engineers
PRO
0
110
VPoEの視点から見た、ヘンリーがサーバーサイドKotlinを使う理由 / Why Server-side Kotlin 2024
cho0o0
1
420
ACRiルーム最新情報とAMD GPUサーバーのご紹介
anjn
0
150
Git 研修 Advanced【MIXI 24新卒技術研修】
mixi_engineers
PRO
0
200
データベース研修 DB基礎【MIXI 24新卒技術研修】
mixi_engineers
PRO
0
210
AWSで”最小権限の原則”を実現するための考え方 /20240722-ssmjp-aws-least-privilege
opelab
10
4.3k
サービス開発を前に進めるために 新米リードエンジニアが 取り組んだこと / Steps Taken by a Novice Lead Engineer to Advance Service Development
nologyance
0
180
dxd2024-生成AIに振り回された3か月間の成功と失敗/dxd2024-link-and-motivation
lmi
2
260
LINE WORKSへ簡単通知!Incoming Webhookアプリの紹介
mmclsntr
0
110
20240717_イケコパ代表Copilot_in_Teams会社でこう使ってます
ponponmikankan
2
430
Featured
See All Featured
Speed Design
sergeychernyshev
9
270
Statistics for Hackers
jakevdp
792
220k
It's Worth the Effort
3n
181
27k
Exploring the Power of Turbo Streams & Action Cable | RailsConf2023
kevinliebholz
12
3.8k
実際に使うSQLの書き方 徹底解説 / pgcon21j-tutorial
soudai
149
45k
Refactoring Trust on Your Teams (GOTO; Chicago 2020)
rmw
29
2.5k
Practical Orchestrator
shlominoach
185
10k
Designing for humans not robots
tammielis
247
25k
No one is an island. Learnings from fostering a developers community.
thoeni
17
2.8k
What the flash - Photography Introduction
edds
65
11k
Imperfection Machines: The Place of Print at Facebook
scottboms
262
13k
Making the Leap to Tech Lead
cromwellryan
127
8.7k
Transcript
Hexagonal Architecture Chris Fidao (hek-sag-uh-nl)
@fideloper
None
Implementing Laravel Real-world implementation of testable and maintainable code. (hopefully)
Vaprobash Vagrant Provisioning Bash Scripts
Servers for Hackers.com
Why / What Ports / Adapters Boundary Layers /
WHY Architecture
Maintainability Technical Debt Time
What is it?
So…What is it?
The Hexagon Core Domain Application Domain Framework
(Core) Domain Core Domain Application Domain Framework
Behavior
Constraints
Application Core Domain Application Domain Framework
Framework Core Domain Application Domain Framework
Outside Core Domain Application Domain Framework
Ports Adapters /
Ports & Adapters Core Domain Application Domain Framework
Inside/Outside Core Domain Application Domain CommandBus Framework HTTP Use Case
Repo DBAL Database Events Dispatcher Service Impl
Core Domain Application Domain Framework Dependencies
interface Notifier { ! public function send(Message $message); } class
SesNotifier implements Notifier { ! public function send(Message $message) { // Details } }
Use-Case Driven Development
All the Contexts •Web •API •CLI •Queue •Event Handler
Use Cases: CommandBus CommandBus executes( ) Command Handler handles( )
Command
// Class SimpleCommandBus ! public function execute( $command ) {
return $this->getHandler( $command ) ->handle( $command ); } Simple CommandBus
Core Domain Application Domain CommandBus Framework HTTP Use Case Repo
DBAL Database Events Dispatcher Service Impl
None
Boundaries
Domain/Application Boundary Core Domain Application Domain Framework Use Case Repo
Events
interface CommandBusInterface { ! public function execute( $command ); }
interface HandlerInterface { ! public function handle( $command ); }
Core Domain Application Domain Framework Use Case Repo Events
interface TicketRepositoryInterface { ! public function getStaffOpenTickets( Staffer $staffer, $limit=10);
! ! public function save(Ticket $model); }
Application Domain CommandBus Framework DBAL Dispatcher The Application/External Boundary
interface Notifier { ! public function send(Message $message); } interface
Validator { ! public function passes(Array $data); ! public function getErrors(); } interface Dispatcher { ! public function dispatch(Array $events); }
Framework Core Domain Application Domain Framework HTTP Database Service Impl
Identify the aspects that vary and separate them from what
stays the same
Layers
The Domain Core Domain Application Domain Framework Use Case Repo
Events
<?php namespace Hex\Tickets; ! class Ticket extends Model { !
public function assignStaffer(Staffer $staffer) { if( ! $staffer->categories->contains( $this->category ) ) { throw new DomainException("Staffer can't be assigned to ".$this->category); } ! $this->staffer()->associate($staffer); // Set Relationship ! return $this; } ! public function setCategory(Category $category) { if( $this->staffer instanceof Staffer && ! $this->staffer->categories->contains( $category ) ) { // Unset staffer if can't be assigned to set category $this->staffer = null; } ! $this->category()->associate($category); // Set Relationship ! return $this; } }
class Ticket extends Model { ! /* ... Other logic
... */ ! public function save(array $options = array()) { /* Integrity Checks, and then: */ ! if( ! $this->exists ) { $this->raise( new TicketCreatedEvent($this) ); } ! return parent::save($options); } }
class CreateTicketCommand { ! protected $data; ! public function __construct($data)
{ $this->data = $data; } ! public function __get($property) { // Simplified example return $this->data[$property]; } }
The Application Application Domain CommandBus Framework DBAL Dispatcher
// Class SimpleCommandBus ! public function execute( $command ) {
return $this->getHandler( $command ) ->handle( $command ); }
! class CreateTicketHandler implements HandlerInterface { ! ! public function
handle($command) { $this->validate($command); // Throw ValidationException $this->save($command); } ! protected function save($command) { $ticket = new Ticket; /* Some other setters... */ $ticket->setCategory( $this->catRepo->find($command->category_id) ); $ticket->setStaffer( $this->staffRepo->find($command->staffer_id) ); $ticket->addMessage( $ticket->addMessage($command->message); ); ! $this->ticketRepo->save($ticket); // Use Repositories ! $this->dispatcher->dispatch( $ticket->flushEvents() ); // Fire Events } }
class DbTicketRepository implements RepositoryInterface { ! public function getStaffOpenTickets(Staffer $staffer,
$limit=10) { return $this->ticket->where('staff_id', $staffer->id) ->take($limit)->get(); } ! public function save(Ticket $ticket) { $ticket->save(); } }
Framework Core Domain Application Domain Framework HTTP Database Service Impl
class TicketController extends BaseController { ! public function createTicket() {
$command = new CreateTicketCommand( Input::all() ); ! try { $this->bus->execute($command); } catch(ValidationException $e) { return Redirect::to('/tickets/new') ->withErrors( $e->getErrors() ); } catch(DomainException $e) { return Redirect::to('/tickets/new') ->withErrors( $e->getErrors() ); } return Redirect::to(‘/tickets'); } }
class SesEmailNotifier implements NotifierInterface { ! public function __construct(SesClient $client)
{ $this->client = $client; } ! public function send(Message $message) { $to = [$message->to()]; $message = ['Data' => $message->message()]; ! $this->client->sendEmail([ 'Destination' => ['ToAddresses' => $to], 'Message' => ['Body' => ['Html' => $message]] ]); } }
use Illuminate\Events\Dispatcher as EventDispatcher; ! class LaravelDispatcher implements Dispatcher {
! public function __construct(EventDispatcher $dispatcher) { $this->dispatcher = $dispatcher; } ! public function dispatch(Array $events) { foreach( $events as $event ) { $this->dispatcher->fire( $event->name(), $event ); } } ! }
TDD is DEAD (and other myths)
Identify the aspects that vary and separate them from what
stays the same
Thanks