Knife4jConfig.java 2.39 KB
package com.canrd.webmagic.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.ParameterBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.schema.ModelRef;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.service.Contact;
import springfox.documentation.service.Parameter;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2WebMvc;

import java.util.ArrayList;
import java.util.List;

/**
 * knife4j配置信息
 */
@Configuration
@EnableSwagger2WebMvc  // 启用swagger支持
public class Knife4jConfig {
    @Bean
    public Docket adminApiConfig(){
        List<Parameter> pars = new ArrayList<>();
        ParameterBuilder tokenPar = new ParameterBuilder();
        tokenPar.name("token")
                .description("用户token")
                .defaultValue("")
                .modelRef(new ModelRef("string"))
                .parameterType("header")
                .required(false)
                .build();
        pars.add(tokenPar.build());
        //添加head参数end

        Docket webMagicApi = new Docket(DocumentationType.SWAGGER_2)
                .groupName("adminApi")
                .apiInfo(adminApiInfo())
                .select()

                // 设置扫描的控制器包   第一层过滤
                .apis(RequestHandlerSelectors.any())
//                .apis(RequestHandlerSelectors.basePackage("org.canrd"))
                 //    //只显示admin路径下的页面   第二层过滤
                .paths(PathSelectors.any())
                .build()
                .globalOperationParameters(pars);
        return webMagicApi;
    }

    // 定义文档的说明   标题  联系人  版本号   联系邮箱
    private ApiInfo adminApiInfo(){

        return new ApiInfoBuilder()
                .title("爬虫-API文档")
                .description("本文档描述了爬虫系统微服务接口定义")
                .version("1.0")
                .contact(new Contact("凌世锦", "http://qq.com", "1187551704@qq.com"))
                .build();
    }
}