KingKong Bruce記事: JSON之教學筆記

就最近寫了很多Ajax的東西，接觸到Ajax的第一件事就是HttpXML.send()之後，伺服器要回傳什麼資料，一般都是responseText或responseXML，也就是說，1. 回傳純文字；2. 回傳XML，純文字難以分析處理(要跑DOM時)，XML在伺服器端要花很多力氣去「組合」出XML資料，然後用戶端再寫很多Code去分析處理，這是很沒效率的。

所以就快快把JSON學一學吧！

JSON概念

進入JSON前，請先看我這篇「第二篇：簡單介紹JavaScript內建物件」Array物件第一段「Array宣告」的地方，宣告一個Javascript Array物件，基本上是兩種語法：

// 正式宣告
var team1 = new Array('Bruce', 'Sherry', 'Happy');
// 整合宣告
var team2 = ['Bruce', 'Sherry', 'Happy'];
alert(team1[0]); // Bruce
alert(team2[2]); // Happy

一個比較正式，一個是比較簡寫，通常Javascript寫久了，會採用第二種方式來宣告Array。

再來看Javascript物件的宣告，基本上也是兩種：

// 正式宣告
var Bruce = new Object();
Bruce.name = 'King Kong';
Bruce.age = 18;
Bruce.sex = 'male';
alert(Bruce.age); // 18

// 整合宣告
var Bruce = {
  'name' : 'King Kong',
  'age' : 18,
  'sex' : 'male'
}
alert(Bruce.name); // King Kong
alert(Bruce[name]); // King Kong

一樣，久了也是會選第二種來寫，再來我們看看Javascript的「Array + Object」的宣告：

// 宣告一個familys Array，裡面包含兩個Object
var familys = [
  {'name' : 'Bruce',
   'age' : 18,
   'sex' : 'male'},
  {'name' : 'Sherry',
   'age' : 16,
   'sex' : 'famale'}
];
alert(family[0].name); // Bruce
alert(family[1].sex);  // famale

到這裡你已經會了JSON的80%以上了，JSON (JavaScript Object Notation)已經說明的很清楚了，它是一個JavaScript的子集，它利用Object與Array來表示資料，讓資料很容易的可以交換使用。

JSON寫法

我們先來看完整的JSON寫法：

{
  'familys' = [
    {'name' : 'Bruce',
     'age' : 18,
     'sex' : 'male'},
    {'name' : 'Sherry',
     'age' : 16,
     'sex' : 'famale'}
  ]
}

JSON會建構出兩種結構：(1)「"名稱" : 值」的集合；(2)Array。

JSON的細節

比對上面範例，你會發現一點也不難。

JSON Object：

以"{"開始，以"}"結尾
每個名稱後跟著一個":"
每對"名稱:值"之間用","分隔

{ // 以"{"開始
  'name' : 'Bruce',  // 每個名稱後跟著一個":"
  'age' : 18,        // 每對"名稱:值"之間用","分隔
  'sex' : 'male'
} // 以"}"結尾

JSON Array：

以"["開始，以"]"結尾
值之間使用","

{
  // familys為一維陣列，陣列裡包含兩筆物件資料
  'familys' = [  // 以"["開始
    {'name' : 'Bruce',
     'age' : 18,
     'sex' : 'male'},  // 值之間使用","
    {'name' : 'Sherry',
     'age' : 16,
     'sex' : 'famale'}
  ] // 以"]"結尾
}

JSON Value：

值本身可以是String、Number、true、false、null、Object、Array；

JSON String：

由雙引號包圍的任意Unicode字元集合。可以使用"反斜線(\)"來轉義。

{ 
  "details" : "這是JSON的值. \n 此格式比XML合適Ajax交換資料使用."
}

JSON Number：

與一般數值相同，除8 / 16進制外。

JSON的使用

那JSON要如何使用呢？

原生的JSON格式資料，目前在IE7以上及MF 3以上，已經內建解析JSON格式的能力，但在相容性及網路上的不確定性(其他瀏覽器)，建議在有需要使用JSON格式的頁面引用json2.js，依官方說法，請不要在使用json.js這個版本的Script了。

我們有一JSON格式的String：

var jsonData = "{'familys'=[{'name' : 'Bruce', 'age' : 18, 'sex' : 'male'},
                            {'name' : 'Sherry','age' : 16, 'sex' : 'famale'}]}"

