1、pom依賴：

<dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-web</artifactId>
    </dependency>

    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter</artifactId>
    </dependency>

    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger2</artifactId>
        <version>${springfox-swagger2.version}</version>
    </dependency>

    <!--這個很坑我 忘了引依賴-->
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>${springfox-swagger-ui.version}</version>
    </dependency>

    <dependency>
        <groupId>com.github.xiaoymin</groupId>
        <artifactId>swagger-bootstrap-ui</artifactId>
        <version>${swagger-bootstrap-ui.version}</version>
    </dependency>
 

2、配置檔案 ，一般新建模組後，直接new—》page包config ，將這個類放入，改改包名，其他的隨自己，不會影響。

package com.citic.swagger.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.
 
springframework.web.servlet.config.annotation.WebMvcConfigurer;
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.EnableSwagger2;

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

/**
 * @program: Jointtest
 * @description: 注入swagger資原始檔
 * @author: Wang XinWen
 * @create: 2018-10-30 19:54
 **/


@Configuration
@EnableSwagger2
public class JointtestSwaggerConfig implements WebMvcConfigurer {
    /**
     *
     * 顯示swagger-ui.html文件展示頁，還必須注入swagger資源：
     * @param registry
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        registry.addResourceHandler("swagger-ui.html")
                .addResourceLocations("classpath:/META-INF/resources/");
        registry.addResourceHandler("/webjars/**")
                .addResourceLocations("classpath:/META-INF/resources/webjars/");
    }
    //可以注入多個doket，也就是多個版本的api，可以在看到有三個版本groupName不能是重複的，v1和v2是ant風格匹配，配置檔案
    @Bean
    public Docket api() {
        //可以新增多個header或引數
        ParameterBuilder aParameterBuilder = new ParameterBuilder();
        aParameterBuilder
                .parameterType("header") //引數型別支援header, cookie, body, query etc
                .name("token") //引數名
                .defaultValue("token") //預設值
                .description("header中token欄位測試")
                .modelRef(new ModelRef("string"))//指定引數值的型別
                .required(false).build(); //非必需，這裡是全域性配置，然而在登陸的時候是不用驗證的
        List<Parameter> aParameters = new ArrayList<Parameter>();
        aParameters.add(aParameterBuilder.build());
        return new Docket(DocumentationType.SWAGGER_2).groupName("v1").select().apis(RequestHandlerSelectors.any())
                .paths(PathSelectors.ant("/api/v1/**")).build().apiInfo(apiInfo1()).globalOperationParameters(aParameters);
    }


    private ApiInfo apiInfo1() {
        return new ApiInfoBuilder()
                .title("exampleApi 0.01")
                .termsOfServiceUrl("www.example.com")
                .contact(new Contact("liumei","http://blog.csdn.net/pc_gad","[email protected]"))
                .version("v0.01")
                .build();
    }
}

3、測試

package com.citic.swagger.controller;

import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.web.bind.annotation.*;

/**
 * @program: Jointtest
 * @description:
 * @author: Wang XinWen
 * @create: 2018-11-02 15:36
 **/
@RequestMapping
@RestController
public class Controller {

    @ApiOperation(value = "獲取新的訂單資訊")
//    @RequestMapping(value = "/getOrder",method = RequestMethod.GET)
    @GetMapping(value = "order")
    public String getOrder(@ApiParam(value = "訂單編號",required = true) @RequestParam(value = "orderNo", required=false) String orderNo,
                           @ApiParam(value = "當前頁") @RequestParam(value = "pageNum",required = false) Integer pageNum,
                           @ApiParam(value = "每頁顯示數量") @RequestParam(value = "pageSize",required = false) Integer pageSize){
        return "請求測試成功";
    }

//    @GetMapping(value = "/order")
//    public String sayHello(){
//        return "Hello ";
//    }

}

注意!!!注意！！！！！！

– 有什麼問題可以聯絡本人