Skip to main content

A Hexagonal Software Architecture in Golang and MongoDB

Github StackBlitz

This project presents a simple product catalogue microservice to demonstrate the principles of a hexagonal software architecture. The microservice exposes a RESTful API that allows consuming applications to perform CRUD operations on a product catalogue. The microservice is developed in Golang, and the product catalogue data is persisted in a MongoDB repository.

Hexagonal Architecture

Prerequisites​

  • Go 1.25 or higher
  • MongoDB
  • Go modules

Setup​

  1. Clone the repository:

    git clone https://github.com/gofiber/recipes.git
    cd recipes/hexagonal

  2. Install dependencies:

    go mod tidy

  3. Configure the MongoDB connection in the config.yaml file:

    database:
      url: "your_mongodb_uri"
      db: "your_db_name"
      timeout: 30

Running the Application​

  1. Run the application:

    go run main.go

  2. The server will start on http://localhost:8080.

Endpoints​

MethodURLDescription
GET/api/v1/productsRetrieves all products
GET/api/v1/product/:idRetrieves a product by ID
POST/api/v1/productCreates a new product
PUT/api/v1/product/:idUpdates an existing product
DELETE/api/v1/product/:idDeletes a product

Example Requests​

Get All Products​

curl -X GET http://localhost:8080/api/v1/products

Get Product by ID​

curl -X GET http://localhost:8080/api/v1/product/1

Create a New Product​

curl -X POST http://localhost:8080/api/v1/product -d '{"name": "New Product", "price": 100}' -H "Content-Type: application/json"

Update a Product​

curl -X PUT http://localhost:8080/api/v1/product/1 -d '{"name": "Updated Product", "price": 150}' -H "Content-Type: application/json"

Delete a Product​

curl -X DELETE http://localhost:8080/api/v1/product/1

Hexagonal Architecture​

Hexagonal architecture, also known as ports and adapters architecture, is a design pattern used to create loosely coupled application components that can be easily connected to their software environment by means of ports and adapters. This architecture allows an application to be equally driven by users, programs, automated tests, or batch scripts, and to be developed and tested in isolation from its eventual runtime devices and databases.

Additional Information​

For more information on hexagonal architecture, you can refer to the following resources: