首页 > 代码库 > IT忍者神龟之jQuery 使用 $.getJSON() 跨域获取 JSON 数据

IT忍者神龟之jQuery 使用 $.getJSON() 跨域获取 JSON 数据

假设在服务器上有文件 http://test.unmi.cc/json.php 文件,它的内容为:

[代码 1]

01
02
03
04
05
06
07
08
09
10
<?php
header(‘Content-type: application/json‘);
 
$user= array(
    "name" => "Unmi",
    "blog"=> "http://unmi.cc"
);
 
echojson_encode($user);
?>

要是在同一个域上要取该文件的内容,那好办,比如同为 test.unmi.cc 域上的 ajax.html 文件中写上:

[代码 2]

01
02
03
04
05
06
07
08
09
10
<script src=http://www.mamicode.com/"http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script>
$(function(){
    $.getJSON("json.php",/*跨域时换成 "http://test.unmi.cc/json.php"*/
        function(data){
            alert(data.name);
        }
    )
});
</script>

那么可以弹出 data.name 为 “Unmi".

但如果 ajax.html 是放在另一个域上,比如说 ajax.html 是在本地,再来取 http://test.unmi.cc/json.php 的 json 数据时,这时候在 Firebug 中你可以看到其实也会用 ajax 来请求 http://test.unmi.cc/json.php 的数据,但是 XHR 里的 Response 是空的,字节数是对的。也就是说对 http://test.unmi.cc/json.php 的 http 请求/响应是完成了的,但基于安全性考虑,浏览器会拒绝处理响应数据。

不少资料上会说,在 jQuery 使用 $.getJSON() 请求数据时,如果判断到请求的数据不在同一个域上会自动采用 JSONP (JSON with Padding) 的方式进行跨域请求,但是还忽略了两点:

一是需求发送 callback=? 或 jsoncallback=? 请求参数
二是这时候还需要服务端的支持,送出的数据就不是 JSON 数据,而是由 callback 或  jsoncallback 参数指定名称的 javascript 函数调用,参数才是 JSON 数据

所以要完成 $.getJSON() 的跨域调用服务端和客户端必须分别改造成:

服务端 http://test.unmi.cc/json.php

[代码 3]

01
02
03
04
05
06
07
08
09
10
<?php
header(‘Content-type: application/javascript‘);
 
$user= array(
    "name" => "Unmi",
    "blog"=> "http://unmi.cc"
);
 
echo$_GET[‘callback‘]."(".json_encode($user).");";
?>

客户端   ajax.html 文件内容:

[代码 4]

01
02
03
04
05
06
07
08
09
10
<script src=http://www.mamicode.com/"http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script>
$(function(){
    $.getJSON("http://test.unmi.cc/json.php?callback=?"
        function(data){
            alert(data.name);
        }
    )
});
</script>

这样就可以得到预期的结果,就是这里多了个 callback,也可以使用 jsoncallback。

我们用 Firebug 来观察上面代码在进行跨域请求时,并未发出 XHR 请求,而是使用了 <script src=http://www.mamicode.com/""> 去请求的脚本,它发出的请求是:

http://test.unmi.cc/json.php?callback=jQuery172018016521480994097_1338136926617&_=1338136926659

得到的响应数据是:

jQuery172018016521480994097_1338136926617({"name":"Unmi","blog":"http:\/\/unmi.cc"});

上面的 callback=? 参数并不是说发送了参数值为 ?,再说 ? 号也得转义才成,? 号只是个点位符,会由 jQuery 来生成一个方法名,如这里的

jQuery172018016521480994097_1338136926617

如果把 [代码 4] 放在与 http://test.unmi.cc/json.php 的同一个域上去执行,那么它发出的请求与响应会是与跨域时一样的,但它却会以 XHR 方式来请求数据,而不是 <script src=http://www.mamicode.com/""> 方式。

$.getJSON() 跨域调用的原理,基本上在 jQuery 里涉及到 ajax 跨域的调用都是通过 <script src=http://www.mamicode.com/""> 来完成的,不知有没有用 <iframe src=""> 的。解释 $.getJSON() 在跨域时,其实就是指定的 $.ajax() 里的 dataType 为 jsonp,进而和 $.getScript 的实现原理是一样的:

