探索 HTTP 请求语法

在 HTTP 请求中使用注释

• 在请求中，使用 // 或 # 开始任何一行将其变成注释行。

  // A basic request GET http://example.com/a/

为 HTTP 请求设置名称

要在 运行/调试配置、 随处搜索 和 运行任何内容 中快速找到请求，可以为其指定一个名称。

• 在请求上方的 ###、 # @name 或 # @name = 旁边输入名称。

  

如果请求没有名称，IntelliJ IDEA 将使用其在请求文件中的位置（例如 #1 ）作为请求名称。 如果请求文件中包含多个同名请求，IntelliJ IDEA 会将请求位置编号附加到每个名称后面。 这将使每个请求名称唯一，以便您可以在 服务 工具窗口、运行/调试配置等中轻松找到所需的请求。

使用简短格式进行 GET 请求

• 对于 GET请求，您可以省略请求方法并且只指定 URI。

  // A basic request https://example.com/a/

  在 Java 环境中，您可以使用 代码补全 Ctrl+Space 来根据已定义的 @Path 注解指定 URI。 对 Java 代码中 @Path 注释的任何更改都会反映在建议列表的内容中。

在单个文件中编写多个请求

1. 通过在下方键入 ### 分隔符来标记请求的结束。

   // A basic request https://example.com/a/ ###

2. 在分隔符下再写一个请求。

   // A basic request https://example.com/a/ ### // A second request using the GET method https://example.com:8080/api/html/get?id=123&value=content

设置执行延迟

• sleep(ms) 函数／方法可将 HTTP 请求或脚本的执行暂停指定时长（以毫秒为单位）。 这对于各种连接测试、websocket 测试等特别有用。

  将 sleep() 函数／方法与 await 关键字结合使用以暂停执行： await sleep(milliseconds)。

• 如果想安排一段代码在延迟后运行，而不阻止脚本的其余部分，请使用 Web API 方法：

  • setTimeout() ：安排一个函数／方法在指定毫秒数后运行一次。 返回计时器 ID。

  • clearTimeout() ：取消使用 setTimeout() 设置的超时。 接受计时器 ID。

• 在预请求脚本中，可以延迟 HTTP 请求的实际发送。 在响应处理程序中，使用这些函数／方法来延迟收到响应后的测试执行或逻辑。

  < {% const job = setTimeout(() => { console.log("This timer is cleared and will not execute."); }, 1000); console.log("Pre-request: Starting sleep..."); clearTimeout(job); const start = Date.now(); await sleep(10000); console.log(`Pre-request: Finished sleep after ${Date.now() - start}ms`); console.log("Pre-request: Proceeding to request."); %} GET https://examples.http-client.intellij.net/anything > {% setTimeout(() => { console.log("Post-script: One second timer fired during sleep."); }, 1000); console.log("Post-script: Starting sleep..."); const start = Date.now(); await sleep(10000); console.log(`Post-script: Finished sleep after ${Date.now() - start}ms`); console.log("Post-script: Script execution complete."); %}

将长请求分成几行

• 将所有查询字符串行缩进，但第一行除外。

  // Using line breaks with indent GET http://example.com:8080 /api /html /get ?id=123 &value=content

• 如果因查询字符串导致 URL 过长，您可以使用专用的上下文操作将每个查询参数放在新行上。 将文本光标放到查询字符串部分，按 Alt+Enter （显示上下文操作​​ ），然后选择 将查询形参放在单独的行中。

  GET https://example.com:8080/api/get/html?firstname=John&lastname=Doe&planet=Tatooine&town=Freetown

  GET https://example.com:8080/api/get/html? firstname=John& lastname=Doe& planet=Tatooine& town=Freetown

• 同样，您可以在请求中格式化正文 Content-Type: application/x-www-form-urlencoded。 请将文本光标放置在正文处，按 Alt+Enter (显示上下文操作​​ )，然后选择 将 form-urlencoded 形参放在单独的行中。

  POST https://ijhttp-examples.jetbrains.com/post Content-Type: application/x-www-form-urlencoded key1=value1&key2=value2&key3=value3&key4=value4&key5=value5

  POST https://ijhttp-examples.jetbrains.com/post Content-Type: application/x-www-form-urlencoded key1 = value1 & key2 = value2 & key3 = value3 & key4 = value4 & key5 = value5

  要配置 x-www-form-urlencoded 正文的换行，请使用 设置 | 编辑器 | 代码样式 | HTTP 请求 | 换行与括号 | 表单编码形参换行 wrap.。 要配置 = 之间以及 & 之前的空格，请使用 设置 | 编辑器 | 代码样式 | HTTP 请求 | Space。

访问具有身份验证的 Web 服务

