如何将QStateMachine与UI解耦？Qt开发场景下的实现疑问

核心思路是将业务状态流转逻辑与UI驱动/展示完全分离，让状态机只关注业务规则，UI和无头模式作为平等的输入输出端，通过抽象层解耦依赖。具体做法如下：

1. 用自定义QEvent替代UI直接信号 #

不要让状态机直接绑定UI控件的信号（如QPushButton::clicked()），而是定义与业务动作对应的自定义事件，所有触发状态流转的操作都通过发送事件给状态机完成。

• 自定义事件示例：

// 自定义事件类型
enum CustomEventType {
    SerialNumberSubmitted = QEvent::User + 1,
    DeviceCheckInitiated,
    DeviceCheckCompleted
};

// 序列号提交事件
class SerialNumberSubmittedEvent : public QEvent {
public:
    explicit SerialNumberSubmittedEvent(const QString& serial)
        : QEvent(static_cast<QEvent::Type>(SerialNumberSubmitted)), m_serial(serial) {}
    QString serialNumber() const { return m_serial; }
private:
    QString m_serial;
};

• UI端触发方式：按钮点击时发送事件给状态机

// 启动页按钮点击槽函数
void StartPage::onSubmitBtnClicked() {
    QString serial = ui->serialEdit->text();
    qApp->postEvent(m_appController->stateMachine(), new SerialNumberSubmittedEvent(serial));
}

• 无头模式触发方式：直接调用控制器接口发送事件

// 无头模式下直接提交序列号
m_appController->submitSerialNumber("SN123456");

2. 状态机输出抽象为业务信号 #

状态机的状态变化不要直接操作UI（如切换Page、更新控件文本），而是发出与业务状态相关的通用信号，UI层和无头模式各自监听这些信号做对应处理。

• 状态类定义业务信号：

class SerialInputState : public QState {
    Q_OBJECT
signals:
    void requestShowPage(int pageType);
    void notifySerialValidationResult(bool isValid);
protected:
    void onEntry(QEvent* event) override {
        // 业务逻辑：验证序列号格式
        auto serialEvent = static_cast<SerialNumberSubmittedEvent*>(event);
        bool valid = !serialEvent->serialNumber().isEmpty();
        emit notifySerialValidationResult(valid);
        if (valid) {
            emit requestShowPage(PageType::DeviceCheckPage);
            // 触发下一个状态流转
            machine()->postEvent(new DeviceCheckInitiatedEvent());
        }
    }
};

• UI层绑定信号更新界面：

// 主窗口初始化时绑定控制器信号
connect(m_appController, &AppController::requestShowPage, this, &MainWindow::loadPage);
connect(m_appController, &AppController::notifySerialValidationResult, this, [=](bool valid) {
    ui->tipLabel->setText(valid ? "序列号有效" : "请输入合法序列号");
});

• 无头模式绑定信号做日志/逻辑处理：

connect(m_appController, &AppController::notifySerialValidationResult, this, [=](bool valid) {
    qDebug() << "Serial validation:" << (valid ? "PASS" : "FAIL");
});

3. 业务逻辑与状态机完全解耦 #

将查询数据库、创建Product实例、检查总线等业务逻辑封装到独立的工具类或接口实现中，状态机仅负责调用这些接口，不依赖任何UI相关代码。

• 示例：封装设备检查逻辑

// 设备检查接口
class IDeviceChecker {
public:
    virtual bool checkBusConnection(Product* product) = 0;
    virtual ~IDeviceChecker() = default;
};

// 真实设备检查实现（UI模式用）
class RealDeviceChecker : public IDeviceChecker {
public:
    bool checkBusConnection(Product* product) override {
        // 调用总线API检查连接
        return product->bus()->isConnected();
    }
};

// 模拟设备检查实现（无头模式用）
class MockDeviceChecker : public IDeviceChecker {
public:
    bool checkBusConnection(Product* product) override {
        // 模拟返回连接成功
        return true;
    }
};

• 状态类通过依赖注入使用接口：

class DeviceCheckingState : public QState {
public:
    explicit DeviceCheckingState(IDeviceChecker* checker, QState* parent = nullptr)
        : QState(parent), m_checker(checker) {}
protected:
    void onEntry(QEvent* event) override {
        // 从状态机全局属性获取Product实例
        Product* product = machine()->property("currentProduct").value<Product*>();
        bool connected = m_checker->checkBusConnection(product);
        // 发送检查完成事件
        machine()->postEvent(new DeviceCheckCompletedEvent(connected));
    }
private:
    IDeviceChecker* m_checker;
};

4. 封装独立的业务控制器 #

将QStateMachine、所有状态对象以及业务逻辑接口封装到一个AppController类中，对外只暴露简洁的业务接口和信号，完全隐藏状态机细节。

class AppController : public QObject {
    Q_OBJECT
public:
    explicit AppController(IDeviceChecker* checker, QObject* parent = nullptr)
        : QObject(parent) {
        // 初始化状态机和状态
        m_stateMachine = new QStateMachine(this);
        auto idleState = new QState(m_stateMachine);
        auto serialInputState = new SerialInputState(m_stateMachine);
        auto deviceCheckState = new DeviceCheckingState(checker, m_stateMachine);

        // 配置状态转换规则
        idleState->addTransition(m_stateMachine, &QStateMachine::event, serialInputState);
        serialInputState->addTransition(m_stateMachine, &QStateMachine::event, deviceCheckState);

        // 绑定状态信号到控制器对外信号
        connect(serialInputState, &SerialInputState::requestShowPage, this, &AppController::requestShowPage);
        connect(serialInputState, &SerialInputState::notifySerialValidationResult, this, &AppController::notifySerialValidationResult);

        m_stateMachine->setInitialState(idleState);
        m_stateMachine->start();
    }

    // 对外业务接口
    void submitSerialNumber(const QString& serial) {
        qApp->postEvent(m_stateMachine, new SerialNumberSubmittedEvent(serial));
    }

signals:
    void requestShowPage(int pageType);
    void notifySerialValidationResult(bool isValid);
    void deviceCheckCompleted(bool connected);

private:
    QStateMachine* m_stateMachine;
};

这样无论UI模式还是无头模式，只需要创建AppController并传入对应依赖实现（真实/模拟检查器），调用控制器的业务接口即可，状态机完全不感知运行环境。

内容的提问来源于stack exchange，提问作者gfree