AppFlowPost/FITK_Kernel/FITKCore/FITKAbstractDataManager.hpp

/**
 *
 * @file FITKAbstractDataManager.hpp
 * @brief 数据管理器模板声明
 * @author LiBaojun (libaojunqd@foxmail.com)
 * @date 2024-02-22
 *
 */
#ifndef _FITKDATAMANAGERABSTRACT_H__
#define _FITKDATAMANAGERABSTRACT_H__

#include "FITKAbstractDataManagerHelper.h"
#include "FITKAbstractObject.hpp"
#include <QMutex>
#include <QMutexLocker>

namespace Core
{
    class FITKAbstractDataObject;
    class FITKAbstractDataManagerHelper;


    template <class T>
    /**
     * @brief 数据管理器模板，采用list维护， 线程安全
     * @author LiBaojun (libaojunqd@foxmail.com)
     * @date 2024-02-22
     */
    class  FITKAbstractDataManager
    {
    public:
        /**
         * @brief Construct a new FITKAbstractDataManager object
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        FITKAbstractDataManager()
        {
            _helper = new FITKAbstractDataManagerHelper(_dataList);
        }
        /**
         * @brief Destroy the FITKAbstractDataManager object
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual ~FITKAbstractDataManager()
        {
            this->clear();
            if (_helper) delete _helper;
        }
        /**
         * @brief 追加对象
         * @param[i] item          追加的数据对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void appendDataObj(FITKAbstractDataObject* item)
        {
            QMutexLocker locker(&_mutex);
            if (!isT(item))
                delete item;
            else
                _helper->appendData(item);
        }
        /**
         * @brief 批量追加对象
         * @param[i] items         追加的数据对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void appendDataObj(const QList<FITKAbstractDataObject*> & items)
        {
            QMutexLocker locker(&_mutex);
             _helper->appendData(items);
        }

        /**
         * @brief 获取管理的数据数量
         * @return int 数据数量
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual int getDataCount() const
        {
            QMutexLocker locker(&_mutex);
            return _dataList.size();
        }
        /**
         * @brief 是否包含数据对象
         * @param[i] obj        待判定对象指针
         * @return true   包含该对象
         * @return false  不包含该对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual bool isContains(FITKAbstractDataObject* obj)
        {
            QMutexLocker locker(&_mutex);
            return (_helper && _helper->isContains(obj));
        }
        /**
         * @brief 清空管理器
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void clear()
        {
            QMutexLocker locker(&_mutex);
            _helper->clear();
        }
        /**
         * @brief 插入数据对象，索引越界追加，索引为负数插入到最前面
         * @param[i] index           插入的索引
         * @param[i] item            待插入的数据对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void insertDataObj(int index, FITKAbstractDataObject* item)
        {
            QMutexLocker locker(&_mutex);
            if (!isT(item))
                delete item;
            else
                _helper->insertDataObj(index, item);
        }
        /**
         * @brief 根据索引获取数据对象，越界返回空指针
         * @param[i]  index          索引
         * @return T* 数据对象指针
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        T* getDataByIndex(const int index)
        {
            QMutexLocker locker(&_mutex);
            return transfe2T(_helper->getDataByIndex(index));
        }
        /**
         * @brief 运算符重载，根据索引获取数据对象，越界返回空指针
         * @param[i]  index          索引
         * @return T* 数据对象指针
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-25
         */
        T* operator[](const int index)
        {
            QMutexLocker locker(&_mutex);
            return transfe2T(_helper->getDataByIndex(index));
        }
        /**
         * @brief 根据数据ID获取对象
         * @param[i]  id             数据ID
         * @return T* 数据对象指针
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual T* getDataByID(const int id)
        {
            QMutexLocker locker(&_mutex);
            return transfe2T(_helper->getDataByID(id));
        }
        /**
         * @brief 获取数据对象的索引，错误值返回-1
         * @param[i]  obj           数据对象指针
         * @return int 查询到的索引值
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual int getDataIndex(FITKAbstractDataObject* obj) const
        {
            QMutexLocker locker(&_mutex);
            return _helper->getDataIndex(obj);
        }
        /**
         * @brief 根据名称获取数据对象，只对FITKAbstractNDataObject派生类生效
         * @param[i]  name           对象名称
         * @param[i]  CompSens       大小写敏感，false时，全部转为小写对比查找
         * @return T*               对象指针
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        T* getDataByName(const QString& name, bool CompSens = false)
        {
            QMutexLocker locker(&_mutex);
            return transfe2T(_helper->getDataByName(name,CompSens));
        }
        /**
         * @brief 移除对象
         * @param[i]  obj            需要移除的对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void removeDataObj(FITKAbstractDataObject* obj)
        {
            QMutexLocker locker(&_mutex);
            _helper->removeDataObj(obj);
        }
        /**
         * @brief 移除对象,不释放对象
         * @param[i]  obj            需要移除的对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-04-23
         */
        void removeDataObjWithoutRelease(FITKAbstractDataObject* obj)
        {
            QMutexLocker locker(&_mutex);
            _helper->removeDataObjWithoutRelease(obj);
        }
        /**
         * @brief 移除第index个对象
         * @param[i]  index          对象索引
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void removeDataByIndex(int index)
        {
            QMutexLocker locker(&_mutex);
            _helper->removeDataByIndex(index);
        }
        /**
         * @brief 根据数据ID移除对象
         * @param[i]  id            数据ID
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void removeDataByID(int id)
        {
            QMutexLocker locker(&_mutex);
            _helper->removeDataByID(id);
        }
        /**
         * @brief 根据名称移除对象
         * @param[i]  name           对象名称
         * @param[i]  CompSens       大小写敏感，false时，全部转为小写对比查找
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        virtual void removeDataByName(const QString &name, bool compSens = false)
        {
            QMutexLocker locker(&_mutex);
            _helper->removeDataByName(name,compSens);
        }
        /**
         * @brief 设置父对象ID
         * @param[i]  id             父对象ID
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-04-07
         */
        void setParentDataIDM(const int & id)
        {
            if (_helper)
                _helper->setParentDataID(id);
        }
        /**
         * @brief 获取父对象id
         * @return int
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-04-07
         */
        int getMParentDataIDM() const
        {
            if (_helper)
                return _helper->getParentDataID();
            return -1;
        }
        /**
         * @brief 检查名称是否重复
         * @param[i]  name         待检查的名字
         * @return QString         不合法返回新名称，合法返回原始名称
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-04-11
         */
        QString checkName(const QString& name)
        {
            if (_helper)
                return _helper->checkName(name);
            return name;
        }

