JCache (Payara 4.1.151)

Contents

• 1. Overview
• 2. Documentation Conventions
• 3. Using JCache in your Applications
  • 3.1 Accessing the JSR107 Caching Provider and Cache Manager
    • 3.1.1 Using Injection
  • 3.2 Using JCache Annotations

1. Overview

This page covers how to use the JCache functionality in Payara 4.1.151.
JSR107 (JCache) is implemented in Payara by Hazelcast.

2. Documentation Conventions

Any paths listed throughout the documentation will use the Unix/Linux file path structure (forward slashes).

3. Using JCache in your Applications

The following section will detail how to access and use JCache in your code.

3.1 Accessing the JSR107 Caching Provider and Cache Manager

To create a Cache, you will need a CachingProvider and CacheManager. The embedded Hazelcast member in Payara has a CachingProvider and CacheManager registered to JNDI, so you do not have to create your own. To access them, import the following classes and initialise two variables like so:

import javax.cache.spi.CachingProvider;
import javax.cache.CacheManager;
...
Context ctx = new InitialContext();
CachingProvider provider = (CachingProvider) ctx.lookup("payara/CachingProvider");
CacheManager manager = (CacheManager) ctx.lookup("payara/CacheManager");

3.1.1 Using Injection

You can also use injection to access and use the CachingProvider and CacheManager embedded in Payara. Inject them into your application like so (note, your war or jar must be an implicit or explicit bean archive i.e. contains a CDI Bean with a bean defining annotation, an EJB Session Bean or a beans.xml file):

import javax.cache.CacheManager;
import javax.cache.spi.CachingProvider;
import javax.inject.Inject;
...
@Inject 
CacheManager manager;
@Inject
CachingProvider provider;

3.2 Using JCache Annotations

Payara has the necessary interceptors implemented for allowing the full set of JCache annotations to be used.

The JCache annotations are as follows:

• @CachePut - Puts the specified key and value in the cache.
• @CacheRemove - Removes the specified key and value from the cache.
• @CacheResult - Retrieves the value associated with the specified key.
• @CacheRemoveAll - Removes all keys and values from the cache.
• @CacheDefaults - Allows the configuration of defaults for CacheResult, CachePut, CacheRemove, and CacheRemoveAll at the class level.
• @CacheKey - Marks a method parameter as the key of a cache.
• @CacheValue - Marks a method parameter as the value of a cache key.