【Spring Cloud】spring boot搭建+swagger-ui

spring boot 搭建restful接口项目
spring cloud 系列
环境：
jdk1.8、maven3.x 、IDEA

简介

搭建项目

1、新建项目

新建完成项目

新建类

新建一个包名为controller的包，在其下面新建HiController类

2、启动

启动Demo1Application的main方法

3、访问

查看默认启动端口是8080

访问: http://localhost:8080

引入swagger-ui

在pom.xml文件中引入swagger-ui修改的jar包

<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>2.6.1</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>2.6.1</version>
</dependency>

重新导入pom，更新jar包

新增Swagger2Config类

解决swagger报swagger-resources/configuration/ui 404找不到异常：

package com.example.demo.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.WebMvcConfigurerAdapter;
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 extends WebMvcConfigurerAdapter {
    private String basePackage = "com.example.demo.controller";

    @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/");
    }
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo())
                .select()
                .apis(RequestHandlerSelectors.basePackage(this.basePackage))
                .paths(PathSelectors.any()).build();
    }
    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("FCat项目 APIs")
                .description("angular、spring cloud实战项目：https://gitee.com/xfdm/FCat")
                .termsOfServiceUrl("http://fcat.xfdmao.com/")
                .contact(new Contact("fier", "http://blog.xfdmao.com", "angularliu@qq.com"))
                .version("1.0")
                .build();
    }
}

重新启动main方法

访问swagger-ui

访问swagger-ui界面：http://localhost:8080/swagger-ui.html

本章节源码地址：https://gitee.com/xfdm_admin/spring-cloud/tree/master
更多相关内容请查看：
angular、spring cloud 开源实战项目源码：https://gitee.com/xfdm/FCat
QQ群：549141844

代码持续更新…