• 根据您正在访问的网络服务，提供 基础或 摘要 授权头。

  // Basic authentication GET http://example.com Authorization: Basic username password ### // Digest authentication GET http://example.com Authorization: Digest username password

提供请求消息体

在请求中，在请求体的前面添加一个空行，并执行以下操作之一：

• 请在此处输入请求正文：

  // The request body is provided in place POST https://example.com:8080/api/html/post HTTP/1.1 Content-Type: application/json Cookie: key=first-value { "key" : "value", "list": [1, 2, 3] }

  如果您将 Content-Type 标头字段的值设置为 支持的语言之一，那么相应的语言片段将会被 自动注入 到 HTTP 请求消息体中。 如果未指定 内容类型 ，您可以手动插入语言片段。

• 在 Java 上下文中，您可以使用 代码补全 Ctrl+Space 来根据定义的 @Produces 注解指定 Accept 标头字段的值。 任何对 Java 代码中 @Produces 注释的更改都会反映在建议列表的内容中。

• 要从文件中读取请求正文，请键入 < 符号，后跟文件路径。

  // The request body is read from a file POST https://example.com:8080/api/html/post Content-Type: application/json < ./input.json

使用 multipart/form-data 内容类型

• 将请求的 内容类型设置为 multipart/form-data。 要作为 multipart/form-data 消息的一部分发送文件，请在 Content-Disposition 标头中包含 文件名 参数。

  POST https://example.com/api/upload HTTP/1.1 Content-Type: multipart/form-data; boundary=boundary --boundary Content-Disposition: form-data; name="first"; filename="input.txt" // The 'input.txt' file will be uploaded < ./input.txt --boundary Content-Disposition: form-data; name="second"; filename="input-second.txt" // A temporary 'input-second.txt' file with the 'Text' content will be created and uploaded Text --boundary Content-Disposition: form-data; name="third"; // The 'input.txt' file contents will be sent as plain text. < ./input.txt --boundary--

禁用后续重定向

当 HTTP 请求被重定向（收到 3xx 状态码）时，将返回重定向页面的响应。 在 服务 工具窗口中，您可以查看重定向的页面响应以及请求过程中发生的所有重定向。

您可能希望禁用跟随重定向。 在这种情况下，将返回实际的重定向响应头（如 301 或 302）。

• 在请求之前，添加带有 @no-redirect 标记的注释行。

  // @no-redirect example.com/status/301

如果您已经有一个重定向的请求，您可以点击 禁用 旁边的 重定向 列表，位于 服务 工具窗口中。 这将向初始请求中添加 @no-redirect 标记。

禁用将请求保存到请求历史

如有必要，您可以防止请求被保存到 请求历史记录。 如果请求包含某些敏感数据，而您不希望将其记录到日志中，此方法会很有用。

• 在请求之前，添加带有 @no-log 标记的注释行。

  // @no-log GET example.com/api

禁用将接收到的 cookie 保存到 cookies jar

如有必要，您可以防止接收的 cookie 保存到 cookies jar。 这样您就可以避免手动从 http-client.cookies 文件中删除不需要的 cookies。

• 在请求之前，添加带有 @no-cookie-jar 标记的注释行。

  // @no-cookie-jar GET example.com/api

禁用编码

默认情况下，HTTP 客户端会将请求参数和正文编码为 ASCII 格式。 例如，请求形参中的斜杠字符将作为 %2F 发送。 您可以禁用编码以按原样发送请求。

• 在请求之前，添加带有 @no-auto-encoding 标记的注释行。

  使用该标签时，请求参数和正文不会被编码：

  # @no-auto-encoding GET https://examples.com/api? name=@#$somebody& qwerty=%40%23%24

  生成的请求将按原样发送：

  https://examples.com/api?name=@#$somebody&qwerty=%40%23%24

  默认情况下，如果未使用该标签，编码将被启用。

  ### Default behavior GET https://examples.com/api? name=@#$somebody& qwerty=%40%23%24

  在此请求中，参数将被编码：

  https://examples.com/api?name=%40%23%24somebody&qwerty=%40%23%24

自定义 HTTP 请求超时

HTTP 客户端 在与服务器建立连接时有 60 秒的超时，同时在持续连接中等待新数据包也有 60 秒的超时。 您可以自定义这两个超时。

• 要为已建立的连接中的新数据包设置超时时间，请在请求前添加带有 @timeout 标签的注释行。

  # @timeout 600 GET example.com/api

• 要设置连接超时，请在请求前添加带有 @connection-timeout 标签的注释行。

  // @connection-timeout 2 m GET example.com/api

默认情况下，超时值以秒为单位，但您可以在值后添加明确的时间单位： 毫秒 为毫秒， 秒 为秒， m 为分钟，例如 100 毫秒 或 5 m。