manager.h

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

    GNU Messenger - The secure instant messenger

    Copyright (C) 1999-2001  Henrik Abelsson <henrik@abelsson.com>
    Copyright (C) 2002-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_PROTOCOL_MANAGER_H
#define GM_PROTOCOL_MANAGER_H

#include <string>
#include <vector>

#include "gm/xml_manager.h"
#include "gm/protocol.h"
#include "gm/basenetwork.h"

namespace GNUMessenger 
{
    using namespace std;

    class ProtocolManager
    {
    public:
        class InvalidContact: public Exception
        {
        public:
            InvalidContact(const string& str): Exception(str) {}
        };

        class InvalidNetwork: public Exception
        {
        public:
            InvalidNetwork(const string& str): Exception(str) {}
        };

        class NetworkError: public Exception
        {
        public:
            NetworkError(const string& str): Exception(str) {}
        };

        ProtocolManager(XMLManager& auth):m_auth(auth), m_shutdown(false) {}

        virtual ~ProtocolManager();

        bool removeProtocol(const string& proto);
        
        bool loadProtocol(const string& name);
        
        void shutdown();

        int getState(const string &proto);

        string screenName(const string &proto);

        bool update(const string &proto);

        void updateAll();

        bool hasProtocol(const string& name);

        bool changeSettings(const string& proto, XMLNode& conf);
            
        bool isGM(const Contact& c);
            
        void forceKeyX(const Contact& c);
        
        void changeCipher(const Contact& c, int cipherType, int keysize = -1, int blocksize = -1);
        
        Contact getContact(const string& name);
    
        list<Network*> getNets(const string &proto);

        list<Network*> getNetsAll();

        bool login(const string &proto);

        bool logout(const string &proto);

        bool setAway(const string& proto, const string& msg);

        void setAllAway(const string& msg);

        bool setInfo(const string& proto, const string& info);

        void setAllInfo(const string& info);
        
        void getInfo(const Contact& contact);

        bool sendMessage(const string& proto,const Contact& recipient, const string &message);
        
        bool sendMessage(const string& proto, const Contact& recipient, const VBuffer& data);

        bool sendMessage(const Contact& c, const string& message);
        
        bool sendMessage(const Contact& c, const VBuffer& data);

        void addContact(const Contact& c);
        
        bool delContact(const string& proto, const Contact& c);
        
        vector<string> protocols() const;
        
        unsigned long getSentBytes(const string& proto) const;
        unsigned long getSentPackets(const string& proto) const;
        
        unsigned long getRecvBytes(const string& proto) const;
        unsigned long getRecvPackets(const string& proto) const;
        
        vector<string> getRemoteIPs(const string& proto) const;

    private:

        friend class Protocol;

        void protoRecvdMessage(const string& proto, const Contact& c, const string& message);
        void protoRecvdMessageAnony(const string& proto, const Contact& c, const string& message);
        void protoStatusChange(const string& proto, const Contact& c);
        void protoError(const string& proto, int err_no, const string& error);
        void protoStateChange(const string &proto, Protocol::State st);
        void protoGotPubkey(const Contact& c, const string& key);
        void protoGotContacts(const string& proto, const vector<buddy>& c);
        void protoCustom(const string& proto, const XMLNode &n);
        void protoGotInfo(const Contact& c, const string& info, const string& proto);

    protected:

        void protoLoggedIn(const string& proto);
        void protoLoggedOut(const string& proto);

        Protocol *protocol(const string &proto);
        
        const Protocol * protocol(const string &proto) const;

        virtual Network *createNet(Protocol *protocol)=0;

        virtual NetworkServer * createServer(Protocol *protocol)=0;

        virtual void removeNet(Network *n) { delete n; }
        

        bool addProtocol(Protocol * proto);

        bool isOnline(const string& proto) const;

        void sendEncryptedMessage(const string& proto, const Contact& c, const string& mess) {}
        void sendEncryptedMessage(const string& proto, const Contact& c, const VBuffer& data) {}
        void receiveEncryptedMessage(const string& proto, const Contact& c, const string& mess) {}
        void receiveEncryptedMessage(const string& proto, const Contact& c, const VBuffer& data) {}
 
        virtual void c_loggedIn(const string &proto) {}
        virtual void c_loggedOut(const string &proto) {}
        virtual void c_recvdMessage(const string &proto, const Contact &c, const string &message) = 0;
        virtual void c_recvdMessageAnony(const string& protocol, const Contact& c, const string& message) = 0;
        virtual void c_statusChange(const string &proto, const Contact &c) {}
        virtual void c_error(const string &proto, int err_no, const string &error) {}
        virtual void c_stateChange(const string &proto, Protocol::State st) {}
        virtual void c_gotPubkey(const Contact& c, const string &key) {}
        virtual void c_gotBuddy(const string &proto, const Contact &c) {}
        virtual void c_gotContacts(const string& proto, const vector<buddy>& c) {}
        virtual void c_custom(const string &proto, const XMLNode &n) {}
        virtual void c_gotInfo(const Contact& c, const string& info, const string& proto) {}

        XMLManager& m_auth;

    private:
        // lists all enabled protocols, no necc logged in
        map<string, Protocol *> m_provider;

        // lists only the protocols that are logged in and ready to go
        map<string, bool> m_online;
        
        // has shutdown been called?  @todo this could fck up if we add stuff
        // after a shutdown...
        bool m_shutdown;
    };

} // !GNUMessenger

#endif // !GM_PROTOCOL_MANAGER

---