Springboot 整合 Ehcache3 详细步骤

最近想在Springboot 项目中整合 Ehcache3 缓存，我们讲下详细配置整合步骤。首先说下版本，我这里是使用的springboot 2.6.6版本，选择的Ehcache3 是3.10.8版本。

第一步：导入maven依赖

maven依赖需要有三个，配置如下：

<!-- 引入Spring Boot缓存依赖 -->
<dependency>
	<groupId>org.springframework.boot</groupId>
	<artifactId>spring-boot-starter-cache</artifactId>
	<version>2.6.6</version>
</dependency>

<!-- 引入EhCache缓存库依赖 -->
<dependency>
	<groupId>org.ehcache</groupId>
	<artifactId>ehcache</artifactId>
	<version>3.10.8</version>
</dependency>
<dependency>
	<groupId>javax.cache</groupId>
	<artifactId>cache-api</artifactId>
	<version>1.1.1</version>
</dependency>

第二步：配置ehcache.xml

我这里使用的是xml配置方式，当然你也可以选择@Configuration代码配置方式，个人觉得还是xml配置方式更加清晰明了。

程序员导航

优网导航旗下整合全网优质开发资源，一站式IT编程学习与工具大全网站

立即访问

在resources目录下新增ehcache.xml，具体配置如下：

<?xml version="1.0" encoding="UTF-8"?>

<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.xsd">

    <!-- 指定硬盘存储目录，如用不到硬盘缓存，无需设置 -->
    <persistence directory="./ehcacheData" />

    <!-- cache-template  创建公开配置，被继承用 -->
    <cache-template name="myDefaults">
        <key-type>java.lang.Long</key-type>
        <value-type>java.lang.String</value-type>
        <heap unit="entries">200</heap>
    </cache-template>

    <!-- 继承自myDefaults，并重写其参数 这里是一个demo -->
    <cache alias="demo" uses-template="myDefaults">
        <key-type>java.lang.String</key-type>
        <expiry>
            <!--此处会覆盖模版中的(TTL)配置 -->
            <ttl unit="days">90</ttl>
        </expiry>
        <resources>
            <heap unit="entries">2000</heap>
            <offheap unit="MB">100</offheap>
        </resources>
    </cache>
</config>

更多配置参数请参考官网：https://www.ehcache.org/documentation/

第三步：配置application.yaml

这里需要注意ehcache3和ehcache2版本配置不一样，这是我们使用的是jcache，而不是ehcache，在application.yaml中新增配置如下：

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

第四步：启用缓存

我们需要在Application.java程序启动入口文件上新增启用ehcache缓存的注解，如下：

AI 工具导航

优网导航旗下AI工具导航，精选全球千款优质 AI 工具集

立即访问

@EnableCaching

至此，springboot已经整合好了ehcache3了，接下来就是使用了，只需要结合Spring中@Cacheable注解即可使用，以下是类似代码：

@Cacheable(cacheNames = "demo", key = "#province")
public String findPostcodeByRegion(String province) {
	// 省略
}

注意这里的cacheNames要和ehcache.xml中配置保持一致，否则会找不到该缓存。

@Cacheable注解更详细的用法请参考文章：[neilian ids=14140]