Qt SQL:QSqlQueryModel、QSqlTableModel

QSqlQueryModel

一、描述

QSqlQueryModel 类继承自 QAbstractTableModel,为 SQL 结果集提供只读数据模型,是用于执行 SQL 语句和遍历结果集的高级接口。它建立在较低级别的 QSqlQuery 之上,可用于为 QTableView 等视图类提供数据。


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

    QSqlQuery query;
    query.exec("create table person (id int primary key, "
                                    "姓名 varchar(20), "
                                    "职业 varchar(20))");
    query.exec("insert into person values(101, '张三', '电工')");
    query.exec("insert into person values(102, '李四', '学生')");
    query.exec("insert into person values(103, '王五', '程序员')");
    query.exec("insert into person values(104, '赵六', '外卖员')");

    return true;
}

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    if (!createConnection())
        return EXIT_FAILURE;

    QSqlQueryModel model;
    model.setQuery("SELECT 姓名, 职业 FROM person");
    model.setHeaderData(0, Qt::Horizontal, QObject::tr("姓名_"));
    model.setHeaderData(1, Qt::Horizontal, QObject::tr("职业_"));
    QTableView view;
    view.setModel(&model);
    view.show();

    return app.exec();
}

Qt SQL:QSqlQueryModel、QSqlTableModel_第1张图片

QSqlQueryModel 也可用于以编程方式访问数据库,而无需将其绑定到视图:

    qDebug()<

这等同于:

    model.data(model.index(1, 1)).toString();

该模型默认为只读。要使其可读写,必须对其进行子类化并重新实现 setData() 和 flags()。另一种选择是使用 QSqlTableModel,它提供了基于单个数据库表的读写模型。

二、成员函数

1、bool canFetchMore(const QModelIndex &parent = QModelIndex())

是否可以从数据库中读取更多行。parent 应该始终是无效的 QModelIndex。

2、void clear()

清除模型并释放所有获取的资源。

3、QVariant data(const QModelIndex &item, int role = Qt::DisplayRole)

返回指定项和角色的值。

4、void fetchMore(const QModelIndex &parent = QModelIndex())

从数据库中获取更多行。parent 应该始终是无效的 QModelIndex。

要获取整个结果集,可以使用:

while (myModel->canFetchMore())
    myModel->fetchMore();

5、QVariant headerData(int section, Qt::Orientation orientation, int role = Qt::DisplayRole)

返回具有指定方向的标题部分中角色 role 的标题数据。

6、QModelIndex indexInQuery(const QModelIndex &item)

返回模型中给定项目的数据库结果集中值的索引。

如果没有插入、删除或移动任何列或行,则返回值与 item 相同。

7、bool insertColumns(int column, int count, const QModelIndex &parent = QModelIndex())

将 count 列插入模型的第 column 列处 。parent 参数必须始终是无效的 QModelIndex。

默认情况下,插入的列是空的。要用数据填充它们,需要重新实现 data() 处理。

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

    QSqlQuery query;
    query.exec("create table person (id int primary key, "
                                    "姓名 varchar(20), "
                                    "职业 varchar(20))");
    query.exec("insert into person values(101, '张三', '电工')");
    query.exec("insert into person values(102, '李四', '学生')");
    query.exec("insert into person values(103, '王五', '程序员')");
    query.exec("insert into person values(104, '赵六', '外卖员')");

    return true;
}

class cumstomModel : public QSqlQueryModel
{
public:
    cumstomModel(QObject *parent = nullptr)
        :QSqlQueryModel(parent)
    {
    }

