桌面应用 / 系统课时

接入模型数据和后端服务

接入模型数据和后端服务

本篇将把 QML 界面连接到真实数据来源,通过模型展示业务数据,并使用 C++ 服务向页面提供操作能力,形成完整的数据流闭环。

学习目标

  • 理解 QML 页面、模型和 C++ 服务之间的数据交互方式
  • 使用 ListModel 和 C++ QObject 服务驱动界面更新
  • 掌握业务操作从界面触发到后端处理的基本流程

连接界面与业务数据

QML 负责界面描述,但桌面应用通常需要访问文件、数据库、网络或系统能力。这些逻辑更适合放在 C++ 后端,通过 QObject 暴露给 QML。

常见结构是模型负责提供列表数据,服务对象负责执行动作。页面只关心展示什么和用户触发什么,不直接处理底层业务细节。

在 QML 中绑定模型数据

下面示例使用 ListModel 模拟业务数据,并通过按钮触发服务调用。真实项目中可以将 ListModel 替换为 C++ 实现的 QAbstractListModel。

qml
import QtQuick
import QtQuick.Controls

Item {
    width: 400
    height: 300

    ListModel {
        id: taskModel
        ListElement { name: '编写文档'; done: false }
        ListElement { name: '发布版本'; done: true }
    }

    Column {
        anchors.centerIn: parent

        ListView {
            width: 300
            height: 120
            model: taskModel
            delegate: Text {
                text: name + (done ? ' [完成]' : ' [进行中]')
            }
        }

        Button {
            text: '刷新数据'
            onClicked: backend.reload()
        }
    }
}

预期输出

text
窗口显示两个任务列表项。
点击“刷新数据”后调用名为 backend 的后端服务方法。

暴露 C++ 服务给 QML

C++ 服务通常继承 QObject,并通过 Q_PROPERTY、Q_INVOKABLE 或信号机制与 QML 通信。下面是服务接口片段示例,展示最小交互方式。

cpp
#include <QObject>
#include <QDebug>

class BackendService : public QObject
{
    Q_OBJECT
public:
    explicit BackendService(QObject *parent = nullptr)
        : QObject(parent) {}

    Q_INVOKABLE void reload()
    {
        // 实际项目中这里可以读取数据库或请求网络数据
        qDebug() << "reload data";
    }
};

预期结果

text
调用 reload() 后,C++ 控制台输出:
reload data

处理数据同步和状态管理

界面状态和业务状态需要明确边界。例如列表选中项属于界面状态,而用户配置、缓存数据属于业务状态。

当后端数据变化时,应通过模型刷新或信号通知 QML 更新,而不是让页面主动轮询。这样可以减少页面耦合,也方便后续替换数据来源。

构建完整业务闭环

一个完整操作通常经过以下路径:用户点击控件,QML 调用服务接口,C++ 执行业务逻辑,模型或属性发生变化,QML 根据绑定关系自动刷新界面。

如果业务逻辑逐渐复杂,应继续拆分模型层、服务层和页面层,让 QML 保持轻量。这样应用在增加数据库、网络通信或插件能力时,不需要重写界面结构。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

接入模型数据和后端服务

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通