Peergine P2P服务器端开发手册 v1.3

1. 概述

为了方便开发者对P2P服务器端进行二次开发，本文整理了SDK里中用到的P2P服务器的API接口，以及JAVA版的客户端封装类的API接口，供各位开发者参考。

1)服务器端的程序：

pgConnectSvr服务器程序：

“P2P穿透模块SDK”、“P2P直播模块SDK”和“P2P单片机模块SDK”，都使用pgConnectSvr服务器程序。

pgTunnelSvr服务器程序：

“P2P隧道模块SDK”和“PP透客户端”都使用pgTunnelSvr服务器程序。

pgClusterSvr集群服务器程序：

实现多个P2P服务器集群操作的程序。pgConnectSvr服务器和pgTunnelSvr服务器都使用pgClusterSvr集群服务器程序来实现集群操作。

2)系统结构说明：

系统结构图：

pgConnectSvr的接口关系图：

pgTunnelSvr的接口关系图：

pgWebClient的接口关系图：

3)服务器端的编程接口：

pgConnectSvr服务器的网络API：

P2P客户端、后台管理工具，以及第三方应用服务器与pgConnectSvr服务器之间的网络接口。

通过中间件的PG_CLASS_Peer的PG_METH_PEER_Call方法访问pgConnectSvr服务器的网络API。例如，访问“用户扩展”接口：

String sData = 1024 + “:” + “Hello pgConnectSvr !”; // 参数格式：方法ID + “:” + 参数

Node.ObjectRequest(“pgConnectSvr”, pgMethod.Peer.Call, sData, “”);

pgTunnelSvr服务器的网络API：

P2P客户端、后台管理工具，以及第三方应用服务器与pgTunnelSvr服务器之间的网络接口。

通过中间件的PG_CLASS_Peer的PG_METH_PEER_Call方法访问pgTunnelSvr服务器的网络API。例如，访问“用户扩展”接口：

String sData = 1024 + “:” + “Hello pgTunnelSvr !”; // 参数格式：方法ID + “:” + 参数

Node.ObjectRequest(“pgTunnelSvr0”, pgMethod.Peer.Call, sData, “”);

pgWebClient客户端封装类的API：

在Peergine中间件的基础上封装的一个JAVA类，旨在简化函数接口。方便第三方P2P客户端、第三方应用(WEB)服务器与P2P服务器之间进行交互。例如，基于TOMCAT的WEB服务器可以调用这个pgWebClient封装类与P2P服务器进行交互，实现WEB后台管理。JAVA版后台管理工具也可以调用这个pgWebClient封装类与P2P服务器进行交互。

pgConnectSvrExt扩展接口：

pgConnectSvr服务器的扩展插件接口。通过此扩展接口，开发者可以实现服务器端的个性化扩展功能。

扩展插件实现：从pgConnectSvrExt接口类派生出实现扩展插件功能的子类，在子类中实现pgConnectSvrExt接口的所有成员函数，并实现开发者所需要的个性化扩展功能。

扩展插件部署：在pgConnectSvr服务器程序的配置文件中，增加扩展插件的配置参数。例如：

(Extend){

(Class){com.peergine.connect.pgConnectSvrExtDemo} // 扩展插件类的类名。

(Param){. . .} // 扩展插件内部使用的其他自定义配置参数。

}

pgConnectSvrProc扩展回调接口：

pgConnectSvrExt扩展插件类中访问pgConnectSvr的回调接口类。pgConnectSvrProc接口由 pgConnectSvr的内部类实现，接口的对象由pgConnectSvrExt.Initialize(pgConnectSvrProc Proc)传递到扩展插件类中。

pgTunnelSvrExt扩展接口：

pgTunnelSvr服务器的扩展插件接口。通过此扩展接口，开发者可以实现服务器端的个性化扩展功能。

扩展插件实现：从pgTunnelSvrExt接口类派生出实现扩展插件功能的子类，在子类中实现pgTunnelSvrExt接口的所有成员函数，并实现开发者所需要的个性化扩展功能。

扩展插件部署：在pgTunnelSvr服务器程序的配置文件中，增加扩展插件的配置参数。例如：