基于Java模块的JavaFX对话框国际化解决方案咨询

在Java模块机制限制下，无法通过在自身模块创建同包资源文件覆盖官方翻译，以下是几种可行方案：

方案1：反射修改ControlResources的资源基础名 #

通过反射修改ControlResources类中的BASE_NAME常量，将其指向自定义的资源文件路径，从而让官方加载逻辑优先使用你的翻译。

实现代码 #

import com.sun.javafx.scene.control.skin.resources.ControlResources;
import java.lang.reflect.Field;

public class I18nInitializer {
    public static void overrideControlResources() {
        try {
            // 获取BASE_NAME字段
            Field baseNameField = ControlResources.class.getDeclaredField("BASE_NAME");
            baseNameField.setAccessible(true);
            // 替换为自定义资源文件的基础名（例如你的资源放在src/main/resources/my/controls下）
            baseNameField.set(null, "my/controls/custom_controls");
        } catch (NoSuchFieldException | IllegalAccessException e) {
            e.printStackTrace();
        }
    }
}

模块权限配置 #

由于涉及访问JavaFX内部包，需在模块声明或运行时参数中开放权限：

• 在module-info.java中添加：

  opens my.controls to javafx.controls;
  opens com.sun.javafx.scene.control.skin.resources to 你的模块名称;
  

• 或运行时添加JVM参数：

  --add-opens javafx.controls/com.sun.javafx.scene.control.skin.resources=你的模块名称
  

优缺点 #

• 优点：全局生效，无需修改每个对话框的使用逻辑
• 缺点：依赖JavaFX内部API，版本更新可能导致兼容性问题

方案2：自定义ResourceBundle.Control加载逻辑 #

通过自定义ResourceBundle.Control，改变资源包的加载顺序，优先加载你的自定义翻译， fallback到官方资源。

实现代码 #

import java.util.Locale;
import java.util.ResourceBundle;

public class CustomResourceControl extends ResourceBundle.Control {
    @Override
    public ResourceBundle newBundle(String baseName, Locale locale, String format, ClassLoader loader, boolean reload)
            throws IllegalAccessException, InstantiationException, java.io.IOException {
        // 先尝试加载自定义资源
        ResourceBundle customBundle = super.newBundle("my/controls/custom_controls", locale, format, loader, reload);
        if (customBundle != null) {
            return customBundle;
        }
        // 自定义资源不存在时，加载官方资源
        return super.newBundle(baseName, locale, format, loader, reload);
    }
}

在应用启动时设置默认控制类：

public class Main extends Application {
    @Override
    public void start(Stage primaryStage) {
        ResourceBundle.setDefaultControl(new CustomResourceControl());
        // 后续对话框将自动使用自定义翻译
    }
}

优缺点 #

• 优点：不依赖内部API反射，全局生效
• 缺点：会影响所有ResourceBundle的加载逻辑，需确保资源查找逻辑不会冲突

方案3：自定义对话框Skin替换按钮文本 #

针对每个对话框类型，自定义Skin类，在初始化时手动替换按钮的文本为你的国际化翻译，避免依赖内部资源加载逻辑。

实现代码（以Alert为例） #

import javafx.scene.control.Alert;
import javafx.scene.control.ButtonType;
import javafx.scene.control.skin.AlertSkin;

public class LocalizedAlertSkin extends AlertSkin {
    public LocalizedAlertSkin(Alert alert) {
        super(alert);
        // 遍历所有按钮类型，替换文本
        alert.getButtonTypes().forEach(buttonType -> {
            alert.getDialogPane().lookupButton(buttonType).setText(
                    // 从你的国际化工具类获取对应文本
                    I18nUtil.getMessage("dialog.button." + buttonType.name())
            );
        });
    }
}

使用时为Alert设置自定义Skin：

Alert confirmAlert = new Alert(Alert.AlertType.CONFIRMATION);
confirmAlert.setSkin(new LocalizedAlertSkin(confirmAlert));

优缺点 #

• 优点：安全稳定，不依赖内部API，支持局部自定义
• 缺点：需要为每个对话框类型编写对应的Skin类，代码量较大

内容的提问来源于stack exchange，提问作者Petr Štechmüller