Apache NetBeans平台国际化中的Bundle加载机制问题分析

问题背景

在Apache NetBeans 23版本中，存在一个长期未解决的国际化问题。该问题涉及平台核心模块org-netbeans-swing-tabcontrol中的按钮提示文本无法正确加载品牌化(branding)覆盖层提供的本地化资源。

技术细节

问题根源在于TabControlButtonFactory.java文件中直接使用了java.util.ResourceBundle.getBundle()方法来加载资源包，而不是采用NetBeans平台推荐的NbBundle.getMessage()方法。这种硬编码的资源加载方式绕过了NetBeans平台的国际化机制，导致无法识别和应用品牌化覆盖层提供的本地化资源。

具体来说，在TabControlButtonFactory类中有多处类似以下的代码：

button.setToolTipText(java.util.ResourceBundle.getBundle("org/netbeans/swing/tabcontrol/plaf/Bundle").getString("Tip_Scroll_Documents_Right"));

影响范围

这个问题影响了多个按钮提示文本的本地化，包括但不限于：

• 文档标签滚动按钮的提示文本
• 最大化/最小化按钮的提示文本
• 关闭按钮的提示文本

解决方案

正确的做法应该是使用NetBeans平台提供的NbBundle类来加载资源，例如：

button.setToolTipText(NbBundle.getMessage(TabControlButtonFactory.class, "Tip_Scroll_Documents_Right"));

这种方式的优势在于：

1. 完全遵循NetBeans平台的国际化机制
2. 能够正确识别和应用品牌化覆盖层提供的本地化资源
3. 提供更好的性能，因为NbBundle会缓存资源包

开发者启示

这个问题给开发者带来的重要启示是：在使用国际化资源时，应该始终遵循平台提供的标准机制，而不是直接使用Java基础库中的方法。特别是在像NetBeans这样的大型平台中，各种扩展机制(如品牌化覆盖层)都是建立在标准API之上的，绕过这些API会导致功能无法正常工作。

修复情况

该问题已在最新代码中得到修复，所有直接使用ResourceBundle.getBundle()的地方都已替换为NbBundle.getMessage()。这一改动确保了品牌化覆盖层中的本地化资源能够被正确加载和应用，提高了平台的国际化支持能力。