    QVariant data(const QModelIndex &item, int role) const override
    {
        if (item.column() > 1 && role == Qt::DisplayRole)
        {
            return QString("插入的数据");
        }
        return QSqlQueryModel::data(item, role);
    }
};

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    if (!createConnection())
        return EXIT_FAILURE;

    cumstomModel model;
    model.setQuery("SELECT 姓名, 职业 FROM person");
    model.setHeaderData(0, Qt::Horizontal, QObject::tr("姓名_"));
    model.setHeaderData(1, Qt::Horizontal, QObject::tr("职业_"));

    QWidget w;
    QVBoxLayout vb(&w);

    QTableView view;
    view.setModel(&model);
    vb.addWidget(&view);
    QPushButton btn("添加");
    QObject::connect(&btn,&QPushButton::clicked,[&]
    {
        model.insertColumns(2,1);
    });
    QHBoxLayout hb;
    hb.addStretch();
    hb.addWidget(&btn);
    vb.addLayout(&hb);
    w.show();

    return app.exec();
}

Qt SQL:QSqlQueryModel、QSqlTableModel_第2张图片

8、QSqlError lastError()

返回有关数据库上发生的最后一个错误的信息。

9、QSqlQuery query()

返回与此模型关联的 QSqlQuery。

10、void queryChange()

每当查询更改时,都会调用此虚函数。

11、QSqlRecord record(int row)

返回包含有关当前查询的字段信息的记录。如果 row 是有效行的索引,则将使用该行中的值填充记录。

      QSqlRecord record()

返回一个空记录,其中包含有关当前查询的字段的信息。

Qt SQL:QSqlQueryModel、QSqlTableModel_第3张图片

12、bool removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

从位置 column 开始从模型中删除 count 列。parent 参数必须始终是无效的 QModelIndex。

删除列可以有效地隐藏它们。它不会影响底层的 QSqlQuery

返回是否删除成功。

13、QHash roleNames()

返回模型的角色名称。

Qt 只为 QSqlQueryModel 定义了一个角色:

14、int rowCount(const QModelIndex &parent = QModelIndex())

如果数据库支持返回查询的大小,则返回当前查询的行数。否则返回当前缓存的行数。

parent 应该始终是无效的 QModelIndex。

15、bool setHeaderData(int section, Qt::Orientation orientation, const QVariant &value, int role = Qt::EditRole)

将角色 role 的水平标题设置为 value。orientation 必须是 Qt::Horizo​​ntal

此函数不能用于修改数据库中的值,因为模型是只读的。

Qt SQL:QSqlQueryModel、QSqlTableModel_第4张图片

16、void setLastError(const QSqlError &error)

用于派生类设置数据库上发生的最后一个错误的值。

17、void setQuery(QSqlQuery && query)

重置模型并设置数据提供者。query 必须是活动的,并且不能是 isForwardOnly()。

      void setQuery(const QString &query, const QSqlDatabase &db = QSqlDatabase())

对数据库连接 db 执行查询查询。如果未指定数据库(或无效数据库),则使用默认连接。

QSqlQueryModel model;
model.setQuery("select * from MyTable");
if (model.lastError().isValid())
    qDebug() << model.lastError();

QSqlTableModel

一、描述

QSqlTableModel 类为单个数据库表提供可编辑的数据模型,继承自 QSqlQueryModel,它是用于从单个表中读取和写入数据库记录的高级接口。它建立在较低级别的 QSqlQuery 之上,可用于为 QTableView 等视图类提供数据。

#include 
#include 
#include 
#include 
#include 
#include 

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

    QSqlQuery query;
    query.exec("create table person (id int primary key, "
                                    "姓名 varchar(20), "
                                    "职业 varchar(20))");
    query.exec("insert into person values(101, '张三', '电工')");
    query.exec("insert into person values(102, '李四', '学生')");
    query.exec("insert into person values(103, '王五', '程序员')");
    query.exec("insert into person values(104, '赵六', '外卖员')");

    return true;
}

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);
    if (!createConnection())
        return EXIT_FAILURE;

    QSqlTableModel model;
    model.setTable("person");
    model.setEditStrategy(QSqlTableModel::OnManualSubmit);
    model.select();

    model.setHeaderData(0, Qt::Horizontal, QObject::tr("编号"));
    model.setHeaderData(1, Qt::Horizontal, QObject::tr("人员姓名"));
    model.setHeaderData(2, Qt::Horizontal, QObject::tr("职业信息"));

    QTableView view;
    view.horizontalHeader()->setSectionResizeMode(QHeaderView::Stretch);
    view.setModel(&model);
    view.show();

    return app.exec();
}

