swagger-bootstrap-ui 1.7 发布,前端 UI 实现

八一菜刀
 八一菜刀
发布于 2017年12月18日
收藏 35

swagger-bootstrap-ui 1.7 发布了。swagger-bootstrap-ui 是 Swagger 的前端 UI 实现,目的是替换 Swagger 默认的 UI 实现 Swagger-UI,使文档更友好一点儿

swagger-bootstrap-ui 1.7更新如下:

1、分组功能实现

替换默认请求接口v2/api-docs,改为swagger的分组接口:swagger-resources,左菜单分组下拉框可选


在Spring Boot的swagger配置如:

@Configuration
@EnableSwagger2
public class SwaggerConfiguration {

    @Bean(value = "defaultApi")
    public Docket defaultApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(apiInfo())
                .groupName("默认接口")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.swagger.bootstrap.ui.demo.controller"))
                .paths(PathSelectors.any())
                .build();
    }
    @Bean(value = "groupRestApi")
    public Docket groupRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                .apiInfo(groupApiInfo())
                .groupName("分组接口")
                .select()
                .apis(RequestHandlerSelectors.basePackage("com.swagger.bootstrap.ui.demo.group"))
                .paths(PathSelectors.any())
                .build();
    }

    private ApiInfo groupApiInfo(){
        return new ApiInfoBuilder()
                .title("分组Api")
                .description("swagger-bootstrap-ui-demo RESTful APIs")
                .termsOfServiceUrl("http://www.group.com/")
                .contact("group@qq.com")
                .version("1.0")
                .build();
    }

    private ApiInfo apiInfo() {
        return new ApiInfoBuilder()
                .title("swagger-bootstrap-ui-demo RESTful APIs")
                .description("swagger-bootstrap-ui-demo RESTful APIs")
                .termsOfServiceUrl("http://www.xx.com/")
                .contact("xx@qq.com")
                .version("1.0")
                .build();
    }

}

详细示例参考demo:swagger-bootstrap-ui-demo

2、文件上传,form表单action地址取相对路径,截取掉首字符"/"

Maven坐标

<dependency>
   <groupId>com.github.xiaoymin</groupId>
   <artifactId>swagger-bootstrap-ui</artifactId>
   <version>1.7</version>
</dependency>
本站文章除注明转载外,均为本站原创或编译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。
转载请注明:文章转载自 OSCHINA 社区 [http://www.oschina.net]
本文标题:swagger-bootstrap-ui 1.7 发布,前端 UI 实现
加载中

精彩评论

loyal
loyal
刚用的时候大家说好看...
时间长了后...都说丑...就又切回原版了...

最新评论(4

戈壁胡杨
有点问题哦:用spring 搭建的分布式,通过zuul访问微服务的doc.html时出了点错:
{
"timestamp": "2018-04-13T11:28:39.566+0000",
"status": 500,
"error": "Internal Server Error",
"message": "The request was rejected because the URL was not normalized.",
"path": "/api/sjfw//getDataServiceList/1/1"
}
路径不对,有个"//",
看了下数据  
"basePath": "/api/sjfw/",
"paths": "/getDataServiceList/{page}/{size}"
源码是:url=cacheData.basePath+DApiUI.getStringValue(apiInfo.url); 作者能否处理一下
风里的叶子
风里的叶子
https://gitee.com/treeleaf/xDoc 基于java注释(不是注解)生成在线和离线接口文档
fineliving
fineliving
看起来不错
loyal
loyal
刚用的时候大家说好看...
时间长了后...都说丑...就又切回原版了...
返回顶部
顶部