        /**
         * @brief   通过数据ID获取数据索引。
         * @param   dataId：数据对象ID
         * @return  数据对象索引
         * @author  ChengHaotian (yeguangbaozi@foxmail.com)
         * @date    2024-10-22
         */
        int getIndexByID(int dataId)
        {
            QMutexLocker locker(&_mutex);
            return _helper->getIndexByID(dataId);
        }

        /**
         * @brief   通过数据索引获取数据ID。
         * @param   dataIndex：数据对象索引
         * @return  数据对象ID
         * @author  ChengHaotian (yeguangbaozi@foxmail.com)
         * @date    2024-10-22
         */
        int getIDByIndex(int dataIndex)
        {
            QMutexLocker locker(&_mutex);
            return _helper->getIDByIndex(dataIndex);
        }

    private:
        /**
         * @brief 是否为模板类型对象
         * @param[i]  obj          待判断的指针
         * @return true
         * @return false
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        bool isT(FITKAbstractDataObject* obj)
        {
            auto p = dynamic_cast<T*>(obj);
            return nullptr != p;
        }
        /**
         * @brief 转换为模板T类型
         * @param[i]  data        数据对象
         * @return T*
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        T* transfe2T(FITKAbstractDataObject* data)
        {
            return dynamic_cast<T*>(data);
        }

     protected:
        /**
         * @brief 实际执行插入删除等操作的对象
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        FITKAbstractDataManagerHelper * _helper{};
        /**
         * @brief 互斥锁，保证线程安全
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        mutable QMutex _mutex{};
        /**
         * @brief 数据对象链表
         * @author LiBaojun (libaojunqd@foxmail.com)
         * @date 2024-02-22
         */
        QList<FITKAbstractDataObject*> _dataList{};
    };



}

#endif