基于Qt的上位机通用框架

news2024/11/15 13:49:59

0.前言

最近一年多的时间一直在开发设备控制相关的软件，加上之前在聚光的两年时间，前前后后开发这种设备控制类型的上位机软件也有三年的时间了。总结出了一套基于Qt的上位机编程框架，核心思想类似于C#的依赖注入，对象的初始化都是基于反射和配置文件生成的，通过修改配置文件就能实现控制流程的修改。
该框架分为基本模块、通讯层、设备层、指令层、控制层五个核心模块，上层调用下层，主要通过Manager单例读取配置json文件,创建并配置对应实体，再将实体指针由Manager管理，可以有效防止内存泄漏等问题。
项目gitee地址

在这里插入图片描述

1.基本模块

定义了BaseFactory、BaseItem、BaseManager三个底层基类，BaseFactory定义了类型注册和实体创建两个方法，主要用于每个模块内的实体创建工作。

#pragma execution_character_set("utf-8")
#ifndef BASEFACTORY_H
#define BASEFACTORY_H
#include <QObject>
#include <QMap>
#include <QDebug>
#include "BaseItem.h"

class BaseFactory
{
public:
    BaseFactory();

    virtual BaseItem* CreateInstance(QString concreteType);

    template <typename T1>
    int Register()
    {
        int preCount=_map.count();
        const QMetaObject& meta = T1::staticMetaObject;
        _map.insert(meta.className(),&meta);

        if(preCount+1!=_map.count())
        {
            throw QString("%1注册失败，请检查!").arg(meta.className());
        }
        return _map.count();
    }

protected:
    QMap<QString,const QMetaObject*> _map;
};

BaseItem主要定义了框架内所有实体的配置接口和配置文件创建接口

#pragma execution_character_set("utf-8")
#ifndef BASEITEM_H
#define BASEITEM_H

#include <QObject>
#include <QJsonObject>
#include <QJsonDocument>
#include <QException>
#include <QSharedPointer>
#include <QDebug>
#include "InterruptedException.h"

class BaseItem : public QObject
{
    Q_OBJECT
public:
    explicit BaseItem(QObject *parent = nullptr);

    QString Name();
    void SetName(QString name);

    virtual void SetConfig(QJsonObject obj);
    virtual QJsonObject Config();

    virtual void SetOtherConfig(QJsonObject other);

    virtual bool Init();

    virtual QWidget* GetConfigWidget();

    virtual QSharedPointer<QWidget> GetConfigWidgetZZZ();

protected:
    QString _name;
    QJsonObject _obj;
    QJsonObject _other;

signals:

public slots:
};

#endif // BASEITEM_H

BaseManager主要定义了Manager类的的基本方法，主要通过读取配置文件，使用工厂模式创建对应的实体对象，再将配置文件中的json对象参数传入对象完成初始化，最后再将这些实体对象指针通放入QList容器，简化对象的管理和监控。
在这里插入图片描述

2.通讯层

定义了SendReply、Publisher、Subscriber、Requester、Replyer、Modbus物种基本的通讯类。并且实现了SendReply、Modbus通讯方式的网口和串口模式,基于zmq实现了Publisher、Subscriber、Requester、Replyer四种通讯模式。
CommunicationManger创建并且管理这些通讯实例，并且具有通讯监控、断线重连等功能，方便再设备运行期间对通讯状态的异常排查。
在这里插入图片描述

3.设备层

定义了IO模块、测距仪、电机控制器等常用设备，完成了不同品牌的具体实现
在这里插入图片描述

4.指令层/控制层

整体业务核心部分，将所有软件执行流程分为分解为多个指令，内部通告异常抛出实现控制流程的中断，大大简化控制流程，通过调整不同指令的位置，可以实现控制流程的自由组合。通过设置不同的权重，可以实现进度报告等功能。

5.中断

将整体业务执行流程分为瞬态控制和等待，在每个等待中使用WaitMs(int time)方法实现业务的中断功能。

#pragma execution_character_set("utf-8")

#include "WaitUtils.h"
#include <QTime>
#include <QDebug>
#include <QCoreApplication>
#include <QElapsedTimer>

WaitUtils::WaitUtils(QObject *parent) : QObject(parent)
{

}

bool WaitUtils::_isRunning=false;


void WaitUtils::WaitMs(int time)
{
    //多处调用displayProgress该变量且有的时true有的时false时会导致进度显示异常，想不通。。。
    QElapsedTimer ela;
    ela.start();
    while (ela.elapsed() < time)
    {
        CheckIsRunning();
        QCoreApplication::processEvents(QEventLoop::AllEvents, 100);
    }
}

void WaitUtils::WaitMsNoException(int msec)
{
    //多处调用displayProgress该变量且有的时true有的时false时会导致进度显示异常，想不通。。。
    QElapsedTimer ela;
    ela.start();
    while (ela.elapsed() < msec)
    {
        QCoreApplication::processEvents(QEventLoop::AllEvents, 300);
    }
}

void WaitUtils::Reset()
{
    _isRunning=true;
}

void WaitUtils::Stop()
{
    _isRunning=false;
}

void WaitUtils::WaitMsNoProgress(int time)
{
    QElapsedTimer ela;
    ela.start();
    while (ela.elapsed() < time)
    {
        CheckIsRunning();
        QCoreApplication::processEvents(QEventLoop::AllEvents, 300);
    }
}

void WaitUtils::CheckIsRunning()
{
    if(!_isRunning)
    {
        throw QString("流程中止");
    }
}