【Qt】数据库实战之QSqlRelationalTableModel-卡核

00. 目录

文章目录

01. 概述

QSqlRelationalTableModel继承自QSqlTableModel，并且对其进行了扩展，提供了对外键的支持。一个外键就是一个表中的一个字段和其他表中的主键字段之间的一对一的映射。例如，student表中的course字段对应的是course表中的id字段，那么就称字段course是一个外键。因为这里的course字段的值是一些数字，这样的显示很不友好，使用关系表格模型，就可以将它显示为course表中的name字段的值。

02. 开发环境

Windows系统：Windows10

Qt版本：Qt5.15或者Qt6

03. QSqlRelationalTableModel外键

本示例在【Qt】数据库实战之QSqlTableModel模型示例上面修改

3.1 connection.h文件修改如下

#ifndef CONNECTION_H
#define CONNECTION_H

#include <QMessageBox>
#include <QSqlDatabase>
#include <QSqlQuery>
#include <QSqlError>
#include <QDebug>

static bool createConnection()
{
    QSqlDatabase db = QSqlDatabase::addDatabase("QSQLITE");
    db.setDatabaseName("test.db");
    if (!db.open())
    {
        return false;
    }

    QSqlQuery query;
    query.exec("create table student(id int primary key, name varchar(20), course int)");
    query.exec("insert into student values(1, ' 王鹏', 1)");
    query.exec("insert into student values(2, '李刚', 1)");
    query.exec("insert into student values(3, '李强', 2)");
    query.exec("insert into student values(4, '王强', 2)");
    query.exec("insert into student values(5, '黎明朗', 2)");

    query.exec("create table course(id int primary key, name varchar(20), teacher varchar(20))");
    query.exec("insert into course values(1, 'Math', '邓明')");
    query.exec("insert into course values(2, 'English', '邓海')");
    query.exec("insert into course values(3, 'Computer', '李丽')");


    return true;
}

#endif // CONNECTION_H

建立了两个表，student表中有一字段是course，它是int型的，而course表的主键也是int型的。如果要将course字段和course表进行关联，它们的类型就必须相同。

3.2 更改main.cpp文件

#include "mainwindow.h"

#include <QApplication>
#include "connection.h"

int main(int argc, char *argv[])
{
    QApplication a(argc, argv);

    if (!createConnection())
    {
        return 1;
    }


    MainWindow w;
    w.show();
    return a.exec();
}

3.3 mainwindow.h文件中添加头文件和私有成员

#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QSqlRelationalTableModel>

QT_BEGIN_NAMESPACE
namespace Ui { class MainWindow; }
QT_END_NAMESPACE

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    MainWindow(QWidget *parent = nullptr);
    ~MainWindow();


private slots:

private:
    Ui::MainWindow *ui;
    QSqlRelationalTableModel *model;
};
#endif // MAINWINDOW_H

3.4 在UI界面设计上添加一个TableView

3.5 mainwindow.cpp文件中，在构造函数里添加如下代码

MainWindow::MainWindow(QWidget *parent)
    : QMainWindow(parent)
    , ui(new Ui::MainWindow)
{
    ui->setupUi(this);


    model = new QSqlRelationalTableModel(this);
    //字段变化时写入数据库
    model->setEditStrategy(QSqlTableModel::OnFieldChange);

    model->setTable("student");

    //将student表的第三个字段设为course表id字段的外建
    //显示course表的name字段的值
    model->setRelation(2, QSqlRelation("course", "id", "name"));
    model->setHeaderData(0, Qt::Horizontal, tr("ID"));
    model->setHeaderData(1, Qt::Horizontal, tr("Name"));
    model->setHeaderData(2, Qt::Horizontal, tr("Course"));

    model->select();

    ui->tableView->setModel(model);
}

这里修改了model的提交策略，OnFieldChange表示只要字段被改动就马上写入数据库，这样就不需要我们再执行提交函数了。setRelation()函数实现了创建外键。

3.6 程序执行结果如下图所示
在这里插入图片描述

可以看到Course字段已经不再是编号，而是具体的课程名称了。外键说简单点就是将两个相关的表建立一个桥梁，让它们关联起来。

04. QSqlRelationalDelegate委托类

有时我们也希望，如果用户更改课程字段，那么只能在课程表中已有的课程中进行选择，而不能随意填写课程。Qt中还提供了一个QSqlRelationalDelegate委托类，它可以为QSqlRelationalTableModel显示和编辑数据。这个委托为一个外键提供了一个QComboBox部件来显示所有可选的数据，这样就显得更加人性化了。使用这个委托很简单，我们先在mainwindow.cpp文件中添加头文件:

在构造函数最后添加一下代码：

    //设置使用委托
    ui->tableView->setItemDelegate(new QSqlRelationalDelegate(ui->tableView));

执行结果如下：
在这里插入图片描述

05. 数据库模型总结

我们可以根据自己的需要来选择使用对应的模型。如果熟悉SQL语法，又不需要将所有的数据都显示出来，那么只需要使用QSqlQuery就可以了。对于QSqlTableModel，它主要是用来显示一个单独的表格，而QSqlQueryModel可以用来显示任意一个结果集，如果想显示任意一个结果集，而且想使其可读写，那么建议子类化QSqlQueryModel，然后重新实现flags()和setData()函数。