Planet
navi homePPSaboutscreenshotsdownloaddevelopmentforum

source: code/branches/release2012/src/libraries/network/ServerList.h @ 11753

Last change on this file since 11753 was 8937, checked in by smerkli, 13 years ago

merged masterserverfix corretly now.

  • Property svn:eol-style set to native
File size: 3.1 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
95
96
97      /* SEARCHING */
98      /* \param address The address of the server that is to be
99       *  found
100       * \return A struct containing a result of the search and a boolean
101       *  that is only true if the search was successful
102       *
103       * Find and return the list handle of a given address.
104       */
105      ServerListSearchResult
106      findServerByAddress( std::string address );
107
108
109      /* \param name The name of the server that is to be
110       *  found
111       * \return The struct containing the list entry of the server
112       *
113       * Find and return the list handle of a given name.
114       */
115      ServerListSearchResult
116      findServerByName( std::string name );
117
118
119      /* SORTING */
120      /** sort by name  */
121      void sortByName();
122     
123      /** sort by ping */
124      void sortByPing();
125
126      /** the list of servers for internal storage */
127      std::list<ServerListElem> serverlist;
128    private:
129  };
130}
131
132#endif /*_ServerList_*/
Note: See TracBrowser for help on using the repository browser.