Swagger规范与框架概述,优化Web服务开发流程
一.介绍Swagger,一个规范和完整的框架,用于生成、描述、调用和可视化RESTful风格的Web服务。其总体目标在于实现客户端和文件系统与服务器同步更新。文件的方法、参数和模型与服务器端代码紧密集成,使得API能够始终保持同步。Swagger极大简化了部署、管理和使用功能强大的API。二.基于Spring框架的Swagger流程应用,本文不涉及具体工具使用方法、yml或json文件语法规范,以及在SpringMVC或Spring Boot中配置Springfox-swagger的步骤,这些可在网络上轻松找到。文章着重介绍如何结合现有工具和功能设计一个流程,以最小代价维护代码、接口文档和Swagger描述文件。2.1项目开始阶段,一般由服务端编写接口文档。在项目开发中,服务端可选择直接编写服务端调用层代码或编写Swagger描述文件。建议在项目启动阶段即搭建好后台框架,...
下载地址
用户评论