knewstuff3/core/provider.h

Go to the documentation of this file.

/*
    knewstuff3/provider.h
    This file is part of KNewStuff2.
    Copyright (c) 2009 Jeremy Whiting <jpwhiting@kde.org>
    Copyright (C) 2009 Frederik Gladhorn <gladhorn@kde.org>

    This library is free software; you can redistribute it and/or
    modify it under the terms of the GNU Lesser General Public
    License as published by the Free Software Foundation; either
    version 2.1 of the License, or (at your option) any later version.

    This library is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
    Lesser General Public License for more details.

    You should have received a copy of the GNU Lesser General Public
    License along with this library.  If not, see <http://www.gnu.org/licenses/>.
*/
#ifndef KNEWSTUFF3_PROVIDER_H
#define KNEWSTUFF3_PROVIDER_H

#include <QtCore/QList>
#include <QtCore/QString>

#include <kurl.h>

#include "entryinternal.h"

class KJob;

namespace KNS3
{
    class Provider: public QObject
    {
        Q_OBJECT
    public:
        typedef QList<Provider*> List;

        enum SortMode {
            Newest,
            Alphabetical,
            Rating,
            Downloads,
            Installed, // only installed items
            Updates // entries that can be updated
        };

        struct SearchRequest {
            SortMode sortMode;
            QString searchTerm;
            QStringList categories;
            int page;
            int pageSize;

            SearchRequest(SortMode sortMode_ = Newest, const QString& searchTerm_ = QString(), const QStringList& categories_ = QStringList(), int page_ = -1, int pageSize_ = 20)
                :sortMode(sortMode_), searchTerm(searchTerm_), categories(categories_), page(page_), pageSize(pageSize_)
            {}

            QString hashForRequest() const;
        };

        Provider();

        virtual ~Provider();

        virtual QString id() const = 0;

        virtual bool setProviderXML(const QDomElement & xmldata) = 0;

        virtual bool isInitialized() const = 0;

        virtual void setCachedEntries(const KNS3::EntryInternal::List& cachedEntries) = 0;

        virtual QString name() const;

        virtual KUrl icon() const; // FIXME use KIcon or pixmap?

        virtual void loadEntries(const KNS3::Provider::SearchRequest& request) = 0;
        virtual void loadEntryDetails(const KNS3::EntryInternal&) {}
        virtual void loadPayloadLink(const EntryInternal& entry, int linkId) = 0;

        virtual bool userCanVote() {return false;}
        virtual void vote(const EntryInternal& entry, uint rating) { Q_UNUSED(entry) Q_UNUSED(rating) }

        virtual bool userCanBecomeFan() {return false;}
        virtual void becomeFan(const EntryInternal& entry) { Q_UNUSED(entry) }

    signals:
        void providerInitialized(KNS3::Provider*);

        void loadingFinished(const KNS3::Provider::SearchRequest&, const KNS3::EntryInternal::List&) const;
        void loadingFailed(const KNS3::Provider::SearchRequest&);

        void entryDetailsLoaded(const KNS3::EntryInternal&);
        void payloadLinkLoaded(const KNS3::EntryInternal&);

        void signalInformation(const QString&) const;
        void signalError(const QString&) const;

    protected:
        QString mName;
        KUrl mIcon;
        
    private:
        Q_DISABLE_COPY(Provider)
    };
}

#endif