swagger

原文于2018年12月份发表在Javacodegeeks。 如 果你看到这里，那只是意味着你面临/曾经面临了一个至关重要的决定： 你应该选择软件测试来支持甚至开始你的职业生涯吗？ 软件测试适合您吗？你应该从哪里开始？你该怎么办？你为什么要这么做？还有一千多个问题…… 有许多文章向你保证为什么或为什么没有，你肯定也必须经历过它们。但我们在这里提供帮助，编制了一份全面的清单，可以帮助您做出决定。那么，让我们开始吧。 为什么选择软件测试作为职业道路？ 软件测试人员专为具有挑战性的工作环境而设计，如果您是喜欢接受新挑战的人，那么软件测试就适合您。 我们不只是声称这一点。软件测试每天都会带来很多挑战。在某些日子里，挑战是长时间工作，而在其他方面，挑战是一遍又一遍地重复相同的过程而不会感到疲倦，以便找到一个正在震动整个系统的错误。 软件测试人员喜欢挑战，他们有能力在大多数其他人之前发现错误。 你可以享受每一天的工作 软件测试是一个完全动态的领域。它在不断变化。在软件开发领域，没有一种技术可以长期统治世界。 作为一名软件测试人员，您将了解到您所在行业每天都会遇到的令人惊叹的新技术，并且还有机会与他们合作。由于单调的工作惯例，没有机会感到无聊。 除此之外，那些无法编码的人成为测试人员的神话日渐衰退。例如，许多自动化测试人员编写代码片段来自动化测试脚本。因此

1. 关于Swagger Swagger 是一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的 Web 服务。 相信采用 Spring Boot 开发的小伙伴几乎是用来构建 RESTful API ，而文档自然是不可缺少的一部分，Swagger 的出现，既可以减少我们创建文档的工作量，同时说明内容又整合入实现代码中，让维护文档和修改代码整合为一体，可以让我们在修改代码逻辑的同时方便的修改文档说明。 另外Swagger2也提供了强大的页面测试功能来调试每个RESTful API。 作用总结： 接口文档在线生成 方便功能测试 集成后的效果图如下： 2. 开始集成 2.1 添加依赖 在 pom.xml 中添加 swagger 依赖 <!-- Swagger API文档 --> < dependency > < groupId > io.springfox </ groupId > < artifactId > springfox-swagger-ui </ artifactId > < version > 2.7.0 </ version > </ dependency > < dependency > < groupId > io.springfox </ groupId > < artifactId > springfox-swagger2 </

swagger2 1、引入依赖 <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.9.2</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.9.2</version> </dependency> 2、Swagger配置 package com.zb.myswagger2; import com.google.common.collect.Lists; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import springfox.documentation.builders.ApiInfoBuilder; import springfox.documentation.builders.PathSelectors; import springfox

重点是方便测试，当然也可以生成HTML和PDF版本的接口规范文档。 最稳定最方便的版本2.7.0（UI界面依据个人爱好，boot版本2.1.2） <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.7.0</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.7.0</version> </dependency> swagger配置类 @Configuration @EnableSwagger2 public class Swagger2 { @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2).globalOperationParameters(getParameters()).apiInfo(apiInfo()) .select().apis(RequestHandlerSelectors.any()) .paths

前言 前一章节介绍了 mybatisPlus 的集成和简单使用，本章节开始接着上一章节的用户表，进行 Swagger2 的集成。现在都奉行 前后端分离 开发和微服务大行其道，分微服务及前后端分离后，前后端开发的沟通成本就增加了。所以一款强大的 RESTful API 文档就至关重要了。而目前在后端领域，基本上是 Swagger 的天下了。 Swagger2介绍 Swagger 是一款 RESTful 接口的文档在线自动生成、功能测试功能框架。一个规范和完整的框架，用于生成、描述、调用和可视化 RESTful 风格的Web服务，加上 swagger-ui ，可以有很好的呈现。 SpringBoot集成 这里选用的swagger版本为：2.8.0 0.pom依赖 <!--swagger --> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger2</artifactId> <version>2.8.0</version> </dependency> <dependency> <groupId>io.springfox</groupId> <artifactId>springfox-swagger-ui</artifactId> <version>2.8.0</version> <