最新版Knife4j在SpringBoot中的使用，比Swagger更好看强大

1、SpringBoot中引入依赖。

        
            com.github.xiaoymin
            knife4j-spring-boot-starter
            3.0.2
        

2、增加Swagger配置类。

@Configuration
@EnableSwagger2
public class SwaggerConfig {

    @Bean(value = "1.web")
    public Docket webAPI(){
        return createDocket("1.web", "com.hello.controller");
    };

    public Docket createDocket(String groupName, String basePackage) {
        Docket docket=new Docket(documentationType.SWAGGER_2)
                .enable(true)
                .apiInfo(apiInfo())
                //将日期时间类型全部转为String类型
                .directModelSubstitute(LocalDateTime.class, String.class)
                //将日期类型全部转为String类型
                .directModelSubstitute(LocalDate.class, String.class)
                //将时间类型全部转为String类型
                .directModelSubstitute(LocalTime.class, String.class)
                //分组名称
                .groupName(groupName)
                .select()
                //这里指定Controller扫描包路径
                .apis(RequestHandlerSelectors.basePackage(basePackage))
                .paths(PathSelectors.any())
                .build()
                .globalRequestParameters(generateRequestParameters());
        return docket;
    }

    private List generateRequestParameters(){
        RequestParameterBuilder token = new RequestParameterBuilder();
        RequestParameterBuilder language = new RequestParameterBuilder();
        List parameters = Lists.newArrayList();
        token.name("Authorization").description("token令牌").in(In.HEADER.toValue()).required(true).build();
        language.name("language").description("语言").in(In.HEADER.toValue()).required(false).build();
        parameters.add(token.build());
        parameters.add(language.build());
        return parameters;
    }


    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("Hello World API")
                .description("Hello World API文档")
                .version("1.0")
                .build();
    }
}

3、在Controller中增加注解。

@RestController
@Slf4j
@RequestMapping("/love")
@Api(value = "love", tags = {"爱你一万年接口"})
public class LoveController {

	@GetMapping("/me")
    @ApiOperation(value = "爱我")
    public Result me() {
        
        return Result.ok();
    }

}