转载

Knife4j 2.0.4 版本发布，支持自定义 Host

Knife4j 前身是 swagger-bootstrap-ui ,是一个为Swagger接口文档赋能的工具

文档： https://doc.xiaominfo.com

效果(旧版)： http://swagger-bootstrap-ui.xiaominfo.com/doc.html

效果(2.X版)： http://knife4j.xiaominfo.com/doc.html

Gitee： https://gitee.com/xiaoym/knife4j

GitHub： https://github.com/xiaoymin/swagger-bootstrap-ui

示例： https://gitee.com/xiaoym/swagger-bootstrap-ui-demo

特性 & 优化

1、支持UiConfiguration中方法调试的配置,如并未配置任何支持的方法,在ui界面中不会出现调试栏Tab，代码如下：

@Bean
public UiConfiguration uiConfiguration(){
    return UiConfigurationBuilder.builder()
        .supportedSubmitMethods(new String[]{})
        .build();
}

界面中的显示效果如下(仅显示文档)：

Knife4j 2.0.4 版本发布，支持自定义 Host

2、在当前文档页添加 复制接口 功能，便于开发人员快速复制接口地址 github #238

Knife4j 2.0.4 版本发布，支持自定义 Host

3、修复Authorize修改或注销的问题 gitee #I1IJK3

4、个性化配置新增Host属性的配置,如果当前对外提供的接口文档和接口本身Host属性存在冲突,可以自动配置此属性进行接口的联调，Host属性可以配置为 ip:port 的形式，这样默认是HTTP进行访问,开发者也可以配置完整的域名或者 HTTPS 等配置

Knife4j 2.0.4 版本发布，支持自定义 Host

其工作原理是在调用axios组件进行接口调试时,配置其 baseURL 属性

var baseUrl='';//默认是空
//是否启用Host
if(this.enableHost){
    baseUrl=this.enableHostText;
}
var requestConfig={
    baseURL:baseUrl,//调用目标Host服务的接口
    url: url,
    method: methodType,
    headers: headers,
    params: formParams,
    data: data,
    //Cookie标志
    withCredentials:this.debugSendHasCookie(headers),
    timeout: 0
}

开发者要使用此Host的配置后端必须开启跨域的配置，如果是 Spring Boot ，示例代码如下：

@Bean
public CorsFilter corsFilter(){
    UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
    CorsConfiguration corsConfiguration=new CorsConfiguration();
    corsConfiguration.setAllowCredentials(true);
    corsConfiguration.addAllowedOrigin("*");
    corsConfiguration.addAllowedHeader("*");
    corsConfiguration.addAllowedMethod("*");
    corsConfiguration.setMaxAge(10000L);
    source.registerCorsConfiguration("/**",corsConfiguration);
    CorsFilter corsFilter=new CorsFilter(source);
    return corsFilter;
}

5、调试接口时,接口在无返回数据或者异常的情况下弹框错误信息,提示开发者

6、图片预览接口无法在响应内容中在线预览图片的问题 gitee #I1KP0Q

Knife4j 2.0.4 版本发布，支持自定义 Host

7、修复针对 Map 字段时,Value指引是本类时出现递归死循环的问题,结构如下：

"SensorTable": {
            "type": "object",
            "properties": {
                "attrib": {
                    "type": "integer",
                    "format": "int32"
                },
                "sensorMap": {
                    "type": "object",
                    "additionalProperties": {
                        "originalRef": "SensorTable",
                        "$ref": "#/definitions/SensorTable"
                    }
                }
                //more...
            },
            "title": "SensorTable"
        },

8、修复离线文档功能导出 Markdown 时,响应参数格式异常的问题 gitee #I1LMYO

9、修复在使用中间件对接口响应内容进行拦截处理时,响应内容不显示的bug，例如使用 sentinel 进行QPS限流,一般在这种情况下是由于接口响应的Content-Type是json，但实际响应内容却是text导致 gitee #I1JO73