JSON 编码格式提交表单数据详解

Question

以 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=="
        }
    ]
}