配置 Swagger API 基础信息

我们先看看效果图：

上面效果图中，配置了项目名称、版本信息、项目描述信息、联系人等基础信息。

springboot广告位

在 Spring Boot 项目中，可以通过在 @Configuration 配置类中配置 Docket Bean。配置如下：

@Bean
public Docket buildDocket(){
    return new Docket(DocumentationType.SWAGGER_2)
            .apiInfo(buildApiInfo())
            .select()
            .apis(RequestHandlerSelectors.basePackage("指定Controller的包名称"))
            .paths(PathSelectors.any())
            .build();
}

private ApiInfo buildApiInfo(){
    return new ApiInfoBuilder()
            .title("项目名称")
            .description("项目详细描述信息")
            .termsOfServiceUrl("(网址链接) https://www.hxstrive.com")
            .contact(new Contact("联系人",
                    "联系人个人网址",
                    "联系人邮箱"))
            .version("版本信息")
            .build();
}

后续文章将介绍 Swagger 的常用注解。