kotlin-hexagonal-architecture

Example project applying hexagonal architecture in kotlin.

Layers

Domain

Concepts that are in our context (User, Product, Cart, etc), and business rules that are determined exclusively by us ( domain services),

Application

The application layer is where the use cases of our application live (register user, publish product, add product to cart, etc).

Infrastructure

Code that changes based on external decisions. In this layer will live the implementations of the interfaces that we will define a domain level. That is, we will rely on the SOLID DIP to be able to decouple from external dependencies.

Application

Check

./gradlew check

Run applications

./gradlew run

HealthCheck

curl --location --request GET 'http://0.0.0.0:8081/healthcheck'

Examples

POST

curl --location --request POST 'http://0.0.0.0:8081/v1/product' \
--header 'Content-Type: application/json' \
--data-raw '{
    "name": "product name",
    "price": 120
}'

GET

Get all products

curl --location --request GET 'http://0.0.0.0:8081/v1/product/all'

Get product by id

curl --location --request GET 'http://0.0.0.0:8081/v1/product/9e6fcea9-237e-4055-ab31-95f90aac2f80'

Update product

curl --location --request PUT 'http://0.0.0.0:8081/v1/product' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "9e6fcea9-237e-4055-ab31-95f90aac2f80",
    "name": "new product name",
    "price": 120
}'

Frameworks

• Ktor for server: Documentation
• Koin for dependency injection: Documentation
• Kotlin Serializations: Documentation