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/kdelibs@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 161 insertions, 0 deletions

diff --git a/kwallet/backend/kwalletbackend.h b/kwallet/backend/kwalletbackend.h
new file mode 100644
index 000000000..f1e9e521d
--- /dev/null
+++ b/kwallet/backend/kwalletbackend.h
@@ -0,0 +1,161 @@
+/* This file is part of the KDE project
+ *
+ * Copyright (C) 2001-2004 George Staikos <staikos@kde.org>
+ *
+ * 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.
+ */
+
+
+#ifndef _KWALLETBACKEND_H
+#define _KWALLETBACKEND_H
+
+#include <kmdcodec.h>
+
+#include <qstring.h>
+#include <qstringlist.h>
+#include <qmap.h>
+#include "kwalletentry.h"
+
+
+namespace KWallet {
+
+class MD5Digest;
+
+/* @internal
+ */
+class KDE_EXPORT Backend {
+	public:
+		Backend(const QString& name = "kdewallet", bool isPath = false);
+		~Backend();
+
+		// Open and unlock the wallet.
+		int open(const QByteArray& password);
+
+		// Close and lock the wallet (saving changes).
+		int close(const QByteArray& password);
+
+		// Close the wallet, losing any changes.
+		int close();
+
+		// Write the wallet to disk
+		int sync(const QByteArray& password);
+
+		// Returns true if the current wallet is open.
+		bool isOpen() const;
+
+		// Returns the current wallet name.
+		const QString& walletName() const;
+
+		// The list of folders.
+		QStringList folderList() const;
+
+		// Force creation of a folder.
+		bool createFolder(const QString& f);
+
+		// Change the folder.
+		void setFolder(const QString& f) { _folder = f; }
+
+		// Current folder.  If empty, it's the global folder.
+		const QString& folder() const { return _folder; }
+
+		// Does it have this folder?
+		bool hasFolder(const QString& f) const { return _entries.contains(f); }
+
+		// Look up an entry.  Returns null if it doesn't exist.
+		Entry *readEntry(const QString& key);
+		
+		// Look up a list of entries.  Supports wildcards.
+		// You delete the list.
+		QPtrList<Entry> readEntryList(const QString& key);
+
+		// Store an entry.
+		void writeEntry(Entry *e);
+
+		// Does this folder contain this entry?
+		bool hasEntry(const QString& key) const;
+
+		// Returns true if the entry was removed
+		bool removeEntry(const QString& key);
+
+		// Returns true if the folder was removed
+		bool removeFolder(const QString& f);
+
+		// The list of entries in this folder.
+		QStringList entryList() const;
+
+		// Rename an entry in this folder.
+		int renameEntry(const QString& oldName, const QString& newName);
+
+		int ref() { return ++_ref; }
+
+		int deref() { return --_ref; }
+
+		int refCount() const { return _ref; }
+
+		static bool exists(const QString& wallet);
+
+		bool folderDoesNotExist(const QString& folder) const;
+
+		bool entryDoesNotExist(const QString& folder, const QString& entry) const;
+
+		static QString openRCToString(int rc);
+
+	private:
+		class BackendPrivate;
+		BackendPrivate *d;
+		QString _name;
+		QString _path;
+		bool _open;
+		QString _folder;
+		int _ref;
+		// Map Folder->Entries
+		typedef QMap< QString, Entry* > EntryMap;
+		typedef QMap< QString, EntryMap > FolderMap;
+		FolderMap _entries;
+		typedef QMap<MD5Digest, QValueList<MD5Digest> > HashMap;
+		HashMap _hashes;
+};
+
+/**
+ * @internal
+ */
+class MD5Digest : public QByteArray {
+	public:
+		MD5Digest() : QByteArray(16) {}
+		MD5Digest(const KMD5::Digest d) : QByteArray() { duplicate(reinterpret_cast<const char *>(d), 16); }
+		virtual ~MD5Digest() {}
+
+		int operator<(const MD5Digest& r) const {
+				int i = 0;
+				char x, y;
+				for (; i < 16; ++i) {
+					x = at(i);
+					y = r.at(i);
+					if (x != y) {
+						break;
+					}
+				}
+				if (i < 16 && x < y) {
+					return 1;
+				}
+				return 0;
+			}
+};
+
+}
+
+#endif
+