使用QTreeView操作Oracle数据库数据：隐藏列后无法关联主键

针对你基于Qt editabletreemodel 示例开发时遇到的问题，以下是具体解决思路和实现步骤：

核心思路 #

无需依赖视图层的隐藏列存储主键，而是将主键信息与树节点的业务数据直接绑定，确保增改操作时能直接获取对应记录的主键，避免视图隐藏列带来的访问问题。

1. 扩展TreeItem结构，内置主键存储 #

editabletreemodel 示例中的TreeItem类负责存储每行数据，给它添加专门的主键存储字段：

class TreeItem
{
public:
    // 原有成员...
    explicit TreeItem(const QVector<QVariant> &data, TreeItem *parent = nullptr);
    // 添加主键操作方法
    void setPrimaryKey(const QString &pk) { m_primaryKey = pk; }
    QString primaryKey() const { return m_primaryKey; }

private:
    // 原有成员...
    QString m_primaryKey; // 新增：存储当前节点对应的Oracle主键
};

2. 加载数据时绑定主键 #

查询Oracle数据时，务必将主键字段包含在SQL语句中，遍历结果时把主键值存入对应TreeItem：

// 示例：从Oracle加载数据到TreeModel
void TreeModel::loadDataFromOracle()
{
    QSqlQuery query("SELECT id, name, department FROM employee"); // id为主键
    while (query.next()) {
        QVector<QVariant> itemData;
        // 仅将需要展示的字段加入itemData（跳过主键）
        itemData << query.value(1) << query.value(2);
        // 创建TreeItem并设置主键
        TreeItem *item = new TreeItem(itemData, rootItem());
        item->setPrimaryKey(query.value(0).toString());
        // 将item添加到树结构（原有逻辑）
        // ...
    }
}

这种方式下，视图层无需处理主键列，自然不会出现隐藏后无法访问的问题。

3. 修改数据时通过主键更新数据库 #

用户在QTreeView中编辑数据后，TreeModel::setData方法会被触发，此时直接从当前节点获取主键构造UPDATE语句：

bool TreeModel::setData(const QModelIndex &index, const QVariant &value, int role)
{
    if (role != Qt::EditRole)
        return false;

    TreeItem *item = getItem(index);
    bool result = item->setData(index.column(), value);

    if (result) {
        // 构造Oracle更新语句
        QString updateSql = "UPDATE employee SET name = :name, department = :dept WHERE id = :id";
        QSqlQuery query;
        query.prepare(updateSql);
        // 绑定修改后的数据
        query.bindValue(":name", item->data(0));
        query.bindValue(":dept", item->data(1));
        // 绑定主键
        query.bindValue(":id", item->primaryKey());
        query.exec();
        emit dataChanged(index, index, {role});
    }
    return result;
}

4. 插入数据时获取并绑定新主键 #

插入新记录到Oracle时，利用RETURNING子句获取自动生成的主键，再绑定到新创建的TreeItem：

void TreeModel::insertNewItem(const QModelIndex &parent)
{
    TreeItem *parentItem = getItem(parent);
    QVector<QVariant> newData;
    newData << "新员工" << "默认部门"; // 初始默认值
    TreeItem *newItem = new TreeItem(newData, parentItem);

    // 执行插入并获取主键
    QString insertSql = "INSERT INTO employee (name, department) VALUES (:name, :dept) RETURNING id INTO :newId";
    QSqlQuery query;
    query.prepare(insertSql);
    query.bindValue(":name", newData[0]);
    query.bindValue(":dept", newData[1]);
    QVariant newId;
    query.bindValue(":newId", newId, QSql::Out);
    if (query.exec()) {
        newItem->setPrimaryKey(newId.toString());
        // 将新节点加入模型（原有逻辑）
        // ...
    }
}

备选方案：保留隐藏列并正确访问 #

如果坚持通过隐藏列存储主键，需注意视图隐藏列不影响模型数据的访问，确保模型包含该列后，直接通过索引获取：

// 初始化时隐藏主键列（假设主键是第0列）
treeView->setColumnHidden(0, true);

// 需要获取主键时，直接通过模型索引访问
QModelIndex pkIndex = model->index(row, 0, parentIndex);
QString primaryKey = model->data(pkIndex).toString();

内容的提问来源于stack exchange，提问作者Thomas.C