Spring Framework 5 and EhCache 3.5

Question

I tried to use EhCache 3.5 caching features in our web application based on Spring Boot 2/Spring Framework 5.

I added EHCache dependency:

    <dependency>
        <groupId>org.ehcache</groupId>
        <artifactId>ehcache</artifactId>
        <version>3.5.0</version>
    </dependency>
    <dependency>
        <groupId>javax.cache</groupId>
        <artifactId>cache-api</artifactId>
        <version>1.0.0</version>
    </dependency>

Then created ehcache.xml file in src/main/resources folder:

<?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:noNamespaceSchemaLocation="ehcache.xsd" updateCheck="true"
    monitoring="autodetect" dynamicConfig="true">

    <cache name="orders" maxElementsInMemory="100" 
        eternal="false" overflowToDisk="false" 
        memoryStoreEvictionPolicy="LFU" copyOnRead="true"
        copyOnWrite="true" />
</ehcache>

Spring 5 reference guide does't mention EHCache usage, Spring 4 reference guide states: "Ehcache 3.x is fully JSR-107 compliant and no dedicated support is required for it."

So I created controller OrderController and REST endpoint:

@Cacheable("orders")
@GetMapping(path = "/{id}")
public Order findById(@PathVariable int id) {
    return orderRepository.findById(id);
}

Spring Boot configuration:

@SpringBootApplication
@EnableCaching
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

But when I call this endpoint I get an exception:

Then I tried to use example from Spring Framework 4:

@Bean
public CacheManager cacheManager() {
    return new EhCacheCacheManager(ehCacheCacheManager().getObject());
}

@Bean
public EhCacheManagerFactoryBean ehCacheCacheManager() {
    EhCacheManagerFactoryBean cmfb = new EhCacheManagerFactoryBean();
    cmfb.setConfigLocation(new ClassPathResource("ehcache.xml"));
    cmfb.setShared(true);
    return cmfb;
}

But it doesn't compile because of exception:

The type net.sf.ehcache.CacheManager cannot be resolved. It is indirectly referenced from required .class file

Please, advise.

score 13 · Answer 1 · edited Jan 25 '19 at 12:05

There is a mix of things here. Ehcache 3, which you are using, is used with Spring through JCache.

Which is why you need to use spring.cache.jcache.config=classpath:ehcache.xml.

Then, your Ehcache configuration is indeed an Ehcache 2 configuration. So is the EhCacheCacheManager. For JCache, you should use JCacheCacheManager. But in fact, you don't even need it with an ehcache.xml.

Here are the steps to make it work

Step 1: Set the correct dependencies. Note that you don't need to specify any version as they are provided by the parent pom dependency management. javax.cache is now version 1.1.

<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
</dependency>
<dependency>
    <groupId>javax.cache</groupId>
    <artifactId>cache-api</artifactId>
</dependency>

Step 2: Add an ehcache.xml file in src/main/resources. An example below.

<?xml version="1.0" encoding="UTF-8"?>
<config
    xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xmlns:jsr107='http://www.ehcache.org/v3/jsr107'
    xmlns='http://www.ehcache.org/v3'
    xsi:schemaLocation="
        http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core-3.5.xsd
        http://www.ehcache.org/v3/jsr107 http://www.ehcache.org/schema/ehcache-107-ext-3.5.xsd">

  <service>
    <jsr107:defaults enable-management="false" enable-statistics="true"/>
  </service>

  <cache alias="value">
    <resources>
      <heap unit="entries">2000</heap>
    </resources>
  </cache>
</config>

Step 3: An application.properties with this line is needed to find the ehcache.xml

spring.cache.jcache.config=classpath:ehcache.xml

Note that since JCache is found in the classpath, Spring Cache will pick it as the cache provider. So there's no need to specify spring.cache.type=jcache.

Step 4: Enable caching like you did

    @SpringBootApplication
    @EnableCaching
    public class Cache5Application {

        private int value = 0;

        public static void main(String[] args) {
            ApplicationContext context = SpringApplication.run(Cache5Application.class, args);
            Cache5Application app = context.getBean(Cache5Application.class);
            System.out.println(app.value());
            System.out.println(app.value());
        }

        @Cacheable("value")
        public int value() {
            return value++;
        }
    }

Upvoted. This works in 06/19. I had everything in place except `javax.cache` dependency. — Tirath, Jun 24 '19 at 10:36

Essex Boy · Answer 2 · 2018-03-14T11:36:19.777

You need to force it to use ehcache version 2

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-cache</artifactId>
</dependency>
<dependency>
    <groupId>net.sf.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>2.10.3</version>
