Swagger 规范接口的文档型 API UI 界面-阿里云开发者社区

开发者社区> 开发与运维> 正文

Swagger 规范接口的文档型 API UI 界面

简介:

主要使用 Vue CLI 3,iView 开发,主要体现文档的可读性功能,给接口调用者提供接口文档,省去文档编写。

Github & Issues: https://github.com/cn-src/swagger-document-ui

码云: https://gitee.com/cn-src/swagger-document-ui

使用方式

主要步骤

  • 此项目需要配合 springfox 框架使用,因此使用之前需要对 springfox 有所了解
  • 配置 swagger-document-ui 替换其它 UI
  • 地址样例 http://localhost:8080/swagger-ui.html
  • springfox 官方文档
  • 此项目没有类似官方的在线测试/调试功能,建议使用 postman,支持 swagger 规范的接口导入,功能更强大
  1. 移除官方 UI 依赖
    <dependency>
        <groupId>io.springfox</groupId>
        <artifactId>springfox-swagger-ui</artifactId>
        <version>${springfox.version}</version>
    </dependency>
  1. 添加 swagger-document-ui 依赖
    <dependency>
        <groupId>cn.javaer.springfox</groupId>
        <artifactId>swagger-document-ui</artifactId>
        <version>0.1.3</version>
    </dependency>

Spring Boot 集成

与 Spring Boot 集成使用是最简单的方式,推荐使用 程序猿DD/spring-boot-starter-swagger 提供的集成方式,然后你需要:

  1. 排除自带 UI 依赖
    <dependency>
        <groupId>com.spring4all</groupId>
        <artifactId>swagger-spring-boot-starter</artifactId>
        <version>${swagger-spring-boot-starter.version}</version>
        <!--排除自带 UI 依赖-->
        <exclusions>
            <exclusion>
                <artifactId>springfox-swagger-ui</artifactId>
                <groupId>io.springfox</groupId>
            </exclusion>
        </exclusions>
    </dependency>
  1. 添加 swagger-document-ui 依赖
    <dependency>
        <groupId>cn.javaer.springfox</groupId>
        <artifactId>swagger-document-ui</artifactId>
        <version>0.1.3</version>
    </dependency>

其它使用方式

此项目最终是生成纯静态资源,理论上来说只要你将 dist 目录里的静态文件部署到 web 服务器的根目录下即可使用,但前提是:你的项目中使用了 swagger 规范的 API 信息接口。

  1. 其会请求 /swagger-resources (springfox 框架默认地址) 和 /swagger-resources.json (本项目新增地址) 拿到 API 信息接口地址。(项目 tests 目录里有样例)
  2. 请求 swagger-resources 中配置的 url(优先) 或者 location(兼容旧版不提供 url 字段) 其应当返回 swagger 规范的 API 信息即可使用。

本文来自云栖社区合作伙伴“开源中国”

本文作者:达尔文

原文链接

版权声明:本文首发在云栖社区,遵循云栖社区版权声明:本文内容由互联网用户自发贡献,版权归用户作者所有,云栖社区不为本文内容承担相关法律责任。云栖社区已升级为阿里云开发者社区。如果您发现本文中有涉嫌抄袭的内容,欢迎发送邮件至:developer2020@service.aliyun.com 进行举报,并提供相关证据,一经查实,阿里云开发者社区将协助删除涉嫌侵权内容。

分享:
开发与运维
使用钉钉扫一扫加入圈子
+ 订阅

集结各类场景实战经验,助你开发运维畅行无忧

其他文章