背景
前两天提到项目组打算用 swagger 来做为 RESTful API 的解决方案,现在已经确定下来了。
之前看到有文章介绍 SpringBoot 中结合 Swagger 直接生成文档的方法,今天尝试了一下,入门还是比较简单的。
前两天提到项目组打算用 swagger 来做为 RESTful API 的解决方案,现在已经确定下来了。
之前看到有文章介绍 SpringBoot 中结合 Swagger 直接生成文档的方法,今天尝试了一下,入门还是比较简单的。
项目组最近新开发一套 RESTful API,需要对应的 API 文档,其实之前我有用 apidoc 作为方案给大家看过。
感觉还好,也是可以直接写成注释放在代码里最后生成。但能感受到它属于轻量级的,内容相对自由,灵活度很大,但也意味着更容易犯错。
不过最后上面还是决定使用 swagger 这一套东西,所以简单的看了下,功能果然成强大,显得更 professionnal 一些。
下面就罗列下我目前掌握的一些信息,其实学习 swagger 的过程就是学习 RESTful API 的过程。
早些年看《大话设计模式》的时候,用Java
实现了书中的例子,可惜当年没有保存好,好多东西都丢了。
现在想着用python
重新实现一下 ,重新学习。
虽然 python 没有接口的概念,但是可以用抽象类代替。