馆长推荐!IDEA接口测试神器Apipost Helper 2.0简介

发布时间:2024年01月20日

各位看官,大家好,我是IT技术馆长!!赞是您的认可!!

最近,馆长留意到不知什么时候出了一个IDEA非常好用的插件,针对于接口测试的开发使用。名为:Apipost Helper-2.0

图片

注意:Apipost Helper 2.0目前仅支持IDEA 2020.3?以上版本

  1. 1.??安装步骤:

首先打开我们的IDEA,找到左上角File -> Settings…..?。

再从Settings?左侧功能栏中找到?Plugins?点击进去到功能面板,

切换到?Marketplace?再从输入框中查询Apipost……。

找到响应名称的Apipost Helper-2.0?,点击?Install?进行安装与重启。

图片

图片

  1. 2.??使用说明:

安装完成后,重启IDEA?在创建web?项目后,在IDEA工具的右侧工具区域有个Apipost的插件工具。我们基本就可以使用了。

图片

图片

3.配置方法

在Settings中找到?Other Settings > Apipost V2 config

1.设置云端地址

云端地址修改为:https://sync-project-ide.apipost.cn(一般安装完成后就有,不需要修改维护)

图片

设置项目token

获取token的两种方式

1、?在Apipost客户端--项目设置--openAPI--右上角新建(根据自己的要求创建单个或多个)

图片

2、如果token输入框没有文字,右侧按钮为获取token,可以通过账号密码获取token

图片

3、上传方式

手动选择项目中目录和自动新建类注释目录模式,默认为手动选择项目中目录模式

图片

1、自动新建类注释目录

上传时选择到项目,自动创建目录,创建的目录为类的注释,如果没有注释则为类名,注释优先级为文档注释标记@module > @menu > @Api(swagger)?>?文档注释第一行

2、手动选择项目中目录

上传时可选择到目录下或者项目下,默认为手动选择项目中目录模式

4、设置上传host

1、如果不配置则读取配置文件中的端口和server.servlet.context-path?

图片

图片

2、如果host设置为空,则只上传相对路径,不包含host,可以在apipost客户端环境中设置

部分机型需要失焦后才能设置host成功?

5、上传

选择2.0版本上传,筛选自己所在的团队--项目--目录,右下角或者通知中会提示接口上传成功的数量。可以右击代码的方法、类、包、module进行上传(上传后,Apipost同账户下资源就同步了)

注:如果选过了目录,idea会记录上次选的项目和目录,如果上传和上次一样的项目和目录,直接点确定就可以

图片

图片

上传后,有上传成功条数提示,可直接点击去调试,跳转Apipost操作台调试,也可点击去分享,浏览器直接打开文档分享的链接

图片

上传后在Apipost客户端右上角刷新,接口即可展示

图片

?注:1.0.12版本不再支持环境变量,上传后的host放在环境中,建议代码的一个module对应客户端一个项目?

三、接口管理

点击右侧Apipost图标,调出操作台

1、搜索

接口搜索,可搜索注释 快捷键mac:command+\ win:Ctrl+\

接口树搜索,可搜索注释 快捷键mac:option+\ win:Alt+\

2、跳转

点击接口左侧的箭头可跳转到接口树中,点击接口树中的接口可跳转代码中

图片

3、idea内部调试全局请求头、host设置以及上传

图片

注:全局header需要失焦后保存才能成功,host不需要?

图片

4、右击接口树上传

右击接口树可上传,支持module、包、类、方法上传

四、IDEA内调试功能

历史记录保存、接口保存功能,每个方法可保存20条

图片

五、IDEA书写要求按照java规范

2.0版本如果方法上有注释则形成接口名称,如果没有注释,接口路径为方法名;入参备注如果没有,上传apipost客户端后无法生成入参备注。支持swagger3.0

入参是对象,对象的属性要用段落注释或者swagger才能生成备注

1.0.9之前的版本,入参如果是对象要用@RequestBody修饰,如果是非对象要用@RequestParam修饰,MultipartFile不用修饰,1.0.9版本入参如果是对象,没有用@RequestBody修饰则在query中生成入参(不支持list、map),建议对象用@RequestBody修饰

package com.example.demo1.controller;

/**
 * 这是类上的注释
 *
 * @author apipost at 2023/7/11 13:48
 */
@RestController
@RequestMapping("api")
public class AController {

    /**
     * 这是方法的注释(Apipost中的接口名称)
     *
     * @param param 入参
     * @return
     */
    @GetMapping("getMethod")//方法路径(必填)
    public String getMethod(@RequestParam String param) {
        return "success";
    }

    /**
     * 文件上传
     *
     * @param file
     * @return
     */
    @PostMapping("upload")
    public R<Void> upload(MultipartFile file) {

        System.out.println();
        return R.ok();
    }

}

/**
 * 用户信息
 *
 * @author apipost at 2023/7/3 14:14
 */
@Data
public class User {
    /**
     * id
     */
    @ApiModelProperty(value = "id")
    private Long id;
    /**
     * 角色集合
     */
    private List<String> roleList;
    /**
     * role对象
     */
    private Role role;
}

图片

支持swagger3.0注释的导入。建议在编写接口时,应用swagger的注解进行修饰,这样生成接口信息时,就会越全,说明就会越清晰。

感谢各位看官,本章介绍就结束了。

馆长准备了很多学习资料,其中包含java方面,jvm调优,spring / spring boot /spring cloud ,微服务,分布式,前端,js书籍资料,视频资料,以及各类常用软件工具,破解工具 等资源。请关注“IT技术馆”公众号,进行关注,馆长会每天更新资源和更新技术文章等。请大家多多关注。

文章来源:https://blog.csdn.net/qq_18237141/article/details/135719259
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。