SwaggerLUI 是一款开源的接口调试、文档管理工具，基于swagger扩展，使用spring boot+layui技术；仅支持swagger注解的接口项目。
前言
- swagger本身的ui界面用起来不习惯；
- 有些接口调试支持的不是很好，如上传、下载；
- 有些开发文档管理起来太麻烦，比较零散，希望跟接口一期维护；
- 接口调试功能和文档维护在一起，前后端分离模式下体验好些；
- 基于以上原因忍不住造了一个轮子，共享出来，有需要的可以试试；
特点
- 自定义接口访问地址，可以不依赖到项目中；
- 也可以方便依赖到项目中，打包为一个jar；
- 方便的接口调试功能，支持多种复杂参数；
- 良好的接口文档界面，可以查看复杂入参、出参，使前后端分离模式更友好；
- 支持post上传、下载调试，更多模式持续更新；
- 可以维护自定义的md文档到这个接口调试工具中；
目的
- 接口方便调试；
- 前后端分离下，有统一的文档管理和查看；
- 希望开发过程中更规范化；
项目演示地址
- http://49.233.23.145:7777/swagger_lui_index.html
- 演示地址是给大家看的，不要使劲搞，没做什么安全防范，也别加入乱七八糟的文件，加了马上删掉，谢谢。
软件架构
spring boot+layui
安装教程
- 下载 swaggerLUI，打包为jar
- 在需要的项目中依赖打包好的jar
<dependency> <groupId>com.swagger.lui</groupId> <artifactId>swaggerLUI</artifactId> <version>0.0.1-SNAPSHOT</version> </dependency>
- 在你自己的项目中配置数据源信息，一般是application.properties文件
使用h2数据库 swlui.driver=org.h2.Driver h2数据库地址：d:/h2/swluidbtest 地址和数据库名称设置为自己的 swlui.url=jdbc:h2:d:/h2/swluidbtest h2数据库的用户名随便设置的 swlui.username=root h2数据库的密码随便设置的 swlui.password=123456
- 在启动类中需如下配置 添加扫描包：com.swagger.lui
@ComponentScan(basePackages = { "com.swagger.lui" })
- 在WebMvcConfig中添加如下代码
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("swagger_lui_index.html").addResourceLocations("classpath:/swagger/doc/");
registry.addResourceHandler("/**").addResourceLocations("classpath:/swagger/lui/");
super.addResourceHandlers(registry);
}
-运行 http://ip+端口+/swagger_lui_index.html 如：http://localhost:8088/swagger_lui_index.html使用说明
- 系统参数设置 首次使用需要运行【系统初始化】，删除表和数据库,并重新创建,注意，此操作会删掉自定义文档信息，无法还原
- 全局参数设置 调试过程中可以设置一些经常用到的参数，方便调试
- MD文档管理 管理自定义MD文档，可以为自己的项目编写开发规范、注意事项等，方便查看、交流、维护； ####DEMO工程使用
- 下载swaggerLUIDEMO-0.0.1-SNAPSHOT.jar
- 启动 java -jar swaggerLUIDEMO-0.0.1-SNAPSHOT.jar --server.port=7777
- 运行http://localhost:7777/swagger_lui_index.html
- 首次运行可能会报错，不用理会，是没初始化数据库的原因
- 设置接口访问地址：http://localhost:7777/
- 运行【系统初始化按钮】，然后可以到【MD文档管理中操作】
-
接口管理平台（Netease Easy Interface），简称 NEI。NEI 虽然叫接口管理平台，但其实不只是管理接口，它可以管理整个产品，也具备项目脚手架的功能。本文介绍 NEI 的设计理念和一些名词的含义。
-
滴滴出行企业管理API为企业客户提供员工用车相关管理接口。包括员工管理、用车管理、发票管理、成本中心等。企业客户可以通过管理API实现企业管理后台与滴滴出行后台的无缝对接。
-
连接管理器是一种客户端网络连接工具，允许用户连接到远程网络，如 Internet 服务提供商 (ISP) 或虚拟专用网络 (VPN) 服务器保护的企业网络。
-
更改历史 * 2018-02-13 邢足健 无过滤条件时，省略filters传参，修改下划线格式字段为驼峰 * 2018-03-06 邢足健 添加批量创建与批量删除接口 * 2018-03-19 管鹏波 基于filters增加或的查询 1.查询接口 * /tables 获取列表,接口名为表名的复数形式 @param pageNo 整数,如1
-
1. 标题栏 NT_UI.setHeader(name, style); 列表 可选值 背景色 颜色 悬浮色 大小 间距 圆角 标题栏 wrapper true 标题栏-客服头像 kefuLogo true true true 标题栏-客服名称 kefuName true 标题栏-客服个性签名 kefuSignature true 标题栏-最小化按钮 min true true 标题栏-关闭按钮
-
初始化 xn('init') 停止默认初始化 xn('stopAutoInit'); 设置访客信息 // customerinfo的可选健值见下表 xn('setCustomerInfo', JSONObject customerinfo); 参数名称 类型 备注 默认值 uid String 用户id 无 uname String 用户名称 无 userlevel String 用户等级
-
jd.setEnableDebug(OBJECT) 设置是否打开调试开关，此开关对正式版也能生效。 OBJECT 参数说明： 参数名 类型 必填 说明 enableDebug Boolean 是 是否打开调试 success Function 否 接口调用成功的回调函数 fail Function 否 接口调用失败的回调函数 complete Function 否 接口调用结束的回调函数（调用成功
-
管理接口操作文档。 { "access_log_path": "...", "profile_path": "...", "address": "..." } access_log_path (required, string) 管理服务器的访问日志的路径。如果不需要访问日志，则指定"/dev/null"。 profile_path (optional, string) 管理服务器的