2021.9.30-10.2学习日志-swagger-Pause

swagger-更好的书写API文档

现在变成了前段渲染，前后端分离，前后端唯一的联系变成了API接口；API文档变成了前后端开发人员联系的纽带，

swagger
	1、是一款让你更好的书写API文档规范且完整的框架。

	2、提供描述、生产、消费和可视化RESTful Web Service。

	3、是由庞大工具集合支撑的形式化规范。这个集合涵盖了从终端用户接口、底层代码库到商业API管理的方方面面。
作用：
    1. 接口的文档在线自动生成。

    2. 功能测试。
 Swagger是一组开源项目，其中主要要项目如下：

	1.   Swagger-tools:提供各种与Swagger进行集成和交互的工具。例如模式检验、Swagger 1.2文档转换成Swagger 2.0文档等功能。
	
	2.   Swagger-core: 用于Java/Scala的的Swagger实现。与JAX-RS(Jersey、Resteasy、CXF...)、Servlets和Play框架进行集成。
	
	3.   Swagger-js: 用于JavaScript的Swagger实现。
	
	4.   Swagger-node-express: Swagger模块，用于node.js的Express web应用框架。
	
	5.   Swagger-ui：一个无依赖的HTML、JS和CSS集合，可以为Swagger兼容API动态生成优雅文档。
	
	6.   Swagger-codegen：一个模板驱动引擎，通过分析用户Swagger资源声明以各种语言生成客户端代码。
	
	7.   swagger-editor:就是一个在线编辑文档说明文件（swagger.json或swagger.yaml文件）的工具，
		以方便生态中的其他小工具（swagger-ui）等使用。