编码为 array 还是 object

首先大家请看这段源码：

  1. -- http://www.kyne.com.au/~mark/software/lua-cjson.php
  2. -- version: 2.1 devel
  4. local json = require("cjson")
  5. ngx.say("value --> ", json.encode({dogs={}}))

输出结果

  1. value --> {"dogs":{}}

注意看下 encode 后 key 的值类型，”{}” 代表 key 的值是个 object，”[]” 则代表 key 的值是个数组。 对于强类型语言(C/C++, Java 等)，这时候就有点不爽。因为类型不是它期望的，需要做容错。对于 Lua 而言，它是把数组和字典融合到一起了，所以它是无法区分空数组和空字典的。

参考 openresty/lua-cjson 中额外贴出测试案例，我们就很容易找到思路了。

  1. -- 内容节选lua-cjson-2.1.0.2/tests/agentzh.t
  2. === TEST 1: empty tables as objects
  3. --- lua
  4. local cjson = require("cjson")
  5. print(cjson.encode({}))
  6. print(cjson.encode({dogs = {}}))
  7. --- out
  8. {}
  9. {"dogs":{}}
  12. === TEST 2: empty tables as arrays
  13. --- lua
  14. local cjson = require("cjson")
  15. cjson.encode_empty_table_as_object(false)
  16. print(cjson.encode({}))
  17. print(cjson.encode({dogs = {}}))
  18. --- out
  19. []
  20. {"dogs":[]}

综合本章节提到的各种问题，我们可以封装一个 json_encode 的示例函数：

  1. local json = require("cjson")
  2. -- 稀疏数组会被处理成 object
  3. json.encode_sparse_array(true)
  5. local function _json_encode(data)
  6.     return json.encode(data)
  7. end
  9. function json_encode( data, empty_table_as_object )
  10.     -- Lua 的数据类型里面，array 和 dict 是同一个东西。对应到 json encode 的时候，就会有不同的判断
  11.     -- cjson 对于空的 table，就会处理为 object，也就是 {}
  12.     -- 处理方法：cjson 使用 `encode_empty_table_as_object` 这个方法。
  13.     json.encode_empty_table_as_object(empty_table_as_object or false) -- 空的 table 默认为 array
  14.     local ok, json_value = pcall(_json_encode, data)
  15.     if not ok then
  16.         return nil
  17.     end
  18.     return json_value
  19. end

另一种思路是，使用 setmetatable(data, json.empty_array_mt)，来标记特定的 table，让 cjson 在编码这个空 table 时把它处理成 array：

  1. local data = {}
  2. setmetatable(data, json.empty_array_mt)
  3. ngx.say("empty array: ", json.encode(data)) -- empty array: []