桌面应用 / 系统课时
接入模型数据和后端服务
接入模型数据和后端服务
本篇将把 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 保持轻量。这样应用在增加数据库、网络通信或插件能力时,不需要重写界面结构。
按自己的节奏,确认真正理解。