Swagger

package com.example.fmmall.config;

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

@Configuration
@EnableSwagger2
public class SwaggerConfig {
    /**swagger会帮助我们生成接口文档
     * 1.配置生成的文档信息
     * 2.配置生成规则*/

    /**
     * Docket封装接口文档信息
     */
    //指定封面信息
    //创建封面信息对象
    @Bean
    public Docket getDocket() {
        ApiInfoBuilder apiInfoBuilder = new ApiInfoBuilder();
        apiInfoBuilder.title("《蜂蜜商城》后端接口文档说明")
                .description("此文档详细说明了项目后端接口规范")
                .version("v 2.0.1")
                .contact(new Contact("曹植", "blog.caotongx.cloud", "caotongx@gmail.com"));
        ApiInfo apiInfo = apiInfoBuilder.build();

        Docket docket=new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo)
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.example.fmmall.controller"))
                .paths(PathSelectors.any())
                .build();
        return docket;
    }


    //指定生成策略
}

访问路径http://localhost:8080/swagger-ui.html

和configuration平级

 

 ApiOperation用于说明接口作用

@ApiImplicitParams()j接口参数

swagger-ui插件

 使用插件之后的地址http://localhost:8080/doc.html