SpringBoot中怎么整合Swagger2

這期內(nèi)容當中小編將會給大家?guī)碛嘘P(guān)SpringBoot中怎么整合Swagger2，文章內(nèi)容豐富且以專業(yè)的角度為大家分析和敘述，閱讀完這篇文章希望大家可以有所收獲。

第一步添加依賴

<!-- SwaggerUI 接口文檔 http://{ip}:{prot}/swagger-ui.html -->
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger2</artifactId>
<version>{version}</version>
</dependency>
<dependency>
<groupId>io.springfox</groupId>
<artifactId>springfox-swagger-ui</artifactId>
<version>{version}</version>
</dependency>

第二步添加注解

@EnableSwagger2 //啟動SwaggerUI，在啟動類或Swagger配置類上添加該注解

第三步寫配置

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean
    public Docket api() {

/*
        //可以添加多個header或參數(shù)
        ParameterBuilder aParameterBuilder = new ParameterBuilder();
        aParameterBuilder
                //參數(shù)類型支持header, cookie, body, query etc
                .parameterType("header")
                //參數(shù)名
                .name("user-token")
                //默認值
                .defaultValue("t122222")
                .description("用戶登錄憑證")
                //指定參數(shù)值的類型
                .modelRef(new ModelRef("string"))
                //非必需，這里是全局配置
                .required(false).build();
        List<Parameter> aParameters = new ArrayList<>();
        aParameters.add(aParameterBuilder.build());
*/

        return new Docket(DocumentationType.SWAGGER_2)
//        return new Docket(DocumentationType.SPRING_WEB)
                .apiInfo(apiInfo())
                .pathMapping("/")
                .select()// 選擇那些路徑和api會生成document
                .apis(RequestHandlerSelectors.any())// 對所有api進行監(jiān)控
                // 不顯示錯誤的接口地址
                .paths(Predicates.not(PathSelectors.regex("/error.*")))// 錯誤error路徑不監(jiān)控
                .paths(Predicates.not(PathSelectors.regex("/actuator.*")))// 錯誤error路徑不監(jiān)控
                .paths(PathSelectors.regex("/.*"))// 對根下所有路徑進行監(jiān)控
                .paths(PathSelectors.any())   // 對所有路徑進行監(jiān)控
                // 自行修改為自己的包路徑
//                .apis(RequestHandlerSelectors.basePackage("com.happyloves.zc.service.account.api"))
                .build()
//                .globalOperationParameters(aParameters)
                .enable(true);
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("API接口")
                .description("API接口文檔")
                //服務條款網(wǎng)址
//                .termsOfServiceUrl("https://www.google.com")
                .version("1.0")
//                .contact(new Contact("啦啦啦", "url", "email"))
                .build();
    }
}

添加依賴

<!-- swagger-bootstrap-ui是 Swagger 的增強UI 實現(xiàn)，使文檔更友好一點兒 http://{ip}:{prot}/doc.html -->
<dependency>
<groupId>com.github.xiaoymin</groupId>
<artifactId>swagger-bootstrap-ui</artifactId>
<version>1.9.6</version>
</dependency>

上述就是小編為大家分享的SpringBoot中怎么整合Swagger2了，如果剛好有類似的疑惑，不妨參照上述分析進行理解。如果想知道更多相關(guān)知識，歡迎關(guān)注億速云行業(yè)資訊頻道。