JavaFX TreeView如何获取不受节点展开状态影响的固定索引

TreeView.getRow() 返回的是当前UI可见状态下的行索引，取值会随节点展开、折叠操作动态变化，和你构建树时按遍历顺序生成的固定平铺索引完全不是一个概念，因此无法直接用这个返回值匹配同步构建的关联数据列表。

根据你的代码场景，有两种成熟实现方式可选：

方案1：节点创建时绑定固定索引（优先推荐，性能最优） #

TreeItem 自带userData属性，专门用于存储节点关联的自定义业务数据。你在构建树、生成关联列表的同时，直接把对应固定索引存在节点自身上，选中节点时直接读取即可，全程不受展开折叠状态影响，查询复杂度O(1)。
核心修改代码如下：

1. 重构节点创建方法，创建节点时直接绑定索引

public TreeItem<String> createBranch(String title, TreeItem parent, int fixedIndex){
    CheckBoxTreeItem<String> newBranch = new CheckBoxTreeItem<>(title);
    // 将固定平铺索引存入节点自定义数据位
    newBranch.setUserData(fixedIndex);
    parent.getChildren().add(newBranch);
    return newBranch;
}

2. 调整树构建逻辑，创建节点时传入对应索引

TreeItem<String> root = new TreeItem<>("root");
List<String> list = new ArrayList<>();
int indexCounter = 0;
for (int i = 0; i < 3; i++){
    TreeItem<String> parentItem = createBranch("TreeItem " + indexCounter, root, indexCounter);
    list.add("List Index " + indexCounter);
    indexCounter++;
    for (int j = 0; j < 3; j++){
        createBranch("TreeItem " + indexCounter, parentItem, indexCounter);
        list.add("List Index " + indexCounter);
        indexCounter++;
    }
}

3. 选中事件中直接读取节点存储的固定索引

treeView.getSelectionModel().selectedItemProperty().addListener((v,oldValue,newValue) -> {
    TreeItem<String> selectedItem = treeView.getSelectionModel().getSelectedItem();
    if (selectedItem == null || selectedItem == root)
        return;
    // 直接读取预存的固定索引，和节点展开/折叠状态完全无关
    int fixedIndex = (int) selectedItem.getUserData();
    System.out.println("固定索引: " + fixedIndex + " TreeView项: " + newValue.getValue() + " --- 关联列表值: " + list.get(fixedIndex));
});

方案2：全树遍历计算固定索引（适配无法修改节点创建逻辑的场景） #

如果受现有代码限制，无法在创建节点时预存索引，可以写一个和你构建列表时遍历逻辑完全一致的深度优先遍历方法，选中节点时从根节点开始遍历全树（无论节点是否展开都遍历其子节点），计数得到固定索引。
工具方法实现：

/**
 * 按树构建时的深度优先顺序，计算目标节点的固定平铺索引
 * @param root 树的根节点
 * @param target 需要查找索引的目标节点
 * @param counter 遍历计数器，初始调用传new int[]{-1}即可
 * @return 目标节点的固定索引，未找到返回-1
 */
private int getFixedTreeIndex(TreeItem<?> root, TreeItem<?> target, int[] counter) {
    for (TreeItem<?> child : root.getChildren()) {
        counter[0]++;
        if (child == target) {
            return counter[0];
        }
        // 无论节点是否展开，都遍历子节点，和构建关联列表的遍历逻辑保持一致
        int res = getFixedTreeIndex(child, target, counter);
        if (res != -1) {
            return res;
        }
    }
    return -1;
}

选中事件中调用方法获取索引：

treeView.getSelectionModel().selectedItemProperty().addListener((v,oldValue,newValue) -> {
    TreeItem<String> selectedItem = treeView.getSelectionModel().getSelectedItem();
    if (selectedItem == null || selectedItem == root)
        return;
    int fixedIndex = getFixedTreeIndex(root, selectedItem, new int[]{-1});
    System.out.println("固定索引: " + fixedIndex + " TreeView项: " + newValue.getValue() + " --- 关联列表值: " + list.get(fixedIndex));
});

• TreeView.getRow()的设计目标是定位UI层面的可见行，本身就不具备数据层面索引的稳定性，永远不要用它做跨展开状态的数据匹配
• 如果树需要支持动态增删节点，优先选择方案1，增删时同步更新受影响节点存储的索引即可，查询性能远高于全树遍历
• userData属性支持存储任意自定义对象，除了索引外，你也可以直接把关联的业务数据存在节点上，省去维护额外列表的成本

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