<!-- swagger2 -->
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.9.2</version>
</dependency>
<!--         swagger 原生ui -->
<!--         <dependency> -->
<!--             <groupId>io.springfox</groupId> -->
<!--             <artifactId>springfox-swagger-ui</artifactId> -->
<!--             <version>2.9.2</version> -->
<!--         </dependency> -->

<!-- bootstrap 写的ui-->
<dependency>
    <groupId>com.github.xiaoymin</groupId>
    <artifactId>swagger-bootstrap-ui</artifactId>
    <version>1.9.3</version>
</dependency>

<!-- spring4All自己封装的,用的swagger自带的ui,这个一个包就足够了, 1.7版本用的是swagger2.9.0,但很多库没有这个包...所以跨过这个版本 -->
<!--         <dependency> -->
<!--             <groupId>com.spring4all</groupId> -->
<!--             <artifactId>swagger-spring-boot-starter</artifactId> -->
<!--             <version>1.9.0.RELEASE</version> -->
<!--         </dependency> -->

<!--高本版好像没有guava包,报错就加上-->
<dependency>
    <groupId>com.google.guava</groupId>
    <artifactId>guava</artifactId>
    <version>27.0.1-jre</version>
</dependency>

@Configuration // 表明这个类是个配置类
@EnableSwagger2 // 启用swagger
public class Swagger2   {
    @Value("${sop.swagger.enable:false}") //默认值为false
    public boolean isEnable;
    @Bean
    public Docket createRestApi() {
        System.out.println("环境取值:  isEnable:"+isEnable);
        return new Docket(DocumentationType.SWAGGER_2)
        .enable(isEnable)
                .apiInfo(apiInfo())
                .select()
                // 扫描的包路径
                .apis(RequestHandlerSelectors.basePackage("com.example.demo"))
                // 监听所有方法
                .paths(PathSelectors.any())
                .build();
    }
    // 构建 api文档的详细信息函数,注意这里的注解引用的是哪个
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                // 页面标题
                .title("swagger的界面")
                // 创建人
                .contact(new Contact("xkj", "", ""))
                // 版本号
                .version("1.0")
                // 描述
                .description("这是我的swagger").build();
    }

@Api(value="测试控制类-val")
@RestController
@RequestMapping("/test")
@Slf4j
public class TestControll{

    @GetMapping("hello")
    @ApiOperation(value="嗨",notes="简单接口" )
    public BaseResponse hello() {
        BaseResponse response = new BaseResponse();
        setResponse(response, ResponseEnum.JS002) ;
        return response;
    }

    @PutMapping("addHelp")
    @ApiParam(required=true,name="help",value="帮助类2")
    public BaseResponse addHelp(@RequestBody HelpInfo help) {
        log.info("入参:{}",help);
        BaseResponse response= new BaseResponse();
        setSuccessResponse(response);
        log.info("返参:{}",LocalDateTime.now());
        return response;
    }

}