1- mvn 配置

        <!-- 接口文檔 -->
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger2</artifactId>
            <version>2.4.0</version>
        </dependency>
        <dependency>
            <groupId>io.springfox</groupId>
            <artifactId>springfox-swagger-ui</artifactId>
            <version>2.4.0</version>
        </dependency>

2- javaConfig

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 Swagger2Config {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.gm.ds.api"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("Simple APIs")
                .description("simple apis")
                .termsOfServiceUrl("http://www.gm.com")
                .contact(new Contact("suliyea", "http://xxx", "suliyea@qq.com"))
                .version("1.0")
                .build();
    }

}

3- 編寫(xiě)測(cè)試 Controller

@RequestMapping("/api/user")
@Api(value = "用戶接口", description = "")
public class UserController {
    private static final Logger logger = LoggerFactory.getLogger(UserController.class);

    @RequestMapping(value = "login", method = RequestMethod.GET)
    @ResponseBody
    public ApiData login(@RequestParam(value = "username", defaultValue = "") String username,
                         @RequestParam(value = "password", defaultValue = "") String password) {
        //TODO....
        return new ApiData().setMessage("用戶帳號(hào)不存在!").setStatus(ApiData.ERROR);
    }
}

4- 按常規(guī), 現(xiàn)在訪問(wèn)http://localhost:8090/swagger-ui.html 應(yīng)該能看到效果了, 可是訪問(wèn)頁(yè)面出現(xiàn)這樣提示

Paste_Image.png

5- 處理方法

在 GitHub 上下載 SwaggerUI 項(xiàng)目（https://github.com/swagger-api/swagger-ui
），將dist下所有內(nèi)容拷貝到本地項(xiàng)目resource/static/swagger下面, 并修改 index.html

//url = "http://petstore.swagger.io/v2/swagger.json";        
url = "http://localhost:8090/v2/api-docs";

然后訪問(wèn)http://localhost:8090/swagger/index.html

Paste_Image.png