列重排后JTable单元格编辑内容存入错误列问题

兄弟，这个坑我太熟了！你遇到的问题本质是把JTable的视图列索引和模型列索引搞混了——列重排、排序都是JTable视图层的“表面操作”，你的AbstractTableModel背后的ArrayList（数据模型）根本没改变列/行的原始顺序，但你编辑时如果直接用视图传递的列索引去更新模型数据，可不就串列了嘛！

核心原因拆解 #

JTable的列重排、内置排序都是通过RowSorter在视图层做映射，不会修改你底层ArrayList里的数据结构。比如你把视图里的第2列拖到第1列，模型的列顺序还是[列0,列1,列2]，但视图显示的顺序变成[列2,列0,列1]。这时候如果编辑视图的第0列（对应模型的第2列），你要是直接用视图的列索引去改模型，就会把值写到模型的第0列里，自然就错了。

具体解决方案 #

1. 编辑时强制转换视图索引为模型索引

在你的AbstractTableModel重写setValueAt方法时，必须先把JTable传递过来的视图列索引转成模型列索引，再去操作ArrayList里的数据：

// 注意：这里需要持有JTable的引用，或者在调用时传入
private JTable table;

@Override
public void setValueAt(Object aValue, int rowIndex, int columnIndex) {
    // 关键一步：把视图列索引转换为模型列索引
    int modelColumn = table.convertColumnIndexToModel(columnIndex);
    
    // 用模型列索引去更新对应的数据字段
    YourDataEntity rowData = dataList.get(rowIndex);
    switch(modelColumn) {
        case 0: rowData.setId(aValue); break;
        case 1: rowData.setName(aValue); break;
        case 2: rowData.setAge(aValue); break;
        // 对应你模型里的每一列
    }
    
    // 通知模型数据更新，触发视图刷新
    fireTableCellUpdated(rowIndex, modelColumn);
}

注意：如果你用了自定义的TableCellEditor，在提交编辑值的时候也要做同样的索引转换，不能直接用视图的column参数。

2. 不要手动修改模型的行顺序，依赖内置RowSorter

JTable的内置排序已经帮你处理了视图层的行映射，绝对不要自己去排序底层的ArrayList！正确启用排序的方式是：

JTable yourTable = new JTable(yourCustomModel);
yourTable.setAutoCreateRowSorter(true); // 一键启用内置排序

如果需要获取选中行的模型数据，也要把视图行索引转成模型行索引：

int viewSelectedRow = yourTable.getSelectedRow();
if (viewSelectedRow != -1) {
    int modelRow = yourTable.convertRowIndexToModel(viewSelectedRow);
    YourDataEntity selectedData = dataList.get(modelRow);
    // 后续操作选中的模型数据
}

3. 严格基于模型结构实现TableModel方法

重写getColumnCount、getValueAt等方法时，必须完全对应你底层数据模型的结构，绝对不能掺杂视图层的状态：

@Override
public int getColumnCount() {
    // 返回模型的固定列数，比如你的数据实体有3个字段就返回3
    return 3;
}

@Override
public Object getValueAt(int rowIndex, int columnIndex) {
    YourDataEntity rowData = dataList.get(rowIndex);
    // 这里的columnIndex是模型列索引，和视图无关
    switch(columnIndex) {
        case 0: return rowData.getId();
        case 1: return rowData.getName();
        case 2: return rowData.getAge();
        default: return null;
    }
}

验证步骤 #

按下面的流程测一遍，确保问题解决：

• 编辑某单元格（比如视图第2列）
• 拖动列头把该列移到视图第1列的位置
• 再次编辑这个单元格（现在在视图第1列），检查模型里对应的字段是否正确更新
• 点击列头排序，确认编辑过的内容始终对应正确的数据字段

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