方法一：使用eval()
這個方法會引發安全性問題，我就不介紹了。

方法二：使用json2.js (IE7以上及MF 3以上可以不引用)

先在網頁中引用json2.js，然後使用json2所提供的parse方法：

var jsonData = "{'familys'=[{'name' : 'Bruce', 'age' : 18, 'sex' : 'male'},
                            {'name' : 'Sherry','age' : 16, 'sex' : 'famale'}]}"

var jsonObj = JSON.parse(jsonData);  // 將JSON格式資料轉為物件

alert(jsonObj.familys[0].name); // Bruce
alert(jsonObj.familys[1].age); // 16

這樣之後，我們就能在Ajax函式將伺服器傳回的JSON格式做解析：

// ...
if(xmlHttp.readyState == 4 && xmlHttp.status == 200){
  var jsonObj = JSON.parse(xmlHttp.responseText);
// ...
}

使用了JSON來交換資料後，你會發現相關Ajax的程式碼變簡單了，例如：

// 原始Ajax函數
function Do(xmlHttp) {
  if(xmlHttp.readyState == 4 && xmlHttp.status == 200){
    var familys = xmlHttp.responseXML.getElementsByTagName('familys');
    for (var i = 0; i < familys.length; i++) {
      var name = familys.getElementsByTagName('name')[0].firstChild.nodeValue;
      var age = familys.getElementsByTagName('age')[0].firstChild.nodeValue;
      var sex = familys.getElementsByTagName('sex')[0].firstChild.nodeValue;
    }
  }
}

// 使用JSON後的Ajax函數
function Do(xmlHttp) {
  if(xmlHttp.readyState == 4 && xmlHttp.status == 200){
    var jsonObj = JSON.parse(xmlHttp.responseText);
    var name = jsonObj.familys[0].name;
    var age = jsonObj.familys[0].age;
    var sex = jsonObj.familys[0].sex;
  }
}

不只有變簡單，而且程式的撰寫更直覺。另外，你也可以把Object轉為JSON：

// 宣告一個familys Array，裡面包含兩個Object
var familys = [
  {'name' : 'Bruce',
   'age' : 18,
   'sex' : 'male'},
  {'name' : 'Sherry',
   'age' : 16,
   'sex' : 'famale'}
];

var jsonData = JSON.stringify(familys);

更快速的是使用jQuery的$getJSON，但這超出了JSON的討論了。以上是接收解析JSON，那如果我要傳送JSON給伺服器呢？也簡單：

var xhr = request();  // 建立XHR物件
xhr.onreadystatechange = handler;
xhr.open('POST',URL);
xhr.setRequestHeader('Content-Type', 'application/json');  // 這裡是重點
xhr.send(json);

記得使用'application/json'來傳送即可，但一般伺服器端是看不懂JSON，不過沒關係，在JSON官網最下方或上網找一下，已經有很多高手分享出來可以在伺服器解析JSON的元件或Source Code，讓JSON資料傳送到伺服器後，依然方便好用。

使用JSONP進行跨站請求

這個主題比較生硬，如果你不會使用到跨網站請求，可以先跳過。

一般而言，在網站中是不太充許你去存取其他網站的內容，但不是百分百，例如iframe或img就是很好的例子，但其他HTML、Javascript就都不太能做這種事，例如XMLHttpRequest，這是一種保護。但現今網頁已經很少能不去存取其他網站，例如掛個「噗浪」「fb」…，但偏偏XMLHttpRequest不充許跨網站去存取。

後來有人發展出了JSONP(JSON with Padding)，JSONP利用Javascript的callback機制，繞過Browser的安全限制，關鍵在動態載入<script src="...">，利用src來載入外部JSON資料或Javascript function到網頁中。

我們先來看動態建立Script

var Script = document.createElement('script');
Script.type = 'text/javascript';
Script.src = 'http://ajax.aspnetcdn.com/ajax/jquery/jquery-1.4.4.min.js';
document.getElementByTagName('head').[0].appendChild(Script);

這相當於在head最下面新增一段script tag：

<script type="text/javascript" src="http://ajax.aspnetcdn.com/ajax/jquery/jquery-1.4.4.min.js"></script>

這差不多就是JSONP的基礎了，透過動態建立script及Javascript callback，來載入跨網站JSON資料。

