blob: 2d0a2a6afa1a2ae607b56a8a0353a7740ac47e18 (
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
124
125
126
127
128
129
130
131
132
|
/*
* 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
|