/** * * @file FITKAbstractDataManagerHelper.h * @brief 数据管理模板实际执行器声明 * @author LiBaojun (libaojunqd@foxmail.com) * @date 2024-02-22 * */ #ifndef __FITKABSTRACTEDATAMANAGERHELPER_H__ #define __FITKABSTRACTEDATAMANAGERHELPER_H__ #include #include #include #include #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& 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& 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); 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& _dataList; /** * @brief 父对象id * @author LiBaojun (libaojunqd@foxmail.com) * @date 2024-04-07 */ int _parentDataID{ -1 }; }; } #endif