安裝與執行
讓我們從安裝的具體細節開始.在可以運行 P2P 應用程序之前,必須下載兩個 jar 文件 -- p2p.jar 和 spp.jar -- 以及配置文件 app.properties.p2p.jar 文件包含 P2P 應用程序自身的類文件.spp.jar 文件包含 P2P 應用程序所使用的消息傳遞庫的類文件.下載這些文件之後,將這兩個 jar 文件和包含配置文件的目錄添加到類路徑中.如果您正在運行 Windows,並且已經將這兩個 jar 文件和配置文件下載到 c:p2p 目錄,則可以如下設置類路徑：
set CLASSPATH=c:p2pp2p.jar;c:p2pspp.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 介面定義資源的結構和行為.該介面還定義允許在資源上執行的操作.目前的操作列表包括 select.以後的實現還將包括 insert 和 delete.
select() 方法將一個定義選擇標準的字元串作為參數.該方法返回有關所有與選擇標準匹配的資源項的信息.按照當前 P2P 應用程序中的文件系統資源所實現的方式,選擇字元串既可以直接命名一項,也可以包含通配符 "*",當直接命名一項時,資源將返回該項本身及其相關元數據；當包含通配符時,資源將只返回它所管理的所有項的元數據.還可以使用更複雜的查詢語言,但這不在本文討論範圍之內.
Shell
Shell 類只是一個允許用戶瀏覽本地和遠程資源的非常簡單的命令行用戶介面.它使用 PeerReference、ResourceReference 和 ItemReference 類向其它夥伴發送請求,但它本身只分析用戶輸入.為了從請求夥伴的角度更好地理解通信的工作原理,讓我們看一下清單 4 中顯示的 PeerReference 類的一部分.
我在上個月詳細描述了通過 shell 進行的用戶交互,
不再這裡重述.在第一次啟動 P2P 應用程序之前,請停一下並使自己重新熟悉它的操作.
通信
P2P 所做的全部就是夥伴間的通信.那些對原始得令人難以置信的 Napster 協議熟悉的讀者應該理解我為什麼選擇高級一些的協議.我在這裡只略微提及 SPP.在以後有關 P2P 通信的文章中,我將詳細描述它.
SPP 將消息建模成一個幀序列,如圖 1 所示：
圖 1. 消息
消息中的每一幀都有一個類型（由 MIME 類型指明）和一個主體.幀中的頭是可選的,它用來描述主體中的數據.構成完整而正確的消息的序列中的幀類型取決於應用程序.一般來講,一條消息由一個控制幀和其後零個或多個數據幀組成.數據幀包含控制幀所引用的數據.我們的 P2P 應用程序就採用這種模式.
消息出現在請求／響應對中.一個夥伴向另一個夥伴發送請求.那個夥伴再將響應發回給第一個夥伴.請求消息中的控制幀是命令幀.它包含命令和為該命令提供的所有參數.如果有任何其它幀存在,則這些幀包含命令幀所需的信息.響應消息中的控制幀是狀態幀.它包含狀態（正確或錯誤）.如果有任何其它幀存在,則這些幀包含狀態幀所引用的信息.如果向文件系統資源發出請求,則該信息將包含所選文件的內容.多幀消息模式的優點在於：它允許在通信應用程序之間交換內容豐富的消息.SPP 在很多方面都類似於 BXXP
完全理解了框架之後,我們就可以繼續討論 P2P 安全性了.我們還將在 P2P 應用程序中集成安全性支持.
