diff options
Diffstat (limited to 'kwallet/backend/kwalletbackend.h')
| -rw-r--r-- | kwallet/backend/kwalletbackend.h | 161 |
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 + |