kngroupmanager.h

Go to the documentation of this file.

/*
    KNode, the KDE newsreader
    Copyright (c) 1999-2005 the KNode authors.
    See file AUTHORS for details

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.
    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software Foundation,
    Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, US
*/

#ifndef KNGROUPMANAGER_H
#define KNGROUPMANAGER_H

#include "kngroup.h"
#include "knjobdata.h"
#include "knnntpaccount.h"

#include <QObject>
#include <qlist.h>

class KNArticleManager;
class KNCleanUp;


//=================================================================================

class KNGroupInfo {

  public:

    KNGroupInfo();
    KNGroupInfo(const QString &n_ame, const QString &d_escription, bool n_ewGroup=false, bool s_ubscribed=false, KNGroup::Status s_tatus=KNGroup::unknown );
    ~KNGroupInfo();

    QString name,description;
    bool newGroup, subscribed;
    KNGroup::Status status;

    bool operator== (const KNGroupInfo &gi2) const;
    bool operator< (const KNGroupInfo &gi2) const;
};


class KNGroupListData : public KNJobItem {

  public:
    typedef boost::shared_ptr<KNGroupListData> Ptr;

    KNGroupListData();
    ~KNGroupListData();

    bool readIn(KNJobData *job=0);
    bool writeOut();
    void merge(QList<KNGroupInfo>* newGroups);

    QList<KNGroupInfo>* extractList();

    QStringList subscribed;
    QString path;
    QList<KNGroupInfo> *groups;
    QDate fetchSince;
    bool getDescriptions;
    QTextCodec *codecForDescriptions;

};

//===============================================================================


class KNGroupManager : public QObject , public KNJobConsumer {

  Q_OBJECT

  public:

    explicit KNGroupManager( QObject * parent = 0 );
    ~KNGroupManager();

    // group access
    void loadGroups( KNNntpAccount::Ptr a );
    void getSubscribed( KNNntpAccount::Ptr a, QStringList &l );
    KNGroup::List groupsOfAccount( KNNntpAccount::Ptr a );

    bool loadHeaders( KNGroup::Ptr g );
    bool unloadHeaders( KNGroup::Ptr g, bool force = true );

    KNGroup::Ptr group( const QString &gName, const KNServerInfo::Ptr s );
    KNGroup::Ptr firstGroupOfAccount( const KNServerInfo::Ptr s );
    KNGroup::Ptr currentGroup() const { return c_urrentGroup; }
    bool hasCurrentGroup() const               { return (c_urrentGroup!=0); }
    void setCurrentGroup( KNGroup::Ptr g );

    // group handling
    void showGroupDialog( KNNntpAccount::Ptr a, QWidget *parent = 0 );
    void subscribeGroup( const KNGroupInfo *gi, KNNntpAccount::Ptr a );
    bool unsubscribeGroup( KNGroup::Ptr g = KNGroup::Ptr() );
    void showGroupProperties( KNGroup::Ptr g = KNGroup::Ptr() );
    void expireGroupNow( KNGroup::Ptr g = KNGroup::Ptr() );
    void reorganizeGroup( KNGroup::Ptr g = KNGroup::Ptr() );

    void checkGroupForNewHeaders( KNGroup::Ptr g = KNGroup::Ptr() );
    void checkAll( KNNntpAccount::Ptr a, bool silent = false );
    void checkAll( int id, bool silent = false );

    void expireAll(KNCleanUp *cup);
    void expireAll( KNNntpAccount::Ptr a );
    void syncGroups();

  public slots:
    void slotLoadGroupList( KNNntpAccount::Ptr a );
    void slotFetchGroupList( KNNntpAccount::Ptr a );
    void slotCheckForNewGroups( KNNntpAccount::Ptr a, QDate date );

  protected:
    void processJob(KNJobData *j);
    KNGroup::List mGroupList;
    KNGroup::Ptr c_urrentGroup;
    KNArticleManager *a_rticleMgr;

  signals:
    void newListReady( KNGroupListData::Ptr d );

    void groupAdded( KNGroup::Ptr g );
    void groupRemoved( KNGroup::Ptr g );
    void groupUpdated( KNGroup::Ptr g );

};



#endif