JSON編碼格式提交表單數據詳解

轉自：http://www.webhek.com/html-json-form-submission

以JSON編碼格式提交表單數據是HTML5對WEB發展進化的又一大貢獻，以前我們的HTML表單數據是通過key-value方式傳輸的服務器端，這種形式的傳輸對數據組織缺乏管理，形式十分原始。而新出現的JSON格式提交表單數據方法，將表單裏的所有數據轉化的具有一定規範的JSON格式，然後傳輸的服務器端。服務器端接收到的數據是直接可以使用的合格JSON代碼。

如何聲明以JSON格式提交表單

大家應該對如何用表單上傳一個文件的寫法很熟悉，它需要在HTML中form標記上添加 enctype="multipart/form-data" 聲明，就是告訴瀏覽器要按上傳文件模式發送表單數據。而JSON格式提交表單的聲明與此類似，它的寫法是： enctype='application/json'。

對老式瀏覽器的兼容

以JSON格式提交表單是HTML5中一種很新的規範，只有實現了這些規範的現代瀏覽器才能識別 enctype='application/json'的語義，才能正確的將表單數據打包成JSON格式。而對於一些老式瀏覽器，以及還未實現這些標準的瀏覽器，它們無法識別 enctype='application/json'代表什麼，於是表單的enctype會自動退化成application/x-www-form-urlencoded缺省編碼格式。服務器端代碼可以根據enctype的值來判斷如何接收數據。

JSON編碼格式提交表單的格式範例

例1 基本用法

<form enctype='application/json'>
  <input name='name' value='Bender'>
  <select name='hind'>
    <option selected>Bitable</option>
    <option>Kickable</option>
  </select>
  <input type='checkbox' name='shiny' checked>
</form>

// 生成的Json數據是
{
  "name":   "Bender"
, "hind":   "Bitable"
, "shiny":  true
}

例2 當表單存在多個重名的表單域時，按JSON數組編碼

<form enctype='application/json'>
  <input type='number' name='bottle-on-wall' value='1'>
  <input type='number' name='bottle-on-wall' value='2'>
  <input type='number' name='bottle-on-wall' value='3'>
</form>

// 生成的Json數據是
{
  "bottle-on-wall":   [1, 2, 3]
}

例3 表單域名稱以數組形成出現的複雜結構

<form enctype='application/json'>
  <input name='pet[species]' value='Dahut'>
  <input name='pet[name]' value='Hypatia'>
  <input name='kids[1]' value='Thelma'>
  <input name='kids[0]' value='Ashley'>
</form>

// 生成的Json數據是
{
    "pet":  {
        "species":  "Dahut"
    ,   "name":     "Hypatia"
    }
,   "kids":   ["Ashley", "Thelma"]
}

例4 在上面的例子中，缺失的數組序號值將以null替代

<form enctype='application/json'>
  <input name='hearbeat[0]' value='thunk'>
  <input name='hearbeat[2]' value='thunk'>
</form>

// 生成的Json數據是
{
    "hearbeat":   ["thunk", null, "thunk"]
}

例5 多重數組嵌套格式，嵌套層數無限制

<form enctype='application/json'>
  <input name='pet[0][species]' value='Dahut'>
  <input name='pet[0][name]' value='Hypatia'>
  <input name='pet[1][species]' value='Felis Stultus'>
  <input name='pet[1][name]' value='Billie'>
</form>

// 生成的Json數據是
{
    "pet":  [
        {
            "species":  "Dahut"
        ,   "name":     "Hypatia"
        }
    ,   {
            "species":  "Felis Stultus"
        ,   "name":     "Billie"
        }
    ]
}

例6 真的，沒有數組維度限制！

<form enctype='application/json'>
  <input name='wow[such][deep][3][much][power][!]' value='Amaze'>
</form>

// 生成的Json數據是
{
    "wow":  {
        "such": {
            "deep": [
                null
            ,   null
            ,   null
            ,   {
                    "much": {
                        "power": {
                            "!":  "Amaze"
                        }
                    }
                }
            ]
        }
    }
}

例7 文件上傳

<form enctype='application/json'>
  <input type='file' name='file' multiple>
</form>

// 假設你上傳了2個文件, 生成的Json數據是:
{
    "file": [
        {
            "type": "text/plain",
            "name": "dahut.txt",
            "body": "REFBQUFBQUFIVVVVVVVVVVVVVCEhIQo="
        },
        {
            "type": "text/plain",
            "name": "litany.txt",
            "body": "SSBtdXN0IG5vdCBmZWFyLlxuRmVhciBpcyB0aGUgbWluZC1raWxsZXIuCg=="
        }
    ]
}