(來源：http://www-900.ibm.com/developerWorks/)
深入細節Todd Sundsted (todd-p2p@etcee.com)
首席設計師，PointFire, Inc.
2001 年 5 月
理解 P2P 計算技術方面的最好方法是仔細觀察一個實際的 P2P 應用程序。這個月，Todd Sundsted 將帶您體驗這樣一個應用程序。他描述了如何安裝、配置這個應用程序，以及它是如何工作的。
在 P2P 計算領域方面，我們只寫了一篇文章，現在已經是轉變的時候了。根據 的讀者反饋意見，我認識到：讀者對于使用和理解 P2P 應用程序的興趣遠比我預想的大。最初，我只把這個應用程序看成是這樣一種方便的資源，可以從中提取示例，以闡明文章中所陳述的觀點。結果表明，某些讀者希望得到更詳細的信息，因此，我將在這個月提供這方面的信息。
這個月，我將不在高層次領域（高達 1000 英尺）繼續討論，也不解決安全性問題，相反，我將在低層次領域（50 英尺）討論應用程序框架。
我真誠地希望這個轉變將比現實生活中經常遇到的轉變更令人愉快。
安裝與執行
讓我們從安裝的具體細節開始。我略微更改了啟動 P2P 應用程序的過程，因為在上個月，一些讀者在啟動應用程序時遇到了問題。
在可以運行 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=<name>
com.etcee.app.ki.resource.0.class=<implementation class>
com.etcee.app.ki.resource.0.arg0=<initialization argument>
com.etcee.app.ki.resource.0.arg1=<initialization argument>
.
.
|
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 應用程序中集成安全性支持。
參考資料
關于作者
自從方便的臺式機出現以來，Todd Sundsted 就一直在編寫程序。盡管最初對用 C++ 構建分布式應用程序感興趣，但是，當 Java 成為同類語言中明顯的選擇時，Todd 轉到了 Java 編程語言。除了寫文章之外，Todd 還是 PointFire, Inc. 的創始人之一和首席設計師。可以通過 todd-p2p@etcee.com 與 Todd 聯系。