DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> JavaScript入門知識 >> AJAX入門 >> AJAX詳解
用 jQuery 的 $.getJSON 動手做一次跨域 Ajax 請求
編輯:AJAX詳解     

jQuery 提供了 $.getJSON 方法,讓我們能實作跨域的 Ajax 請求。不過官方 API 文件的說明實在偏少——到底該怎麼呼叫?被請求的網站應該回傳什麼樣的資料,$.getJSON 才拿得到?下面用一個實際例子把整個流程走一遍,順便留著以後備用。

一、原理:JSONP

$.getJSON 之所以能跨域,靠的是 JSONP(JSON with Padding):與其用 XMLHttpRequest(受同一來源政策限制),不如動態插入一個 <script> 標籤去載入遠端資源——script 標籤不受跨域限制。而載入的內容不是純 JSON,而是一段包裹在你指定函式名稱中的 JavaScript 呼叫。

關鍵就在 URL 裡那個 callback=?:問號是告訴 jQuery「這裡請幫我填入一個臨時的 callback 函式名稱」。伺服器必須把這個名稱原封不動地讀出來,再包在回應外面。

二、後端:以 PHP 為例

以下實作一個預約登記介面,需要傳入的參數為姓名、聯絡電話與地址:

/* 預約登記執行介面 */
case "yuyue_interface":
    $name  = trim($_GET['name']);
    $phone = trim($_GET['phone']);
    $addr  = trim($_GET['addr']);
    $dt    = date("Y-m-d H:i:s");

    // 這個 callback 參數是 JSONP 的關鍵,必須原樣回傳
    $cb = $_GET['callback'];

    if ($name == "" || $name == NULL){
        echo $cb . "({code:" . json_encode(1) . "})";
    } elseif ($phone == "" || $phone == NULL){
        echo $cb . "({code:" . json_encode(2) . "})";
    } elseif ($addr == "" || $addr == NULL){
        echo $cb . "({code:" . json_encode(3) . "})";
    } else {
        $db->execute("insert into tb_yuyue
            (realname, telphone, danwei, dt, ischeck)
            values ('$name', '$phone', '$addr', '$dt', 0)");
        echo $cb . "({code:" . json_encode(0) . "})";
    }
    exit;
break;

回應的樣子會像這樣(假設 jQuery 產生的函式名為 jQuery1234567):

jQuery1234567({code:0})

伺服器端三個重點:一定要把傳進來的 callback 參數原樣輸出,否則前端收不到;回應內容必須是合法的 JavaScript 表達式;處理完畢立刻 exit,別讓後續輸出污染回應。

三、前端:呼叫與處理

$(document).ready(function(){
    // 以下三個為預約登記所需的參數
    var name  = "name";    // varchar,最長 8 位(4 個漢字)
    var phone = "phone";   // varchar,長度 11 位
    var addr  = "addr";    // varchar,最長 500 位(250 個漢字)

    $.getJSON("https://請求網站位址/data.php?ac=yuyue_interface"
        + "&name=" + name
        + "&phone=" + phone
        + "&addr=" + addr
        + "&callback=?",
        function(data){
            if (data.code == 1){
                alert("姓名不能為空");
            } else if (data.code == 2){
                alert("手機不能為空");
            } else if (data.code == 3){
                alert("所在單位不能為空");
            } else {
                alert("預約成功");
            }
        });
});

回呼函式中拿到的 data 已經是解析好的物件,可以直接用 data.code 判斷。這正是 JSONP 的方便之處:你不必自己解析字串。

四、幾個實務上必須注意的地方

參數務必編碼:上面的範例直接把中文姓名與地址拼進 URL,實務上應改用 encodeURIComponent(),或更好的做法是使用 jQuery 的 $.ajax 搭配 dataType: 'jsonp',讓它替你處理:

$.ajax({
    url      : "https://請求網站位址/data.php",
    dataType : "jsonp",
    data     : { ac : "yuyue_interface", name : name, phone : phone, addr : addr },
    success  : function(data){
        // 依 data.code 處理
    }
});

安全性要重新評估:JSONP 的本質是「執行遠端網站提供的 JavaScript」,因此你必須完全信任對方。若回應中包含使用者輸入而未妥善處理,等於主動引入跨站腳本風險。上面的 PHP 範例直接把變數拼進 SQL,應改用參數化查詢;回傳 JSON 前也應過濾特殊字元。

不要用 GET 傳送敏感資料:跨域請求的參數會完整出現在網址中,並可能被中介設備與日誌留存。這類介面若涉及個資,應改走同域 POST 並全程使用 HTTPS。

錯誤處理:JSONP 無法回傳標準的 HTTP 錯誤狀態,因此伺服器端的一致回應格式(例如永遠回傳 {code: ...})就顯得格外重要;前端也建議為 $.ajax 加上 error 與逾時設定。

做完這次實驗,你不但學會了 $.getJSON 的用法,也等於學會了如何提供一個让别人跨域呼叫的介面。若哪裡寫錯了,歡迎指正。

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