ResourceBundle.Control 是 Java 资源加载链中唯一可定制“查找、解析、缓存”行为的核心钩子,需在无法热更新 properties、需支持 YAML/JSON、或需精确控制缓存时自定义;必须重写 getCandidateLocales、getFormats、newBundle 三个方法,并合理实现缓存与编码处理。
ResourceBundle.Control 是什么,什么时候必须自定义它
当你发现
总是加载不到你改过的 .properties 文件,或者想支持 .yml/.json 格式的资源文件,又或者需要控制缓存时间(比如开发时热更新),这时候就得用
。它不是用来“增强功能”的装饰器,而是 Java 资源加载链里唯一能插手“怎么找文件”“怎么解析内容”“缓存多久”的钩子。
常见错误现象:
– 修改了
,重启前一直用旧值
– 用
却加载了
而非预期的
– 想让资源支持 UTF-8 BOM 或带注释的 YAML,但默认只认 ISO-8859-1 编码的 .properties
继承 ResourceBundle.Control 时必须重写的三个方法
别只重写
就以为搞定了——Java 的资源查找流程会依次调用这三个方法,漏掉任一都可能跳过你的逻辑:
:决定按什么顺序尝试匹配文件名,比如要不要先试
再试
,甚至加个
:返回支持的后缀列表,如
;注意返回空或 null 会导致整个 bundle 加载失败
:真正读取并解析资源的地方;
表示本次是强制刷新(比如开发模式下),你要在这里重新读磁盘、跳过缓存
关键细节:
–
必须返回非 null 的
实例,否则流程中断
– 不要在这个方法里做耗时操作(如远程拉配置),它在每次
调用时都执行
– 如果你返回的是自定义子类(比如
),它必须继承
并实现
立即学习
“
Java免费学习笔记(深入)
”;
缓存控制:setCacheDuration() 和 reload 参数的真实作用
很多人以为调用
就能立刻生效,其实它只清本地线程/ClassLoader 级缓存,而
的缓存策略才是源头。
Eclipse导入Android或其他的JAVA项目的正确方法 WORD版
本文档主要讲述的是Eclipse导入Android或其他的JAVA项目的正确方法;希望本文档会给有需要的朋友带来帮助;感兴趣的朋友可以过来看看
下载
正确做法是:在
中根据
参数决定是否绕过缓存;同时用
的子类覆盖
方法:
返回
:永不缓存(每次调用都走
)
返回
:缓存但不过期(等同于默认行为)
返回正数(毫秒):比如
表示最多缓存 5 秒,超时后下次访问自动触发
性能影响:
– 设为 -1 在生产环境会显著拖慢国际化调用,尤其高频页面
–
返回值对同一个
组合全局生效,不能按 key 动态调整
– 注意 JVM 参数
会全局覆盖,慎用
自定义格式支持:.yml / .json 的实际落地难点
支持 YAML 或 JSON 不是改个后缀就行。Java 默认只内置
和
,其他格式必须自己解析并构造
映射。
实操建议:
不要在
里直接用
—— 它没做线程安全封装,高并发下容易出错;改用预构建的静态实例
YAML 的嵌套结构(如
)需扁平化为单层 key,否则
找不到
JSON 不支持注释,但 .properties 支持
行;如果你的团队习惯写中文注释,转 JSON 后这部分信息就丢了
编码问题最常踩坑:YAML/JSON 文件保存为 UTF-8 无 BOM,但某些编辑器(如老版 Notepad)默认加 BOM,
会把它当非法字符抛
真正难的不是读文件,而是让所有已有代码无感切换——比如 Spring 的
底层也调
,只要你的
注册得早,它就自动生效;但如果项目混用了
直接读流,那这部分就得单独适配。
ResourceBundle.getBundle()ResourceBundle.Controlmessages_zh_CN.propertiesgetBundle("messages", Locale.CHINA)messages.propertiesmessages_zh_CN.propertiesgetCandidateLocales()getCandidateLocales(String baseName, Locale locale)messages_zh_CNmessages_zhmessages_devgetFormats(String baseName)Arrays.asList("xml", "properties")newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload)reload == truenewBundle()ResourceBundlegetBundle()YamlResourceBundleResourceBundlehandleGetObject()ResourceBundle.clearCache()ResourceBundle.ControlnewBundle()reloadControl.INSTANCEgetCacheDuration()-1newBundle()05_000newBundle(..., true)getCacheDuration()baseName + locale + format-Djava.util.ResourceBundle.control=xxxPropertiesResourceBundleListResourceBundlekey → valuenewBundle()new ObjectMapper()error.login.failedbundle.getString("error.login.failed")#InputStreamReaderMalformedInputExceptionMessageSourceResourceBundle.getBundle()ControlClassPathResource