search.png
关于我
menu.png
超实用的Ehcache的工具类

收录于墨的2020~2021开发经验总结

这个工具类最早是在网络上找的,现在已经找不到出处了,后边自己改了很多地方,也加了很多新的东西。

现在将其公开出来,希望对大家有用。

需要导入包:

    compile 'org.ehcache:ehcache'

maven的话是,这个版本用2的、3的都可以:

<!-- https://mvnrepository.com/artifact/org.ehcache/ehcache -->
<dependency>
    <groupId>org.ehcache</groupId>
    <artifactId>ehcache</artifactId>
    <version>3.9.4</version>
</dependency>

主要包括两个类,一个是默认配置的接口,一个是操作缓存的常用方法的封装。

Ehcache2Config 类:

/**
 * Ehcache2Config
 *
 * @author hengyumo
 * @version 1.0
 * @since 2019/9/9
 */
public interface Ehcache2Config {

    /**
     * 内存中最大的缓存对象数量
     */
    int MAX_ELEMENTS_IN_MEMORY = 500;

    /**
     * 是否把溢出数据持久化到硬盘
     */
    boolean OVER_FLOW_TO_DISK = true;

    /**
     * 是否永久存活
     */
    boolean ETERNAL = false;

    /**
     * 缓存空闲多久后失效/秒
     */
    int TIME_TO_IDLE_SECONDS = 600;

    /**
     * 缓存最多存活时间/秒
     */
    int TIME_TO_LIVE_SECONDS = 1800;

    /**
     * 是否需要持久化到硬盘
     */
    boolean DISK_PERSISTENT = false;

    /**
     * 缓存策略
     */
    String MEMORY_STORE_EVICTION_POLICY = "LFU";

    /**
     * 默认的cacheName
     */
    String DEFAULT_CACHE = "cache";
}

Ehcache2Cache 类:


import net.sf.ehcache.Cache;
import net.sf.ehcache.CacheManager;
import net.sf.ehcache.Element;
import net.sf.ehcache.config.CacheConfiguration;
import org.springframework.data.util.Pair;

import java.util.ArrayList;
import java.util.List;
import java.util.Optional;


/**
 * ehcache工具类
 */
public class Ehcache2Cache implements Ehcache2Config {

    private static CacheManager cacheManager = null;
    private static Cache cache = null;

    static {
        initCacheManager();
        initCache();
    }

    /**
     * 初始化缓存管理容器
     */
    public static CacheManager initCacheManager() {
        try {
            if (cacheManager == null) {
                cacheManager = CacheManager.getInstance();
            }
        } catch (RuntimeException e) {
            e.printStackTrace();
        }
        return cacheManager;
    }

    /**
     * 初始化缓存管理容器
     *
     * @param path ehcache.xml存放的路徑
     */
    public static CacheManager initCacheManager(String path) {
        try {
            if (cacheManager == null) {
                CacheManager.getInstance();
                cacheManager = CacheManager.create(path);
            }
        } catch (RuntimeException e) {
            e.printStackTrace();
        }
        return cacheManager;
    }


    /**
     * 初始化cache
     */
    public static Cache initCache() {
        return initCache(DEFAULT_CACHE);
    }

    /**
     * 获取cache
     */
    public static Cache initCache(String cacheName) {
        checkCacheManager();
        if (null == cacheManager.getCache(cacheName)) {
            cacheManager.addCache(cacheName);
        }
        cache = cacheManager.getCache(cacheName);
        return cache;
    }

    /**
     * 添加缓存
     *
     * @param key   关键字
     * @param value 值
     */
    public static void put(Object key, Object value) {
        checkCache();
        // 创建Element,然后放入Cache对象中
        Element element = new Element(key, value);
        cache.put(element);
    }

    /**
     * 获取cache
     *
     * @param key 关键字
     * @return value
     */
    public static Object get(Object key) {
        checkCache();
        Element element = cache.get(key);
        if (null == element) {
            return null;
        }
        return element.getObjectValue();
    }

