安装与执行
让我们从安装的具体细节开始。在可以运行 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 接口定义资源的结构和行为。