Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

15.2. Using the Infinispan CDI Module

The Infinispan CDI module can be used for the following purposes:
  • To configure and inject Infinispan caches into CDI Beans and Java EE components.
  • To configure cache managers.
  • To control storage and retrieval using CDI annotations.
Report a bug

15.2.1. Configure and Inject Infinispan Caches
Copy link

15.2.1.1. Inject an Infinispan Cache
Copy link

An Infinispan cache is one of the multiple components that can be injected into the project's CDI beans.
The following code snippet illustrates how to inject a cache instance into the CDI bean: 
public class MyCDIBean {
    @Inject
    Cache<String, String> cache;
}
Copy to Clipboard Toggle word wrap
Report a bug

15.2.1.2. Inject a Remote Infinispan Cache
Copy link

The code snippet to inject a normal cache is slightly modified to inject a remote Infinispan cache, as follows: 
public class MyCDIBean {
    @Inject
    RemoteCache<String, String> remoteCache;
}
Copy to Clipboard Toggle word wrap
Report a bug

15.2.1.3. Set the Injection's Target Cache
Copy link

The following are the three steps to set an injection's target cache:
  1. Create a qualifier annotation.
  2. Add a producer class.
  3. Inject the desired class.
Report a bug
15.2.1.3.1. Create a Qualifier Annotation
Copy link
To use CDI to return a specific cache, create custom cache qualifier annotations as follows: 
@javax.inject.Qualifier
@Target({ElementType.FIELD, ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface SmallCache {}
Copy to Clipboard Toggle word wrap
Use the created @SmallCache qualifier to specify how to create specific caches.
Report a bug
15.2.1.3.2. Add a Producer Class
Copy link
The following code snippet illustrates how the @SmallCache qualifier (created in the previous step) specifies a way to create a cache: 
import org.infinispan.configuration.cache.Configuration;
import org.infinispan.configuration.cache.ConfigurationBuilder;
import org.infinispan.cdi.ConfigureCache;
import javax.enterprise.inject.Proces;

public class CacheCreator {
    @ConfigureCache("smallcache")
    @SmallCache
    @Produces
    public Configuration specialCacheCfg() {
        return new ConfigurationBuilder()
                   .eviction()
                       .strategy(EvictionStrategy.LRU)
                       .maxEntries(10)
                   .build();
    }
}
Copy to Clipboard Toggle word wrap
The elements in the code snippet are:
  • @ConfigureCache specifies the name of the cache.
  • @SmallCache is the cache qualifier.
Report a bug
15.2.1.3.3. Inject the Desired Class
Copy link
Use the @SmallCache qualifier and the new producer class to inject a specific cache into the CDI bean as follows: 
public class MyCDIBean {
    @Inject @SmallCache
    Cache<String, String> mySmallCache;
}
Copy to Clipboard Toggle word wrap
Report a bug
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top