Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/trunk/src/libraries/network/ServerList.h @ 10799

Last change on this file since 10799 was 10622, checked in by landauf, 9 years ago

merged branch presentationFS15merge back to trunk

  • Property svn:eol-style set to native
File size: 3.2 KB
Line 
1/*
2 *   ORXONOX - the hottest 3D action shooter ever to exist
3 *                    > www.orxonox.net <
4 *
5 *
6 *   License notice:
7 *
8 *   This program is free software; you can redistribute it and/or
9 *   modify it under the terms of the GNU General Public License
10 *   as published by the Free Software Foundation; either version 2
11 *   of the License, or (at your option) any later version.
12 *
13 *   This program is distributed in the hope that it will be useful,
14 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
15 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16 *   GNU General Public License for more details.
17 *
18 *   You should have received a copy of the GNU General Public License
19 *   along with this program; if not, write to the Free Software
20 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
21 *
22 *   Author:
23 *      Sandro 'smerkli' Merkli
24 *   Co-authors:
25 *      ...
26 *
27 */
28
29#ifndef _ServerList_
30#define _ServerList_
31
32#include <list>
33#include <string>
34#include <network/packet/ServerInformation.h>
35
36/* methods necessary */
37namespace orxonox
38{
39  /* HELPER STRUCTURES */
40  struct ServerListElem
41  {
42    /* server information (name, IP, etc) */
43    packet::ServerInformation ServerInfo;
44
45    /* peer pointer */
46    ENetPeer* peer;
47  };
48
49  struct ServerListSearchResult
50  {
51    /* list element found */
52    ServerListElem result;
53
54    /* successful search */
55    bool success;
56  };
57
58
59
60
61
62  /** This class is keeps a list of game servers
63   * and some info about them.
64   */
65  class ServerList
66  { public:
67      /** constructor */
68      ServerList();
69
70      /** destructor */
71      ~ServerList();
72
73
74      /* BASIC MANIPULATION */
75      /** \param toadd the server to add.
76       *
77       * Add server to the game server list
78       */
79      int addServer( packet::ServerInformation toadd,
80        ENetPeer *peer );
81
82      /** \param name Name of the server to remove
83       *
84       * Remove server by name
85       */
86      bool delServerByName( std::string name );
87
88      /** \param address IP address of the server to remove
89       *
90       * Remove server by address
91       */
92      bool delServerByAddress( std::string address );
93
94      bool setNameByAddress( std::string address, std::string name  );
95
96      bool setClientsByAddress( std::string address, int clientNumber );
97
98      /* SEARCHING */
99      /* \param address The address of the server that is to be
100       *  found
101       * \return A struct containing a result of the search and a boolean
102       *  that is only true if the search was successful
103       *
104       * Find and return the list handle of a given address.
105       */
106      ServerListSearchResult
107      findServerByAddress( std::string address );
108
109
110      /* \param name The name of the server that is to be
111       *  found
112       * \return The struct containing the list entry of the server
113       *
114       * Find and return the list handle of a given name.
115       */
116      ServerListSearchResult
117      findServerByName( std::string name );
118
119
120      /* SORTING */
121      /** sort by name  */
122      void sortByName();
123
124      /** sort by ping */
125      void sortByPing();
126
127      /** the list of servers for internal storage */
128      std::list<ServerListElem> serverlist;
129    private:
130  };
131}
132
133#endif /*_ServerList_*/
Note: See TracBrowser for help on using the repository browser.