最终的

HTTP客户端

将 cURL 转换为 HTTP 请求

• 将 cURL 请求粘贴到 HTTP 请求文件中。IntelliJ IDEA 会将其转换为 HTTP 请求格式，并将原始 cURL 请求注释掉以供以后参考。

  

• 或者，单击HTTP 请求编辑器面板顶部的 并选择Convert cURL to HTTP Request。

  在“将 cURL 转换为 HTTP 请求”对话框中，键入或粘贴要转换的 cURL 请求。

  

将 HTTP 请求转换为 cURL

1. 将插入符号放在要转换为 cURL 格式的 HTTP 请求处。

2. 单击并选择转换为 cURL 并复制到剪贴板。AltEnter

   或者，您可以单击HTTP 请求编辑器面板顶部的“转换”快捷方式链接，然后选择“将插入符下的 HTTP 请求转换为 cURL 并复制”。

这将根据 HTTP 请求生成 cURL 请求并将其复制到剪贴板。

1. 单击 URL 并按。AltEnter

2. 在打开的上下文菜单中，单击“在 HTTP 客户端中生成请求”。

   这将创建一个新的 GET HTTP 请求，指向generated-requests.http 临时文件中的指定 URL 。

创建到端点的 HTTP 请求

• 在 OpenAPI 规范文件中，单击端点定义旁边的编辑器装订线。

• 或者，打开查看 | 工具窗口 | 端点，右键单击端点，然后选择在 HTTP 客户端中生成请求。

IntelliJ IDEA 将创建一个新的 HTTP 请求并将其保存在generated-requests.http 临时文件中。

如果您想要快速向端点发送请求并且不想保存它，可以使用端点工具窗口中的HTTP 客户端选项卡。

IntelliJ IDEA 根据可用的 OpenAPI 规范提供请求 URL 和请求正文（JSON 格式）的补全。这不仅适用于本地，也适用于远程规范（将它们添加到 IDE 设置中以启用完成功能）。

动图

重命名端点及其用途

使用重命名重构可以同时重命名定义的端点及其在 HTTP 请求中的用法。

1. 执行以下任一操作：

   • 在 OpenAPI 规范文件中，将插入符号放在要重命名的端点的定义处。

   • 在 HTTP 请求文件中，将插入符号放在要重命名的 URL 路径段处。

2. 选择重构 | 从主菜单或上下文菜单重命名，或按。ShiftF6

3. 在打开的“重命名”对话框中，指定新端点的名称。

4. 预览并应用更改。

IntelliJ IDEA 将重命名端点及其用法。

插入响应处理程序脚本

您可以就地或通过引用外部文件将响应处理程序脚本插入到您的请求中。

• 要就地插入脚本，请在其前面添加>并将其括在 中{% %}：

  GET host/api/test
  
  > {%
  // Response Handler Script
  ...
  %}

• 要从外部文件插入脚本，请在其前面添加>：

  GET host/api/test
  
  > scripts/my-script.js

如果响应处理程序脚本有任何输出（错误或client.log的输出），则当您运行请求时，它会显示在“服务”工具窗口的“响应处理程序”选项卡中。

插入预请求脚本

您可以就地或通过引用外部文件将预请求脚本插入到您的请求中。

• 要就地插入脚本，请在其前面添加<并将其括在 中{% %}：

  < {%
      request.variables.set("petName", "Bella")
  %}
  POST https://example.org/pets/{{petName}}

• 要从外部文件插入脚本，请在其前面添加<：

  < scripts/my-script.js
  
  POST https://example.org/pets/{{petName}}

如果预请求脚本有任何输出（错误或client.log的输出），则当您运行请求时，它会显示在“服务”工具窗口的“预请求处理程序”选项卡中。

导入 JavaScript 代码

有时，您可能需要使用外部文件中的特定功能，例如变量或函数。为此，在预请求和响应处理程序脚本中，您可以使用常规 ES6 导入功能来访问本地 JavaScript 文件中定义的变量和函数。

1. 从 JavaScript 文件导出所需的值。HTTP Client 支持export以下格式的语句：

   export let name1, name2/*, … */; // also var
   export const name1 = 1, name2 = 2/*, … */; // also var, let
   export function functionName() { /* … */ }
   
   export { name1, /* …, */ nameN };
   export { variable1 as name1, variable2 as name2, /* …, */ nameN };
   
   export default expression;
   export default function functionName() { /* … */ }
   export default function () { /* … */ }

2. 将所需的值导入到响应处理程序或预请求脚本中。HTTP Client 支持import以下格式的语句：

   import defaultExport from "module-name";
   import * as name from "module-name";
   import { export1 } from "module-name";
   import { export1 as alias1 } from "module-name";
   import { export1, export2 } from "module-name";
   import { export1, export2 as alias2, /* … */ } from "module-name";
   import defaultExport, { export1, /* … */ } from "module-name";
   import defaultExport, * as name from "module-name";
   import "module-name"; // side effect import

   笔记

   如果您想从外部文件运行一些测试并且不需要从中导入任何内容，则可以在响应处理程序脚本中使用副作用导入，例如import 'test-scripts/mytests'. 如果您有通用测试并希望在多个请求中重用它们，同时又保留为某些请求编写（或导入）单独测试的能力，这可能会很有用。

为响应处理程序和预请求脚本启用 JavaScript 编码帮助

1. 按(查找操作)。CtrlShift0A

2. 键入Use JavaScript Library，单击相应的操作，然后在打开的上下文菜单中选择HTTP Pre-Request and Response Handler。

修改 HTTP 请求运行/调试配置

1. 执行以下任一操作：

   • 在编辑器中，右键单击请求，然后在上下文菜单中选择修改运行配置...。

   • 或者，选择运行 | 从主菜单编辑配置，然后在HTTP 请求列表中选择所需的运行/调试配置。

2. 更改所需的配置参数：

   • 在环境列表中，选择将定义请求中使用的环境变量集的环境。

   • 在文件字段中，提供HTTP 请求文件的路径。您可以手动键入路径并在键入时使用路径完成功能，或者单击并在打开的对话框中选择所需的文件夹。CtrlSpace

   • 如果您的请求文件包含多个请求，请在请求列表中选择要执行的请求的名称。

保存临时 HTTP 请求运行/调试配置

• 在“运行/调试配置”选择器中，选择“保存 <配置名称>”。

• 在“运行/调试配置”对话框中，选择配置并单击。

使用运行/调试配置执行请求

• 在运行/调试配置选择器中，选择所需的运行配置。然后单击主工具栏上的 或按。ShiftF10

• 按，从列表中选择所需的运行配置，然后按。AltShiftF10Enter