The Infinispan subsystem provides caching support for HA services in the form of Infinispan caches such as high-performance, transactional caches which can operate in both non-distributed and distributed scenarios. WildFly application server ships with the Infinispan subsystem, however, it is recommended not to use the application server cache definition as repository for your Cache. This tutorial shows the available options for using Infinispan in an Enterprise application deployed on WildFly or any Java EE container.

As said, you are adviced not to use WildFly's Infinispan Caches for application purpose as they are internally used for managing the application's server own Caches. So which are our options? You can use these two patterns:

Library mode - When running in this mode, you have to provide all the binaries required to build and run your Cache. You can do it in two ways: either embedding the libraries in your application or installing the modules into the application server. This usage mode gives access to advanced functionalities such as Transactional support, Listeners and Interceptors, Batching, Lucene-based queries and index, Distributed execution framework via Map-Reduce.

Client-server mode: When running in this mode applications can remotely access the data grid server using Hot Rod, memcached or REST client APIs. You have to bundle a minimal set of API to connect to the Infinispan Server and this additional layer can provide you some benefits such as Connection pooling with cache stores, multiple interfaces (memcached, Hotrod, REST), authentication and encrypytion and cluster Rolling upgrades (without bringing the cluster down).

infinispan tutorial


In the following tutorial we have described how to use a remote Infinispan Server through the Hot Rod protocol: Connecting to a Remote Infinispan Server using Hot Rod

Now we will learn how to code an application in Library mode

Deploy and application on WildFly in Library Mode 

The core part of it is the MyCacheManagerProvider which defines a DefaultCacheManager using the "jgroups-udp.xml" configuration based on a Clustered Synchronous Cache that uses Distribution as Cache mode:

package com.mastertheboss.producer;

import javax.annotation.PreDestroy;
import javax.enterprise.context.ApplicationScoped;
import org.infinispan.manager.DefaultCacheManager;
import org.infinispan.configuration.cache.Configuration;
import org.infinispan.configuration.cache.ConfigurationBuilder;
import org.infinispan.configuration.cache.CacheMode;

public class MyCacheManagerProvider {

	private static final long ENTRY_LIFESPAN = 60 * 1000; // 60 seconds

	private DefaultCacheManager manager;

	public DefaultCacheManager getCacheManager() {
		if (manager == null) {

			GlobalConfiguration glob = new GlobalConfigurationBuilder().clusteredDefault() 
					.transport().addProperty("configurationFile", "jgroups-udp.xml")  
			Configuration loc = new ConfigurationBuilder().jmxStatistics().enable()  
			manager = new DefaultCacheManager(glob, loc, true);
		return manager;

	public void cleanUp() {
		manager = null;


The above Cache is configure to expire its entries after 60 seconds.

In order to make available the DefaultCacheManager, we will create a producer Class that gets injected the MyCacheManagerProvider:

package com.mastertheboss.producer;

import javax.enterprise.context.ApplicationScoped;
import javax.enterprise.inject.Produces;
import javax.inject.Inject;
import org.infinispan.manager.DefaultCacheManager;

public class ApplicationBean {
    MyCacheManagerProvider cacheManagerProvider;

    DefaultCacheManager getDefaultCacheManager() {
        return cacheManagerProvider.getCacheManager();

The class which manages your Cache is the following Manager class that contains some basic methods for adding or cleaning the cache:

package com.mastertheboss.service;

import java.util.ArrayList;
import java.util.List;
import javax.enterprise.inject.Model;
import javax.inject.Inject;

import org.infinispan.Cache;
import org.infinispan.manager.DefaultCacheManager;
import com.mastertheboss.model.Item;

public class Manager {

	DefaultCacheManager cacheManager;

	private String key;
	private String value;

	public Manager() {

	public String save() {
		Cache<String, Item> cache = cacheManager.getCache();
		Item item = new Item();
		cache.put(item.getKey(), item);
		return "home";

	public List getCacheList() {
		Cache<String, Item> cache = cacheManager.getCache();
		List list = new ArrayList();
		cache.entrySet().forEach(entry -> list.add(entry.getValue()));
		return list;


	public void removeItem(String key) {
		Cache<String, Item> cache = cacheManager.getCache();   

	public void clear() {
		Cache<String, Item> cache = cacheManager.getCache();
	public String getKey() {
		return key;

	public void setKey(String key) {
		this.key = key;

	public String getValue() {
		return value;

	public void setValue(String value) {
		this.value = value;

In order to complete the application, a simple xhtml page which displays data and let add new Items:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
<html xmlns=""

	<h2>Infinispan Demo - Library Mode</h2>
	<h:form id="jsfexample">
		<h:panelGrid columns="2" styleClass="default">

			<h:outputText value="Enter key:" />
			<h:inputText value="#{manager.key}" />

			<h:outputText value="Enter value:" />
			<h:inputText value="#{manager.value}" />

			<h:commandButton actionListener="#{}"
				styleClass="buttons" value="Save key/value" />
			<h:commandButton actionListener="#{manager.clear}"
				styleClass="buttons" value="Clear cache" />

			<h:messages />


		<h:dataTable value="#{manager.cacheList}" var="item"
			styleClass="table" headerClass="table-header"
				<f:facet name="header">Key</f:facet>
				<h:outputText value="#{item.key}" />
				<f:facet name="header">Value</f:facet>
				<h:outputText value="#{item.value}" />

Finally, if we want to package our application and deploy it on WildFly, we need to specify in our pom.xml that Infinispan libraries are NOT provided so they will be packaged in our Web application. Here is the pom.xml:

<project xmlns=""



	<name>Quickstart: Infinispan-WildFly</name>

			<name>Apache License, Version 2.0</name>






 And here is the application in action:

infinispan tutorial

You can check the source code for this tutorial on:

Two options to deploy applications in library mode

The example discussed here bundles the infinispan libraries with your application. Another option for deploying applications in library mode is to install the Infinispan data Grid/JDG Modules in the WildFly/JBoss EAP application server. The Infinispan modules are available here: (Click on WildFly/EAP Modules)

To install the modules in JBoss EAP/WildFly, unzip the modules in the application server home directory. The user application needs to include dependencies on these modules via jboss-deployment-structure.xml file.

<jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2">
         <module name="org.infinispan" slot="ispn-9.4" services="export"/>

Related articles available on

Getting Started with Infinispan - Part 1

This tutorial has been updated to work with the lastes Infinispan

Infinispan tutorial part 2

In the first tutorial we have covered some basic concepts about I

Infinispan RESTful interface

This is an update for Infinispan REST tutorial which is based on

Develop a clustered application with Infinispan Data Grid

In this tutorial we will use Infinispan Data Grid Platform to sto

Using Infinispan Query API

Applications using a NoSQL storage often need to query data using

Monitoring WildFly's Infinispan caches

In this tutorial we will learn how to monitor the Embedded Infini