本文主要总结网站编写以来在传递 JSON 数据方面遇到的一些问题以及目前采用的解决方案。网站数据库采用 MongoDB，后端是 Python，前端采用“半分离”形式的 Riot.js，所谓半分离，是说第一页数据是通过服务器端的模板引擎直接渲染到 HTML 中，从而避免首页两次加载的问题，而其它动态内容则采用 Ajax 加载。整个流程中数据都是通过 JSON 格式传递的，但是在不同的环节中需要采用不同的方式并遇到一些不同的问题，本文主要做记录、总结。
1. What is JSON?
JSON（JavaScript Object Notation） 是一种由道格拉斯·克罗克福特构想设计、轻量级的数据交换语言，它的前辈 XML 可能更早被人们所熟知。当然 JSON 并不是为了取代 XML 而存在的，只是相比于 XML 它更小巧、更适合在网页开发中用作数据传递（JSON 之于 JavaScript 就像 XML 之于 Lisp）。从名字上可以看出，JSON 的格式符合 JavaScript 语言中“对象”的语法格式，除了 JavaScript 之外，很多其他语言中也具有类似的类型，例如 Python 中的字典（ dict ），除了编程语言之外，一些基于文档存储的 NoSQL 非关系型数据库也选择 JSON 作为其数据存储格式，例如 MongoDB。
总的来说，JSON 定义一种标记格式，可以非常方便地在编程语言中的变量数据与字符串文本数据之间相互转换。JSON 描述的数据结构包括以下这几种形式：
对象： {key: value}
列表： [obj, obj,...]
字符串： "string"
数字：数字
布尔值： true / false
了解了 JSON 的基本概念之后，下面分别针对上图中的几个数据交互环节进行总结。
2. Python <=> MongoDB
Python 与 MongoDB 之间的交互主要由现有的驱动库提供支持，包括 PyMongo、Motor 等，而这些驱动所提供的接口都是非常友好的，我们不需要了解任何底层的实现，只要对 Python 原生的字典类型进行操作即可：
import motor client = motor.motor_tornado.MotorClient() db = client['test'] user_col = db['user'] user_col.insert(dict( name = 'Yu', is_admin = True, ))
唯一需要注意的是 MongoDB 中的索引项 _id 是通过 ObjectId("572df0b78a83851d5f24e2c1") 存储的，而对应的 Python 对象为 bson.objectid.ObjectId ，因此在查询时需要以此对象的实例进行：
from bson.objectid import ObjectId user = db.user.find_one(dict( _id = ObjectId("572df0b78a83851d5f24e2c1") ))
3. Python <=> Ajax
前端与后端之间的数据交流比较常用的是通过 Ajax 完成，这时遇到了第一个不大不小的坑。在之前的一篇文章中，我总结了 一次 Python 编码的坑 ，我们知道 HTTP 传递过程中肯定不存在 JSON/XML ，一切都是二进制数据，但是我们可以选择让前端用什么样的方式解读这些数据，即通过设定 Header 中的 Content-Type ，一般传递 JSON 数据时将其设定为 Content-Type: application/json ，在 Tornado 最新版本中，只需要直接写入字典类型即可：
# Handler async def post(self): user = await self.db.user.find_one({}) self.write(user)
于是迎来了第一个错误： TypeError: ObjectId('572df0b58a83851d5f24e2b1') is not JSON serializable 。追溯原因，虽然 Tornado 帮我们简化了操作，但在像 HTTP 中写入字典类型时仍然需要经历一次 json.dumps(user) 操作，而对于 json.dumps 来说， ObjectId 类型是非法的。于是我选择了最直观的解决方案：
import json from bson.objectid import ObjectId class JSONEncoder(json.JSONEncoder): def default(self, obj): if isinstance(obj, ObjectId): return str(obj) return super().default(self, obj) # Handler async def post(self): user = await self.db.user.find_one({}) self.write(JSONEncoder.encode(user))
这次不会再出错了，我们自己的 JSONEncoder 可以应对 ObjectId 了，但另一个问题也出现了：
JSONEncoder.encode 之后字典类型被转换成字符串，写入 HTTP 之后 Content-Type 变为 text/html ，这时前端将认为接收的数据为字符串而不是可用的 JavaScript Object。当然还有进一步的弥补方案，那就是前端再进行一次转换：
$.post(API, {}, function(res){ data = JSON.parse(res); console.log(data._id); })
问题暂时解决了，在整个过程中 JSON 的变换是这样的：
Python ==> json.dumps ==> HTTP ==> JavaScript ==> JSON.parse dict ==> str ==> binary ==> string ==> Object
结果第二个问题来了，当数据中存在一些特殊字符时， JSON.parse 将出现错误：
JSON.parse("{'abs': '\n'}"); // VM536:1 Uncaught SyntaxError: Unexpected token ' in JSON at position 1(…)