Qt SQL:QSqlQueryModel、QSqlTableModel_第5张图片

QSqlTableModel 也可用于以编程方式访问数据库,而无需将其绑定到视图:

    qDebug()<

上面的代码片段从查询 SELECT * from person 的结果集中的记录 1 中提取“职业”字段。

可以使用 setFilter() 设置过滤器,或使用 setSort() 修改排序顺序。最后必须调用 select() 以使用数据填充模型。

QSqlTableModel 不直接支持外键。如果要解析外键,应使用 QSqlRelationalTableModel QSqlRelationalDelegate

二、类型成员

1、enum QSqlTableModel::EditStrategy:此枚举描述了在编辑数据库中的值时选择的策略。

  • OnFieldChange:对模型的所有更改将立即应用于数据库。
  • OnRowChange:当用户选择不同的行时,将应用对行的更改。
  • OnManualSubmit:在调用 submitAll() 或 revertAll() 之前,所有更改都将缓存在模型中。

三、成员函数

1、【信号】void beforeDelete(int row)

此信号由 deleteRowFromTable() 在从当前活动的数据库表中删除行之前发出。

2、【信号】void beforeInsert(QSqlRecord &record)

在将新行插入当前活动的数据库表之前,insertRowIntoTable() 会发出此信号。即将插入的值存储在 record 中,可以在插入之前进行修改。

3、【信号】void beforeUpdate(int row, QSqlRecord &record)

此信号由 updateRowInTable() 在当前活动数据库表中使用记录中的值更新行之前发出。

只有标记为已生成的值才会被更新。生成的标志可以用 QSqlRecord::setGenerated() 设置并用 QSqlRecord::isGenerated() 检查。

4、【信号】void primeInsert(int row, QSqlRecord &record)

当在当前活动数据库表的给定行中启动插入时,insertRows() 发出此信号。

处理此信号时,请勿尝试通过其他方式(例如 setData() 或 setRecord())编辑记录。

5、void revert()

当用户取消编辑当前行时,项目委托将调用此函数。

如果模型的策略设置为 OnRowChange OnFieldChange,则还原更改。

6、void revertAll()

还原所有还未应用的更改。

Qt SQL:QSqlQueryModel、QSqlTableModel_第6张图片

7、bool select()

使用指定的过滤器和排序条件,使用通过 setTable() 设置的表中的数据填充模型。

调用 select() 将还原所有未提交的更改并删除所有插入的列。

8、bool selectRow(int row)

使用与主键值匹配数据库表行中的值刷新模型中的行。如果没有主键,所有列值都必须匹配。如果没有找到匹配的行,模型将显示一个空行。

9、bool submit()

当用户停止编辑当前行时,项目委托会调用函数。

如果模型的策略设置为 OnRowChange OnFieldChange,则提交当前编辑的行。

10、bool submitAll()

提交所有更改。

OnManualSubmit 模式下,当 submitAll() 失败时,已经提交的更改不会从缓存中清除。这允许在不丢失数据的情况下回滚和重新提交事务。

11、QSqlDatabase database()

返回模型的数据库连接。

12、bool deleteRowFromTable(int row)

从当前活动的数据库表中删除给定的行。返回该行是否被删除

这是一种直接对数据库进行操作的低级方法,不建议使用。建议使用 removeRow() 或 removeRows() 删除值。模型将根据其编辑策略决定何时修改数据库。

13、int fieldIndex(const QString &fieldName)

返回字段 fieldName 的索引,如果模型中不存在对应的字段,则返回 -1。

14、bool insertRecord(int row, const QSqlRecord &record)

