如何在javax.swing.filechooser的WindowsFileSystemView实现文件名输入过滤

要实现类似Word/Excel的文件名输入联想功能，核心是监听文件名输入框的文本变化，实时筛选当前目录下匹配前缀的文件并展示下拉列表，具体实现步骤如下：

1. 获取文件名输入框 #

JFileChooser的UI组件中包含一个用于输入文件名的JTextField，我们需要先定位到这个组件。针对Windows平台的WindowsFileChooserUI，可以通过反射或组件树遍历的方式获取：

private JTextField getFileNameTextField(JFileChooser fileChooser) {
    FileChooserUI ui = fileChooser.getUI();
    if (ui instanceof WindowsFileChooserUI) {
        try {
            Method method = WindowsFileChooserUI.class.getDeclaredMethod("getFileNameTextField");
            method.setAccessible(true);
            return (JTextField) method.invoke(ui);
        } catch (Exception e) {
            // 反射失败则遍历组件树查找
            return findFileNameTextField(fileChooser);
        }
    }
    return findFileNameTextField(fileChooser);
}

// 通用组件树遍历查找方法
private JTextField findFileNameTextField(Component parent) {
    if (parent instanceof JTextField && "FileNameTextField".equals(parent.getName())) {
        return (JTextField) parent;
    }
    if (parent instanceof Container) {
        for (Component child : ((Container) parent).getComponents()) {
            JTextField field = findFileNameTextField(child);
            if (field != null) {
                return field;
            }
        }
    }
    return null;
}

2. 监听文本变化并实时筛选文件 #

给输入框添加DocumentListener，每次文本变更时，获取当前输入的前缀，筛选当前目录下符合前缀匹配的文件（支持大小写不敏感），并将结果展示在输入框下方的下拉菜单中：

private void setupAutoComplete(JFileChooser fileChooser) {
    JTextField fileNameField = getFileNameTextField(fileChooser);
    if (fileNameField == null) return;

    JPopupMenu popupMenu = new JPopupMenu();
    fileNameField.getDocument().addDocumentListener(new DocumentListener() {
        @Override
        public void insertUpdate(DocumentEvent e) {
            updatePopup(fileChooser, fileNameField, popupMenu);
        }

        @Override
        public void removeUpdate(DocumentEvent e) {
            updatePopup(fileChooser, fileNameField, popupMenu);
        }

        @Override
        public void changedUpdate(DocumentEvent e) {
            updatePopup(fileChooser, fileNameField, popupMenu);
        }
    });

    // 点击下拉项自动填充文件名
    popupMenu.addMouseListener(new MouseAdapter() {
        @Override
        public void mouseClicked(MouseEvent e) {
            if (e.getSource() instanceof JMenuItem) {
                String fileName = ((JMenuItem) e.getSource()).getText();
                fileNameField.setText(fileName);
                popupMenu.setVisible(false);
            }
        }
    });
}

private void updatePopup(JFileChooser fileChooser, JTextField fileNameField, JPopupMenu popupMenu) {
    String prefix = fileNameField.getText().trim();
    popupMenu.removeAll();

    if (prefix.isEmpty()) {
        popupMenu.setVisible(false);
        return;
    }

    File currentDir = fileChooser.getCurrentDirectory();
    if (currentDir == null || !currentDir.isDirectory()) {
        popupMenu.setVisible(false);
        return;
    }

    // 筛选以输入前缀开头的文件（大小写不敏感）
    File[] files = currentDir.listFiles((dir, name) -> name.toLowerCase().startsWith(prefix.toLowerCase()));
    if (files == null || files.length == 0) {
        popupMenu.setVisible(false);
        return;
    }

    // 将匹配的文件名添加到下拉菜单
    for (File file : files) {
        JMenuItem item = new JMenuItem(file.getName());
        popupMenu.add(item);
    }

    // 在输入框下方展示下拉菜单
    popupMenu.show(fileNameField, 0, fileNameField.getHeight());
}

3. 使用改造后的文件选择器 #

创建JFileChooser实例后，调用上述方法启用自动完成功能即可：

JFileChooser fileChooser = new JFileChooser();
setupAutoComplete(fileChooser);

int result = fileChooser.showOpenDialog(null);
if (result == JFileChooser.APPROVE_OPTION) {
    File selectedFile = fileChooser.getSelectedFile();
    // 处理选中的文件逻辑
}

注意事项 #

• 上述代码针对Windows平台优化，若需跨平台使用，可调整组件查找逻辑以兼容其他FileChooserUI实现
• 若需要支持模糊匹配（如包含前缀而非仅开头），只需修改文件筛选的Lambda表达式即可
• 可扩展支持文件夹的前缀匹配，在listFiles的过滤条件中添加目录判断

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