swagger应用php技巧_web项目每次都自己写controller测试用例理解一下swagger吧

引入pom

<dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.6.1</version></dependency><dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.6.1</version></dependency>

加配置类

@Configuration@EnableSwagger2public class Swagger2 { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .select() .apis(RequestHandlerSelectors.basePackage(\公众com.makenv.controller\公众)) .build(); }}

访问http://localhost:8080/swagger-ui.html即可测试controller

你所有写好的controller方法直接就能在这里测试了，有没有比自己布局url访问方便多了？

随着互联网技能的发展，现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，而且前端技能和后端技能在各自的道路上越走越远。

前端和后真个唯一联系，变成了API接口；API文档变成了前后端开拓职员联系的纽带，变得越来越主要，swagger便是一款让你更好的书写API文档的框架。

没有API文档工具之前，大家都是手写API文档的，在什么地方书写的都有，有在confluence上写的，有在对应的项目目录下readme.md上写的，每个公司都有每个公司的玩法，无所谓好坏。

书写API文档的工具有很多，但是能称之为“框架”的，估计也只有swagger了。

在此先先容一款其他的API文档工具，叫rap，这玩意儿用一句话就能概括：解放生产力，代替手写API的web工具。

RAP写起来确实比手写文档要快，看看图就知道：

可以选择某个项目，写针对某个项目的API

请看，可以填写要乞降相应的字段

还可以选择字段对应的类型

类似的API文档工具网上还有很多，但是能拿上台面的，不多。
RAP是由阿里开拓的，全体阿里都在用，还不错。
github地址为：https://github.com/thx/RAP

当然咯，rap不可能只有线上版本，肯定可以支配到私服上。

https://github.com/thx/RAP/wiki/deploy_manual_cn

rap挺好的，但是和swagger比起来有点轻量。

先看看swagger的生态利用图：

个中，红颜色的是swaggger官网方推举的。

下面再细看看swagger的生态的详细内容：

swagger-ui

这玩意儿从名字就能看出来，用来显示API文档的。
和rap不同的是，它不可以编辑。

点击某个详细API的可以试。

swagger-editor

便是一个在线编辑文档解释文件（swagger.json或swagger.yaml文件）的工具，以方便生态中的其他小工具（swagger-ui）等利用。

左边编辑，右边立马就显示出编辑内容来。

编辑swagger解释文件利用的是yaml语法详细的内容可以辞官网查看。

各种措辞版本的根据annotation或者注释天生swagger解释文档的工具

目前最盛行的做法，便是在代码注释中写上swagger干系的注释，然后，利用小工具天生swagger.json或者swagger.yaml文件。

目前官方没有推出。
github上各种措辞各种框架各种有，可以自己搜吧搜吧，这里只说一个php干系的。

swagger-php :https://github.com/zircote/swagger-php

swagger-validator

这个小工具是用来校验天生的文档解释文件是否符合语法规定的。
用法非常大略，只需url地址栏，根路径下加上一个参数url，参数内容是放swagger解释文件的地址。
即可校验。

例如：

docker hub地址为：https://hub.docker.com/r/swaggerapi/swagger-validator/

可以pull下镜像来自己玩玩。

swagger-codegen

代码天生器，脚手架。
可以根据swagger.json或者swagger.yml文件天生指定的打算机措辞指定框架的代码。

有一定用途，Java系用的挺多。
工业上该当不咋用。

mock server

这个目前还没有找到很得当的mock工具，包括rap也好，其他API文档工具也好，都做的不足完善，大多便是根据解释文件，例如swagger.json等天生一些去世的静态的mock数据，不能够根据限定条件：例如“只能是数字，必传”等做出合理的回应。

原文地址：https://blog.csdn.net/i6448038/article/details/77622977