はじめに Web サービスの運用を続けていくと,依存関係が徐々に複雑になっていきます.そしてメンテナンスするものが増えた結果,それらが相互に乖離していく,といったことが起こりがちです. そこで今回は,JSON Schema のみをメンテナンスしていくことで,動的チェック (バリデーション),静的チェック (FlowType),API ドキュメント生成,スタブ作成といった様々な恩恵を享受し,品質と保守性を同時に向上させるアプローチについて書いていきます.この JSON Schema を中心に据えたエコシステムを,JSON Schema 中心設計と呼ぶことにします. JSON Schema の仕様については割愛しますので,必要な方は こちら をご覧下さい.また,本記事では JavaScript での事例を紹介しますが,他の言語でも同様の適用ができるかと思います. アプローチ 本記事では,以下の
![JSON Schema 中心設計 - FlowType から RAML まで - - Qiita](https://cdn-ak-scissors.b.st-hatena.com/image/square/f6b48feb3e25c64679c41fa92417accd09bda8fc/height=288;version=1;width=512/https%3A%2F%2Fqiita-user-contents.imgix.net%2Fhttps%253A%252F%252Fcdn.qiita.com%252Fassets%252Fpublic%252Farticle-ogp-background-412672c5f0600ab9a64263b751f1bc81.png%3Fixlib%3Drb-4.0.0%26w%3D1200%26mark64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZ3PTk3MiZoPTM3OCZ0eHQ9SlNPTiUyMFNjaGVtYSUyMCVFNCVCOCVBRCVFNSVCRiU4MyVFOCVBOCVBRCVFOCVBOCU4OCUyMC0lMjBGbG93VHlwZSUyMCVFMyU4MSU4QiVFMyU4MiU4OSUyMFJBTUwlMjAlRTMlODElQkUlRTMlODElQTclMjAtJnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnR4dC1jb2xvcj0lMjMyMTIxMjEmdHh0LWZvbnQ9SGlyYWdpbm8lMjBTYW5zJTIwVzYmdHh0LXNpemU9NTYmcz05Njg3ODY5MTBkNzIxOTU1ODFiNzA2Y2U2ZTIyNTY0Ng%26mark-x%3D142%26mark-y%3D57%26blend64%3DaHR0cHM6Ly9xaWl0YS11c2VyLWNvbnRlbnRzLmltZ2l4Lm5ldC9-dGV4dD9peGxpYj1yYi00LjAuMCZoPTc2Jnc9NzcwJnR4dD0lNDBwaWthX3NoaSZ0eHQtY29sb3I9JTIzMjEyMTIxJnR4dC1mb250PUhpcmFnaW5vJTIwU2FucyUyMFc2JnR4dC1zaXplPTM2JnR4dC1hbGlnbj1sZWZ0JTJDdG9wJnM9MDQwNWY2NjNiYWZjZGE2NGQ5M2M4NzY0MmEzNDU0Mzg%26blend-x%3D142%26blend-y%3D486%26blend-mode%3Dnormal%26s%3D622e16dd23069775a8e7e8454aae7adb)