apiversionparser.h

Go to the documentation of this file.

//#
//# Copyright (C) 2022-2025 QuasarApp.
//# Distributed under the lgplv3 software license, see the accompanying
//# Everyone is permitted to copy and distribute verbatim copies
//# of this license document, but changing it is not allowed.
//#
 
 
#ifndef APIVERSIONPARSER_H
#define APIVERSIONPARSER_H
 
#include "abstractnodeinfo.h"
#include "iparser.h"
 
namespace QH {
 
namespace PKG {
class APIVersion;
class VersionIsReceived;
}
class HEARTSHARED_EXPORT APIVersionParser: public iParser
{
    Q_OBJECT
public:
    APIVersionParser(AbstractNode* node);
 
    ParserResult parsePackage(const QSharedPointer<PKG::AbstractData> &pkg,
                              const Header &pkgHeader,
                              AbstractNodeInfo *sender) override;
    int version() const override;
    QString parserId() const override;

    QString toString() const override;

    QSharedPointer<PKG::AbstractData>
    searchPackage(unsigned short cmd,
                  AbstractNodeInfo *sender) const;

    QSharedPointer<iParser> getSelectedApiParser(const QString& apiKey,
                                                 QH::AbstractNodeInfo *node) const;

    const QSharedPointer<QH::iParser>&
    addApiParser(const QSharedPointer<QH::iParser>& parserObject);

    QHash<QString, QSharedPointer<QH::iParser>>
    selectParser(const VersionData& distVersion) const;

    unsigned int parsersTypedCount() const;

    QSharedPointer<QH::iParser> selectParser(unsigned short cmd,
                                             AbstractNodeInfo *sender) const;

    QSharedPointer<QH::iParser> selectParser(const QString& parserKey,
                                             unsigned short version) const;

    QSharedPointer<QH::iParser> selectParser(const QString& parserKey,
                                             AbstractNodeInfo *sender) const;

    unsigned short maximumApiVersion(const QString& apiKey) const;

    unsigned short minimumApiVersion(const QString& apiKey) const;

    bool sendSupportedAPI(AbstractNodeInfo *dist) const;
 
    unsigned short selectPackageVersion(const VersionData& local, const VersionData& dist);
 
signals:

    void sigNoLongerSupport(const QString& ApiKey, unsigned short version);
 
private:
 
    QSharedPointer<QH::iParser>
    selectParserImpl(unsigned short cmd, AbstractNodeInfo *sender) const;
 
    QSharedPointer<QH::iParser>
    selectParserImpl(const QString& key, AbstractNodeInfo *sender) const;
 
    bool processAppVersion(const QSharedPointer<PKG::APIVersion> &message,
                           AbstractNodeInfo *sender,
                           const QH::Header &);
    bool versionDeliveredSuccessful(const QSharedPointer<PKG::VersionIsReceived> &,
                                    QH::AbstractNodeInfo *sender,
                                    const QH::Header &);
 
    QHash<QString, QMap<int, QSharedPointer<QH::iParser>>> _apiParsers;
 
    // This is internal check of registered commands.
    // works only in debug.
    bool commandsValidation(const QSharedPointer<iParser> &parserObject);
};
}
#endif // APIVERSIONPARSER_H