您的位置:  首页 > 技术杂谈 > 正文

IDEA版Postman - Fast Request版本更新,为简化开发而生

2022-04-01 12:00 https://my.oschina.net/dromara/blog/5507853 Dromara开源组织 次阅读 条评论

2022.1.5

  • 移除了Accept头上的text/html
  • 添加对自动生成参数描述的支持
  • 添加一键生成API文档的支持
  • 添加单个类的API整体预览
  • 修复了一些bug

添加对自动生成参数描述的支持

可选择性的对描述进行隐藏

添加一键生成API文档的支持

点击生成参数后,可通过分享直接生成Markdown文档

 

添加单个类的API整体预览

聚焦窗口后输入关键字可快速定位

 

2022.1.4.0

==idea版本2021.3+==

  • SearchEveryWhere高亮优化
  • APIs导入导出支持
  • APIs支持直接运行
  • API请求增加超时设置
  • 兼容idea 2022.1
  • 自动生成参数可选化
  • swagger注解默认值参数解析支持
  • 对Send和Send and Download按钮进行了合并
  • APIs界面优化
  • Tab页API Navigate重命名Navigate
  • 使用引导上的细节优化
  • url生成优化之多url随机生成
  • 修复了Light files should have PSI only in one project

SearchEveryWhere高亮优化

高亮展示搜索关键字,加快真实想要查找的API的查找速度,同时展示api对应的javadoc help

APIs导入导出支持

增加对APIs的导入导出支持,利用改功能,你可以非常方便得将自己已有的APIs分享给别的开发者,或者导入到其他设备上的IDEA

 

* 导出的时候会新增一个名为fastRequestCollection.xml的xml文件,你不能重命名它, 默认导出到当前项目路径下

* 导入的时候会做默认备份,并且会在.idea文件夹下生成一个名为fastRequestCollection-yyyyMMddHHmmssSSS.xml的文件,
如果是导入误操作,可以通过导入它来还原

* 如果fastRequestCollection.xml不可见,点击file->Reload All from Disk来强制刷新

APIs支持直接运行

你可以在APIs tab页直接运行你保存的请求

 

自动生成参数可选化

 

swagger注解默认值参数解析支持

增加了swagger注解默认值的解析,该功能对于入参的传递更加人性化

  • @ApiParam(swagger2)
  • @ApiImplicitParam(swagger2)
  • @ApiModelProperty(swagger2)
  • @Parameter(swagger3)
  • @Schema(swagger3)

已下是一些example

优先级: swagger配置的值 > 配置默认值


swagger2

* @ApiParam

@GetMapping(value="/test/{id}")
public String test3(@ApiParam(name = "id",example="2") @PathVariable("id") Integer id) {
    return "";
}

@GetMapping(value="/test/{id}")
public String test3(@ApiParam(name = "id",defaultValue="2") @PathVariable("id") Integer id) {
    return "";
}


* @ApiImplicitParam

@ApiImplicitParams({
    @ApiImplicitParam(paramType="query",name="pageNo",dataType="String",required=true,value="pageNo",defaultValue="1"),
    @ApiImplicitParam(paramType="query",name="pageSize",dataType="String",required=true,value="pageSize",defaultValue="10")
})
@GetMapping(value="/testPage)
public String testPage(@RequestParam("pageNo") Integer pageNo, @RequestParam("pageSize") Integer pageSize) {
    return "";
}


* @ApiModelProperty
@Data
public class UserDto {
    @ApiModelProperty(example = "Bob")
    private String userName;
}
swagger3

* @Parameter

@GetMapping(value="/test/{id}")
public String test3(@Parameter(name = "id",example="2") @PathVariable("id") Integer id) {
    return "";
}

* @Schema(swagger3)

@Data
public class UserDto {
    @Schema(example = "Bob")
    private String userName;
}

对Send和Send and Download按钮进行了合并

对按钮进行了合并,因为常见的操作都是非下载操作,减少了工具栏按钮个数,看上去更加简捷 mergeRunAndDownload

使用引导上的细节优化

我们在不同的操作窗口,增加?选项用来展示一些注意事项及操作指引,对于初次使用的用户,操作门槛更低

并且随着版本的迭代,后续可能会加入更多的提示操作指引

 

url解析优化

历史逻辑只会取第一个url即test1,考虑到实际使用中,有可能你需要的是另外一个url,所以添加了随机支持

以下demo,url将随着点击小火箭随机生成 /url1/test1,/url1/test2,/url2/test1,/url2/test2

@RequestMapping({"url1","url2"})
@RestController
public class MultiUrlController {
    @GetMapping(value = {"test1","test2"})
    public Integer testUrl(){
        return 1;
    }
}

支持变量计算,以下demo将生成 /url/public/test1

public class Constant {
    public static final String PUBLIC_URL = "/public";
}
@RequestMapping("url")
@RestController
public class MultiUrlController {
    @GetMapping(value = Constant.PUBLIC_URL + "/test1")
    public Integer testUrl(){
        return 1;
    }
}

Tab页API Navigate重命名Navigate

在工具窗口比较小的情况下,API Navigate会被隐藏,为了在尽可能小的工具窗口展示更多内容,所以命名更加简短

IDEA插件市场搜索Restful Fast Request 安装即可使用!

https://gitee.com/dromara/fast-request 

https://github.com/dromara/fast-request 

展开阅读全文
  • 0
    感动
  • 0
    路过
  • 0
    高兴
  • 0
    难过
  • 0
    搞笑
  • 0
    无聊
  • 0
    愤怒
  • 0
    同情
热度排行
友情链接