contact_manager.h

/*
    $Id: contact__manager_8h-source.html,v 1.1 2004/10/05 21:12:01 mentat Exp $

    GNU Messenger - The secure instant messenger

    Copyright (C) 2003-2004 Jesse Lovelace <jesse at aslogicsys dot com>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program 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 General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
*/

#ifndef GM_CONTACT_MANAGER_H
#define GM_CONTACT_MANAGER_H

#include <map>
#include "gm/xmlnode.h"
#include "gm/exception.h"
#include "gm/tree.h"

namespace GNUMessenger
{
    using namespace std;

    class Contact;

    class ContactManager
    {
    public:
        ContactManager(XMLNode& xml): m_xml(xml) {}

        class InvalidUserName: public Exception
        {
        public:
            InvalidUserName(const string& error): Exception(error) {}
        };

        class InvalidFolder: public Exception
        {
        public:
            InvalidFolder(const string& msg): Exception(msg) {}
        };

        class InvalidNode: public Exception
        {
        public:
            InvalidNode(const string& msg): Exception(msg) {}
        };

        enum Type { FOLDER, BASEFOLDER, CONTACT, CONTACTBASE, PROTOCOL };

        bool addContact(const string& contactname, const string& folder = "");
        
        bool addContact(const Contact& contact, const string& folder = "");
        
        bool deleteContact(const string& contactname);

        bool moveContact(const string& name, const string& newbase);

        bool renameContact(const string& oldname, const string& newname);
        
        Contact getContact(const string& contactname);

        vector<Contact> getAllContacts();

        bool setInfo(const string& username, const string& infoname, const string& data, const string& childof = "");
        
        bool deleteInfo(const string& username, const string& infoname);

        string getAvailableName() const;

        string getInfo(const string& username, const string& infoname);
        map<string, string> getAllInfo(const string& username);

        bool addNet(const string& username, const string& netname, const string& login);
        bool deleteNet(const string& username, const string& netname);
        

        /* ------- Folder Manipulation --------- */
        bool renameFolder(const string& oldname, const string& newname);
        bool addFolder(const string& folder_name, const string& base = "");
        bool deleteFolder(const string& folder_name);
        bool moveFolder(const string& name, const string& newbase);
        
        bool folderExists(const string& name) const;
        bool contactExists(const string& name) const;

        Folder getFolder(const string& name = "");
      
        void getContactsOfProtocol(const string& protocol, vector<Contact>& contacts);        
        
        void deleteAllNets(const string& contactname);
        
        void deleteAllInfo(const string& contactname);

        unsigned long getCount();
        
        string getPublicKey(const string& contactname);

        bool getInfoXML(const string& username, XMLNode& xml);
        bool setInfoXML(const string& username, const XMLNode& xml);
        
        
        XMLNode getXML(const string& name);
        XMLNode getFolderXML(const string & name);

    private:


        XMLNode& m_xml;
    };

} 

#endif //GM_CONTACT_MANAGER_H

---