插入记录。如果 row 为负数,则记录将附加到末尾。返回是否插入成功。

15、bool insertRowIntoTable(const QSqlRecord &values)

将记录插入到当前活动的数据库表中。返回是否插入成功

这是一种直接对数据库进行操作的低级方法,不建议使用。建议使用 insertRow() 和 setData() 插入值。模型将根据其编辑策略决定何时修改数据库。

16、bool insertRows(int row, int count, const QModelIndex &parent = QModelIndex())

在位置 row 插入 count 个空行。parent 必须是无效的,因为当前模型不支持父子关系。

对于编辑策略 OnFieldChange OnRowChange,一次只能插入一行。

将为每个新行发出 primeInsert() 信号。如果要使用默认值初始化新行,可连接到此信号。

无论编辑策略如何,都不提交行。

如果参数超出范围或无法插入行,则返回 false。

17、bool isDirty(const QModelIndex &index)

如果索引 index 处的值是否脏值。脏值是在模型中修改但尚未写入数据库的值。

       bool isDirty()

模型是否包含尚未提交到数据库的修改值。

18、QSqlIndex primaryKey()

返回当前表的主键,如果表没有设置或没有主键,则返回一个空的 QSqlIndex。

19、QSqlRecord record()

 返回一个记录,只有字段名称。此函数可用于检索记录的字段名称。

       QSqlRecord record(int row)

返回模型中第 row 行的记录。

20、bool removeColumns(int column, int count, const QModelIndex &parent = QModelIndex())

从父模型中删除 count 列,从索引 column 开始。

21、bool removeRows(int row, int count, const QModelIndex &parent = QModelIndex())

从 row 开始删除计数行。由于此模型不支持分层结构,因此 parent 必须是无效的模型索引。

在从数据库中删除一行之前,会发出 beforeDelete() 信号。

如果可以删除所有行,则返回 true。可以使用 lastError() 检索详细的数据库错误信息。

22、void revertRow(int row)

还原指定行的所有更改。

23、bool setData(const QModelIndex &index, const QVariant &value, int role = Qt::EditRole)

将角色 role 的项目 index 的数据设置为 value。

如果角色不是 Qt::EditRole,则返回 false。要为 Qt::EditRole 以外的角色设置数据,请使用自定义代理模型或子类 QSqlTableModel。

Qt SQL:QSqlQueryModel、QSqlTableModel_第7张图片

24、void setFilter(const QString &filter)

设置过滤器。过滤器是一个没有关键字 WHERE 的 SQL WHERE 子句(例如,name='Josephine')。

Qt SQL:QSqlQueryModel、QSqlTableModel_第8张图片

25、void setPrimaryKey(const QSqlIndex &key)

设置主键。通常,每当调用 setTable() 时,都会自动设置主索引。

26、bool setRecord(int row, const QSqlRecord &values)

将 values 应用于模型中的行 row 。

必须对 values 中的所有值设置 setGenerated(false) 将标志设置为 false(默认 QSqlRecord 中的所有字段为 true),才能将更改保存回数据库。

27、void setSort(int column, Qt::SortOrder order)

设置要排序的列的排序顺序。

这不会影响当前数据,要使用新的排序顺序刷新数据,需要调用 select()。

enum Qt::SortOrder:此枚举描述了小部件中的项目是如何排序的。

  • Qt::AscendingOrder:升序排序。
  • Qt::DescendingOrder:降序排序。

28、void setTable(const QString &tableName)

设置模型操作的数据库表。不会从表中选择数据,但获取其字段信息。

29、void sort(int column, Qt::SortOrder order)

对数据进行排序。

30、bool updateRowInTable(int row, const QSqlRecord &values)

使用指定值更新当前活动数据库表中的给定行。

这是一种直接对数据库进行操作的低级方法,不建议使用用。建议使用 setData() 更新值。模型将根据其编辑策略决定何时修改数据库。

你可能感兴趣的:(Qt,SQL,qt,sql)