先决条件
已在开发计算机上安装 Maven
已在开发计算机上安装 Git
Azure 订阅付费版或试用版
HTTP 测试应用程序,如 Postman
使用 Swagger.IO 创建 API 基架
使用 swagger.io 在线编辑器可以输入表示 API 结构的 Swagger JSON 或 YAML 代码。设计 API 外围应用后,可以针对各种不同的平台和框架导出代码。在下一部分,我们将修改基架代码,包含模拟功能。
本演示从粘贴到 swagger.io 编辑器中的 Swagger JSON 正文开始,接着使用该正文来生成利用 JAX-RS 访问 REST API 终结点的代码。然后,将编辑基架代码来返回模拟数据,以便模拟一个构建在数据持久性机制基础上的 REST API。
将以下 Swagger JSON 代码复制到剪贴板:
{"swagger": "2.0","info": {"version": "v1","title": "Contact List","description": "A Contact list API based on Swagger and built using Java"},"host": "localhost","schemes": ["http","https"],"basePath": "/api","paths": {"/contacts": {"get": {"tags": ["Contact"],"operationId": "c