DEV Community: Hexagon Toolkit

Hexagon v4 released 🎉

Juanjo Aguililla — Fri, 07 Mar 2025 08:43:31 +0000

A few days ago I released version 4 of Hexagon, a toolkit for developing REST APIs (and now also 'serverless' services). If you are curious to try something other than Java + Spring (Hexagon is more like JS + Express), give it a try... And share your feedback :) Check the link to the release below:

https://hexagontk.com

https://github.com/hexagontk/hexagon/releases/tag/4.0.1

Hexagon v2 released 🎉

Juanjo Aguililla — Thu, 09 Jun 2022 14:05:03 +0000

Check the latest changes on the project website or its GitHub repository.

This is an important milestone in the project. It switches from using DSL transformation to adapters constructions,
to define a common handlers pipeline used by all adapters.

To wrap up the project history:

Fork of Spark to support Java 8.
Port to Kotlin (first Hexagon version). Still heavily based on Spark.
V2, complete rewrite to be based on middlewares, as opposed to before/after filters like Spark.

This design change makes easier to add new adapters as proved
with Netty's brand new adapter.

These changes come with a performance boost, however there is still room for improvement here (stay tuned for more performance gains here).

Also, the new design improves reusability by letting users define their own Callbacks, Handlers and Predicates.

The documentation and examples are not yet fully ported, but works on this regard are ongoing.

Please take a look at the changes, share your feedback... and spread the word!

Thanks for your support 🙂

Hexagon 1.4.0 released!!! 🎉

Juanjo Aguililla — Fri, 13 Aug 2021 06:36:59 +0000

Hello fellow Kotlin lovers... The 1.4.0 version of the Hexagon Toolkit got released!

Hexagon is a Microservices Toolkit that aims to provide all you need to develop applications that run on Cloud environments.

This is a minor release, but I think it is important to note because it contains a lot of internal improvements (and a lot of contributions from the past Hacktoberfest).

Another important event tied to this release is that it is the first release since Bikramjeet Singh joined the project. Welcome Bikramjeet!

Features

This release brings the following features:

Logging modules: Programmatically change logging level on packages not having to rely on configuration files (shaving some ms. to the start up time).
Server options and parameters: Fine tune the HTTP Server adapter under the hood (i.e., changing the number of worker threads).
Server features: Allow the development of Server Adapters with a subset of the functionalities. Some features could be ZIP support or Sessions support. Adapter's users can also use those adapters with a subset of the supported features to improve memory usage and overall performance.
Serialization modularization. Serialization formats have been moved to their own modules, making the final service include only the ones used (and saving disk on the binary distribution).
Recover Java 8 support (Jetty not supported, but Servlet is). This can be handy if you work in a slow-moving-company and want to use Hexagon to build some tools, do testing... or delivering production services if you dare 😉

Thanks to Contributors

Future Steps

Complete the functionality set (security, Websockets and OpenAPI).
Change the API: make it more consistent and switch to middleware filters instead before/after.

Spread the Word

Play with the toolkit and share your feedback :)
Tweet about it
Give it a ⭐
Contribute!

Hacktoberfest is coming

Juanjo Aguililla — Thu, 24 Sep 2020 16:41:52 +0000

For those of you who are looking for a Kotlin project to help in the next Hacktoberfest, I'm sharing with you the tasks you can pick in the Hexagon Toolkit project (you can find more information about the project on the Web page, GitHub organization and the main repository).

If you find the project interesting, you can check the tasks labeled with hacktoberfest in the following boards:

Toolkit board: for features and improvements on any toolkit module (like the HTTP server or Template processors).
Organization board: for side tasks as the Benchmark and examples.

Once you have found an appealing task, you can read the Contributing Guide with all the details on how to proceed to start working on it. If you would like to take a task, and you find the information incomplete, do not hesitate to contact me for any detail you want or need.

Thanks... And happy coding!!!

hexagontk / hexagon

