特别好用的 swagger-ui-layer(简单配置，即插即用)

看过其他小伙伴 封装的swagger-ui-layer,非常好用，但是使用下来也不是很方便，

小伙伴地址：https://blog.csdn.net/tuposky/article/details/77965139

所以准备自己封装一套，修改相应的UI，并制定了两套使用规则

1）微服务版本：微服务与 layui 分离，layui 部署到新服务器上，供各个服务使用

    demo例子：http://106.12.9.238:8080/webjars/swagger-ui/index.html#106.12.9.238:8081

2）单服务版本：layui 部署在服务上，即插即用，非常方便

源码地址：https://github.com/huanshare/huan-swagger#huan-swagger

使用说明

一、微服务版本：

1、部署到服务器上：huan-swagger-ui项目

2、微服务项目修改

1） pom依赖

<dependency>
       <groupId>com.github.huanshare</groupId>
       <artifactId>huan-swagger-core</artifactId>
       <version>1.0.1</version>
   </dependency>

2） spring boot项目启动项添加：

@EnableHuanSwagger

3） application.yml配置 (可选项配置)

 # Swagger设置  enable 默认为true,为false时，关闭接口展示
 swagger:
   enable: true,
   version: 版本号
   title: 项目标题
   description: 项目描述
   contact:
     name: 用户名
     url: url地址
     mail: 邮箱

3、页面访问：UI服务器地址/webjars/swagger-ui/index.html#API-服务器地址

4、具体使用方式，请参考 huan-swagger-test

二、单服务版本：

1、服务项目修改

1） pom依赖

 <dependency>
   <groupId>com.github.huanshare</groupId>
   <artifactId>swagger-ui-layer</artifactId>
   <version>1.0.0</version>
 </dependency>

2） spring boot项目启动项添加：

@EnableHuanSwagger

3） application.yml配置 (可选项配置)

 # Swagger设置  enable 默认为true,为false时，关闭接口展示
  swagger:
    enable: true,
    version: 版本号
    title: 项目标题
    description: 项目描述
    contact:
      name: 用户名
      url: url地址
      mail: 邮箱

3、页面访问：UI服务器地址/api-doc.html

最新版jar包地址：https://oss.sonatype.org/#nexus-search;quick~com.github.huanshare 

特点

原来看过其他小伙伴的源码，页面交互不算太理想

无论单机版还是微服务版，整体UI在小伙伴基础上做了一些修改，整体内容进行了封装，不需要配置一些额外的选项，即插即用，非常方便

微服务版：实现了API与UI的分离，但是需要为UI单独部署一套服务器，增加了其他成本；如果微服务多的话，这也算是个不错的方案

单服务版：简单配置，即插即用，非常方便