Swing中JTable自定义TableCellRenderer后无法选中行的问题

我正在开发一款待办清单应用，使用JTable（仅一列）展示所有任务，同时为JTable添加了RowFilter以根据不同类别筛选任务。我创建了实现TableCellRenderer的类，仅显示任务名称和任务截止日期的剩余天数。但现在遇到问题：用户无法点击选中任何行，也无法通过Ctrl+点击选择多个任务，自定义的选中逻辑也未生效——点击单元格时本该输出行列索引的数组，但没有任何输出。

package com.daniel.todolist.gui.todolist_components;

import javax.swing.*;
import javax.swing.table.AbstractTableModel;
import javax.swing.table.TableCellRenderer;
import javax.swing.table.TableRowSorter;

import java.awt.*;
import java.awt.event.*;
import java.util.stream.*;
import com.daniel.todolist.db_objs.*;
import java.util.*;

public class ContentPage extends JPanel {
    private java.util.List<Task> tasks;
    private JTable tasksTable;
    private TableRowSorter<MyTableModel> sorter;
    private boolean pressingCTRL = false;
    private KeyListener keyListener;
    private MouseAdapter tableMouseListener;
    Vector selectedCells = new Vector<int[]>();

    public ContentPage(java.util.List<Task> tasks) {
        super();
        this.tasks = tasks;
        setBackground(Color.white);
        setupContentPage();
    }

    public void setupContentPage(){
        MyTableModel model = new MyTableModel();    // 自定义表格模型
        tasksTable = new JTable(model);
        tasksTable.setDefaultRenderer(Task.class, new TaskCellRenderer());
        sorter = new TableRowSorter<>(model);
        tasksTable.setRowSorter(sorter);
        // 初始化鼠标和键盘监听器
        something();
        tasksTable.addKeyListener(keyListener);
        tasksTable.addMouseListener(tableMouseListener);
        add(new JScrollPane(tasksTable));
    }

    // 实现行选择的方法（参考Stack Overflow问答）
    public void something(){

        keyListener = new KeyAdapter() {
            @Override
            public void keyPressed(KeyEvent e){
                if(e.getKeyCode() == KeyEvent.VK_CONTROL){
                    pressingCTRL = true;
                }
            }

            @Override
            public void keyReleased(KeyEvent e){
                if(e.getKeyCode() == KeyEvent.VK_CONTROL){
                    pressingCTRL = false;
                }
            }
        };

        tableMouseListener = new MouseAdapter() {
            @Override
            public void mouseClicked(MouseEvent e){
                if(pressingCTRL){   // 检查是否按住Ctrl键
                    int row = tasksTable.rowAtPoint(e.getPoint());
                    int col = tasksTable.columnAtPoint(e.getPoint());
                    int[] newEntry = new int[]{row, col};
                    // 打印选中的行列索引
                    System.out.println(newEntry);   // 无输出
                    if(selectedCells.contains(newEntry)){
                        selectedCells.remove(newEntry);
                    }
                    else{
                        selectedCells.add(newEntry);
                    }
                }
            }
        };
    }

    // 根据类别筛选表格的方法
    public void filterTable(String category){
        RowFilter<AbstractTableModel, Object> filter =  null;

        filter = new RowFilter<AbstractTableModel, Object>(){
            @Override 
            public boolean include(Entry<? extends AbstractTableModel, ? extends Object> entry){
                Task task = (Task) entry.getValue(0);
                if(category == "ASSIGNED"){
                    return task.getUserId() != task.getAssigned_by();
                }
                else if(category == "IMPORTANT"){
                    return task.getIsImportant();
                }
                else {
                    return true;
                }
            }
        };

        sorter.setRowFilter(filter);
    }
     

    // 自定义表格模型
    class MyTableModel extends AbstractTableModel {
        private String[] columnNames = {"Tasks"};
        // 将任务列表转为二维数组
        private Object[][] data = tasks.stream()
                                        .map(element -> new Object[]{element})
                                        .toArray(Object[][]::new);
        private Class<?>[] columnClasses = { Task.class };

        public String getColumnName(int c){
            return this.columnNames[c];
        }

        public int getColumnCount() {
            return this.columnNames.length;
        }

        public Object getValueAt(int row, int col) {
            return (Task) data[row][col];
        }

        public int getRowCount() {
            return this.data.length;
        }

        // JTable通过此方法获取单元格的默认渲染器
        public Class<?> getColumnClass(int c) { 
            return columnClasses[c];
        }
    }

}


class TaskCellRenderer extends JLabel implements TableCellRenderer {
    private Font labelFont = new Font("Dialog", Font.PLAIN, 17);