    /**
     * 初始化缓存
     *
     * @param cacheName           缓存名称
     * @param maxElementsInMemory 元素最大数量
     * @param overflowToDisk      是否持久化到硬盘
     * @param eternal             是否永远存活
     * @param timeToLiveSeconds   缓存存活时间
     * @param timeToIdleSeconds   缓存的间隔时间
     * @return cache 缓存
     * @throws RuntimeException e
     */
    public static Cache initCache(String cacheName, int maxElementsInMemory,
                                  boolean overflowToDisk, boolean eternal,
                                  long timeToLiveSeconds, long timeToIdleSeconds)
            throws RuntimeException {

        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache != null) {
                CacheConfiguration config = cache.getCacheConfiguration();
                config.setTimeToLiveSeconds(timeToLiveSeconds);
                config.setMaxEntriesLocalHeap(maxElementsInMemory);
                config.setOverflowToDisk(overflowToDisk);
                config.setEternal(eternal);
                config.setTimeToIdleSeconds(timeToIdleSeconds);
            }
            if (myCache == null) {
                Cache memoryOnlyCache = new Cache(cacheName, maxElementsInMemory,
                        overflowToDisk, eternal, timeToLiveSeconds, timeToIdleSeconds);
                cacheManager.addCache(memoryOnlyCache);
                myCache = cacheManager.getCache(cacheName);
            }
            return myCache;
        } catch (RuntimeException e) {
            throw new RuntimeException("init cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 初始化cache
     *
     * @param cacheName         cache的名字
     * @param timeToLiveSeconds 有效时间
     * @return cache 缓存
     * @throws RuntimeException e
     */
    public static Cache initCache(String cacheName, long timeToLiveSeconds) throws RuntimeException {
        return initCache(cacheName, MAX_ELEMENTS_IN_MEMORY, OVER_FLOW_TO_DISK,
                ETERNAL, timeToLiveSeconds, TIME_TO_IDLE_SECONDS);
    }

    /**
     * 初始化Cache
     *
     * @param cacheName cache容器名
     * @return cache容器
     * @throws RuntimeException e
     */
    public static Cache initMyCache(String cacheName) throws RuntimeException {
        return initCache(cacheName, TIME_TO_LIVE_SECONDS);
    }

    /**
     * 修改缓存容器配置
     *
     * @param cacheName           缓存名
     * @param timeToLiveSeconds   有效时间
     * @param maxElementsInMemory 最大数量
     * @throws RuntimeException e
     */
    public static boolean modifyCache(String cacheName, long timeToLiveSeconds, int maxElementsInMemory) throws RuntimeException {
        try {
            if (cacheName != null && !"".equals(cacheName)
                    && timeToLiveSeconds != 0L && maxElementsInMemory != 0) {
                Cache myCache = cacheManager.getCache(cacheName);
                CacheConfiguration config = myCache.getCacheConfiguration();
                config.setTimeToLiveSeconds(timeToLiveSeconds);
                config.setMaxEntriesLocalHeap(maxElementsInMemory);
                return true;
            } else {
                return false;
            }
        } catch (RuntimeException e) {
            throw new RuntimeException("modify cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 向指定容器中设置值
     *
     * @param cacheName 容器名
     * @param key       键
     * @param value     值
     * @return 返回真
     * @throws RuntimeException e
     */

    public static boolean setValue(String cacheName, String key, Object value) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                myCache = initCache(cacheName);
            }
            myCache.put(new Element(key, value));
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("set cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 向指定容器中设置值
     *
     * @param cacheName         容器名
     * @param key               键
     * @param value             值
     * @param timeToLiveSeconds 存活时间
     * @return 真
     * @throws RuntimeException e
     */
    public static boolean setValue(String cacheName, String key, Object value, Integer timeToLiveSeconds) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                initCache(cacheName, timeToLiveSeconds);
                myCache = cacheManager.getCache(cacheName);
            }
            myCache.put(new Element(key, value, timeToLiveSeconds, timeToLiveSeconds));
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("set cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 从ehcache的指定容器中取值
     *
     * @param key 键
     * @return 返回Object类型的值
     * @throws RuntimeException e
     */
    public static Object getValue(String cacheName, String key) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                myCache = initMyCache(cacheName);
            }
            Element element = myCache.get(key);
            return element == null ? null : element.getObjectValue();
        } catch (RuntimeException e) {
            throw new RuntimeException("get cache " + cacheName + " value failed!!!");
        }
    }

    /**
     * 从ehcache的指定容器中取值,并获取标识位,标识是否缓存中存在这个Key
     * 该设计是为了避免空值时出现缓存穿透的可能
     *
     * @param key 键
     * @return 返回Object类型的值
     * @throws RuntimeException e
     */
    public static Pair<Boolean, Optional<?>> getValueWithState(String cacheName, String key) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                myCache = initMyCache(cacheName);
            }
            Element element = myCache.get(key);
            boolean cacheContainsKey = element != null;
            Object value = cacheContainsKey ? element.getObjectValue() : null;
            return Pair.of(cacheContainsKey, Optional.ofNullable(value));
        } catch (RuntimeException e) {
            throw new RuntimeException("get cache " + cacheName + " value failed!!!");
        }
    }

    /**
     * 删除指定的ehcache容器
     *
     * @param cacheName cacheName
     * @return 真
     * @throws RuntimeException e
     */

    public static boolean removeCache(String cacheName) throws RuntimeException {
        try {
            cacheManager.removeCache(cacheName);
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("remove cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 删除所有的ehcache容器
     *
     * @return 返回真
     * @throws RuntimeException e
     */

    public static boolean removeAllCache() throws RuntimeException {
        try {
            cacheManager.removeAllCaches();
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("remove cache failed!!!");
        }
    }

    /**
     * 删除ehcache容器中的元素
     *
     * @param cacheName 容器名
     * @param key       键
     * @return 真
     * @throws RuntimeException e
     */
    public static boolean removeElement(String cacheName, String key) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            myCache.remove(key);
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("remove cache " + cacheName + " failed!!!");
        }
    }

    /**
     * 删除指定容器中的所有元素
     *
     * @param cacheName 容器名
     * @param key       键
     * @return 真
     * @throws RuntimeException e
     */
    public static boolean removeAllElement(String cacheName, String key) throws RuntimeException {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            myCache.removeAll();
            return true;
        } catch (RuntimeException e) {
            throw new RuntimeException("remove cache failed!!!");
        }
    }

    /**
     * 释放CacheManage
     */
    public static void shutdown() {
        cacheManager.shutdown();
    }

    /**
     * 移除默认cache
     */
    public static void removeCache() {
        checkCacheManager();
        if (null != cache) {
            cacheManager.removeCache(DEFAULT_CACHE);
        }
        cache = null;
    }

    /**
     * 移除默认cache中的key
     *
     * @param key key
     */
    public static void remove(String key) {
        checkCache();
        cache.remove(key);
    }

    /**
     * 移除默认cache所有Element
     */
    public static void removeAllKey() {
        checkCache();
        cache.removeAll();
    }

    /**
     * 获取所有的cache名称
     *
     * @return String[]
     */
    public static String[] getAllCaches() {
        checkCacheManager();
        return cacheManager.getCacheNames();
    }

    /**
     * 获取Cache所有的Keys
     *
     * @return List
     */
    public static List<?> getKeys() {
        checkCache();
        return cache.getKeys();
    }

    /**
     * 获取Cache所有的Keys
     *
     * @return List
     */
    public static List<?> getKeys(String cacheName) {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                return new ArrayList<>();
            }
            return myCache.getKeys();
        } catch (RuntimeException e) {
            throw new RuntimeException("get cache " + cacheName + " value failed!!!");
        }
    }

    /**
     * 判断缓存是否存在该Key
     *
     * @param cacheName 缓存名称
     * @param key       key
     * @return true存在
     */
    public static boolean containsKey(String cacheName, String key) {
        try {
            Cache myCache = cacheManager.getCache(cacheName);
            if (myCache == null) {
                return false;
            }
            Element element = myCache.get(key);
            return element != null;
        } catch (RuntimeException e) {
            throw new RuntimeException("get cache " + cacheName + " value failed!!!");
        }
    }

    /**
     * 检测cacheManager
     */
    private static void checkCacheManager() {
        if (null == cacheManager) {
            throw new IllegalArgumentException("调用前请先初始化CacheManager值:initCacheManager");
        }
    }

    /**
     * 检测cache
     */
    private static void checkCache() {
        if (null == cache) {
            throw new IllegalArgumentException("调用前请先初始化Cache值:initCache(参数)");
        }
    }

    /**
     * 输出cache信息
     */
    public static void showCache() {
        String[] cacheNames = cacheManager.getCacheNames();
        System.out.println("缓存的key cacheNames length := "
                + cacheNames.length + " 具体详细列表如下:");
        for (String cacheName : cacheNames) {
            System.out.println("cacheName := " + cacheName);
            Cache cache = cacheManager.getCache(cacheName);
            List<?> cacheKeys = cache.getKeys();
            for (Object key : cacheKeys) {
                System.out.println(key + " = " + cache.get(key));
            }
        }
    }

    public static void main(String[] arg) {
        put("A", "AAAAA");
        put("B", "BBBBB");
        put("F", "FFFFF");
        System.out.println(get("F"));
        List<?> keys = getKeys();
        for (Object key : keys) {
            System.out.println(key);
        }
        shutdown();
    }
}

