summaryrefslogtreecommitdiff
path: root/src/net/connectionhandler.hpp
blob: df22aaccec5b2363c15faaf539f7e46c005047d7 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
/*
 *  The Mana World Server
 *  Copyright 2004 The Mana World Development Team
 *
 *  This file is part of The Mana World.
 *
 *  The Mana World 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 World 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 World; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 *
 *  $Id$
 */

#ifndef _TMWSERV_CONNECTIONHANDLER_H_
#define _TMWSERV_CONNECTIONHANDLER_H_

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

class MessageIn;
class MessageOut;
class NetComputer;

/**
 * Convert a IP4 address into its string representation
 */
std::string
ip4ToString(unsigned int ip4addr);

/**
 * 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.
         */
        bool startListen(enet_uint16 port);

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

        /**
         * Process outgoing messages and listen to the server socket for
         * incoming messages and new connections.
         */
        virtual void process();

        /**
         * 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 int getClientNumber();

    private:
        ENetAddress address;      /**< Includes the port to listen to. */
        ENetHost *host;           /**< The 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;

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

#endif