tdewallet.h

/* This file is part of the KDE project
 *
 * Copyright (C) 2002-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 _TDEWALLET_H
#define _TDEWALLET_H
 
#include <tqglobal.h>
 
#ifdef Q_OS_UNIX
 
#include <tqstring.h>
#include <tqstringlist.h>
#include <tqobject.h>
#include <dcopobject.h>
 
class DCOPRef;
 
namespace TDEWallet {
 
class TDEIO_EXPORT Wallet : public TQObject, public DCOPObject {
    K_DCOP
    TQ_OBJECT
    protected:
        Wallet(int handle, const TQString& name);
        Wallet(const Wallet&);
 
    public:
        enum EntryType { Unknown=0, Password, Stream, Map, Unused=0xffff };
 
        virtual ~Wallet();
        
        static TQStringList walletList();
 
        static bool isEnabled();
 
        static bool isOpen(const TQString& name);
 
        static int closeWallet(const TQString& name, bool force);
 
        static int deleteWallet(const TQString& name);
 
        static bool disconnectApplication(const TQString& wallet, const TQCString& app);
 
        enum OpenType { Synchronous=0, Asynchronous, Path, OpenTypeUnused=0xff };
 
        static Wallet* openWallet(const TQString& name, WId w = 0, OpenType ot = Synchronous);
 
        static TQStringList users(const TQString& wallet);
 
        static const TQString LocalWallet();
 
        static const TQString NetworkWallet();
 
        static const TQString PasswordFolder();
 
        static const TQString FormDataFolder();
 
        static void changePassword(const TQString& name, WId w = 0);
 
        virtual int sync();
 
        virtual int lockWallet();
 
        virtual const TQString& walletName() const;
 
        virtual bool isOpen() const;
 
        virtual void requestChangePassword(WId w = 0);
 
        virtual TQStringList folderList();
 
        virtual bool hasFolder(const TQString& f);
 
        virtual bool setFolder(const TQString& f);
 
        virtual bool removeFolder(const TQString& f);
 
        virtual bool createFolder(const TQString& f);
 
        virtual const TQString& currentFolder() const;
 
        virtual TQStringList entryList();
 
        virtual int renameEntry(const TQString& oldName, const TQString& newName);
 
        virtual int readEntry(const TQString& key, TQByteArray& value);
 
        virtual int readMap(const TQString& key, TQMap<TQString,TQString>& value);
 
        virtual int readPassword(const TQString& key, TQString& value);
 
        int readEntryList(const TQString& key, TQMap<TQString, TQByteArray>& value);
 
        int readMapList(const TQString& key, TQMap<TQString, TQMap<TQString, TQString> >& value);
 
        int readPasswordList(const TQString& key, TQMap<TQString, TQString>& value);
 
        virtual int writeEntry(const TQString& key, const TQByteArray& value, EntryType entryType);
 
        virtual int writeEntry(const TQString& key, const TQByteArray& value);
 
        virtual int writeMap(const TQString& key, const TQMap<TQString,TQString>& value);
 
        virtual int writePassword(const TQString& key, const TQString& value);
 
        virtual bool hasEntry(const TQString& key);
 
        virtual int removeEntry(const TQString& key);
 
        virtual EntryType entryType(const TQString& key);
 
        static bool folderDoesNotExist(const TQString& wallet, const TQString& folder);
 
        static bool keyDoesNotExist(const TQString& wallet, const TQString& folder, 
                        const TQString& key);
 
    signals:
        void walletClosed();
 
        void folderUpdated(const TQString& folder);
 
        void folderListUpdated();
 
        void folderRemoved(const TQString& folder);
 
        void walletOpened(bool success);
 
    private:
    k_dcop:
        ASYNC slotWalletClosed(int handle);
 
        ASYNC slotFolderUpdated(const TQString& wallet, const TQString& folder);
 
        ASYNC slotFolderListUpdated(const TQString& wallet);
 
        ASYNC slotApplicationDisconnected(const TQString& wallet, const TQCString& application);
 
        ASYNC walletOpenResult(int rc);
 
    private slots:
        void slotAppUnregistered(const TQCString&);
 
    private:
        class WalletPrivate;
        WalletPrivate *d;
        TQString _name;
        TQString _folder;
        int _handle;
        DCOPRef *_dcopRef;
 
    protected:
        virtual void virtual_hook(int id, void *data);
};
 
}
 
#endif //Q_OS_UNIX
 
#endif //_TDEWALLET_H