DIV CSS 佈局教程網

深入解析 jQuery ajax 與 getJSON 的跨域取資料機制
編輯:JQuery特效代碼     

很多開發者習慣用 jQuery 在前后端之間取資料,久而久之容易以為「前端就能讀取任何網站的資料」。最近因為要與第三方公司共享資料,又不想多佔伺服器資源,於是決定直接在 HTML 端讀取、不走後家中轉——結果就撞上了瀏覽器的跨域限制。

先釐清一個觀念:跨域安全限制只存在於瀏覽器端,伺服器與伺服器之間沒有這個問題。

方法一:以 $.ajax 的 jsonp 模式跨域

JSONP 是 "JSON with Padding" 的縮寫。它允許伺服器動態產生 <script> 標籤回傳給客戶端,藉由 JavaScript callback 的形式完成資料讀取。

前端:

jQuery(document).ready(function () {
  $.ajax({
    type: "get",                     // jQuery 不支援 POST 方式的跨域
    async: false,
    url: "https://api.taobao.com/apitools/ajax_props.do", // 跨域請求的 URL
    dataType: "jsonp",
    jsonp: "jsoncallback",           // 傳給後端、用來指定回調函式名稱的參數名(預設為 callback)
    jsonpCallback: "success_jsonpCallback", // 自訂回調函式名稱(預設由 jQuery 隨機產生)
    success: function (json) {
      alert(json);
    }
  });
});

後端(以 Java 為例):

public void jsonpTest() throws IOException {
  HttpServletRequest request = ServletActionContext.getRequest();
  HttpServletResponse response = ServletActionContext.getResponse();

  // 取得前端指定的回調函式名稱,本例為 success_jsonpCallback
  String callbackName = (String) request.getAttribute("jsoncallback");

  // 組出要回傳的 JSON 字串(實務上可用 Gson 等工具序列化物件)
  String jsonStr = "{\"name\":\"張三\",\"age\":28}";

  // 最終輸出:success_jsonpCallback({"name":"張三","age":28})
  String renderStr = callbackName + "(" + jsonStr + ")";
  response.setContentType("text/plain;charset=UTF-8");
  response.getWriter().write(renderStr);
}

要注意的是:這件事必須後端配合才行。很多人以為前端改成 jsonp 就能直接跨域,其實不然——後端得願意把資料包成回調形式。

JSONP 的原理

  1. 客戶端註冊一個 callback(如 jsoncallback),並把回調函式名稱(如 success_jsonpCallback)傳給伺服器。
  2. 伺服器先產生要回傳的 JSON 資料。
  3. 再以 JavaScript 語法產生一個函式,函式名稱就是傳上來的那個參數值。
  4. 把 JSON 資料作為參數放進函式中,形成一段合法的 JS 文件回傳。
  5. 瀏覽器解析 script 標籤並執行它,資料作為參數傳入客戶端預先定義好的 callback 函式中。

也就是說,跨域是透過動態增加 script 來載入資料,無法像 XHR 那樣直接取得回應物件,所以必須靠回調函式把資料「遞」回來。

方法二:以 getJSON 跨域

getJSON 的原理與上述 jsonp 模式完全相同,只是寫法更短。它的函式原型是:

jQuery.getJSON(url, data, success(data, status, xhr))
  • url(必要):請求的位址。
  • data(選填):一同送出的資料。
  • success(選填):請求成功時執行的函式,可取得 response(結果資料)、status(請求狀態)、xhr(XMLHttpRequest 物件)。

它其實是 ajax 的語法糖,等價於:

$.ajax({
  url: url,
  data: data,
  success: callback,
  dataType: "json"
});

使用方式:

$.getJSON("https://api.taobao.com/apitools/ajax_props.do?jsoncallback=?",
  function (data) {
    alert(data);
  }
);

執行原理一樣:送出請求時帶一個 jsoncallback=? 參數,jQuery 會把問號自動替換成產生的回調函式名稱,實際請求可能長得像:

https://api.taobao.com/apitools/ajax_props.do?jsoncallback=jsonp1322444422697

與 $.ajax 方式相比,唯一的差別就是「回調函式名稱是自動產生」還是「手工指定」。

最後幾點提醒

  • 範例中的淘寶 API 端點早已變更,實際使用請替換為目前有效的服務。
  • async: false 會凍結整個瀏覽器 UI 直到請求結束,實務上應避免,改用非同步並搭配 loading 提示。
  • JSONP 需要後端配合,跨網域限制也無法完全放寬。若你能控制後端,設定 CORS 回應標頭(Access-Control-Allow-Origin)會是更現代、更安全的做法,也能支援 POST。
XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved