|
|
/**
|
|
|
*
|
|
|
* @file FITKAbstractDataManagerHelper.h
|
|
|
* @brief 数据管理模板实际执行器声明
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*
|
|
|
*/
|
|
|
#ifndef __FITKABSTRACTEDATAMANAGERHELPER_H__
|
|
|
#define __FITKABSTRACTEDATAMANAGERHELPER_H__
|
|
|
|
|
|
#include <QList>
|
|
|
#include <QHash>
|
|
|
#include <QObject>
|
|
|
#include <QString>
|
|
|
#include "FITKCoreAPI.h"
|
|
|
|
|
|
namespace Core
|
|
|
{
|
|
|
class FITKAbstractDataObject;
|
|
|
/**
|
|
|
* @brief 数据管理模板实际执行器
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
class FITKCoreAPI FITKAbstractDataManagerHelper : public QObject
|
|
|
{
|
|
|
Q_OBJECT
|
|
|
public:
|
|
|
/**
|
|
|
* @brief Construct a new FITKAbstractDataManagerHelper object
|
|
|
* @param[i] l 数据管理器中的链表引用
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
explicit FITKAbstractDataManagerHelper(QList<FITKAbstractDataObject*>& l);
|
|
|
/**
|
|
|
* @brief Destroy the FITKAbstractDataManagerHelper object
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-04-07
|
|
|
*/
|
|
|
~FITKAbstractDataManagerHelper() = default;
|
|
|
/**
|
|
|
* @brief 追加对象
|
|
|
* @param[i] obj 追加的数据对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void appendData(FITKAbstractDataObject* obj);
|
|
|
|
|
|
/**
|
|
|
* @brief 批量追加对象
|
|
|
* @param[i] objs 追加的数据对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-08-27
|
|
|
*/
|
|
|
void appendData(const QList<FITKAbstractDataObject*>& objs);
|
|
|
/**
|
|
|
* @brief 获取管理的数据数量
|
|
|
* @return int 数据数量
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
int getDataCount() const;
|
|
|
/**
|
|
|
* @brief 是否包含数据对象
|
|
|
* @param[i] obj 待判定对象指针
|
|
|
* @return true 包含该对象
|
|
|
* @return false 不包含该对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
bool isContains(FITKAbstractDataObject* obj) const;
|
|
|
/**
|
|
|
* @brief 清空管理器
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void clear();
|
|
|
/**
|
|
|
* @brief 插入数据对象，索引越界追加，索引为负数插入到最前面
|
|
|
* @param[i] index 插入的索引
|
|
|
* @param[i] item 待插入的数据对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void insertDataObj(int index, FITKAbstractDataObject* item);
|
|
|
/**
|
|
|
* @brief 根据索引获取数据对象，越界返回空指针
|
|
|
* @param[i] index 索引
|
|
|
* @return T* 数据对象指针
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
FITKAbstractDataObject* getDataByIndex(const int index);
|
|
|
/**
|
|
|
* @brief 根据数据ID获取对象
|
|
|
* @param[i] id 数据ID
|
|
|
* @return T* 数据对象指针
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
FITKAbstractDataObject* getDataByID(const int id);
|
|
|
/**
|
|
|
* @brief 根据名称获取数据对象，只对FITKAbstractNDataObject派生类生效
|
|
|
* @param[i] name 对象名称
|
|
|
* @param[i] CompSens 大小写敏感
|
|
|
* @return T* 对象指针
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
FITKAbstractDataObject* getDataByName(const QString& name, bool compSens);
|
|
|
/**
|
|
|
* @brief 获取数据对象的索引，错误值返回-1
|
|
|
* @param[i] obj 数据对象指针
|
|
|
* @return int 查询到的索引值
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
int getDataIndex(FITKAbstractDataObject* obj);
|
|
|
/**
|
|
|
* @brief 移除对象
|
|
|
* @param[i] obj 需要移除的对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void removeDataObj(FITKAbstractDataObject* obj);
|
|
|
/**
|
|
|
* @brief 移除对象,不释放对象
|
|
|
* @param[i] obj 需要移除的对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void removeDataObjWithoutRelease(FITKAbstractDataObject* obj);
|
|
|
/**
|
|
|
* @brief 移除第index个对象
|
|
|
* @param[i] index 对象索引
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void removeDataByIndex(int index);
|
|
|
/**
|
|
|
* @brief 根据数据ID移除对象
|
|
|
* @param[i] id 数据ID
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void removeDataByID(int id);
|
|
|
/**
|
|
|
* @brief 根据名称移除对象
|
|
|
* @param[i] name 数据对象名称
|
|
|
* @param[i] CompSens 大小写敏感
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void removeDataByName(const QString &name, bool CompSens);
|
|
|
/**
|
|
|
* @brief 设置父对象ID
|
|
|
* @param[i] id 父对象ID
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-04-07
|
|
|
*/
|
|
|
void setParentDataID(const int & id);
|
|
|
/**
|
|
|
* @brief 获取父对象id
|
|
|
* @return int
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-04-07
|
|
|
*/
|
|
|
int getParentDataID() const;
|
|
|
/**
|
|
|
* @brief 检查名称是否重复
|
|
|
* @param[i] name 待检查的名字
|
|
|
* @return QString 不合法返回新名称，合法返回原始名称
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-04-11
|
|
|
*/
|
|
|
QString checkName(const QString& name);
|
|
|
|
|
|
/**
|
|
|
* @brief 通过数据ID获取数据索引。
|
|
|
* @param dataId：数据对象ID
|
|
|
* @return 数据对象索引
|
|
|
* @author ChengHaotian (yeguangbaozi@foxmail.com)
|
|
|
* @date 2024-10-22
|
|
|
*/
|
|
|
int getIndexByID(int dataId);
|
|
|
|
|
|
/**
|
|
|
* @brief 通过数据索引获取数据ID。
|
|
|
* @param dataIndex：数据对象索引
|
|
|
* @return 数据对象ID
|
|
|
* @author ChengHaotian (yeguangbaozi@foxmail.com)
|
|
|
* @date 2024-10-22
|
|
|
*/
|
|
|
int getIDByIndex(int dataIndex);
|
|
|
|
|
|
private:
|
|
|
/**
|
|
|
* @brief 关联/断开数据对象与本管理器的信号关联
|
|
|
* @param[i] obj 数据对象
|
|
|
* @param[i] con 是否关联
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void connectHelper(FITKAbstractDataObject* obj, bool con = true);
|
|
|
|
|
|
|
|
|
public slots :
|
|
|
/**
|
|
|
* @brief 对象被销毁之后的操作
|
|
|
* @param[i] obj 被销毁对象
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
void dataObjectDestoried(FITKAbstractDataObject* obj);
|
|
|
|
|
|
private:
|
|
|
/**
|
|
|
* @brief 数据管理器引用
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-02-22
|
|
|
*/
|
|
|
QList<FITKAbstractDataObject*>& _dataList;
|
|
|
/**
|
|
|
* @brief 父对象id
|
|
|
* @author LiBaojun (libaojunqd@foxmail.com)
|
|
|
* @date 2024-04-07
|
|
|
*/
|
|
|
int _parentDataID{ -1 };
|
|
|
};
|
|
|
}
|
|
|
|
|
|
|
|
|
|
|
|
#endif
|