Hexagonal architecture (software): Difference between revisions

Revision as of 12:58, 10 October 2022

Latest revision as of 17:53, 30 July 2025

(12 intermediate revisions by 8 users not shown)

Line 3:

== Origin ==

The hexagonal architecture was invented by [[Alistair Cockburn]] in an attempt to avoid known structural pitfalls in [[Object-oriented analysis and design|object-oriented software design]], such as undesired dependencies between [[Layer (object-oriented design)|layers]] and contamination of [[user interface]] code with [[business logic]],. and publishedIt inwas 2005.discussed at first on the [[Portland Pattern Repository]] wiki;<ref>{{Cite web|url=https://wwwwiki.infoqc2.com/news?HexagonalArchitecture|title=Hexagonal Architecture in the C2 Wiki}}</2014ref><ref>{{Cite web|url=https:/10/exploring-hexagonal-architecturewiki.c2.com/?PortsAndAdaptersArchitecture|title=ExploringPorts theAnd HexagonalAdapters Architecture|last in the C2 Wiki}}</ref> in 2005 Cockburn renamed it "Ports and adapters".<ref name=Stenberg":0"></ref> In April 2024, Cockburn published a comprehensive book on the subject, coauthored with Juan Manuel Garrido de Paz.<ref>{{Cite web|firsturl=Jan|date=2014https://store7710079.company.site/Hexagonal-10Architecture-31Explained-p655931616|websitetitle=InfoQ|access-date=2019-08-12Hexagonal Architecture Explained}}</ref>

The term "hexagonal" comes from the graphical conventions that shows the application component like a [[hexagon]]al cell. The purpose was not to suggest that there would be six borders/ports, but to leave enough space to represent the different interfaces needed between the component and the external world.<ref name=":0" ></ref>

== Principle ==

Line 11:

The hexagonal architecture divides a system into several loosely-coupled interchangeable components, such as the application core, the database, the user interface, test scripts and interfaces with other systems. This approach is an alternative to the traditional layered architecture.

Each component is connected to the others through a number of exposed "ports". Communication through these ports follow a given protocol depending on their purpose. Ports and protocols define an abstract [[Application programming interface|API]] that can be implemented by any suitable technical means (e.g. [[method invocation]] in an [[Object-oriented programming|object-oriented language]], [[remote procedure call]]s, or [[Webweb service]]s).

The granularity of the ports and their number is not constrained:

* a single port could in some case be sufficient (e.g. in the case of a simple service consumer) ;

* typically, there are ports for event sources (user interface, automatic feeding), notifications (outgoing notifications), [[database]] (in order to interface the component with any suitable DBMS), and administration (for controlling the component);

* in an extreme case, there could be a different port for every [[use case]], if needed.

Line 22:

== Criticism ==

The term "hexagonal" implies that there are 6 parts to the concept, whereas there are only 4 key areas. The term’s usage comes from the graphical conventions that shows the application component like a [[Hexagon|hexagonalhexagon]]al cell. The purpose was not to suggest that there would be six borders/ports, but to leave enough space to represent the different interfaces needed between the component and the external world.<ref name=":020">{{Cite web|last=Cockburn|first=Alistair|date=2005-04-01|title=Hexagonal architecture|url=https://alistair.cockburn.us/hexagonal-architecture/|access-date=2020-11-18|website=alistair.cockburn.us}}</ref>

According to [[Martin Fowler (software engineer)|Martin Fowler]], the hexagonal architecture has the benefit of using similarities between presentation layer and data source layer to create symmetric components made of a core surrounded by interfaces, but with the drawback of hiding the inherent asymmetry between a service provider and a service consumer that would better be represented as layers.<ref>{{Cite book|title=Patterns of enterprise application architecture|last=Fowler, Martin|date=2003|publisher=Addison-Wesley|isbn=0-321-12742-0|pages=21|oclc=50292267}}</ref>

Line 33:

The onion architecture proposed by Jeffrey Palermo in 2008 is similar to the hexagonal architecture: it also externalizes the infrastructure with interfaces to ensure loose coupling between the application and the database.<ref>{{Cite web|url=https://jeffreypalermo.com/2008/07/the-onion-architecture-part-1/|title=The Onion Architecture : part 1|last=Jeffrey|first=Palermo|date=2008-07-29|website=Programming with Palermo|language=en-US|access-date=2019-08-12}}</ref> It decomposes further the application core into several concentric rings using [[inversion of control]].<ref>{{Cite book|title=Learning NHibernate 4 : explore the full potential of NHibernate to build robust data access code|last=Chatekar, Suhas|publisher=Packt Publishing|year=2015|isbn=978-1-78439-206-2|pages=249–250|oclc=937787252}}</ref>

The clean architecture proposed by [[Robert C. Martin]] in 2012 combines the principles of the hexagonal architecture, the onion architecture and several other variants;. It provides additional levels of detail of the component, which are presented as concentric rings. It isolates adapters and interfaces (user interface, databases, external systems, devices) in the outer rings of the architecture and leaves the inner rings for [[use case]]s and [[Entity class|entities]].<ref>{{Cite web|url=https://blog.cleancoder.com/uncle-bob/2012/08/13/the-clean-architecture.html|title=The Clean architecture {{!}} Clean Coder Blog|last=Martin|first=Robert, C.|date=2012-08-12|website=blog.cleancoder.com|access-date=2019-08-12}}</ref><ref>{{Cite book|title=Clean architecture : a craftsman's guide to software structure and design|last=Martin, Robert C.|publisher=Prentice Hall|year=2017|isbn=978-0-13-449416-6|oclc=1004983973}}</ref> The clean architecture uses the principle of [[Dependency inversion principle|dependency inversion]] with the strict rule that dependencies shall only exist between an outer ring to an inner ring and never the contrary.

== See also ==

Line 39:

* [[Layer (object-oriented design)]]

* [[Composite structure diagram]]

* [[Object-oriented analysis and design|Object oriented Analysisanalysis and design]]

== References ==

{{Reflist}}

[[Category:Software design]]

[[Category:Architectural pattern (computer science)]]