python-tornado的接口用swagger进行包装的实例

写这个文章的主要原因，就是因为没有相关的东西，导致我完全不知道应该怎么做，经过了两个晚上的摸索，终于搞清楚了，如果有谁需要tornado+swagger的输出模式，可以照这个套；

主要是static文件的生成

我们用swagger就是为了做一个静态页面，也就是生成一个static文件：

几个必备的工具：swagger-py-codegen我们不用他们的文件框架只需要其生成的static文件，拷贝到自己文件夹下即可；

1）需要注意的是生成文件需要用yaml文件，当编辑好文件后，最主要的是要注意base_path文件的改动，你生成的文件的请求会加上你basepath的内容，会造成请求出错， 比如 你的url:port/GET?testparas=test,那么如果说你的static文件生成的过程中,如下图所示

2）生成的文件，swagger-ui中的swagger.json文件是按照你的yaml文件生成的，index.html文件中是有地方设置swagger.json的地址的，如下图所示

3）这个时候我们可以启动我们的swagger程序，

接下来接受一下tornado中的一些设置，主要为application的设置：

在这里其实没用到tornado的高级方法，只是随意设置了一个参数进行测试：

`import tornado.web
import tornado.ioloop
import os


abs_path = os.path.dirname(os.path.abspath("__file__"))
print(abs_path)

class IndexHandler(tornado.web.RequestHandler):
 def get(self, *args, **kwargs):
  para = self.get_argument('test', None)
  self.write("test tornado {}".format(para))


if __name__ == '__main__':
 app = tornado.web.Application([
  (r'/GET', IndexHandler)
 ],
  static_path=os.path.join(abs_path, 'static')
 )
 # 监听端口
 app.listen(8000)
 tornado.ioloop.IOLoop.current().start()`

目录结构如下

生成swagger-ui的代码如下：

swagger_py_codegen -s api.yaml project-one -p demo -tlp=tornado --ui --spec

其中 ?Cui ?Cspec是生成swagger-ui的关键代码