kngroup.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 KNGROUP_H
#define KNGROUP_H

#include "configuration/settings_container_interface.h"
#include "knarticle.h"
#include "knarticlecollection.h"
#include "knjobdata.h"
#include "knglobals.h"
#include "knnntpaccount.h"

#include <kio/job.h>
#include <KPIMIdentities/Identity>
#include <QByteArray>
#include <QList>

namespace KNode {
  class Cleanup;
}


class KNGroup : public KNArticleCollection , public KNJobItem, public KNode::SettingsContainerInterface
{
  public:
    typedef boost::shared_ptr<KNGroup> Ptr;

    enum Status { unknown=0, readOnly=1, postingAllowed=2, moderated=3 };

    explicit KNGroup( KNCollection::Ptr p = KNCollection::Ptr() );
    ~KNGroup();

    typedef QList<KNGroup::Ptr> List;

    collectionType type()               { return CTgroup; }

    void updateListItem();

    QString path();
    bool readInfo(const QString &confPath);
    void writeConfig();

    bool hasName() const                         { return (!n_ame.isEmpty()); }
    const QString& name();
    const QString& groupname()              { return g_roupname; }
    void setGroupname(const QString &s)     { g_roupname=s; }
    QString description() const { return d_escription; }
    void setDescription( const QString &s ) { d_escription = s; }

    int newCount() const               { return n_ewCount; }
    void setNewCount(int i)       { n_ewCount=i; }
    void incNewCount(int i=1)     { n_ewCount+=i; }
    void decNewCount(int i=1)     { n_ewCount-=i; }
    int firstNewIndex() const          { return f_irstNew; }
    void setFirstNewIndex(int i)  { f_irstNew=i; }

    int lastFetchCount() const         { return l_astFetchCount; }
    void setLastFetchCount(int i) { l_astFetchCount=i; }

    int readCount()const               { return r_eadCount; }
    void setReadCount(int i)      { r_eadCount=i; }
    void incReadCount(int i=1)    { r_eadCount+=i; }
    void decReadCount(int i=1)    { r_eadCount-=i; }

    int firstNr() const { return f_irstNr; }
    void setFirstNr( int i ) { f_irstNr = i; }
    int lastNr() const { return l_astNr; }
    void setLastNr( int i ) { l_astNr = i; }
    int maxFetch() const { return m_axFetch; }
    void setMaxFetch( int i ) { m_axFetch = i; }

    int statThrWithNew();
    int statThrWithUnread();

    // article access
    KNRemoteArticle::Ptr at( int i )
      { return boost::static_pointer_cast<KNRemoteArticle>( KNArticleCollection::at( i ) ); }
    KNRemoteArticle::Ptr byId( int id )
      { return boost::static_pointer_cast<KNRemoteArticle>( KNArticleCollection::byId( id ) ); }
    KNRemoteArticle::Ptr byMessageId( const QByteArray &mId )
      { return boost::static_pointer_cast<KNRemoteArticle>( KNArticleCollection::byMessageId( mId ) ); }

    bool loadHdrs();
    bool unloadHdrs(bool force=true);
    void insortNewHeaders( const KIO::UDSEntryList &list, KNJobData *job = 0 );
    int saveStaticData(int cnt,bool ovr=false);
    void saveDynamicData(int cnt,bool ovr=false);
    void syncDynamicData();

    void appendXPostID(const QString &id);
    void processXPostBuffer(bool deleteAfterwards);

    void updateThreadInfo();
    void reorganize();
    void scoreArticles(bool onlynew=true);

    bool isLocked()             { return l_ocked; }
    void setLocked(bool l)      { l_ocked=l; }

    QString prepareForExecution();

    const QByteArray defaultCharset()           { return d_efaultChSet; }
    void setDefaultCharset( const QByteArray &s ) { d_efaultChSet = s; }
    bool useCharset()                         { return ( u_seCharset && !d_efaultChSet.isEmpty() ); }
    void setUseCharset(bool b)                { u_seCharset=b; }

    KNNntpAccount::Ptr account();

    virtual const KPIMIdentities::Identity & identity() const;
    virtual void setIdentity( const KPIMIdentities::Identity &i )
      { mIdentityUoid = ( i.isNull() ? -1 : i.uoid() ); }

    Status status() const { return s_tatus; }
    void setStatus(Status s) { s_tatus = s; }
    void showProperties();

    KNode::Cleanup *cleanupConfig() const { return mCleanupConf; }
    KNode::Cleanup *activeCleanupConfig();


  protected:
    void buildThreads(int cnt, KNJobData *parent=0);
    KNRemoteArticle::Ptr findReference( KNRemoteArticle::Ptr a );

    int       n_ewCount,
              l_astFetchCount,
              r_eadCount,
              i_gnoreCount,
              f_irstNr,
              l_astNr,
              m_axFetch,
              d_ynDataFormat,
              f_irstNew;

    QByteArray d_efaultChSet;
    QString   g_roupname,
              d_escription;

    bool      l_ocked,
              u_seCharset;

    Status    s_tatus;

    QStringList c_rosspostIDBuffer;

    QList<QByteArray> mOptionalHeaders;

    int mIdentityUoid;

    KNode::Cleanup *mCleanupConf;

    class dynDataVer0 {

      public:
        dynDataVer0()     { id=-1; idRef=-1; read=0; thrLevel=0; score=50; }
        ~dynDataVer0()    {}
        void setData( KNRemoteArticle::Ptr a );
        void getData( KNRemoteArticle::Ptr a );

        int id;
        int idRef;
        bool read;
        short thrLevel, score;
    };

    class dynDataVer1 {

      public:
        dynDataVer1()     { id=-1; idRef=-1; read=0; thrLevel=0; score=0, ignoredWatched=0; }
        void setData( KNRemoteArticle::Ptr a );
        void getData( KNRemoteArticle::Ptr a );

        int id;
        int idRef;
        bool read;
        short thrLevel, score;
        char ignoredWatched;
    };

    KNGroup::Ptr thisGroupPtr();

    virtual KNCollection::Ptr selfPtr()
    {
      return thisGroupPtr();
    }

};

#endif

// kate: space-indent on; indent-width 2;