    public TaskPanel() {
        super();
    }

    public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus,
            int row, int column) {
                Task task = (Task) value;
                String text = task.getTaskName() + " | " + task.getDaysLeft();
                setText(text);
                return this;
    }
}

1. 自定义TableCellRenderer错误 #

• 构造函数名称错误：TaskCellRenderer的构造函数写成了TaskPanel()，导致实例化时调用默认构造函数，引发渲染异常。
• 未处理选中/焦点状态：Renderer未根据isSelected和hasFocus参数设置样式，视觉上无选中反馈，且JTable无法正确识别选中操作。
• 修复代码：

class TaskCellRenderer extends JLabel implements TableCellRenderer {
    private Font labelFont = new Font("Dialog", Font.PLAIN, 17);

    // 修正构造函数名称
    public TaskCellRenderer() {
        super();
        setOpaque(true); // 设置不透明，确保背景色生效
    }

    @Override
    public Component getTableCellRendererComponent(JTable table, Object value, boolean isSelected, boolean hasFocus,
            int row, int column) {
        Task task = (Task) value;
        String text = task.getTaskName() + " | " + task.getDaysLeft();
        setText(text);
        setFont(labelFont);

        // 根据选中状态设置样式
        if (isSelected) {
            setBackground(table.getSelectionBackground());
            setForeground(table.getSelectionForeground());
        } else {
            setBackground(table.getBackground());
            setForeground(table.getForeground());
        }
        // 处理焦点状态
        if (hasFocus) {
            setBorder(UIManager.getBorder("Table.focusCellHighlightBorder"));
        } else {
            setBorder(null);
        }
        return this;
    }
}

2. 鼠标事件监听问题 #

• 视图行与模型行混淆：使用TableRowSorter时，rowAtPoint返回的是视图行索引，若需操作模型数据需转换为模型行索引。
• 数组引用比较失效：Vector.contains(newEntry)永远返回false，因为数组是对象，contains用引用相等性判断，而非内容相等。
• 修复后的鼠标监听：

tableMouseListener = new MouseAdapter() {
    @Override
    public void mouseClicked(MouseEvent e){
        int viewRow = tasksTable.rowAtPoint(e.getPoint());
        int viewCol = tasksTable.columnAtPoint(e.getPoint());
        if (viewRow == -1 || viewCol == -1) {
            return; // 点击在表格外，直接返回
        }
        // 转换为模型行索引（如需操作模型数据）
        int modelRow = tasksTable.convertRowIndexToModel(viewRow);

        if(pressingCTRL){
            int[] newEntry = new int[]{viewRow, viewCol};
            // 打印数组内容而非引用
            System.out.println("选中行列：[" + viewRow + ", " + viewCol + "]");
            
            // 遍历判断是否存在内容相同的数组
            boolean exists = false;
            Iterator<int[]> iterator = selectedCells.iterator();
            while (iterator.hasNext()) {
                int[] entry = iterator.next();
                if (entry[0] == newEntry[0] && entry[1] == newEntry[1]) {
                    iterator.remove();
                    exists = true;
                    break;
                }
            }
            if (!exists) {
                selectedCells.add(newEntry);
            }
        } else {
            // 非Ctrl点击时清空选中（可根据需求调整）
            selectedCells.clear();
            selectedCells.add(new int[]{viewRow, viewCol});
        }
    }
};

3. KeyListener局限性 #

JTable的键盘事件可能被内部输入映射拦截，建议改用全局键盘焦点管理器监听Ctrl键：

// 替换原keyListener实现
KeyboardFocusManager.getCurrentKeyboardFocusManager().addKeyEventDispatcher(new KeyEventDispatcher() {
    @Override
    public boolean dispatchKeyEvent(KeyEvent e) {
        pressingCTRL = e.isControlDown();
        return false; // 让事件继续传递
    }
});

注意：组件销毁时需移除该Dispatcher，避免内存泄漏。

4. 字符串比较错误 #

filterTable中用==比较字符串会导致匹配失败，改用equals()：

if("ASSIGNED".equals(category)){
    return task.getUserId() != task.getAssigned_by();
}
else if("IMPORTANT".equals(category)){
    return task.getIsImportant();
}

5. 启用JTable默认多选（可选） #

若无需完全自定义选中逻辑，可直接启用JTable自带的多选功能：

tasksTable.setSelectionMode(ListSelectionModel.MULTIPLE_INTERVAL_SELECTION);

用户可通过Ctrl/Shift键完成多选，无需手动维护选中列表。

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