LightweightDatabaseServer Class Reference
[MySQLNetworkedDatabase]

A simple flat database included with RakNet, useful for a server browser or a lobby server. More...

#include <LightweightDatabaseServer.h>

Inheritance diagram for LightweightDatabaseServer:

PluginInterface2

List of all members.

Public Member Functions

DataStructures::TableGetTable (const char *tableName)
DataStructures::TableAddTable (const char *tableName, bool allowRemoteQuery, bool allowRemoteUpdate, bool allowRemoteRemove, const char *queryPassword, const char *updatePassword, const char *removePassword, bool oneRowPerSystemAddress, bool onlyUpdateOwnRows, bool removeRowOnPingFailure, bool removeRowOnDisconnect, bool autogenerateRowIDs)
bool RemoveTable (const char *tableName)
void Clear (void)
 Clears all memory.
DataStructures::Page< unsigned,
DataStructures::Table::Row
*, _TABLE_BPLUS_TREE_ORDER > * 
GetTableRows (const char *tableName)
virtual void Update (void)
 Update is called every time a packet is checked for .
virtual PluginReceiveResult OnReceive (Packet *packet)
virtual void OnClosedConnection (SystemAddress systemAddress, RakNetGUID rakNetGUID, PI2_LostConnectionReason lostConnectionReason)


Detailed Description

A simple flat database included with RakNet, useful for a server browser or a lobby server.

Deprecated:
Use RakNet::SQLite3ServerPlugin found at DependentExtensions/SQLite3Plugin/SQLite3ServerPlugin.h
A flat database interface. Adds the ability to track IPs of row updaters and passwords for table read and write operations, Best used for data in which queries which do not need to be updated in real-time

Member Function Documentation

DataStructures::Table* LightweightDatabaseServer::AddTable ( const char *  tableName,
bool  allowRemoteQuery,
bool  allowRemoteUpdate,
bool  allowRemoteRemove,
const char *  queryPassword,
const char *  updatePassword,
const char *  removePassword,
bool  oneRowPerSystemAddress,
bool  onlyUpdateOwnRows,
bool  removeRowOnPingFailure,
bool  removeRowOnDisconnect,
bool  autogenerateRowIDs 
)

Adds a new table It is valid to read and write to the returned pointer.

Parameters:
[in] tableName Name of the new table to create. Remote systems will refer to this table by this name.
[in] allowRemoteQuery true to allow remote systems to query the table. false to not allow this.
[in] allowRemoteUpdate true to allow remote systems to update rows in the table. false to not allow this.
[in] allowRemoteRemove true to allow remote systems to remove rows from the table. false to not allow this.
[in] queryPassword The password required to query the table. Pass an empty string for no password.
[in] updatePassword The password required to update rows in the table. Pass an empty string for no password.
[in] removePassword The password required to remove rows from the table. Pass an empty string for no password.
[in] oneRowPerSystemAddress Only used if allowRemoteUpdate==true. This limits remote systems to one row.
[in] onlyUpdateOwnRows Only used if allowRemoteUpdate==true. This limits remote systems to only updating rows they created.
[in] removeRowOnPingFailure Only used if allowRemoteUpdate==true and removeRowOnDisconnect==false. If true, this will periodically ping disconnected systems and remove rows created by that system if that system does not respond to pings.
[in] removeRowOnDisconnect Only used if allowRemoteUpdate==true. This removes rows created by a system when that system disconnects.
[in] autogenerateRowIDs true to automatically generate row IDs. Rows are stored in order by row ID. If false, the clients must specify a unique row ID when adding rows. If they specify a row that already exists the addition is ignored.
Returns:
The newly created table, or 0 on failure.

DataStructures::Table* LightweightDatabaseServer::GetTable ( const char *  tableName  ) 

Returns a table by name. It is valid to read and write to the returned pointer.

Parameters:
[in] tableName The name of the table that was passed to AddTable
Returns:
The requested table, or 0 if tableName cannot be found.

DataStructures::Page<unsigned, DataStructures::Table::Row*, _TABLE_BPLUS_TREE_ORDER>* LightweightDatabaseServer::GetTableRows ( const char *  tableName  ) 

Returns a linked list of ordered lists containing the rows of a table, by name. The returned structure is internal to the BPlus tree. See DS_BPlusTree This is a convenience accessor, as you can also get this from the table returned from GetTable()

Parameters:
[in] tableName The name of the table that was passed to AddTable
Returns:
The requested rows, or 0 if tableName cannot be found.

virtual void LightweightDatabaseServer::OnClosedConnection ( SystemAddress  systemAddress,
RakNetGUID  rakNetGUID,
PI2_LostConnectionReason  lostConnectionReason 
) [virtual]

Called when a connection is dropped because the user called RakPeer::CloseConnection() for a particular system

Parameters:
[in] systemAddress The system whose connection was closed
[in] rakNetGuid The guid of the specified system
[in] lostConnectionReason How the connection was closed: manually, connection lost, or notification of disconnection

Reimplemented from PluginInterface2.

virtual PluginReceiveResult LightweightDatabaseServer::OnReceive ( Packet packet  )  [virtual]

OnReceive is called for every packet.

Parameters:
[in] packet the packet that is being returned to the user
Returns:
True to allow the game and other plugins to get this message, false to absorb it

Reimplemented from PluginInterface2.

bool LightweightDatabaseServer::RemoveTable ( const char *  tableName  ) 

Removes a table by name.

Parameters:
[in] tableName The name of the table that was passed to AddTable
Returns:
true on success, false on failure.


The documentation for this class was generated from the following file:

Generated on Fri Jul 22 08:28:34 2011 for RakNet by  doxygen 1.5.7.1