如何解决Windows与macOS间Java文件选择器的类转换异常？

核心问题 #

Windows环境下的OpenJDK不包含macOS专属的com.apple.laf.AquaFileChooserUI类，直接在代码中引用会导致编译失败；而macOS上BasicFileChooserUI与AquaFileChooserUI无继承关系，强制类型转换会抛出ClassCastException。

解决办法 #

1. 使用Swing标准API替代直接操作UI（推荐）

优先使用JFileChooser的公开API间接更新文件名输入框，完全跨平台且无需依赖平台特定UI类：

if (fileName != null && !fileName.isEmpty()) {
    Utilities.invokeLater(() -> {
        // 通过设置选中文件同步更新文件名输入框
        setSelectedFile(new File(fileName));
    });
}

优点：符合Swing设计规范，无平台依赖，代码简洁稳定。

2. 反射动态调用setFileName方法

通过反射绕过编译时的类依赖，直接调用UI实例的setFileName方法：

import java.lang.reflect.Method;

// ...

if (fileName != null && !fileName.isEmpty()) {
    Utilities.invokeLater(() -> {
        Object uiInstance = getUI();
        try {
            Method setFileNameMethod = uiInstance.getClass()
                .getMethod("setFileName", String.class);
            setFileNameMethod.invoke(uiInstance, fileName);
        } catch (NoSuchMethodException | IllegalAccessException | InvocationTargetException e) {
            // 处理方法不存在或调用失败的场景，如日志记录或降级处理
            e.printStackTrace();
        }
    });
}

优点：无需判断操作系统，自动适配所有提供setFileName方法的UI实现；避免编译时依赖平台类。

3. 按系统分支动态加载类

保留系统判断逻辑，但通过Class.forName动态加载macOS专属UI类，避免Windows编译报错：

import java.lang.reflect.Method;

// ...

if (fileName != null && !fileName.isEmpty()) {
    val osType = doPrivileged(getOSTypeAction());
    Utilities.invokeLater(() -> {
        Object uiInstance = getUI();
        if (osType == WINDOWS || osType == LINUX) {
            ((BasicFileChooserUI) uiInstance).setFileName(fileName);
        } else if (osType == MACOSX) {
            try {
                Class<?> aquaUIClass = Class.forName("com.apple.laf.AquaFileChooserUI");
                Method setFileNameMethod = aquaUIClass.getMethod("setFileName", String.class);
                setFileNameMethod.invoke(uiInstance, fileName);
            } catch (Exception e) {
                e.printStackTrace();
            }
        }
    });
}

优点：保留原有逻辑结构，仅对macOS分支做动态处理；缺点是代码相对繁琐。

内容的提问来源于stack exchange，提问作者douglasf