查看原文
其他

媲美 postman 的 IDEA 插件神器,常用功能统统搞定!

Java知音 2023-03-16

介绍

RESTful WebServices是一个类似jmeter、postman的工具。可以使用纯文本编辑。

编写HTTP请求

在IDEA中的位置Tools->Http client->Test Restful WebService。点击之后出现如下界面

点击红色部分即可出现文本编辑页面

可以点击Add Request快速生成模板,也可输入gtr生成get请求模板,ptr生成post请求模板,mptr生成multipart/form-data请求模板。

点击Examples,其中包含很多复杂的http请求集合示例,可以参考,非常全面。

HTTP请求中使用变量

编写HTTP请求时,可以使用variables来参数化其元素 。变量可以保存请求的主机,端口和路径的值,查询参数或值,标头值或在请求主体内部或外部文件中使用的任意值。

要在请求中提供变量,请将其括在双花括号中,如{{variable}}。变量名称只能包含字母,数字,下划线符号 _或连字符-。

变量的值可以通过以下方式获取:

  • 默认方式动态生成的$uuid$timestamp$randomInt预定义的动态变量
  • 通过环境变量为每个环境显式提供
  • 编写响应处理脚本方式定义。即使用 client.global.set

预定义的动态变量

每次您运行请求时,动态变量都会生成一个值:

  • $uuid:生成通用的唯一标识符(UUID-v4)
  • $timestamp:生成当前的UNIX时间戳
  • $randomInt:生成介于0到1000之间的随机整数。

例如:

GET http://localhost/api/get?id={{$uuid}}

环境变量创建

环境变量使您可以在项目内部存储一组环境定义。例如,您可以创建和使用{{host}}变量,而不是在请求中显式提供主机名。执行请求时,可以在定义的环境之间进行选择,然后将其发送到特定的主机:

定义环境变量

环境变量在环境文件中定义。

在项目内部,创建以下文件:

  • rest-client.env.json(或http-client.env.json)是包含常见的变量,其目的是要与你的项目一起分发的常规文件。
  • rest-client.private.env.json(或http-client.private.env.json)是一个 私人 的文件可能包括密码,令牌,证书和其他敏感信息。默认情况下,此文件被添加到VCS忽略文件列表中。在http-client.private.env.json文件中指定的变量的值将覆盖环境文件中的值。

环境变量示例

http-client.env.json

{
    "development": {
        "host""localhost",
        "id-value"12345,
        "username""",
        "password""",
        "my-var""my-dev-value"
    },

    "production": {
        "host""example.com",
        "id-value"6789,
        "username""",
        "password""",
        "my-var""my-prod-value"
    }
}

http-client.private.env.json

{
    "development": {
        "host""localhost",
        "id-value"12345,
        "username""",
        "password""",
        "my-var""my-dev-value"
    },

    "production": {
        "host""example.com",
        "id-value"6789,
        "username""",
        "password""",
        "my-var""my-prod-value"
    }
}

示例HTTP请求如下

GET http://{{host}}/api/json/get?id={{id-value}}&key={{unresolved_var}}
Authorization: Basic {{username}} {{password}}
Content-Type: application/json

{
"key": {{my-var}}
}

当您执行上述请求时,IntelliJ IDEA会在定义的执行环境之间提供一个选择:

响应处理脚本API

该脚本包含两个对象,分别为client和response。该脚本在http请求完成后执行。

  • client存储会话元数据,可以在脚本内部对其进行修改。该client直到IntelliJ IDEA关闭存在。

  • response保存有关接收到的响应的信息:其内容类型,状态,响应正文等。

HTTP Client 介绍

Client用于存储全局变量,跟随IDEA启动和关闭,重启IDEA变量不会保存。

client属性

名称描述
global用于全局变量存储,用于设置,检索,或删除变量。在HTTP请求中,您可以使用语法{{variable_name}}访问存储在client.global中名称为variable_name的变量。

client方法

名称参数描述
testtestName (string) func (function)创建名为testName,body 为func的测试。
assertcondition (boolean) message (string)检查指定的 condition 是true; 否则引发异常。可选message 参数用作异常消息。
logtext打印text到控制台

global全局变量存储对象

该global对象用作变量存储,并用于设置,检索或删除变量。

global方法

名称参数描述
setvarName(String) varValue(String)将具有varName名称的变量保存到存储器中,并将其值设置为 varValue。
getvarName(String)返回varName变量的值。
isEmpty
检查global对象是否未定义变量。
clear
从变量存储中 删除变量varName。
clearAll
从变量存储中删除所有变量。

HTTP response对象

该response对象保存有关接收到的HTTP响应的信息(响应内容,标头,状态等),并提供对headers和contentType嵌套对象的访问。

responses属性

名称描述
body(字符串或者对象) 响应内容,如果响应的内容类型 为application / json,则为字符串或JSON对象 。
headers(ResponseHeaders)响应报头存储对象
status(int)响应状态,例如200或404。
contentType (ContentType)contentType对象,用于保存Content-Type响应标头值上的数据。

Headers对象

该ResponseHeaders对象用于检索有关响应头值的数据。

方法

名称参数描述
valueOfheaderName (string)检索headerName响应头的第一个值,或者 null如果headerName响应头不存在。
valuesOfheaderName (string)检索包含headerName响应标头的所有值的数组。如果headerName响应头不存在,则返回一个空数组。

ContentType对象

用于保存Content-Type响应标头值上的数据。

属性

名称描述
mimeType(string)响应的MIME类型,例如text / plain, text / xml,application / json
charset(string)响应字符集的字符串表示形式,例如utf-8。
脚本示例

检查headers,body和mimeType

### Check response status, headers, and content-type
GET https://httpbin.org/get

> {%
    client.test("Request executed successfully", function() {
        client.assert(response.status === 200, "Response status is not 200");
    });

    client.test("Headers option exists", function() {
        client.assert(response.body.hasOwnProperty("headers"), "Cannot find 'headers' option in response");
    });

    client.test("Response content-type is json", function() {
        var type = response.contentType.mimeType;
        client.assert(type === "application/json""Expected 'application/json' but received '" + type + "'");
    });
%}

设置及使用环境变量

在此示例中,我们将从接收到的响应中捕获一个值到环境变量中,然后将其用于后续请求中。

POST https://httpbin.org/post
Content-Type: application/json

{
    "token""my-secret-token"
}

//设置环境变量
> {%
    client.global.set("auth_token", response.body.json.token);
%}
//使用上面定义的变量
GET https://httpbin.org/headers
Authorization: Bearer {{auth_token}}
Content-Type: application/json

{
    "token""my-secret-token"
}

//设置环境变量
> {%
    client.global.set("auth_token", response.body.json.token);
%}


//使用上面定义的变量
GET https://httpbin.org/headers
Authorization: Bearer {{auth_token}}

作者:M_Q_L_

来源:blog.csdn.net/M_Q_L_/article/

details/104895135

推荐

Java面试题宝典

技术内卷群,一起来学习!!

PS:因为公众号平台更改了推送规则,如果不想错过内容,记得读完点一下“在看”,加个“星标”,这样每次新文章推送才会第一时间出现在你的订阅列表里。“在看”支持我们吧!

您可能也对以下帖子感兴趣

文章有问题?点此查看未经处理的缓存