Getting Started with Hazelcast using Microprofile

See something wrong? Edit this page.

This guide will get you started to use Hazelcast in a Microprofile application.

You can see the whole project here.

What You’ll Learn

In this guide, you will learn how to use Hazelcast IMDG within Microprofile microservices.

The Microprofile application contains three endpoints which helps you to put, read and list the data. The application initializes a single Hazelcast IMDG member instance which is used to keep the data. When you run the application multiple times, Hazelcast IMDG instances build a cluster and share the data.


  • ~ 10 mins

  • A text editor or IDE

  • JDK 1.8+

  • Apache Maven 3.2+

Configuring Hazelcast

Before starting to use Hazelcast inside the application, let’s configure it in

HazelcastInstance create() {
    Config config = new Config();
    // all other configurations (networking,
    // listeners, etc.) can be set here.
    MapConfig mapConfig = new MapConfig();
    return Hazelcast.newHazelcastInstance(config);

create() method will supply HazelcastInstance wherever it is injected:

HazelcastInstance instance;

Now that we have a HazelcastInstance, we can reach to the distributed map over the instance:

private IMap<Integer,String> getDistributedMap() {
    return instance.getMap(HazelcastApplication.MAP_NAME);
Since we call the map with MAP_NAME - which we configured before, it will have 30 seconds of time-to-live.

And that’s all! The distributed map is ready to use now.

IMap<Integer,String> map = getDistributedMap();
map.put(1, "value");
map.putIfAbsent(1, "another_value");

Running the Microprofile Application

Now, let’s build the servers and then deploy the applications.

$ mvn clean install

Start the first server listening on port 9080:

$ mvn -pl server1 liberty:run-server

In another terminal session, start the second server listening on port 9081:

$ mvn -pl server2 liberty:run-server

After two servers are up and ready, you will see the logs:

The HazelcastGuides1 server is ready to run a smarter planet.
The HazelcastGuides2 server is ready to run a smarter planet.

Let’s give it a try:

$ curl -X PUT "http://localhost:9080/application/map/put?key=1&value=greetings_from_server1"
Put: greetings_from_server1. Old value was: null

$ curl -X GET "http://localhost:9081/application/map/get?key=1"
{ 1 : greetings_from_server1 }

$ curl -X PUT "http://localhost:9081/application/map/put?key=2&value=cool"
Put: cool. Old value was: null

$ curl -X GET "http://localhost:9080/application/map/list"
Size: 2
{ 1: greetings_from_server1 }
{ 2: cool }

Note that after 30 seconds, these values will be evicted.


In this guide, we developed a simple application that stores the data in a Hazelcast instance. We started two application instances, and they formed a Hazelcast cluster. Since the data was shared among Hazelcast cluster instances, we could access it from both application instances.