Swagger-UI-layer 效果如何使用License 介绍
Swagger-UI-layer 是一个基于 Swagger 的前端 UI 实现,是为了替换了默认的 SwaggerUI,让生成的文档更加友好和美观。
Swagger-UI-layer 要依赖 Swagger 的注解功能,因为 Swagger-UI-layer 仅仅只是一个前端 UI
界面的实现,解析的数据来源于 /v2/api-docs
效果
最终生成文档的展示例子:http://suldemo.tianox.com/docs.html
接口文档信息界面
接口文档调试界面
如何使用
1、引入jar包
首先需要在你的 pom.xml 中引入swagger 和 swagger-ui-layer 的包
swagger-ui-layer 最新版jar包地址:
http://search.maven.org/#search%7Cgav%7C1%7Cg%3A%22com.github.caspar-
chen%22%20AND%20a%3A%22swagger-ui-
layer%22
io.springfox springfox-swagger2 2.2.2 com.github.caspar-chen swagger-ui-layer ${last-version}
启用swagger ,创建SwaggerConfig文件,内容如下,
需要注意的一点是 swagger api 的默认地址是/v2/api-docs 所以swagger-ui-layer也读取的是默认地址,
所以在new Docket()的时候不能指定group参数,否则 swagger api 的地址会在后面加入group的参数导致swagger-ui-
layer不能正确请求到数据
@Configuration @EnableSwagger2 public class SwaggerConfig { @Bean public Docket ProductApi() { return new Docket(DocumentationType.SWAGGER_2) .genericModelSubstitutes(DeferredResult.class) .useDefaultResponseMessages(false) .forCodeGeneration(false) .pathMapping("/") .select() .build() .apiInfo(productApiInfo()); } private ApiInfo productApiInfo() { ApiInfo apiInfo = new ApiInfo("XXX系统数据接口文档", "文档描述。。。", "1.0.0", "API TERMS URL", "联系人邮箱", "license", "license url"); return apiInfo; } }
常用的swagger注解 Api ApiModel ApiModelProperty ApiOperation ApiParam ApiResponse
ApiResponses ResponseHeader 具体的注解用法可参阅互联网
3、查看结果
swagger-ui-layer 的默认访问地址是 http://${host}:${port}/docs.html
License
Apache License 2.0
Swagger-UI-layer 效果如何使用License 官网
https://github.com/caspar-chen/swagger-ui-layer
版权声明:本文内容由互联网用户自发贡献,该文观点与技术仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容, 请发送邮件至 dio@foxmail.com 举报,一经查实,本站将立刻删除。