[代码 5]

1
2
3
4
varhead = document.getElementsByTagName("head")[0];
varscript = document.createElement("script");
script.src = http://www.mamicode.com/s.url;
head.appendChild(script);

记得在  $.getJSON() 如果是跨域时获得的是一段 JavaScript 调用代码,函数名由  callback 指定,该函数由 jQuery 生成,JSON 数据作为参数传给该 callback 函数,最后这个 JSON 数据也会传递到 success 函数中去,所以我们能够像 $getJSON() 获取本域的 JSON 数据那样使用。

不用便捷的  $.getJSON() 而采用基础的 $.ajax() 函数来作跨域调用就得写成:

[代码 6]

01
02
03
04
05
06
07
08
09
10
11
12
<script src=http://www.mamicode.com/"http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script>
$(function(){
     $.ajax({
       url:"http://test.unmi.cc/json.php",
       dataType:‘jsonp‘,
       success:function(data){
         alert(data.name);
       }
   });
});
</script>

只告诉它 dataType 为  jsonp 即可,它同样是发出类似

http://test.unmi.cc/json.php?callback=jQuery172018016521480994097_1338136926617&_=1338136926659

的请求,callback 参数名是默认的。

再加上两个 $.ajax 跨域获取 JSON 数据时两个重要的选项,比如下面的代码:

[代码 7]

01
02
03
04
05
06
07
08
09
10
11
12
13
14
<script src=http://www.mamicode.com/"http://ajax.googleapis.com/ajax/libs/jquery/1.7.2/jquery.min.js"></script>
<script>
$(function(){
     $.ajax({
       url:"http://test.unmi.cc/json.php",
       dataType:‘jsonp‘,
       jsonp:‘jsonpcallback‘,
       jsonpCallback:‘jsonCallbackFunction123‘,
       success:function(data){
         alert(data.name);
       }
   });
});
</script>

执行后发出的请求是:

http://test.unmi.cc/json.php?jsonpcallback=jsonCallbackFunction123&_=1338139076306

响应是:

jsonCallbackFunction123({"name":"Unmi","blog":"http:\/\/unmi.cc"});

与上面对照一下就能看出来 jsonp 用来指定传送函数名的请求参数名,而不是默认的 callback,jsonpCallback 指定回调函数的名数,而不用默认 jQuery 随机生成的那一长串的函数名称。

而且,因为回调函数名是已知的,所以你可以自己定义那个 jsonCallbackFunction123 函数,原型是:

function jsonCallbackFunction123(data) { ... },

即使自定义了这个回调函数,由  success 指定的函数同样会得到调用,会在 jsonCallbackFunction123 之后被调用。

关于 $.getJSON() 可以看官方的说明 http://api.jquery.com/jQuery.getJSON/,其中有一个取 flickr 上照片的例子。

顺便引入一个可在线测试各种 JavaScript 框架的网站 http://jsfiddle.net/praveen_prasad/tnaWd/,支持各版本的 jQuery, Mootools, Prototype, YUI, Glow, Dojo, Processing, ExtJS, Raphael, RightJS, ThreeJS, Zepto, Enyo, Shipyar, MooFx 和 Knockout。

试用一下,进到 http://jsfiddle.net/praveen_prasad/tnaWd/,选择框架为 jQuery 1.7.2, 事件为 onl oad 或 onDomReady,然后在 Javascript 框中贴入代码:

[代码  8]

1
2
3
4
5
6
7
8
9
//$(function(){  
   $.getJSON("http://api.flickr.com/services/feeds/photos_public.gne?tags=cat&tagmode=any&format=json&jsoncallback=?",
        function(data){
          $.each(data.items,function(i,item){
            $("<img/>").attr("src", item.media.m).appendTo("body");
            if( i == 3 ) returnfalse;
          });
    });
//});

再点击上边的 Run 按钮,一会儿就能看到 Result 框中显示四个可爱的猫咪图片。

参考:1. Using JQuery, AJAX and JSONP to do cross-domain calls with PHP

http://unmi.cc/jquery-getjson-cross-domain/

IT忍者神龟之jQuery 使用 $.getJSON() 跨域获取 JSON 数据