如何使用swagger导出java项目api？

Question

我创建了一个springboot + mybatis + swagger项目，我想使用swagger导出项目api，我在代码中写了swagger注释。

如何将api导出为html或doc或chm？

Answer 1

要使Swagger进入，我们需要在Maven POM中使用以下依赖项声明

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.6.1</version>
    <scope>compile</scope>
</dependency>

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

在应用程序中配置Swagger 2

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    @Bean
    public Docket productApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .select()                 .apis(RequestHandlerSelectors.basePackage("com.springframework.example"))
                .paths("/")
                .build();

    }
}

此时，您应该可以通过启动应用并将浏览器指向http://localhost:8080/v2/api-docs

来测试配置

将浏览器指向http://localhost:8080/swagger-ui.html，您将看到由Swagger UI呈现的生成文档。

Reference Document