Java Cache Tutorial with Cache Dependency Injection (CDI)

When you want to speed your application by saving the results of long calculations, caching is often a good solution. Fortunately, the Java caching API is being standardized with jcache, and in combination with CDI, you can use caching in a completely standard fashion in Resin.

This example defines a single local, persistent cache named "my-cache", defined in the WEB-INF/resin-web.xml (this part is Resin specific, of course.) Once the cache is defined, the standard jcache javax.cache.Cache object can be injected into your class with the standard CDI @Inject annotation and used.

The definition selected the LocalCache implementation (com.caucho.distcache.LocalCache), gives it a javax.inject.Named name of "my-cache" and configures it. Here we only configure the name, and set the expire time to 1H. (The default is infinite expire.)

<web-app xmlns="http://caucho.com/ns/resin"
        xmlns:ee="urn:java:ee"
        xmlns:resin="urn:java:com.caucho.resin">

  <resin:LocalCache ee:Named="my-cache">
    <name>my-cache</name>
    <modified-expire-timeout>1H</modified-expire-timeout>
  </resin:LocalCache>
 
</web-app>

CDI inject of javax.cache.Cache

In the MyService class, we inject the cache that we defined using the CDI @Inject and @Named annotations. Normally, CDI recommends that you create custom qualifier annotations instead of using @Named, but to keep the example simple, we're giving it a simple name.

The Cache object can be used somewhat like a java.util.Map. Here we just use the get() and put() methods. Because we set the modified-expire-timeout to be 1H, the get() will return null an hour after the data was populated.

import javax.inject.Inject;
import javax.cache.Cache;

public class MyService {
  @Inject @Named("my-cache")
  private Cache<String,String> _cache;

  public String doStuff(String key)
  {
    String cachedValue = _cache.get(key);

    if (cachedValue == null) {
      cachedValue = doLongCalculation(key);

      _cache.put(key, cachedValue);
    }

    return cachedValue;
  }
}

The Resin LocalCache implementation

Since Resin's LocalCache is a persistent cache, the entries you save will be stored to disk and recovered. This means you can store lots of data in the cache without worrying about running out of memory. If the memory becomes full, Resin will use the cache entries that are on disk. For performance, commonly-used items will remain in memory.