Przemysław Wilczyński
Wstęp
Celem niniejszego artykułu jest pokazanie głównej idei budowania aplikacji z wykorzystaniem architektury heksagonalnej (zwanej również architekturą portów i adapterów), przedstawieniem jej zalet oraz próby jej wykorzystania.
Cel wprowadzenia architektury
Koncept architektury heksagonalnej został wprowadzony przez Alistair Cockburn w 2005. Głównym celem było umożliwienie, aby aplikacja mogła być wykorzystywana w takim samym stopniu przez użytkowników, inne programy, automatyczne testy oraz umożliwienie uruchomienia aplikacji w środowisku odizolowanym (developerskim, testowym) bez konieczności zależenia od zewnętrznych serwisów, baz danych itp. Z założenia zastosowanie architektury heksagonalnej pozwala na modularność aplikacji oraz łatwą zmianę i dodawanie nowych komponentów, np. podmiana warstwy persystencji, dodanie nowego interfejsu aplikacji jak na przykład interface RESTowy, konsolowy lub zamiana istniejących zewnętrznych zależności na mocki, aby móc w pełni przetestować aplikację.
Struktura
Główna idea polega na utworzeniu różnych modułów aplikacji (heksagonów) będących corem logicznym aplikacji, tzn. zawierających logikę biznesową niezależną od zewnętrznych frameworków, warstwy persystencji itp. Pojedynczy moduł posiada porty i adaptery (api i jego różne implementacje). Pojedynczy moduł może posiadać wiele portów do różnych celów, na przykład do komunikacji z użytkownikiem, bazą danych, innymi modułami i aplikacjami. Dodatkowo każdy port może mieć wiele adapterów, czyli implementacji danego api jak na przykład implementacje warstwy persystencji dla różnych baz.
Case study
W wykonywanym projekcie wydzielono 3 moduły devices, values oraz moduł producera. Każdy z modułów devices i values posiada port do warstwy persystencji, oraz port do komunikacji z użytkownikiem. Z portem do bazy danych mogą łączyć się 2 Adaptery zawierające implementację pozwalającą na łączenie się z relacyjną bazą danych lub też testową implementacją InMemory. Za komunikację z użytkownikiem odpowiada RESTowy Adapter. Dodatkowo w module Values znajduje się port do komunikacji pomiędzy modułami oraz jego implementacja dla modułu Devices. Moduł producera posiada port do komunikacji z urządzeniami zewnętrznymi oraz adapter Restowy pozwalający się komunikować z nimi przez protokół HTTP. Z drugiej strony posiada on port i Adapter do zapisu danych do bufora Kafki.
