Hibernate二级缓存ehcache.xml配置文件怎么写

月夜之吻
发布: 2025-12-12 12:17:02
原创
667人浏览过
ehcache.xml 是 Ehcache 1.x/2.x 的 XML 配置文件,需置于 classpath 根目录;Hibernate 4.x/5.2- 依赖它实现二级缓存,而 Hibernate 5.3+ 推荐 JCache 抽象层。

hibernate二级缓存ehcache.xml配置文件怎么写

<p>ehcache.xml 是 Ehcache 1.x(常用于老版本 Hibernate,如 4.x)的缓存配置文件,放在 <strong>classpath 根目录</strong>(如 src/main/resources)下即可被 Hibernate 自动加载。注意:Ehcache 2.x 仍兼容此格式;Ehcache 3.x 已弃用 XML 配置,改用 Java 或 YAML,且 Hibernate 5.3+ 默认推荐使用 JCache(JSR-107)抽象层。</p>

<H3>基础 ehcache.xml 结构(适配 Hibernate 4.x / 5.2 及以下)</H3>
<p>以下是最简可用、符合 Hibernate 二级缓存要求的配置示例:</p>
<pre class="brush:php;toolbar:false;"><font size="2"><?xml version="1.0" encoding="UTF-8"?>
<ehcache xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="ehcache.xsd">

  <!-- 磁盘缓存路径,需确保应用有写权限 -->
  <diskStore path="java.io.tmpdir/ehcache"/>

  <!-- 默认缓存策略(Hibernate 未显式指定缓存策略时使用)-->
  <defaultCache
      maxEntriesLocalHeap="1000"
      eternal="false"
      timeToIdleSeconds="300"
      timeToLiveSeconds="600"
      overflowToDisk="true"
      diskPersistent="false"
      diskExpiryThreadIntervalSeconds="120"
      memoryStoreEvictionPolicy="LRU"/>

  <!-- 为具体实体类或集合配置缓存(必须)-->
  <cache name="com.example.User"
      maxEntriesLocalHeap="500"
      eternal="false"
      timeToIdleSeconds="60"
      timeToLiveSeconds="300"
      overflowToDisk="true"/>

  <!-- 缓存集合(如 User.roles)-->
  <cache name="com.example.User.roles"
      maxEntriesLocalHeap="100"
      eternal="false"
      timeToIdleSeconds="30"
      timeToLiveSeconds="120"
      overflowToDisk="true"/>

</ehcache></font>
登录后复制

关键配置项说明

  • diskStore path:建议用 java.io.tmpdir/ehcache 或绝对路径(如 /var/cache/myapp/ehcache),避免硬编码用户目录
  • maxEntriesLocalHeap:堆内最大缓存条目数,避免 OOM;按实体热度合理设置,不要盲目调大
  • eternal="false":必须设为 false,否则 timeToIdleSeconds / timeToLiveSeconds 不生效
  • timeToIdleSeconds:对象空闲多久后过期(不被访问)
  • timeToLiveSeconds:对象创建后多久强制过期(不管是否访问)
  • overflowToDisk:堆满后是否溢出到磁盘(开启需确保 diskStore 可写)
  • cache name:必须与实体类全限定名(package.ClassName)或集合属性路径(package.ClassName.propertyName)完全一致

Hibernate 端需配合的配置

仅配置 ehcache.xml 不够,还需在 Hibernate 配置中启用二级缓存:

NNiji·Journey
NNiji·Journey

二次元风格绘画生成器,由 Spellbrush 与 Midjourney 共同设计开发

NNiji·Journey 61
查看详情 NNiji·Journey
  • hibernate.cfg.xml 或 application.properties 中添加:
<font size="2"><property name="hibernate.cache.use_second_level_cache">true</property>
<property name="hibernate.cache.region.factory_class">org.hibernate.cache.ehcache.EhCacheRegionFactory</property>
<!-- 或用 SingletonEhCacheRegionFactory(单例模式,适合单应用)--></font>
登录后复制
  • 实体类上标注缓存策略:
<font size="2">@Entity
@Cache(usage = CacheConcurrencyStrategy.READ_WRITE) // 或 READ_ONLY, NONSTRICT_READ_WRITE
public class User { ... }</font>
登录后复制

常见问题提醒

  • 类名拼写错误(大小写、包名)、集合路径写成 User.roles 而非 com.example.User.roles → 缓存不生效
  • 忘记在实体类加 @Cache 注解 → 即使配置了 cache name 也无效
  • Ehcache jar 版本与 Hibernate 不匹配(如 Hibernate 4.3.x 应用 ehcache-core 2.6.x,不兼容 3.x)
  • 未设置 hibernate.cache.use_second_level_cache=true → 二级缓存被忽略

基本上就这些。配置不复杂但容易忽略细节,建议配完后通过日志(开启 org.hibernate.cache DEBUG)验证缓存命中情况。

以上就是Hibernate二级缓存ehcache.xml配置文件怎么写的详细内容,更多请关注php中文网其它相关文章!

最佳 Windows 性能的顶级免费优化软件
最佳 Windows 性能的顶级免费优化软件

每个人都需要一台速度更快、更稳定的 PC。随着时间的推移,垃圾文件、旧注册表数据和不必要的后台进程会占用资源并降低性能。幸运的是,许多工具可以让 Windows 保持平稳运行。

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号