Introduction to JSON Schema

JSON Schema速習会の資料です http://wantedly.connpass.com/event/17532/

https://github.com/izumin5210/jsonschema-study

Transcript

1. 20150716 - JSON Schema 速習会 Introduction to JSON Schema Masayuki IZUMI - @izumin5210
2. Ƅ Rekimoto Lab. at the University of Tokyo (2008-2015: Akashi-NCT) Ɠ Enginner at Wantedly, Inc. (2014.9-2015.2: Dmetlabel, Inc.)
3. pry(main)> izumin.skill_ratio Ruby JavaScript Android Design
4. pry(main)> izumin.skill_ratio Ruby JavaScript Android Design
5. 「JSON Schema ?」 さいきんよく見かけるけど，一体何者？
6. Q: What does it do? JSON Schema ってなにすんの？ A: It describes your JSON data format[1] . JSON のフォーマット記述するやつやで． [1] http://json-schema.org/ 20150716 - JSON Schema 速習会
7. What is JSON Schema ? 20150716 - JSON Schema 速習会 * Defines structure of JSON data - JSON Schema Core * Provides structual validation - JSON Schema Validation * Defines hyper{text,media} related things - JSON Hyper Schema
8. $ git clone https://github.com/izumin5210/jsonschema-study.git $ cd jsonschema-study # branch 名はお好みでどうぞ $ git checkout -b hands-on refs/tags/entrypoint # path 不要な人は省略してください $ bundle install --path vendor/bundle $ RACK_ENV=mock bundle exec rackup config.ru -p 5000 $ open http://localhost:5000/api/users とりあえず触ってみましょう
9. /api/users [ { "created_at": "2015...", "id": 1, "name": "Masayuki IZUMI", "updated_at": "2015..." } ] namespace '/api' do get '/users' do json [] end end /api/users app.rb
10. /api/users [ { "created_at": "2015...", "id": 1, "name": "Masayuki IZUMI", "updated_at": "2015..." } ] namespace '/api' do get '/users' do json [] end end /api/users app.rb
11. /api/users [ { "created_at": "2015...", "id": 1, "name": "Masayuki IZUMI", "updated_at": "2015..." } ] namespace '/api' do get '/users' do json [] end end /api/users app.rb [2] https://github.com/r7kamura/rack-json_schema/
12. testing
13. レスポンスを適当に弄ってみる
15. [2] https://github.com/r7kamura/rack-json_schema/
16. document $ open http://localhost:5000/doc
17. [2] https://github.com/r7kamura/rack-json_schema/ document $ open http://localhost:5000/doc
18. 自分で書いてみる $ bundle exec prmd init -y post > doc/schemata/post.yml [3] https://github.com/interagent/prmd
19. 基本構造 title: User description: User object definitions: # 属性等の定義 links: # API の定義（厳密にはチョットチガウ） properties: # 属性の定義（defeinitions への参照が多い）
20. 基本構造 - definitions title: User description: User object definitions: email: description: email address type: string format: email # 以下略
21. 基本構造 - properties title: User description: User object definitions: # 中略 properties: email: "$ref": "/schemata/user#/definitions/email" # 以下略
22. title: User description: User object definitions: # 中略 properties: email: "$ref": "/schemata/user#/definitions/email" # 以下略 基本構造 - properties "$ref": "#/foo/bar" JSON Reference[4] #/foo/bar JSON Pointer[5] [4] http://tools.ietf.org/html/draft-pbryan-zyp-json-ref-03 [5] http://tools.ietf.org/html/rfc6901
23. 基本構造 - links title: User description: User object definitions: # 中略 links: - description: Info for existing user. href: "/api/users/{(%2Fschemata%2Fuser%23definitions%2Fid)}" method: GET rel: self title: Info # 以下略
24. 基本構造 - links title: User description: User object definitions: # 中略 links: - description: Info for existing user. href: "/api/users/{(%2Fschemata%2Fuser%23definitions%2Fid)}" method: GET rel: self title: Info # 以下略
25. 基本構造 - links title: User description: User object definitions: # 中略 links: - description: Info for existing user. href: "/api/users/{(%2Fschemata%2Fuser%23definitions%2Fid)}" method: GET rel: self title: Info # 以下略 "/foo/bar/{(%23baz)}" URI Template[6] [6] http://tools.ietf.org/html/rfc6570
26. 基本構造 - links # 略 links: - description: Create a new user. href: "/api/users" method: POST rel: self schema: properties: # 属性の定義 type: - object title: Create # 以下略
27. 基本構造 - links # 略 links: - description: Create a new user. href: "/api/users" method: POST rel: self schema: properties: # 属性の定義 type: - object title: Create # 以下略
28. 基本構造 - links # 略 links: - description: Create a new user. href: "/api/users" method: POST rel: self schema: properties: # 属性の定義 type: - object title: Create # 以下略
29. 結合 $ bundle exec prmd combine \ --meta doc/meta.yml \ doc/schemata > doc/schemata/post.yml