java-design-patterns/hexagonal/README.md

---
layout: pattern
title: Hexagonal Architecture
folder: hexagonal
permalink: /patterns/hexagonal/
pumlid: HSTB4W8X30N0g-W1XkozpPD90LO8L3wEnzUTk-xxq2fvSfhSUiJs1v7XAcr4psSwMrqQh57gcZGaBmICNdZZEDb7qsCZWasT9lm7wln1MmeXZlfVIPjbvvGl
categories: Architectural
tags:
 - Java
 - Difficulty-Expert
---

## Also known as
* Ports and Adapters
* Clean Architecture
* Onion Architecture

## Intent
Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases.

![Hexagonal Architecture class diagram](./etc/hexagonal.png)

## Applicability
Use Hexagonal Architecture pattern when

* it is important that the application is fully testable
* you use Domain Driven Design methodology and/or Microservices architectural style

## Real world examples

* [Apache Isis](https://isis.apache.org/)

## Credits

* [Alistair Cockburn - Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture)
Add readme and class diagram 2016-04-10 21:22:40 +03:00			`---`
			`layout: pattern`
			`title: Hexagonal Architecture`
			`folder: hexagonal`
			`permalink: /patterns/hexagonal/`
Work on #190: Commit initial pumlId's added by the script 2016-08-30 15:10:34 +02:00			`pumlid: HSTB4W8X30N0g-W1XkozpPD90LO8L3wEnzUTk-xxq2fvSfhSUiJs1v7XAcr4psSwMrqQh57gcZGaBmICNdZZEDb7qsCZWasT9lm7wln1MmeXZlfVIPjbvvGl`
Add readme and class diagram 2016-04-10 21:22:40 +03:00			`categories: Architectural`
			`tags:`
			`- Java`
			`- Difficulty-Expert`
			`---`

Add alias name for the pattern 2016-04-10 21:49:40 +03:00			`## Also known as`
Markdown fix 2016-05-22 09:33:50 +03:00			`* Ports and Adapters`
			`* Clean Architecture`
			`* Onion Architecture`
Add alias name for the pattern 2016-04-10 21:49:40 +03:00
Add readme and class diagram 2016-04-10 21:22:40 +03:00			`## Intent`
			`Allow an application to equally be driven by users, programs, automated test or batch scripts, and to be developed and tested in isolation from its eventual run-time devices and databases.`

			`![Hexagonal Architecture class diagram](./etc/hexagonal.png)`

			`## Applicability`
			`Use Hexagonal Architecture pattern when`

			`* it is important that the application is fully testable`
			`* you use Domain Driven Design methodology and/or Microservices architectural style`

			`## Real world examples`

			`* [Apache Isis](https://isis.apache.org/)`

			`## Credits`

			`* [Alistair Cockburn - Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture)`