path: root/src/net/connectionhandler.h

/*
 *  The Mana Server
 *  Copyright (C) 2004-2010  The Mana World Development Team
 *
 *  This file is part of The Mana Server.
 *
 *  The Mana Server 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
 *  any later version.
 *
 *  The Mana Server 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 The Mana Server.  If not, see <http://www.gnu.org/licenses/>.
 */

#ifndef CONNECTIONHANDLER_H
#define CONNECTIONHANDLER_H

#include <list>
#include <string>
#include <enet/enet.h>

class MessageIn;
class MessageOut;
class NetComputer;

/**
 * This class represents the connection handler interface. The connection
 * handler will respond to connect/reconnect/disconnect events and handle
 * incoming messages, passing them on to registered message handlers.
 */
class ConnectionHandler
{
    public:
        virtual ~ConnectionHandler() {}

        /**
         * Open the server socket.
         *
         * @param port      the port to listen to
         * @param hostname  the host IP to listen on, defaults to the default localhost
         */
        bool startListen(enet_uint16 port,
                         const std::string &hostname = std::string());

        /**
         * Disconnect all the clients and close the server socket.
         */
        void stopListen();

        /**
         * Return the port the handler is listening on, or 0 if not listening.
         */
        enet_uint16 getPort() const;

        /**
         * Return the host the handler was asked to listen on.
         */
        const std::string &getHostname() const { return hostname; }

        /**
         * Process outgoing messages and listen to the server socket for
         * incoming messages and new connections.
         *
         * @timeout an optional timeout in milliseconds to wait for something
         *          to happen when there is nothing to do
         */
        void process(enet_uint32 timeout = 0);

        /**
         * Process outgoing messages.
         */
        void flush();

        /**
         * Called when a computer sends a packet to the network session.
         */
        //void receivePacket(NetComputer *computer, Packet *packet);

        /**
         * Send packet to every client, used for announcements.
         */
        void sendToEveryone(const MessageOut &msg);

        /**
         * Return the number of connected clients.
         */
        unsigned getClientCount() const;

    private:
        std::string hostname;   /**< The unresolved host the handler was asked to listen on. */
        ENetHost *host;         /**< The ENet host that listen for connections. */

    protected:
        /**
         * Called when a computer connects to the server. Initialize
         * an object derived of NetComputer.
         */
        virtual NetComputer *computerConnected(ENetPeer *peer) = 0;

        /**
         * Called when a computer reconnects to the server.
         */
        //virtual NetComputer *computerReconnected(ENetPeer *) = 0;

        /**
         * Called when a computer disconnects from the server.
         *
         * <b>Note:</b> After returning from this method the NetComputer
         *              reference is no longer guaranteed to be valid.
         */
        virtual void computerDisconnected(NetComputer *) = 0;

        /**
         * Called when a message is received.
         */
        virtual void processMessage(NetComputer *, MessageIn &) = 0;

        using NetComputers = std::list<NetComputer *>;
        /**
         * A list of pointers to the client structures created by
         * computerConnected.
         */
        NetComputers clients;
};

#endif