瀏覽器的同源策略會擋下跨域的 Ajax 請求,但 <script> 標籤不受此限制。JSONP 正是利用這個特性:伺服器把資料包成一層函式呼叫,前端事先定義好該函式,資料便能在跨域情況下順利傳遞。以下分三步驟實作。
於 system.web 節點內加入:
<!-- 此節點可允許腳本跨域調用 webservice -->
<webServices>
<protocols>
<add name="HttpPost"/>
<add name="HttpGet"/>
</protocols>
</webServices>
<!-- 此節點可允許腳本跨域調用 webservice -->
預設情况下 ASP.NET 的 WebService 只接受 SOAP 與 POST,把 HttpGet/HttpPost 加入 protocols 清單,才能讓它回應來自指令稿的請求。
using System;
using System.Web;
using System.Web.Services;
namespace WebService {
/// <summary>
/// WebService1 的摘要說明
/// </summary>
[WebService(Namespace = "https://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[System.ComponentModel.ToolboxItem(false)]
// 若要允許使用 ASP.NET AJAX 從腳本中調用此 Web 服務,請取消下一行的註釋
[System.Web.Script.Services.ScriptService]
public class WebService1 : System.Web.Services.WebService {
[ValidateInput(false)]
[WebMethod(Description = "測試")]
public void getDBTableInfos(string EnterpriseCode) {
HttpContext.Current.Response.ContentType = "application/json;charset=utf-8";
// 取出前端傳來的 callback 函式名稱
string jsonCallBackFunName =
HttpContext.Current.Request.Params["jsoncallback"].ToString();
// 把結果包成 callback({...}) 的形式輸出
HttpContext.Current.Response.Write(
jsonCallBackFunName + "({ \"Result\": \"" + EnterpriseCode + "\" })");
}
}
}
這段程式做了兩件事:讀取 jsoncallback 參數取得前端指定的函式名稱,再把資料包成 函式名稱({...}) 的字串輸出。前端收到的其實是一段會被執行的 JavaScript,函式因此被呼叫,資料也就到手了。
<!DOCTYPE html>
<html>
<head>
<title>Index</title>
<script src="https://www.cnblogs.com/Scripts/jquery-1.5.1.js" type="text/javascript"></script>
<script type="text/javascript">
$(function () {
$("#btnSubmit").click(function () {
var EnterpriseCode = "39"; // 企業代碼
var dataStr = "EnterpriseCode=" + EnterpriseCode;
$.ajax({
type: "get",
url: "https://xxx/xxx.asmx/AntiWebQuery_Ajax?jsoncallback=?",
dataType: "jsonp",
jsonp: 'jsoncallback', // 告訴 jQuery callback 參數名叫什麼
data: dataStr,
success: function (result) {
alert(result.Result);
}
});
});
});
</script>
</head>
<body>
<div>
<input id="btnSubmit" type="button" value="查詢" />
</div>
</body>
</html>
jQuery 的 dataType: "jsonp" 會自動做幾件事:動態插入一個 <script> 標籤、產生一個隨機命名的回呼函式、並透過 jsonp 參數指定 callback 的查詢鍵名。等 script 載入完成、函式被執行,success 就拿到了資料。
只支援 GET。因為它本質上就是一個 <script src> 請求,無法帶 request body。
它會執行對方回傳的任何程式碼。這是 JSONP 最根本的安全特性——你不是在「取資料」,而是在「執行對方的 JavaScript」。因此只能對你完全信任的來源使用,且該來源一旦被入侵,你的頁面也跟著淪陷。
回呼函式名稱絕不可直接拼接使用者輸入。範例中 jsonCallBackFunName 直接從 Request 取值後就寫進回應,若有人傳入惡意字串,就形成 XSS。正式環境請用白名單或正則表達式(例如 ^[a-zA-Z_$][a-zA-Z0-9_$]*$)驗證過再使用。
錯誤處理很麻煩。script 載入失敗時不會拋出有意義的錯誤,只能靠逾時自行判斷。
因此,若伺服器雙方能配合,CORS 是更好的選擇:它支援所有 HTTP 方法、錯誤處理正常、也不需要在回應中產生可執行程式碼。只有在必須對接無法修改的舊系統時,JSONP 才還是合理選項。