kmail

kmfoldermbox.h

Go to the documentation of this file.
00001 /*
00002  * kmail: KDE mail client
00003  * Copyright (c) 1996-1998 Stefan Taferner <taferner@kde.org>
00004  *
00005  * This program is free software; you can redistribute it and/or modify
00006  * it under the terms of the GNU General Public License as published by
00007  * the Free Software Foundation; either version 2 of the License, or
00008  * (at your option) any later version.
00009  *
00010  * This program is distributed in the hope that it will be useful,
00011  * but WITHOUT ANY WARRANTY; without even the implied warranty of
00012  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
00013  * GNU General Public License for more details.
00014  *
00015  * You should have received a copy of the GNU General Public License
00016  * along with this program; if not, write to the Free Software
00017  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
00018  *
00019  */
00020 #ifndef kmfoldermbox_h
00021 #define kmfoldermbox_h
00022 
00023 #include "kmfolderindex.h"
00024 #include "mboxjob.h"
00025 
00026 #include <sys/types.h> // for size_t
00027 
00028 namespace KMail {
00029   class FolderJob;
00030   class MboxJob;
00031   class AttachmentStrategy;
00032 }
00033 using KMail::FolderJob;
00034 using KMail::MboxJob;
00035 using KMail::AttachmentStrategy;
00036 
00037 /* Mail folder.
00038  * (description will be here).
00039  *
00040  * Accounts:
00041  *   The accounts (of KMail) that are fed into the folder are
00042  *   represented as the children of the folder. They are only stored here
00043  *   during runtime to have a reference for which accounts point to a
00044  *   specific folder.
00045  */
00046 
00047 class KMFolderMbox : public KMFolderIndex
00048 {
00049   Q_OBJECT
00050   friend class ::KMail::MboxJob;
00051 public:
00052 
00053 
00057   KMFolderMbox(KMFolder* folder, const char* name=0);
00058   virtual ~KMFolderMbox();
00059 
00061   virtual KMFolderType folderType() const { return KMFolderTypeMbox; }
00062 
00064   DwString getDwString(int idx);
00065 
00072   virtual int addMsg( KMMessage* msg, int* index_return = 0 );
00073 
00079   virtual int open(const char *owner);
00080 
00082   virtual void reallyDoClose(const char *owner);
00083 
00084   virtual int canAccess();
00085 
00087   virtual void sync();
00088 
00090   virtual int create();
00091 
00094   virtual int compact( bool silent );
00095 
00098   int compact( unsigned int startIndex, int nbMessages, FILE* tmpFile, off_t& offs, bool& done );
00099 
00101   virtual bool isReadOnly() const { return mReadOnly; }
00102 
00104   bool isLocked() const { return mFilesLocked; }
00105 
00106   void setLockType( LockType ltype=FCNTL );
00107 
00108   void setProcmailLockFileName( const QString& );
00109 
00110   static QByteArray escapeFrom( const DwString & str );
00111 
00112   virtual IndexStatus indexStatus();
00113 
00115   virtual Q_INT64 doFolderSize() const;
00116 
00117 protected:
00118   virtual FolderJob* doCreateJob( KMMessage *msg, FolderJob::JobType jt, KMFolder *folder,
00119                                   QString partSpecifier, const AttachmentStrategy *as ) const;
00120   virtual FolderJob* doCreateJob( QPtrList<KMMessage>& msgList, const QString& sets,
00121                                   FolderJob::JobType jt, KMFolder *folder ) const;
00124   virtual KMMessage* readMsg(int idx);
00125 
00129   virtual int createIndexFromContents();
00130 
00133   virtual int lock();
00134 
00137   virtual int unlock();
00138 
00142   virtual int removeContents();
00143 
00147   virtual int expungeContents();
00148 
00149 private:
00150   FILE *mStream;
00151   bool mFilesLocked; // TRUE if the files of the folder are locked (writable)
00152   bool mReadOnly; // true if locking failed
00153   LockType mLockType;
00154   QString mProcmailLockFileName;
00155 };
00156 
00157 #endif // kmfoldermbox_h