DIV CSS 佈局教程網

深入 JSONP:跨網域請求的原理與實作(原生 JS 與 jQuery)
編輯:關於JavaScript     

最近做專案時,需要用子網域去呼叫主網域下一個既有的功能,於是想到用 JSONP 來解決。相信不少人都碰過類似需求,這裡就把它記錄下來,也順道分享給需要的朋友。

什麼是 JSONP 協議?

JSONP 即 JSON with Padding。由於同源策略的限制,XmlHttpRequest 只能請求「當前來源」(網域、協議、連接埠)的資源。若要跨網域請求,可以借助 HTML 的 script 標籤來進行,並在回應中返回要執行的 script 程式碼,其中可直接用 JSON 傳遞 JavaScript 物件——這種跨網域通訊方式就稱為 JSONP。話說回來,JSONP 本質上是一種「腳本注入(Script Injection)」行為,因此要特別留意其安全性。

jQuery 中的 JSONP 範例

我們需要兩個頁面,分別扮演協議的用戶端與伺服器端。

用戶端程式碼:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" >
<head>
<title>jsonp測試例子</title>
<script type="text/javascript" src="https://www.xxxxxxxxxxxx.cn/js/jquery.min.js"></script>
<script type="text/javascript">
jQuery(document).ready(function(){
$.ajax({
type: "get",
async: false,
url: "https://www.xxxxxxxxxxxx.cn/demos/jsonp.php",
dataType: "jsonp",
jsonp: "callback",//傳遞給請求處理程序的參數名(一般預設為 callback)
jsonpCallback:"feedBackState",//自訂的 jsonp 回呼函式名稱,預設為 jQuery 自動產生的隨機函式名
success: function(data){
var $ul = $("<ul></ul>");
$.each(data,function(i,v){ $("<li/>").text(v["id"] + " " + v["name"]).appendTo($ul) });
$("#remote").append($ul);
},
error: function(){ alert('fail'); }
});
});
</script>
</head>
<body>
遠程數據如下:<br/>
<div id="remote"></div>
</body>
</html>

伺服器端程式碼(本例採用 PHP):

<?php
$jsonp = $_REQUEST["callback"];
$str = '[{"id":"1","name":"測試1"},{"id":"2","name":"測試2"}]';
$str = $jsonp . "(" .$str.")";
echo $str;
?>

JSONP 的原理與簡易範例

jQuery 只是把它封裝起來,你未必看得到真正的實作。下面這個例子能說明其精神:

用戶端程式碼:

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "https://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="https://www.w3.org/1999/xhtml" >
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<head>
<title>jsonp測試例子</title>
<script type="text/javascript" src="https://www.xxxxxxxxxxxx.cn/js/jquery.min.js"></script>
<script type="text/javascript">
function CallJSONPServer(url){ // 呼叫 JSONP 伺服器,url 為請求伺服器位址
var oldScript =document.getElementById(url); // 若頁面已註冊該伺服器,則重新呼叫
if(oldScript){ oldScript.setAttribute("src",url); return; }
var script =document.createElement("script"); // 若未註冊,則註冊並請求之
script.setAttribute("type", "text/javascript");
script.setAttribute("src",url);
script.setAttribute("id", url);
document.body.appendChild(script);
}
function OnJSONPServerResponse(data){
var $ul = $("<ul></ul>");
$.each(data,function(i,v){ $("<li/>").text(v["id"] + " " + v["name"]).appendTo($ul) });
$("#remote").append($ul);
}
</script>
</head>
<body>
<input type="button" value="點擊獲取遠程數據" onclick="CallJSONPServer('https://www.xxxxxxxxxxxx.cn/demos/jsonp_original.php')" />
<div id="remote"></div>
</body>
</html>

伺服器端程式碼:

<?php
$str = '[{"id":"1","name":"測試1"},{"id":"2","name":"測試2"}]';
$str = "OnJSONPServerResponse(" .$str.")";
echo $str;
?>

看過程式碼,你應該就明白它的運作方式:動態插入一個 script 標籤指向跨網域網址,伺服器回傳「回呼函式(資料)」形式的文字,瀏覽器執行後資料就到手了。

注意事項

1. 由於 jQuery 在 ajax 處理中使用 UTF-8 編碼傳遞參數,所以 JSONP 處理端最好也用 UTF-8,省得編碼轉換;若非 UTF-8 記得轉換,否則中文會亂碼。
2. 請求的伺服器端 URL 最好不要寫成 https://www.xxxxxxxxxxxx.cn/?act=add 這種形式,應寫完整為 https://www.xxxxxxxxxxxx.cn/index.php?act=add,否則過程中可能出現不相容的情況。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved