一日一点RakNet(60)--PHP Directory Server(目录服务器)
PHP 目录服务器概述
使用共享的Web主机给出游戏列表
Lightweight数据库插件功能强大，但是它要求一个一台专用的服务器运行RakNet实例。在有些情况下，这个要求无法满足，并且运行专用服务器额负担也是不可取的。对于这些情况，RakNet提供了一个DirectoryServer.php，它可以再Sample\PHPDirecotory目录下找到。
设置web服务器，仅仅需要将Samples\PHPDirectoryServer\Directory.php上传到你的PHP的web主机即可(webhost可以是任何标准的web服务器)。转到你新上传的webpage，点击显示按钮，输入密码和其他的想要的设置参数。
C++代码更加复杂。首先，你需要定义一个TCPInterface的实例，并且启动该实例。这是通常的TCP通信必备。
TCPInterface tcp;
tcp.Start(0, 64);
第二，还需要一个HTTPConnection实例，它用于通过TCPInterface实例与webpages进行通信。
HTTPConnection httpConnection(tcp, "jenkinssoftware.com");
第三，你需要定义一个PHPDirectoryServer实例。它用于解析和与指定的DirectoryServer.php通信。
PHPDirectoryServer phpDirectoryServer(httpConnection, "/raknet/DirectoryServer.php");
转到http://www.jenkinssoftware.com/raknet/DirectoryServer.php可以实际看一看页面效果。
然后你可以设置列，上传你的表或下载已经存在的表：
// 使用columnname / value设置域值
phpDirectoryServer.SetField("beehive","inthewater");
// 上传前面设置的域，要用到游戏名称，游戏端口，和密码
phpDirectoryServer.UploadTable(50, "Game name", 1234, "");
// 下载上传的服务器
phpDirectoryServer.DownloadTable("");
更新系统，应该从TCPInterface向两个接口传递数据包，并且要调用Update()。TCP数据报没有包含一个完整的webpage响应，webpage可能包含错误代码，来自webpage的信息不全是与我们的服务器相关的使得事情变得比较复杂。例子详细说明了如何处理，如下的代码是一个简要的摘录：
Packet *packet = tcp.Receive();
if(packet)
{
// 在这个例子中，这一行不是必须的，但是如果我们正在使用TCPInterface，我们想要确保我们仅仅给它一个消息表明我们我们的本条连接。
if (packet->systemAddress==httpConnection.GetServerAddress())
{
// 从一个web服务器一条请求可能返回多个数据报。当最后的数据报达到时， ProcessFinalTCPPacket会返回真
if (httpConnection.ProcessFinalTCPPacket(packet))
{
int code;
RakNet::RakString data;
/// 检查请求已经处理，没有错误代码
if (httpConnection.HasBadResponse(&code, &data)==false)
{
// 好的响应，让PHPDirectoryServer类处理该数据
// 如果resultCode不是空字符串，那么我们得到了一些东西而非表
// (例如删除行成功提示，或消息仅仅是HTTP的并不是本类的数据).
HTTPReadResult readResult = phpDirectoryServer.ProcessHTTPRead(httpResult);
if (readResult==HTTP_RESULT_GOT_TABLE)
{
/// 获得了一个内部存储的表，打印出来。
char out[10000];
const DataStructures::Table *games = phpDirectoryServer.GetLastDownloadedTable();
games->PrintColumnHeaders(out,sizeof(out),',');
printf("COLUMNS: %s\n", out);
// 打印表的每一行
for (unsigned i=0; i < games->GetRowCount(); i++)
{
games->PrintRow(out,sizeof(out),',',true, games->GetRowByIndex(i,NULL));
printf("ROW %i: %s\n", i+1, out);
}
}
}
}
}
// 释放数据报
tcp.DeallocatePacket(packet);
}
httpConnection.Update();
phpDirectoryServer.Update();
某些列被保存，给你返回一个查询。这些列名字不允许用于终端用户，如果参数使用会发生assert(断言)。
// 带有这个头的列包含了游戏的名字，传递给UploadTable()
static const char *GAME_NAME_COMMAND="__GAME_NAME";
// 带有这个头的列包含了游戏的端口，传递给UploadTable()
static const char *GAME_PORT_COMMAND="__GAME_PORT";
// 从PHP服务器返回，表明了这行最后更新的时间。
static const char *LAST_UPDATE_COMMAND="__SEC_AFTER_EPOCH_SINCE_LAST_UPDATE";
// 删除一行的命令
static const char *DELETEME_COMMAND="__DELETE_ROW";
// 传递给PHP服务器，它是作为密码
static const char *GAME_PASSWORD_COMMAND="__PHP_DIRECTORY_SERVER_PASSWORD";
// 这一列传递给PHP服务器，作为在自动推出之前多长时间列出这个服务器。
static const char *GAME_TIMEOUT_COMMAND="__GAME_LISTING_TIMEOUT";
__SYSTEM_ADDRESS参数被返回表明外部的一个IP用于上传webpage。
注意由于技术限制，在同一个时间仅仅允许一个上传。如果你的服务器仅仅管理一个游戏，那么这个限制不是问题。当一个上传正在进行，如果调用了PHPDirectoryServer::UploadTable()方法会覆盖掉这前一个上传。当HTTPConnectionBusy()返回false时可以执行另外一个上传过程。
By 北洋小郭
转载请注明出处，请勿用于商业用途，谢谢！