對大多數服務提供商而言,自助服務正逐漸成為一種趨勢——尤其是那些資金緊張的 ISP。因此,當你需要更多頻寬(無論是下載還是玩線上遊戲)時,只要登入服務商的網站,透過網頁就能自動升級與服務商的連線。舉個具體例子:清單 1 展示了一份簡單的、以 XML 為基礎的用戶服務設定檔。
清單 1. 一份簡單的、以 XML 為基礎的服務描述
<ServiceInstance> <Customer>Josephine Bloggs</Customer> <Package>Internet</Package> <Bandwidth>1mbps</Bandwidth> <DownloadLimit>1Gbyte</DownloadLimit> <Uptime>95</Uptime> </ServiceInstance>
這段代碼詮釋了該用戶的 XML 服務模型,它包含:一個服務執行個體、客戶名稱、服務包裝的名稱、已設定的頻寬量、每月允許的下載上限,以及服務商的正常運行時間保證。
毫無疑問,實際的服務定義可能遠比這個例子複雜,其他內容還可能包括客戶地址、帳單明細、往返延遲、加密方式與服務補償資訊等。重點在於:越來越多的服務商開始提供如清單 1 所示的網頁化服務細節。這在一定程度上能降低客服電話的成本與頻次。有趣的是,這種以 Web 為基礎的服務,會讓用戶覺得為自己提供服務的是較先進的服務商,從而實現雙贏:客戶能更便利地存取自己的服務資料,服務商則能銷售無須人工介入的服務方案。獲授權的用戶可以修改清單 1 中的部分服務參數(例如已設定的頻寬),隨之調整的便是每月訂閱費用。
由此可見,清單 1 中的代碼構成了以 XML 為基礎的服務模型之基石。用戶只要與線上表格互動,就能修改可寫的服務元素(如頻寬),這些變更會被記錄並反映到可由設定檔修改的後端服務中。這是實作自助服務的一種標準做法。
接下來要介紹的,則是另一種更為鬆散耦合的自助服務模式:用戶可以透過在網路中傳輸清單 1 中的 XML 內容來修改資料。在這種情境下,傳輸的 XML 內容可由一個以 Java 技術撰寫的用戶端進行修改——該用戶端能執行於桌上型電腦、筆記型電腦,甚至某種資源受限的裝置(如手機)——再把資料回傳給網路服務商。這種機制超越了基本的 HTML 頁面模型,採納了 SOA(服務導向架構)的思想。
Java 技術為 XML 資料處理提供了一些相當強大的工具。如果把清單 1 中的內容視為某個資料集的 XML 呈現,那麼你其實還能用其他方式來呈現它。構成清單 1 基本內容的原始資料通常保存在資料庫中,那麼,你該如何把這些資料打包成 XML 呢?
清單 2 的內容摘自此文隨附的 Java 檔 encodeXML.java。encodeXML.java 類別對 XMLEncoder 類別的物件進行了執行個體化,這個物件隨後會在當前目錄中建立一個名為 xmldata.xml 的檔案。下一步是把 XML 資料值寫入檔案,這可透過一連串的 writeObject() 方法呼叫來完成。顯然,在正式環境中,清單 2 裡硬編碼的字串將來自資料庫這類持久化儲存;但無論如何,不難看出 XML 資料檔的建立非常簡單。
清單 2. 使用 XML 格式編碼資料
XMLEncoder e = new XMLEncoder(
new BufferedOutputStream(
new FileOutputStream("xmldata.xml")));
e.writeObject("Josephine Bloggs");
e.writeObject("Internet");
e.writeObject("1mbps");
e.writeObject("Gbyte");
e.writeObject("295");
e.close();
執行清單 2 中的程序後,執行目錄裡便會出現一個名為 xmldata.xml 的檔案。清單 3 說明了這個新檔案所涵蓋的內容。
清單 3. 產生的 XML 資料
<?xml version="1.0" encoding="UTF-8"?> <java version="1.5.0_06" class="java.beans.XMLDecoder"> <string>Josephine Bloggs</string> <string>Internet</string> <string>1mbps</string> <string>Gbyte</string> <string>295</string> </java>
你可以透過網路把清單 3 中的檔案傳輸給處於等待狀態的用戶端——而這個用戶端同樣可以用 Java 技術打造。清單 4 展示了一個簡單的例子。
清單 4. 跨網路傳輸檔案
byte[] bytes = new byte[BUFFER_SIZE];
FileInputStream inputFile = null;
try
{
File file = new File("xmldata.xml");
if (file.exists())
{
inputFile = new FileInputStream(file);
int ch = inputFile.read(bytes, 0, BUFFER_SIZE);
while (ch != -1)
{
output.write(bytes, 0, ch);
ch = inputFile.read(bytes, 0, BUFFER_SIZE);
}
}
清單 4 的代碼建立了一個長度為 BUFFER_SIZE 的緩衝區,該常量的值可以是 1024 或更高。透過呼叫 inputFile.read() 方法,把輸入檔(xmldata.xml)的內容讀入緩衝區;完成緩衝後,output.write() 方法再把檔案資料寫入 OutputStream 物件對應的 socket,最後一步便是把資料經由網路送往等待中的用戶端。這一切居然只需這麼點代碼!
接下來,你需要讓用戶端處理接收到的 XML 資料。
用戶端該如何接收 XML 資料?同樣,對 Java 技術來說只是小事一樁。資料接收透過一個 socket 物件完成,清單 5 的代碼會接收傳入的資料,並把它推入 ArrayList 類別的物件中。
此時,用戶端必須解決兩個與資料項數量有關的問題。由於這是鬆散耦合的情境,你必須假設用戶端並不清楚服務設定檔(即清單 1 中的代碼)裡到底有多少 XML 資料項,因此得設法準確接收並處理未知數量的資料項。第二個問題相對簡單,就是如何保存處理後的資料。你會看到,清單 5 同時解決了這兩個難題。
清單 5. 擷取內嵌的 XML 資料
XMLDecoder d = new XMLDecoder(input);
try {
while (true) {
ArrayList<Object[]> rowList = new ArrayList<Object[]>();
String dataItem = (String)d.readObject();
System.out.println("XML decoded data: " + dataItem);
rowList.add(dataItem);
}
} catch (Exception exc) {
if (exc instanceof ArrayIndexOutOfBoundsException) {
// No more records to process
System.out.println("Parsed all XML records - " +
"threw exception. Number of rows: " + rowList.size());
}
}
d.close();
透過一個 while (true) 的循環,你可以持續接收資料,直到讀完最後一個資料項、拋出例外(ArrayIndexOutOfBoundsException)為止。除非用戶端事先已知期望的資料項數量,否則就必須借助這種例外機制。
從 InputStream 物件接收到的 XML 資料會被保存在 ArrayList 類別的物件中,這個類別對此類應用非常實用。ArrayList 在定義完成後會有一個初始容量,並在加入元素時自動擴容,因此你不必擔心超出陣列上限,這個類別會替你處理好一切。
此時,用戶端已擁有清單 1 中資料的副本。用戶端可以把頻寬元素改成所需的值,再反向執行檔案傳輸過程,從用戶端送回伺服器。藉由把 XML 檔從伺服器移到用戶端,用戶端實際上便「使用」了這項服務;更新後的資料被送回伺服器以完成交易。當然,服務商必須驗證傳入的資料,並據此提供所需的頻寬變更。
本文所述的模式,首先是透過網路把一個 XML 檔傳到用戶端;用戶端把檔案資料當作資料流接收,解析為記憶體常駐的物件,接著對該物件進行修改,再反向執行傳輸,把物件送回伺服器。
還有一種情境,是 XML 資料被完整無缺地從伺服器傳到用戶端。此時用戶端會以某種檔案傳輸協定(例如 FTP)取得完整檔案副本。由於檔案傳輸是標準技術,這裡不多贅述;你只需知道用戶端會下載清單 1 中服務設定資料的檔案副本,然後解析、修改並回傳給伺服器。這種模式又是如何運作的呢?
此時,用戶端已把服務設定檔的副本保存在磁碟上,必須對該檔進行解析以擷取 XML 資料。令人意外的是,這做起來有些難度,對較大的檔案尤其如此。解決的關鍵在於選對解析工具。本文使用的工具是 dom4j,它允許你把 XML 資料解析成一個 Java 物件;你也可以選用基於 SAX(Simple API for XML)的解析器,只不過 SAX 屬於較低階的技術。你會看到,dom4j 只需很少的功夫就能完成解析。清單 6 摘自本文隨附的 ProcessEventXML.java 檔,展示了使用 dom4j 解析檔案所需的主要元素。
清單 6. 以 dom4j 處理 XML 資料
try
{
handler.treeWalk(handler.parse(new File(argv[0])));
}
catch (Throwable t)
{
t.printStackTrace();
}
public Document parse(File url)
throws DocumentException
{
SAXReader reader = new SAXReader();
Document document = reader.read(url);
return document;
}
public void treeWalk(Document document)
throws Exception
{
treeWalk(document.getRootElement());
}
基本上只需要兩種方法:parse() 與 treeWalk()。當我執行編譯後的類別時,得到了如清單 7 所示的輸出。若你想親自跑一遍,請先下載並安裝 dom4j 副本,把它加入 CLASSPATH(最後一步就是把對應的 JAR 檔加入 CLASSPATH 變數),接著編譯 ProcessEventXML.java 檔並執行:
java ProcessEventXml ServiceDefinition.xml
清單 7. 以 dom4j 處理 XML 檔
java ProcessEventXml ServiceDefinition.xml Josephine Bloggs Internet 1mbps 1Gbyte 95
如你所見,只需少量功夫,就能把 XML 資料整潔地呈現出來,而這些工作大多由 dom4j 一手包辦。事實上,絕大部分處理是透過 treeWalk() 方法完成的——這是一種遞迴方法,直到抵達檔案結尾才會停止呼叫。這裡展示了 dom4j 的一個特色:在記憶體中進行處理。需要注意的是,這項技術並不適用於特別龐大的 XML 檔,尤其是當你的 Java 裝置非常小時。不過在本文的例子中,XML 資料集相當小,因此不成問題。
至此,你的以檔案為基礎的用戶端已成功存取 XML 資料。用戶端可以按需修改資料、撰寫新的 XML 檔,再把它傳回伺服器進行處理。與前文一樣,用戶端正是在這一過程中「使用」了這項服務。