码迷,mamicode.com
首页 > 编程语言 > 详细

springmvc集成swagger2

时间:2019-01-11 10:14:30      阅读:217      评论:0      收藏:0      [点我收藏+]

标签:源地址   最新   注解   restapi   hub   info   conf   mvc   显示   

swagger2有一个web前端ui界面,可以清楚的看到所有被swagger2扫描到的接口列表,源码在github上:swagger-ui

这个版本不是最新版,但是带有搜索功能,这是在最新版里没有的。

项目×××之后,解压,把dist文件夹下的所有的东西放到项目中静态目录下,目录文件夹名称假设是swagger,修改index.html文件里的js代码,源码里的js访问doc路径修改成自己项目的访问路径:
url = "/xxx/v2/api-docs";
xxx的部分就是web项目名称,根据实际情况修改

这个v2/api-docs路径是swagger2接口文档的json数据访问地址,这个地址返回的项目中所有接口说明的json格式字符串,这个index.html中的js代码就解析这个json数据再渲染出来

项目需要依赖两个包:

 <dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger2</artifactId>
    <version>${swagger2.version}</version>
</dependency>
<dependency>
    <groupId>io.springfox</groupId>
    <artifactId>springfox-swagger-ui</artifactId>
    <version>${swagger-ui.version}</version>
</dependency>
<properties>
<swagger2.version>2.7.0</swagger2.version>
<swagger-ui.version>2.7.0</swagger-ui.version>
</properties>

创建swagger2配置类:

@Configuration // 让Spring来加载该类配置
@EnableSwagger2 // 启用Swagger2
@EnableWebMvc
public class Swagger2Config {

    static final Logger log = LoggerFactory.getLogger(Swagger2Config.class);

    @Bean
    public Docket createRestApi() {
        log.info("开始加载Swagger2...");
        return new Docket(DocumentationType.SWAGGER_2).apiInfo(apiInfo()).select()
                                                      // 扫描指定包中的swagger注解
                                                      .apis(RequestHandlerSelectors.basePackage("com.xxx.xxx.controller"))
                                                      // 扫描所有有注解的api,用这种方式更灵活
                                                      // .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                                                      .paths(PathSelectors.any()).build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder().title("Api Documentation").description("xxx系统API接口文档").version("1.0.0").build();
    }
}

到此配置文件,启动项目,访问地址:http://ip:port/项目名称/swagger/index.html进入swagger-ui界面,进入后可以看到正在获取数据,那是解析数据的过程,稍等一会就会显示出接口列表

这个接口的json数据来源地址中的域名(也就是ip:port)这个部分是swagger2获取的web项目启动的tomcat的域名,有的环境下是会被nginx代理,真正的web服务器域名是不能直接访问的,这个时候需要添加-Dspringfox.documentation.swagger.v2.host=xxx环境变量,配置nginx的域名,这样就能正常经过nginx走代理路径。

springmvc集成swagger2

标签:源地址   最新   注解   restapi   hub   info   conf   mvc   显示   

原文地址:http://blog.51cto.com/wangguangshuo/2341274

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!