ukui-search/libsearch/appdata/application-info.h

#ifndef APPLICATIONINFO_H
#define APPLICATIONINFO_H

#include <QObject>

#include "application-property.h"
namespace UkuiSearch {
class ApplicationInfoPrivate;
class ApplicationInfo : public QObject
{
    Q_OBJECT
public:
    explicit ApplicationInfo(QObject *parent = nullptr);
    ~ApplicationInfo();
    /**
     * @brief getInfo 查询单个应用的单个属性
     * @param desktopFile
     * @param property
     * @return
     */
    QVariant getInfo(const QString &desktopFile, ApplicationProperty::Property property);
    /**
     * @brief getInfo 查询单个应用的多个属性
     * @param desktopFile
     * @param properties
     * @return
     */
    ApplicationPropertyMap getInfo(const QString &desktopFile, ApplicationProperties properties);
    /**
     * @brief getInfo 查询所有应用的多个属性
     * @param property
     * @return
     */
    ApplicationInfoMap getInfo(ApplicationProperties properties);

    /**
     * @brief ApplicationInfo::getInfo
     * get the application info that meets the restrictions
     * @param restrictions: The restrictions that the search results should meet(e.g. u want get the app infos whose top state is 0)
     * @param properties: Each application's information should contain these properties
     * @return ApplicationInfoMap: the search result
     */
    ApplicationInfoMap getInfo(ApplicationProperties properties, ApplicationPropertyMap restrictions);

    /**
     * @brief ApplicationInfo::searchApp
     * @param keyWord: the keyword of this search for applications
     * @param installAppInfoRes: the search results of applications
     * @return ApplicationInfoMap: the search result
     */
    ApplicationInfoMap searchApp(ApplicationProperties properties, const QString &keyword, ApplicationPropertyMap restrictions);
    ApplicationInfoMap searchApp(ApplicationProperties properties, const QStringList &keywords, ApplicationPropertyMap restrictions);

    /**
     * @brief ApplicationInfo::setAppFavoritesState
     * set the favorites state of the app
     * @param desktopFilePath: the desktop file path of app
     * @param num: the favorites app's order(from 1)
     */
    void setAppFavoritesState(const QString &desktopFilePath, size_t num);

    /**
     * @brief ApplicationInfo::setAppTopState
     * set the top state of the app
     * @param desktopFilePath: the desktop file path of app
     * @param num: the top app's order(from 1)
     */
    void setAppTopState(const QString &desktopFilePath, size_t num);

    /**
     * @brief ApplicationInfo::changeFavoriteAppPos
     * change the position of the app which is one of the Favorites Apps
     * @param desktopFilePath: desktop file path of app
     * @param pos: the position which the app will be changed into
     */
    bool changeFavoriteAppPos(const QString &desktopFilePath, size_t pos);

    /**
     * @brief ApplicationInfo::changeTopAppPos
     * hange the position of the app which is one of the Top Apps
     * @param desktopFilePath: desktop file path of app
     * @param pos: the position which the app will be changed into
     * @return bool: true if success, else false
     */
    bool changeTopAppPos(const QString &desktopFilePath, size_t pos);

    /**
     * @brief ApplicationInfo::tranPid2DesktopFp
     * find the desktop file path of the process which corresponds to the pid
     * @param pid: the pid of the process which need to get its desktop file path
     * @param desktopFilePath: the desktop file path of the process corresponding to pid
     * @return bool:true if success,else false
     */
    bool tranPidToDesktopFp(int pid, QString &desktopFilePath);

Q_SIGNALS:
    void DBOpenFailed();
    void appDBItems2BUpdate(ApplicationInfoMap);
    void appDBItems2BUpdateAll(QStringList);
    void appDBItems2BAdd(QStringList);
    void appDBItems2BDelete(QStringList);

private:
    ApplicationInfoPrivate *d = nullptr;

};

}
#endif // APPLICATIONINFO_H