swagger 原生的界面谈不上美观。swagger-bootstrap-ui是springfox-swagger的增强UI实现,为Java开发者在使用 swagger 的时候,能拥有一份简洁、强大的接口文档体验。
swagger-bootstrap-ui提供两大核心功能:文档说明 和 在线调试,以下作说明。
在以上实例的基础上,引入maven依赖即可:
<!--美化swagger--> <dependency> <groupId>com.github.xiaoymin</groupId> <artifactId>swagger-bootstrap-ui</artifactId> <version>1.7</version> </dependency>然后,访问 :8084/doc.html,看看效果:
其实对于作者来说,我并不喜欢这种这种编码风格。虽然生成了 spi 文档,但是其注解对接口的污染较大。算是事有利弊吧,主要衡量利弊轻重。
源码:我的GitHub