对等计算实践之：构建 P2P 应用程序框架_Java教程

　　安装与执行
　　让我们从安装的具体细节开始。在可以运行 P2P 应用程序之前，必须下载两个 jar 文件 -- p2p.jar 和 spp.jar -- 以及配置文件 app.properties。p2p.jar 文件包含 P2P 应用程序自身的类文件。spp.jar 文件包含 P2P 应用程序所使用的消息传递库的类文件。下载这些文件之后，将这两个 jar 文件和包含配置文件的目录添加到类路径中。假如您正在运行 Windows，并且已经将这两个 jar 文件和配置文件下载到 c:\p2p 目录，则可以如下设置类路径：
　　
　　set CLASSPATH=c:\p2p\p2p.jar;c:\p2p\spp.jar;c:\p2p
　　
　　假如您正在运行 Linux、Solaris 或某个合适的 UNIX 变体，并且已经将这两个 jar 文件和配置文件下载到 /home/foo/p2p 目录，可如下设置类路径：
　　
　　eXPort CLASSPATH=/home/foo/p2p/p2p.jar:/home/foo/p2p/spp.jar:/home/foo/p2p
　　
　　（以上命令假设您正在运行 BASH 来作为命令 shell）。将如何在其它流行的 shell（如 CSH）中设置环境变量的问题留给您自己去考虑。一旦设置了类路径，就可以用以下命令启动应用程序：
　　
　　Java com.etcee.app.ki.Main
　　
　　P2P 应用程序将显示一个别致的信息性标志和一个命令提示来欢迎您。最后再说一遍：我的 P2P 应用程序一定需要 Java 2 平台。
　　
　　配置文件
　　前几步将启动并运行 P2P 应用程序，但是，在能够很好地使用它之前，必须编辑配置文件。配置文件定义 P2P 应用程序使用的端口、控制的资源以及识别的伙伴。清单 1 演示了每一个定义。
　　
　　清单 1. 示例配置文件
　　
　　com.etcee.app.ki.port=7777
　　com.etcee.app.ki.resource.0.name=share
　　com.etcee.app.ki.resource.0.class=com.etcee.app.ki.resource.file.FileResource
　　com.etcee.app.ki.resource.0.arg0=/home/foo/share
　　com.etcee.app.ki.resource.1.name=tmp
　　com.etcee.app.ki.resource.1.class=com.etcee.app.ki.resource.file.FileResource
　　com.etcee.app.ki.resource.1.arg0=/tmp
　　com.etcee.app.ki.peer.0=bass:7777
　　com.etcee.app.ki.peer.1=salmon:7777
　　com.etcee.app.ki.peer.2=perch:7777
　　com.etcee.app.ki.peer.3=guppy:7777
　　
　　第一部分由一行组成，它定义了 P2P 应用程序用来接收其它伙伴连接请求的端口。最好不要改变这行。第二部分定义 P2P 应用程序治理的资源。您可能需要编辑这部分。清单 1 定义了两个资源：share 和 tmp。从应用程序的观点来看，资源只是实现 Resource 接口的类的实例，我们将马上讲到这点。资源定义一般具有以下基本形式：
　　
　　清单 2. 资源定义
　　
　　com.etcee.app.ki.resource.0.name=
　　com.etcee.app.ki.resource.0.class=
　　com.etcee.app.ki.resource.0.arg0=
　　com.etcee.app.ki.resource.0.arg1=
　　.
　　.
　　name 是给予资源的名称，它用来生成人们可读的输出。class 是 Java 类的名称，可以将其初始化以创建资源。P2P 应用程序在运行期间动态装入这个类并将其初始化。在其初始化期间，argN 自变量被传递到新初始化的资源。例如，FileResource 类使用这些自变量定义目录来为文件提供服务。您需要编辑目录自变量以指向您机器上的某个目录。
　　
　　第三部分定义 P2P 应用程序识别的伙伴。每一行都包含伙伴的名称（或 IP 地址）和伙伴的端口。用这种方式定义伙伴显然不是可伸缩的解决方案。在以后的文章中，我们将看一种更好的解决方案。
　　
　　代码
　　除了对等通信采用的 SPP（简单点到点）包之外，P2P 应用程序不包含很多类。首先，我们先仔细查看最重要的类，最后再看一下 SPP 通信包。
　　
　　资源
　　P2P 应用程序的主要组件是资源。事实上，P2P 应用程序只是答应和控制对已发布资源的远程访问。资源可以是任何可寻址的事物 -- 文件系统、电话簿、数据库和目录。每个资源都治理零个或多个适当类型的项（文件系统资源治理文件，电话簿资源治理电话号码）。为演示如何实现资源，我创建了一个简单的文件系统资源类 FileResource，如清单 3 所示。这个文件系统资源治理零个或多个文件。
　　
　　清单 3. Resource 接口
　　
　　public
　　interface Resource
　　{
　　// The initialize() method requires a TTDFactory instance
　　// (which the factory uses to create the TTDItem instances
　　// it returns from the select() method in response to a
　　// query) and a String array (which contains the arguments
　　// from the configuration file).
　　public
　　void
　　initialize(TTDFactory ttdfactory, String [] arstring)
　　throws ResourceException;
　　// The select() method requires a String instance that
　　// defines the selection criteria.　It returns an array
　　// of TTDItems, one for each entry that matches the
　　// selection criteria.
　　public
　　TTDItem []
　　select(String stringSelector)
　　throws ResourceException;
　　}
　　Resource 接口定义资源的结构和行为。