Book Image

Designing Hexagonal Architecture with Java

By : Davi Vieira
Book Image

Designing Hexagonal Architecture with Java

By: Davi Vieira

Overview of this book

Hexagonal architecture enhances developers' productivity by decoupling business code from technology code, making the software more change-tolerant, and allowing it to evolve and incorporate new technologies without the need for significant refactoring. By adhering to hexagonal principles, you can structure your software in a way that reduces the effort required to understand and maintain the code. This book starts with an in-depth analysis of hexagonal architecture's building blocks, such as entities, use cases, ports, and adapters. You'll learn how to assemble business code in the Domain hexagon, create features by using ports and use cases in the Application hexagon, and make your software compatible with different technologies by employing adapters in the Framework hexagon. Moving on, you'll get your hands dirty developing a system based on a real-world scenario applying all the hexagonal architecture's building blocks. By creating a hexagonal system, you'll also understand how you can use Java modules to reinforce dependency inversion and ensure the isolation of each hexagon in the architecture. Finally, you'll get to grips with using Quarkus to turn your hexagonal application into a cloud-native system. By the end of this hexagonal architecture book, you'll be able to bring order and sanity to the development of complex and long-lasting applications.
Table of Contents (21 chapters)
1
Section 1: Architecture Fundamentals
7
Section 2: Using Hexagons to Create a Solid Foundation
12
Section 3: Becoming Cloud-Native

Bootstrapping the Domain hexagon

The hexagonal application project that we're going to start in this chapter is actually a continuation of the topology and inventory system that we've been developing in the previous chapters. However, the difference here is that we will augment some of the system's capabilities and use the Java Platform Module System (JPMS) to encapsulate the Domain hexagon in a Java module.

To get started with bootstrapping the Domain hexagon, let's create a multi-module Maven project, as follows:

  1. We first create a parent project called topology-inventory by executing the following code:
    mvn archetype:generate \
    -DarchetypeGroupId=org.codehaus.mojo.archetypes \
    -DarchetypeArtifactId=pom-root \
    -DarchetypeVersion=RELEASE \
    -DgroupId=dev.davivieira \
    -DartifactId=topology-inventory \
    -Dversion=1.0-SNAPSHOT \
    -DinteractiveMode=false

    We use the archetype:generate Maven goal to generate a Maven root project for the system. It creates a pom...