</dependency>

To use ehcache 3:

Here is the application:

@SpringBootApplication
@EnableCaching
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

Here is the application.yml

spring:
  cache:
    ehcache:
      config: ehcache.xml

Here a service with a counter for testing

@Service
public class OrderService {

    public static int counter=0;

    @Cacheable("orders")
    public Order findById(Long id) {
        counter++;
        return new Order(id, "desc_" + id);
    }
}

Here is a test to prove it is using the cache:

@RunWith(SpringRunner.class)
@SpringBootTest
public class OrderServiceTest {

    @Autowired
    private OrderService orderService;

    @Test
    public void getHello() throws Exception {
        orderService.findById(1l);
        assertEquals(1, OrderService.counter);
        orderService.findById(1l);
        assertEquals(1, OrderService.counter);
        orderService.findById(2l);
        assertEquals(2, OrderService.counter);
    }
}

See here for working example.

Thank you. Is there any way to specify ehcache.xml (not jcache.xml) ? — Sergiy, Mar 01 '18 at 11:10

Sergiy · Answer 3 · 2018-03-01T15:10:02.460

I made additional research. The following configuration isn't picked up by Spring Boot(from application.properties):

spring.cache.ehcache.config=classpath:ehcache.xml

So I created jcache.xml and also put into src/main/resource folder:

<config xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xmlns='http://www.ehcache.org/v3'
    xsi:schemaLocation="
        http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core-3.0.xsd">

    <cache alias="orders">
        <key-type>org.springframework.cache.interceptor.SimpleKey</key-type>
        <value-type>java.util.Collections$SingletonList</value-type>
        <heap unit="entries">200</heap>
    </cache>
</config>

Then I changed setting in application.properties to

spring.cache.jcache.config=classpath:jcache.xml

Now Spring Caching works correctly. However it's still a question how to pick up ehcache.xml

score 0 · Answer 4 · answered Oct 20 '18 at 17:50

Facing the same issue.

My ehcache.xml looks like

<config xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xmlns='http://www.ehcache.org/v3'
    xmlns:jsr107='http://www.ehcache.org/v3/jsr107'
    xsi:schemaLocation="
        http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core-3.0.xsd
        http://www.ehcache.org/v3/jsr107 http://www.ehcache.org/schema/ehcache-107-ext-3.0.xsd">
  <service>
      <jsr107:defaults>
          <jsr107:cache name="vehicles" template="heap-cache" />
      </jsr107:defaults>
  </service>
  <cache-template name="heap-cache">
      <heap unit="entries">20</heap>
  </cache-template>
</config>

Have configured spring.cache.jcache.config=classpath:ehcache.xml in application.properties
Have @EnableCaching on my application class.
Have @CacheResult on my service implementation.

@CacheResult(cacheName = "vehicles") public VehicleDetail getVehicle(@CacheKey String vehicleId) throws VehicleServiceException

Do NOTE that I do not have a CacheManager bean.

Would be really helpful if someone can point out what am I missing.

score 0 · Answer 5 · answered Oct 20 '18 at 18:10

hmm.. changing ehcache.xml to, did the trick ..

<config xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance'
    xmlns='http://www.ehcache.org/v3'
    xmlns:jsr107='http://www.ehcache.org/v3/jsr107'
    xsi:schemaLocation="
        http://www.ehcache.org/v3 http://www.ehcache.org/schema/ehcache-core-3.0.xsd
        http://www.ehcache.org/v3/jsr107 http://www.ehcache.org/schema/ehcache-107-ext-3.0.xsd">

    <service>
        <jsr107:defaults enable-management="true"
            enable-statistics="true" />
    </service>

    <cache alias="vehicles" uses-template="heap-cache" />

    <cache-template name="heap-cache">
        <heap unit="entries">20</heap>
    </cache-template>
</config>

score 0 · Answer 6 · answered May 04 '23 at 15:48

Add the Below Dependencies in POM.XML

<parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>3.0.6</version>
        <relativePath />
    </parent>
   <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-cache</artifactId>
        </dependency>
        <dependency>
            <groupId>org.ehcache</groupId>
            <artifactId>ehcache</artifactId>
            <version>3.10.8</version>
        </dependency>

Add the Below line in the Application.properties file

spring.cache.jcache.config=classpath:ehcache.xml

Add Ehcache.xml And then add the below code in the @SpringBootApplication file along with @EnableCaching

@Bean
    public CacheManager cacheManager() {
      return new ConcurrentMapCacheManager("yourcacheName{must match with XML file}");
    }

Spring Framework 5 and EhCache 3.5

6 Answers6