Hexagon is a microservices toolkit written in Kotlin. Its purpose is to ease the building of services (Web applications or APIs) that run inside a cloud platform.

Hexagon

The atoms of your platform

Home Site | Quick Start

What is Hexagon

Hexagon is a microservices' toolkit (not a framework) written in Kotlin. Its purpose is to ease the building of server applications (Web applications, APIs or queue consumers) that run inside a cloud platform.

The Hexagon Toolkit provides several libraries to build server applications. These libraries provide single standalone features and are referred to as "Ports".

The main ports are:

The HTTP server: supports HTTPS, HTTP/2, mutual TLS, static files (serve and upload), forms processing, cookies, CORS and more.
The HTTP client: which supports mutual TLS, HTTP/2, cookies, form fields and files among other features.
Template Processing: allows template processing from URLs (local files, resources or HTTP content) binding name patterns to different engines.

Each of these features or ports may have different implementations called "Adapters".

Hexagon is designed to…

View on GitHub

Hexagon Toolkit 1.3 released

Juanjo Aguililla — Tue, 25 Aug 2020 23:02:07 +0000

Hello everyone, the Hexagon Toolkit released the 1.3 version this week.

To summarise, Hexagon is a Microservices Toolkit that aims to provide all you need to develop applications that run on Cloud environments.

You can find more information about the project in the following links:

This release was focused mostly on internal changes. Below you can find all the details.

Features

Implement HTTP Client Feature (Port). Implemented by the Async HTTP Client Adapter.
Add the Freemarker Template Adapter.
Improve RabbitMQ (beta) module adding metrics to it (by Donky106).
Sign Packages and publish on Maven Central.
Check dependencies' integrity for security (by Donky106).
Support Maven through a Maven parent POM.
Create a Twitter Clone example (by Bikramjeet Singh).
Depend only on SLF4J for logging. Allowing users to set up Logback, Log4j2 and JUL at their preference.

Sponsorship

Thanks to the following companies for borrowing resources to the project, this is much appreciated!

DigitalOcean: provides Cloud resources to run tools and test deployments.
JetBrains: donates a license of their wonderful IDEs for the toolkit development.

Thanks to Contributors

Bikramjeet Singh for implementing the Freemarker Adapter and creating the Twitter Clone example.
Donky106 for improving the RabbitMQ adapter and setting up dependencies' verification.
Shahid Raza for improving the log statements' information on the library.
Tyler Lowrey for contributing with the HTTP Client documentation.

Future Steps

Complete the functionality set (security, Websockets and OpenAPI).
Change the API: make it more consistent and switch to middleware filters instead before/after.
Develop asynchronous handlers using coroutines.

Spread the Word

Play with the toolkit and share your feedback :)
Retweet on Twitter
Give it a ⭐
Contribute!

TechEmpower released round 19 of their server benchmark (including Hexagon's result)

Juanjo Aguililla — Fri, 29 May 2020 15:23:21 +0000

TechEmpower just released the latest round (19) of their server middleware benchmark. You can check the results here: https://www.techempower.com/benchmarks

Mutual TLS authentication in REST services with Kotlin

Juanjo Aguililla — Fri, 17 Jan 2020 17:04:23 +0000

Do you want to develop mutual TLS Web services in Kotlin? Hexagon 1.2 got released today with that feature, check the following section to learn how: https://hexagonkt.com/port_http_server/#https

You can check all project's examples and source code at GitHub : https://github.com/hexagonkt

If you give it a go, please share your feedback!

Disclaimer: I'm the project's maintainer

Real World REST API with Kotlin (Hexagon)

Juanjo Aguililla — Mon, 16 Sep 2019 17:51:28 +0000

To showcase the toolkit usage, I developed a Real World example (https://github.com/gothinkster/realworld) implemented with Hexagon (https://hexagonkt.com). You can check it in the following repository: https://github.com/hexagonkt/real_world

This example covers JWT auth, CORS implementation, Simple DB store and integration testing.

I will be using this example to test new Hexagon features.

Please, share your feedback :)