ehcache.xml,放置到resources文件夹下:

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


<ehcache name="HIBERNATE_CACHE" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="http://www.ehcache.org/ehcache.xsd"
         updateCheck="false" monitoring="autodetect" dynamicConfig="true">

    <diskStore path="java.io.tmpdir"/>

    <transactionManagerLookup
            class="net.sf.ehcache.transaction.manager.DefaultTransactionManagerLookup"
            properties="jndiName=java:/TransactionManager"
            propertySeparator=";"/>

    <defaultCache
            maxEntriesLocalHeap="500"
            eternal="false"
            timeToIdleSeconds="1800"
            timeToLiveSeconds="3600">
        <!--<terracotta/>-->
    </defaultCache>

    <!-- 基础缓存 -->
    <cache name="baseCache"
           maxEntriesLocalHeap="1000"
           maxEntriesLocalDisk="2000"
           eternal="false"
           diskSpoolBufferSizeMB="20"
           timeToIdleSeconds="300"
           timeToLiveSeconds="3600"
           memoryStoreEvictionPolicy="LFU"
           transactionalMode="off">
        <persistence strategy="localTempSwap"/>
    </cache>

    <!-- 永久缓存 -->
    <cache name="eternalCache"
           maxEntriesLocalHeap="200"
           maxElementsOnDisk="300"
           eternal="true"
           memoryStoreEvictionPolicy="LFU"
           transactionalMode="off">
        <persistence strategy="localTempSwap"/>
    </cache>

    <!-- 语句结果缓存 -->
    <cache name="default-query-results-region"
           maxEntriesLocalHeap="1000"
           eternal="false"
           memoryStoreEvictionPolicy="LFU"
           timeToLiveSeconds="120">
        <persistence strategy="localTempSwap"/>
    </cache>

    <cache name="org.hibernate.cache.spi.TimestampsCache"
           maxEntriesLocalHeap="5000"
           eternal="true">
        <persistence strategy="localTempSwap"/>
    </cache>

</ehcache>

版权声明

知识共享许可协议 本文章由作者“衡于墨”创作,转载请注明出处,未经允许禁止用于商业用途

本作品采用 知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议 进行许可。
发布时间:2021年06月13日 21:24:31

评论区#

还没有评论哦,期待您的评论!

关闭特效