SpringBoot基于Starter快速整合Swagger|dependency|return|starter|swagger|version

我们在开发WebAPI的时候，接口文档肯定是少不了的，所以Swagger这类在线接口文档生成工具就显得格外的实用，那么在以前，我们是怎么整合Swagger呢？我们需要先引入依赖包

io.springfoxgroupId>

springfox-swagger2artifactId>

2.9.2version>

dependency>

io.springfoxgroupId>

springfox-swagger-uiartifactId> 2.9.2version>

dependency>

然后新建配置类Swagger2Config并添加@EnableSwagger2的注解:

@Configuration@EnableSwagger2public class Swagger2Config { /** * swagger2的配置文件，这里可以配置swagger2的一些基本的内容，比如扫描的包等等 * @return */ @Bean public Docket createRestApi() { return new Docket(DocumentationType.SWAGGER_2) .apiInfo(apiInfo()) .select() .apis(RequestHandlerSelectors.withClassAnnotation(RestController.class)) .paths(PathSelectors.any()) .build(); } /** * 构建 api文档的详细信息函数,注意这里的注解引用的是哪个 * @return */ private ApiInfo apiInfo() { Contact contact = new Contact("Demo", "http://www.baidu.com", ""); return new ApiInfoBuilder() //页面标题 .title("Demo") //创建人 .contact(contact) //版本号 .version("1.0") //描述 .description("Demo API描述") .build(); }}

然后新建一个DemoController:

@Api(value = "Demo", tags = {"Demo"})@RestController@RequestMapping("query")public class DemoController { @ApiOperation(value = "查询信息", notes = "查询信息") @PostMapping("info") public ResponseEntity queryInfo() { return ResponseEntity.ok("ok!"); }}

好了，一个简单的Swagger文档就配置好了，我们来看看效果