a introduction of jsonnanny

1. JSON Schema,Orderly JSON
and JSON Nanny

2. Summary
• JSON Schema = 基本语法
• Orderly JSON = 简要实现
• JSON Nanny = 文档平台

3. JSON Schema
• JSON Schema解决什么问题？
• JSON Schema基本语法
• JSON Schema的问题

4. JSON Schema
Q:我需要前端同学给我提供一份接口设计？
A:使用php或其他模拟各 条件分支，然后提
供example。
Q:我如何更清晰的了解接口是如何设计的？
A:F2F沟通，然后写入注释。
Q:现在谁负责这个应用，当时是如何设计的？
A: ...，不太清楚，我看下代码
Q: 步抛错了，JSON接口问题吧？

5. JSON Schema
Q:不同的前端接口是否对 发和前端来说都是
一 成本？
e.g 产品，订单，优惠条件...

6. JSON Schema
解决的问题：
存档、描述、校验

7. JSON Schema
• JSON Schema解决什么问题？
• JSON Schema基本语法
• JSON Schema的问题

8. JSON Schema
{
"name":"Product",
"properties":{
"id":{
"type":"number",
"description":"Product identifier",
"required":true
}
}
}

9. JSON Schema
• {"type":["string","number"]}
• "properties":{
"id":{
"type":"number",
"description":"Product identifier",
"required":true,
“default”:3
}
}

10. enum,pattern,$schema,links
• enum用于枚举
• pattern 正则表达式约束
• $schema指向schema草案中定义的基带
schema
• 依赖其他工具实现的links

11. JSON Schema
• 书写 杂，难于记忆
• 相 工具未实现的细节太多，暂时可以
忽略

12. Orderly JSON
• Orderly JSON解决什么问题？
• Orderly JSON基本语法

13. Orderly JSON
object {
string name;
string description?;
string homepage /^http:/;
integer {1500,3000} invented;
}*；

14. Orderly JSON
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"description": {
"type": "string",
"optional": true
},
"homepage": {
"type": "string",
"pattern": "^http:"
},
"invented": {
"type": "integer",
"minimum": 1500,
"maximum": 3000
}
},
"additionalProperties": true
}

15. Orderly JSON
JSON Schema子集的一中微语言表现方式，
便于书写，记忆。

16. JSON Nanny
承载json schema,以及orderly json的文档平
台，基于gist，tornado，mongodb
•4月draft,reference翻译，主功能实现
• 5月组权限,fork以及tour文档