开发实践:使用Swagger快速打造REST API文档

概要
随着Mobile程序和Single Page Application单页应用的愈发流行,编写REST API也正变得越来越常见和重要,但由于程序员们比较抵触麻烦的WSDL和WADL,因此实际上REST API一直缺少一个更合适的描述方法。 本演讲将主要介绍GitCafe开发符合Swagger规范的API描述的具体过程,以及GitCafe是如何减少代码和文档中的重复内容,并在一个月之内在基于Web 2.0网站的代码上完成了API,同时得到了一个可测试的文档的,分享GitCafe是怎样基于和Swagger同样的抽象概念,开发了操作Swagger API的Ruby client的,演讲最后还将回顾贯穿于整个过程的DRY原则。

个人简介

吴江,现为GitCafe技术负责人,致力于通过代码托管平台帮助每一个企业将敏捷注入到软件开发的各个环节。吴江作为资深Ruby程序员,拥有8年Rails经验,从2005年阅读Robert Martin的书后开始实践敏捷开发,曾在Inker、Factual、Ehoke等公司担任高级程序员,还曾在EMC参与了大规模跨国团队的敏捷开发工作。

QCon是由InfoQ主办的全球顶级技术盛会,每年在伦敦、北京、东京、纽约、圣保罗、杭州、旧金山召开。自2007年3月份首次举办以来,已经有包括传统制造、金融、电信、互联网、航空航天等领域的近万名架构师、项目经理、团队领导者和高级开发人员参加过QCon大会。

你可能感兴趣的:(开发实践:使用Swagger快速打造REST API文档)