You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
tdepim/knode/kngroupmanager.h

143 lines
4.0 KiB

/*
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 <qobject.h>
#include <qsortedlist.h>
#include "knjobdata.h"
#include "kngroup.h"
class KNNntpAccount;
class KNProtocolClient;
class KNServerInfo;
class KNArticleManager;
class KNCleanUp;
//=================================================================================
/** helper classes for the group selection dialog
contains info about a newsgroup (name, description) */
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();
/** group names will be utf-8 encoded in the future... */
QString name,description;
bool newGroup, subscribed;
KNGroup::Status status;
bool operator== (const KNGroupInfo &gi2);
bool operator< (const KNGroupInfo &gi2);
};
class KNGroupListData : public KNJobItem {
public:
KNGroupListData();
~KNGroupListData();
bool readIn(KNProtocolClient *client=0);
bool writeOut();
void merge(QSortedList<KNGroupInfo>* newGroups);
QSortedList<KNGroupInfo>* extractList();
QStringList subscribed;
QString path;
QSortedList<KNGroupInfo> *groups;
QDate fetchSince;
bool getDescriptions;
QTextCodec *codecForDescriptions;
};
//===============================================================================
class KNGroupManager : public QObject , public KNJobConsumer {
Q_OBJECT
public:
KNGroupManager(QObject * parent=0, const char * name=0);
~KNGroupManager();
// group access
void loadGroups(KNNntpAccount *a);
void getSubscribed(KNNntpAccount *a, QStringList &l);
QValueList<KNGroup*> groupsOfAccount( KNNntpAccount *a );
bool loadHeaders(KNGroup *g);
bool unloadHeaders(KNGroup *g, bool force=true);
KNGroup* group(const QString &gName, const KNServerInfo *s);
KNGroup* firstGroupOfAccount(const KNServerInfo *s);
KNGroup* currentGroup() const { return c_urrentGroup; }
bool hasCurrentGroup() const { return (c_urrentGroup!=0); }
void setCurrentGroup(KNGroup *g);
// group handling
void showGroupDialog(KNNntpAccount *a, QWidget *parent=0);
void subscribeGroup(const KNGroupInfo *gi, KNNntpAccount *a);
bool unsubscribeGroup(KNGroup *g=0);
void showGroupProperties(KNGroup *g=0);
void expireGroupNow(KNGroup *g=0);
void reorganizeGroup(KNGroup *g=0);
void checkGroupForNewHeaders(KNGroup *g=0);
void checkAll(KNNntpAccount *a, bool silent=false);
void expireAll(KNCleanUp *cup);
void expireAll(KNNntpAccount *a);
void syncGroups();
public slots:
/** load group list from disk (if this fails: ask user if we should fetch the list) */
void slotLoadGroupList(KNNntpAccount *a);
/** fetch group list from server */
void slotFetchGroupList(KNNntpAccount *a);
/** check for new groups (created after the given date) */
void slotCheckForNewGroups(KNNntpAccount *a, QDate date);
protected:
/** reimplemented from @ref KNJobConsumer */
void processJob(KNJobData *j);
QValueList<KNGroup*> mGroupList;
KNGroup *c_urrentGroup;
KNArticleManager *a_rticleMgr;
signals:
void newListReady(KNGroupListData* d);
void groupAdded(KNGroup* g);
void groupRemoved(KNGroup* g);
void groupUpdated(KNGroup* g);
};
#endif