最後我們來看整個JSONP的運作流程示意程式碼，注意程式的流程，Step 1在Client--> Step 2在Server--> Step 3 回到Client。

Client端：*.html

// 使用jQuery

// Step 1：送出JSONP請求，
$(function(){
  $('#send').click(function(){
    // 最後必須是 &callback=funcion 或 &jsoncallback=function 結尾
    var URL = "http://abc.com/jsonp.aspx?id=1&name=Bruce&jsoncallback=dosomething";

    $.ajax({
      type : 'GET',
      dataType : 'jsonp',  // 記得是jsonp
      url : URL,
      error : function(xhr, error){ alert('Ajax request error.');}
    })
  })
});

// Step 3：收到伺服器回應後(response.write(jsonp))，執行的callback的function

function dosomething(jsonData){
  // jsonData會取得Server傳回{...json data ...}
  alert(jsonData.name);
  alert(jsonData.age);
  alert(jsonData.sex);
}

在建立非同請求時，在網址最後加上「&callback=函數名稱」或「&jsoncallback=函數名稱」，就可以取得其他網域的資料並執行後續callback的函數。

Server端 *.aspx

' Step 2：進行相關處理

'接收到的id & name處理...

' 以下是重點，組合出function及json資料，然後回傳
Dim jsonp AS String = 
' dosomething是 function name
' {...} 是json data 
jsonp = "dosomething({ _
  ' ... json data ... _
})"

Response.Write(jsonp)

Reference：

Javascript
http://www.json.org/json-zh.html (官方網站，一定要看)
https://github.com/douglascrockford/JSON-js (請下載json2.js使用)
http://blog.roodo.com/syshen/archives/1410294.html (JSON介紹)
http://pulipuli.blogspot.com/2010/08/ajaxjavascriptjsonp.html (Ajax & JSON投影片做得好)
http://happytemplate.blogspot.com/2007/11/jsonp.html (JSONP例子簡單)
http://herolin.twbbs.org/?s=jsonp
http://caterpillar.onlyfun.net/Gossip/JavaScript/index.html (很多Javascript資料)
http://www.pozzware.com (可以下載到Visual Basic 2008解析JSON的Source Code，可自行編譯為*.DLL，但註冊及成為正式使用者需要一些日子，我約二~三週後才成為RegisteredUser，然後才下載到PW.JSON Library)

8 則留言:

匿名2012年2月14日上午11:02
不好意思，你的 var jsonData 寫錯了，應該如下：

var jsonData = "{'familys' : [{'name' : 'Bruce', 'age' : 18, 'sex' : 'male'},
{'name' : 'Sherry','age' : 16, 'sex' : 'famale'}]}"
回覆刪除
回覆
匿名2012年2月14日上午11:07
剛剛寫錯了，應該這樣才能運作：最外面是 ' 單引號，裡面的值是雙引號， familys 要用 : 不是 = ，這樣 JSON.parse 才會過。
var jsonData = '{"familys" : [{"name" : "Bruce", "age" : 18, "sex" : "male"}, {"name" : "Sherry","age" : 16, "sex" : "famale"}]}';
回覆刪除
回覆
陳傳興2012年2月14日下午2:18
感謝。
讀者請參考：http://blog.kkbruce.net/2012/02/javascript-jsonstring.html#.Tzn8ZbHxpZg
原文不修正。
回覆刪除
回覆
匿名2013年7月4日下午4:30
"http://abc.com/jsonp.aspx?id=1&name=Bruce&jsoncallback=dosomething"這網址我們想要自己產生要怎麼做?
回覆刪除
回覆
fatalfeel2016年5月29日晚上10:25
非常好的範例與解說比起直接用json語法教學好太多
回覆刪除
回覆
布丁布丁吃布丁2016年11月26日上午11:45
我是上面您引用中提到投影片blog「布丁布丁吃什麼？」的作者布丁，來這兒是想謝謝您的稱讚QQ
一起努力學習JavaScript吧
回覆刪除
回覆
蔡阿勇2017年7月28日下午5:15
動態建立script 最後一行程式有些typo，可以修正一下
document.getElementsByTagName('head')[0].appendChild(Script);
回覆刪除
回覆

新增留言

感謝您的留言，如果我的文章你喜歡或對你有幫助，按個「讚」或「分享」它，我會很高興的。