Hexagonal Software Architecture for Web Applications Course

Module 1: Introduction to Hexagonal Architecture

1 week

• Topics: Evolution of software architecture, limitations of traditional layers, hexagon model overview

• Hands-on: Sketch the hexagon diagram for a sample “To-Do” application

Module 2: Defining the Domain & Ports

1 week

• Topics: Core domain modeling, boundary interfaces (ports), use-case definitions

• Hands-on: Write domain entities and port interfaces for task creation and querying

Module 3: Building Inbound Adapters

1 week

• Topics: HTTP controllers, CLI interfaces, WebSocket entry points as inbound adapters

• Hands-on: Implement a REST adapter using a lightweight web framework to expose port functionality

Module 4: Developing Outbound Adapters

1 week

• Topics: Persistence adapters (SQL, NoSQL), messaging adapters (Kafka, RabbitMQ), external API clients

• Hands-on: Create a database adapter for tasks using an ORM and configure it behind the repository port

Module 5: Wiring the Application & Configuration

1 week

• Topics: Dependency injection, wiring ports to adapters, environment-based configuration

• Hands-on: Bootstrap the application by assembling the hexagon in a main entry-point

Module 6: Testing Strategies

1 week

• Topics: Unit testing the domain (mocking ports), adapter integration tests, end-to-end tests

• Hands-on: Write tests for domain logic with a fake adapter and integration tests against an in-memory database

Module 7: Error Handling & Cross-Cutting Concerns

1 week

• Topics: Exception translation, logging, metrics, security adapter patterns

• Hands-on: Implement a global error handler adapter and integrate logging via an outbound port

Module 8: Deployment & Evolution

1 week

• Topics: Containerization of adapters, versioning ports for backward compatibility, gradual adapter replacement

• Hands-on: Containerize the web and database adapters with Docker, and demonstrate swapping the DB adapter

Get certificate