summaryrefslogtreecommitdiffstats
path: root/kmail/kmailicalifaceimpl.h
diff options
context:
space:
mode:
authortoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
committertoma <toma@283d02a7-25f6-0310-bc7c-ecb5cbfe19da>2009-11-25 17:56:58 +0000
commit460c52653ab0dcca6f19a4f492ed2c5e4e963ab0 (patch)
tree67208f7c145782a7e90b123b982ca78d88cc2c87 /kmail/kmailicalifaceimpl.h
downloadtdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.tar.gz
tdepim-460c52653ab0dcca6f19a4f492ed2c5e4e963ab0.zip
Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.
BUG:215923 git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdepim@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
Diffstat (limited to 'kmail/kmailicalifaceimpl.h')
-rw-r--r--kmail/kmailicalifaceimpl.h347
1 files changed, 347 insertions, 0 deletions
diff --git a/kmail/kmailicalifaceimpl.h b/kmail/kmailicalifaceimpl.h
new file mode 100644
index 000000000..261774860
--- /dev/null
+++ b/kmail/kmailicalifaceimpl.h
@@ -0,0 +1,347 @@
+/*
+ This file is part of KMail.
+
+ Copyright (c) 2003 Steffen Hansen <steffen@klaralvdalens-datakonsult.se>
+ Copyright (c) 2003 - 2004 Bo Thorsen <bo@sonofthor.dk>
+
+ This library is free software; you can redistribute it and/or
+ modify it under the terms of the GNU Library General Public
+ License as published by the Free Software Foundation; either
+ version 2 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
+ Library General Public License for more details.
+
+ You should have received a copy of the GNU Library General Public License
+ along with this library; see the file COPYING.LIB. If not, write to
+ the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
+ Boston, MA 02110-1301, USA.
+
+ In addition, as a special exception, the copyright holders give
+ permission to link the code of this program with any edition of
+ the Qt library by Trolltech AS, Norway (or with modified versions
+ of Qt that use the same license as Qt), and distribute linked
+ combinations including the two. You must obey the GNU General
+ Public License in all respects for all of the code used other than
+ Qt. If you modify this file, you may extend this exception to
+ your version of the file, but you are not obligated to do so. If
+ you do not wish to do so, delete this exception statement from
+ your version.
+*/
+
+/** @file This file contains the class KMailICalIfaceImpl which actually
+* implements the ICal (DCOP) interface for KMail.
+*/
+
+#ifndef KMAILICALIFACEIMPL_H
+#define KMAILICALIFACEIMPL_H
+
+#include "kmailicalIface.h"
+#include "kmfoldertype.h"
+#include <kfoldertree.h>
+
+#include <qdict.h>
+#include <qguardedptr.h>
+#include <qmap.h>
+
+class KMFolder;
+class KMMessage;
+class KMFolderDir;
+class KMFolderTreeItem;
+
+namespace KMail {
+
+ // Local helper class
+class ExtraFolder {
+public:
+ ExtraFolder( KMFolder* f );
+ ~ExtraFolder();
+ QGuardedPtr<KMFolder> folder;
+};
+
+class Accumulator {
+public:
+ Accumulator( const QString& t, const QString& f, int c )
+ :type( t ), folder( f ), count( c ) {}
+
+ void add( const QString& incidence ) {
+ incidences << incidence;
+ count--;
+ }
+ bool isFull() { return count == 0; }
+
+ const QString type;
+ const QString folder;
+ QStringList incidences;
+ int count;
+};
+
+}
+
+/** The implementation of the interface. */
+class KMailICalIfaceImpl : public QObject, virtual public KMailICalIface {
+ Q_OBJECT
+public:
+ KMailICalIfaceImpl();
+
+ bool isWritableFolder( const QString& type, const QString& resource );
+
+ StorageFormat storageFormat( const QString &resource );
+
+ /// Update a kolab storage entry.
+ /// If message is not there, it is added and
+ /// given the subject as Subject: header.
+ /// Returns the new mail serial number,
+ /// or 0 if something went wrong,
+ Q_UINT32 update( const QString& resource,
+ Q_UINT32 sernum,
+ const QString& subject,
+ const QString& plainTextBody,
+ const QMap<QCString, QString>& customHeaders,
+ const QStringList& attachmentURLs,
+ const QStringList& attachmentMimetypes,
+ const QStringList& attachmentNames,
+ const QStringList& deletedAttachments );
+
+ bool deleteIncidenceKolab( const QString& resource,
+ Q_UINT32 sernum );
+ int incidencesKolabCount( const QString& mimetype,
+ const QString& resource );
+ QMap<Q_UINT32, QString> incidencesKolab( const QString& mimetype,
+ const QString& resource,
+ int startIndex,
+ int nbMessages );
+
+ QValueList<SubResource> subresourcesKolab( const QString& contentsType );
+
+ bool triggerSync( const QString& contentsType );
+
+ // "Get" an attachment. This actually saves the attachment in a file
+ // and returns a URL to it
+ KURL getAttachment( const QString& resource,
+ Q_UINT32 sernum,
+ const QString& filename );
+
+ QString attachmentMimetype( const QString &resource,
+ Q_UINT32 sernum,
+ const QString &filename );
+
+ QStringList listAttachments( const QString &resource, Q_UINT32 sernum );
+
+
+ bool removeSubresource( const QString& );
+
+ bool addSubresource( const QString& resource,
+ const QString& parent,
+ const QString& contentsType );
+
+ // tell KOrganizer about messages to be deleted
+ void msgRemoved( KMFolder*, KMMessage* );
+
+ /** Initialize all folders. */
+ void initFolders();
+
+ /** Disconnect all slots and close the dirs. */
+ void cleanup();
+
+ /**
+ * Returns true if resource mode is enabled and folder is one of the
+ * resource folders.
+ */
+ bool isResourceFolder( KMFolder* folder ) const;
+
+ /* Returns true if the folder is one of the standard resource folders, as
+ * opposed to an extra folder. */
+ bool isStandardResourceFolder( KMFolder* folder ) const;
+
+ /**
+ * Returns true if isResourceFolder( folder ) returns true, and
+ * imap folders should be hidden.
+ */
+ bool hideResourceFolder( KMFolder* folder ) const;
+
+ /**
+ * Returns true if the given folder is the root of the groupware account,
+ * groupware folders are hidden, and only groupware folders shown in this
+ * account.
+ */
+ bool hideResourceAccountRoot( KMFolder* folder ) const;
+
+ /**
+ * Returns the resource folder type. Other is returned if resource
+ * isn't enabled or it isn't a resource folder.
+ */
+ KFolderTreeItem::Type folderType( KMFolder* folder ) const;
+
+ /**
+ * Returns the name of the standard icon for a folder of given type or
+ * QString::null if the type is no groupware type.
+ */
+ QString folderPixmap( KFolderTreeItem::Type type ) const;
+
+ /** Returns the localized name of a folder of given type.
+ */
+ QString folderName( KFolderTreeItem::Type type, int language = -1 ) const;
+
+ /** Get the folder that holds *type* entries */
+ KMFolder* folderFromType( const QString& type, const QString& folder );
+
+ /** Return the ical type of a folder */
+ QString icalFolderType( KMFolder* folder ) const;
+
+ /** Find message matching a given UID. */
+ KMMessage* findMessageByUID( const QString& uid, KMFolder* folder );
+ /** Find message matching a given serial number. */
+ static KMMessage* findMessageBySerNum( Q_UINT32 serNum, KMFolder* folder );
+
+ /** Convenience function to delete a message. */
+ void deleteMsg( KMMessage* msg );
+
+ bool isEnabled() const { return mUseResourceIMAP; }
+
+ /** Called when a folders contents have changed */
+ void folderContentsTypeChanged( KMFolder*, KMail::FolderContentsType );
+
+ /// @return the storage format of a given folder
+ StorageFormat storageFormat( KMFolder* folder ) const;
+ /// Set the storage format of a given folder. Called when seeing the kolab annotation.
+ void setStorageFormat( KMFolder* folder, StorageFormat format );
+
+
+ static const char* annotationForContentsType( KMail::FolderContentsType type );
+
+ // Called after a folder was synced with the server
+ void folderSynced( KMFolder* folder, const KURL& folderURL );
+ // Called when deletion of a folder from the server suceeded,
+ // triggers fb re-generation
+ void folderDeletedOnServer( const KURL& folderURL );
+ void addFolderChange( KMFolder* folder, FolderChanges changes );
+
+ // See CachedImapJob::slotPutMessageResult
+ bool isResourceQuiet() const;
+ void setResourceQuiet(bool q);
+
+public slots:
+ /* (Re-)Read configuration file */
+ void readConfig();
+ void slotFolderRemoved( KMFolder* folder );
+
+ void slotIncidenceAdded( KMFolder* folder, Q_UINT32 sernum );
+ void slotIncidenceDeleted( KMFolder* folder, Q_UINT32 sernum );
+ void slotRefresh( const QString& type);
+
+ // Called when a folder is made readonly or readwrite, or renamed,
+ // or any other similar change that affects the resources
+ void slotFolderPropertiesChanged( KMFolder* folder );
+
+private slots:
+ void slotRefreshFolder( KMFolder* );
+ void slotCheckDone();
+ void slotFolderLocationChanged( const QString&, const QString& );
+ void slotFolderRenamed();
+ void slotMessageRetrieved( KMMessage* );
+
+private:
+ /** Helper function for initFolders. Initializes a single folder. */
+ KMFolder* initFolder( KMail::FolderContentsType contentsType );
+ KMFolder* initScalixFolder( KMail::FolderContentsType contentsType );
+
+ void connectFolder( KMFolder* folder );
+
+ KMFolder* extraFolder( const QString& type, const QString& folder );
+
+ void syncFolder( KMFolder* folder ) const;
+
+ struct StandardFolderSearchResult
+ {
+ enum FoundEnum { FoundAndStandard, NotFound, FoundByType, FoundByName };
+ StandardFolderSearchResult() : folder( 0 ) {}
+ StandardFolderSearchResult( KMFolder* f, FoundEnum e ) : folder( f ), found( e ) {}
+ KMFolder* folder; // NotFound implies folder==0 of course.
+ FoundEnum found;
+ };
+
+ StandardFolderSearchResult findStandardResourceFolder( KMFolderDir* folderParentDir, KMail::FolderContentsType contentsType );
+ KMFolder* findResourceFolder( const QString& resource );
+
+
+ bool updateAttachment( KMMessage& msg,
+ const QString& attachmentURL,
+ const QString& attachmentName,
+ const QString& attachmentMimetype,
+ bool lookupByName );
+ bool deleteAttachment( KMMessage& msg,
+ const QString& attachmentURL );
+ Q_UINT32 addIncidenceKolab( KMFolder& folder,
+ const QString& subject,
+ const QString& plainTextBody,
+ const QMap<QCString, QString>& customHeaders,
+ const QStringList& attachmentURLs,
+ const QStringList& attachmentNames,
+ const QStringList& attachmentMimetypes );
+ static bool kolabXMLFoundAndDecoded( const KMMessage& msg, const QString& mimetype, QString& s );
+
+ void handleFolderSynced( KMFolder* folder,
+ const KURL& folderURL,
+ int _changes );
+ void triggerKolabFreeBusy( const KURL& folderURL );
+
+ StorageFormat globalStorageFormat() const;
+
+ static bool folderIsAlarmRelevant( const KMFolder * );
+
+private:
+ QGuardedPtr<KMFolder> mContacts;
+ QGuardedPtr<KMFolder> mCalendar;
+ QGuardedPtr<KMFolder> mNotes;
+ QGuardedPtr<KMFolder> mTasks;
+ QGuardedPtr<KMFolder> mJournals;
+
+ // The extra IMAP resource folders
+ // Key: folder location. Data: folder.
+ QDict<KMail::ExtraFolder> mExtraFolders;
+ // used for collecting incidences during async loading
+ QDict<KMail::Accumulator> mAccumulators;
+ // More info for each folder we care about (mContacts etc. as well as the extra folders)
+ // The reason for storing it here is that it can be shared between
+ // kmfoldercachedimap and kmfolderimap, and that it's groupware data anyway.
+ struct FolderInfo {
+ FolderInfo() {} // for QMap
+ FolderInfo( StorageFormat f, FolderChanges c ) :
+ mStorageFormat( f ), mChanges( c ) {}
+ StorageFormat mStorageFormat;
+ FolderChanges mChanges;
+ };
+ // The storage format used for each folder that we care about
+ typedef QMap<KMFolder*, FolderInfo> FolderInfoMap;
+ // helper for reading the FolderInfo from the config file
+ FolderInfo readFolderInfo( const KMFolder * const folder ) const;
+
+ FolderInfoMap mFolderInfoMap;
+
+ unsigned int mFolderLanguage;
+
+ KMFolderDir* mFolderParentDir;
+ KMFolder* mFolderParent;
+ KMFolderType mFolderType;
+
+ bool mUseResourceIMAP;
+ bool mResourceQuiet;
+ bool mHideFolders;
+
+ /*
+ * Bunch of maps to keep track of incidents currently in transfer, ones
+ * which need to be ungotten, once we are done, once with updates pending.
+ * Since these are transient attributes of only a small but changing number
+ * of incidences they are not encapsulated in a struct or somesuch.
+ */
+ QMap<QString, Q_UINT32> mUIDToSerNum;
+ QMap<Q_UINT32, bool> mTheUnGetMes;
+ QMap<QString, QString> mPendingUpdates;
+ QMap<QString, bool> mInTransit;
+
+};
+
+#endif // KMAILICALIFACEIMPL_H