本文雖以 PHP 為示範語言,但概念同樣適用於任何後端語言。閱讀前,建議你已具備 JavaScript 與 PHP(或類似後端語言)的基礎知識。
這個範例的流程是:以 Ajax 把使用者對某個 RSS 摘要的請求送到一個自訂的 PHP 物件,該物件在本機伺服器上建立一份摘要副本並回傳其路徑;請求物件收到路徑後加以解析,最後以 HTML 呈現給使用者。看似步驟繁多,實際上只由四個小檔案組成,透過各司其職的分工讓整體處理更有效率。
或許有人會問:為何要在本機伺服器建立副本,而不直接解析原始摘要?原因在於 XMLHttpRequest 物件存在跨網域限制,建立本機副本正是繞過此限制的做法。以下先從發出請求的表單說起。
首先在 HTML 的 head 區段引入所需的 JavaScript 與 CSS 檔。這裡用一份樣式表來完成最終版面,並用一個 JavaScript 檔負責發送請求與解析摘要:
<link href="css/layout.css" rel="stylesheet" type="text/CSS" /> <script src="js/request.JS"></script>
接著建立一個表單,針對特定的 RSS 摘要發出請求。表單只含一個輸入欄位與一個提交按鈕,請求的查詢字串由摘要輸入值與一個後端會校驗的密碼組成,形式如下:
"password=mypassWord
程式在每次頁面載入時發出一次請求,因此若重新整理頁面,輸入欄位中現有的摘要字串會在載入時再次被請求。以下為表單與用來顯示解析結果的 div 標籤範例:
<body onload="Javascript:makeRequest('request.PHP?request=' + document.feedForm.feed.value + '"password=mypassWord');">
<form name="feedForm" method="post" action="Javascript:makeRequest('request.PHP?request=' + document.feedForm.feed.value + '"password=mypassWord');">
Enter a feed: <input type="text" name="feed" id="feed" size="20">
<input type="submit" name="submit" value="Add Feed">
</form>
<div id="logo"></div>
<hr/>
<div id="copy"></div>
<div id="details"></div>
</body>
這裡建立了 logo、copy、details 三個 div,各自在樣式表中對應一組樣式,後續解析摘要時會用到。不過在此之前,我們得先能取得所請求的摘要,這就要靠前面提到的 PHP 物件了。
我用 PHP 寫了一個小型的 RSS 類別,它在本機伺服器上建立請求摘要的副本,供稍後的 XMLHttpRequest 物件存取。由於一般無法跨網域請求檔案,這個類別藉由建立副本、回傳本機路徑的方式解決了跨域問題。
類別中唯一的請求方法只接收一個指向 RSS 摘要的 URL 參數。它先檢查本機是否已有名為 rss 的目錄,若無則建立並將權限設為 0666(可讀寫),如此一來副本便能寫入並日後存取:
//如果不存在目錄就創建一個
$dir = "rss";
if(!is_dir($dir))
{ mkdir($dir, 0666);
}
註:在 Windows 平台上使用 PHP 4.2.0 以上版本時,權限模式參數並非必要,即便存在也會被忽略;保留它是為了日後專案可能遷移至 UNIX 或 Linux 伺服器。
複製摘要前需要一個唯一的檔名。我對完整的 URL 使用 md5 加密以確保檔名唯一,再將它與描述目錄的字串拼接,用於建立副本:
//創建唯一的命名 $file=md5($rss_url); $path="$dir/$file.XML";
最後,透過上述路徑與原始摘要 URL 建立副本,並將新檔案路徑作為回應返回:
//復制饋送到本地服務器 copy($rss_url,"$path"); return $path;
完整的 RSS 類別如下:
<?PHP
class RSS
{ function get($rss_url)
{ if($rss_url != "")
{
//如果不存在目錄就創建一個
$dir = "rss";
if(!is_dir($dir))
{ mkdir($dir, 0666);
}
// 創建一個唯一的名字
$file = md5($rss_url);
$path = "$dir/$file.XML";
//復制饋送到本地服務器
copy($rss_url, "$path");
return $path;
}
}
}
?>
為了呼叫此類別的方法,需要一個作為介面的請求檔,也就是我們正在請求的檔案。它先驗證查詢中的密碼變數,若不符則回覆未授權訊息,否則引入並實例化 RSS 物件、以請求的摘要 URL 為參數呼叫請求方法並輸出結果:
<?
if($password == "mypassWord")
{
require_once('classes/RSS.class.PHP');
$rss = new RSS();
echo $rss->get($request);
}
else
{
echo "You are an unauthorized user";
}
?>
要進行 POST 請求,先建立請求物件,再呼叫 sendFeed 方法並傳入表單產生的 URL:
function sendFeed(url){
post.onreadystatechange = sendRequest;
post.open("POST", url, true);
post.send(url);
}
收到 PHP 物件的回應並正確載入後,再針對回應所指的本機檔案發出另一個請求,此時 post.responseText 即為新檔案的路徑:
function sendRequest(){
if(checkReadyState(post)){
request = createRequestObject();
request.onreadystatechange = onResponse;
request.open("GET", post.responseText, true);
request.send(null);
}
}
由於各家 RSS 摘要格式略有差異,解析時需稍作檢查。有些摘要含有 image 節點,有些則沒有,因此解析時得先判斷是否含圖像。若含有,就能與標題、連結一起在 image div 中顯示:
var _logo = "";
var _title = response.getElementsByTagName('title')[0].firstChild.data;
var _link = response.getElementsByTagName('link')[0].firstChild.data;;
_logo += "<a href='" + _link + "' target='_blank'>" + _title + "</a><br/>";
if(checkForTag(response.getElementsByTagName('image')[0]))
{
var _url = response.getElementsByTagName('url')[0].firstChild.data;
_logo += "<img src='" + _url + "' border='0'><br/>"
}
document.getElementById('logo').innerHtml = _logo;
不僅顯示時要檢查圖像,遍歷所有項目時也一樣。因為若存在圖像節點,後續標題與連結的索引會整體位移,因此發現圖像標籤時應在每次遍歷中把索引值加一來校正:
if(checkForTag(response.getElementsByTagName('image')[0]) "" i>0){
var _title=response.getElementsByTagName('title')[i+1].firstChild.data;
var _link=response.getElementsByTagName('link')[i+1].firstChild.data;
}
else{
var _title =response.getElementsByTagName('title')[i].firstChild.data;
var _link = response.getElementsByTagName('link')[i].firstChild.data;
}
可用 checkForTag 方法判斷特定標籤是否存在:
function checkForTag(tag){
if(tag != undefined) {
return true;
}
else{
return false;
}
}
解析摘要的方式有許多種。例如可依類別歸納項目並讓類別可摺疊,讓使用者自行選擇想看的內容。以下範例以日期分類,透過判斷某項的 pubDate 是否與前一項不同來決定是否顯示新的日期分隔:
if(i>1){
var previousPubDate = response.getElementsByTagName('pubDate')[i-1].firstChild.data;
}
if(pubDate != previousPubDate || previousPubDate == undefined){
_copy += "<div id='detail'>" + pubDate + "</div><hr align='left' width='90%'/>";
}
_copy += "<a href="Javascript:showDetails('" + i + "');">" + _title + "</a><br/><br/>";
document.getElementById('copy').innerHtml += _copy;
最後的 showDetails 方法,用於使用者在摘要中點選特定項目時顯示詳細內容。