IntelliJ IDEA 2025.1 Help

WireMock

IntelliJ IDEA 支持 WireMock ,一种用于模拟 HTTP 服务的工具。 模拟涉及创建存根或设置 API 调用的响应,以模仿真实的 API 行为,而无需实际的服务器通信。

安装 WireMock 插件

此功能依赖于 WireMock 插件,您需要安装并启用该插件。

  1. Ctrl+Alt+S 打开设置,然后选择 插件

  2. 打开 Marketplace 选项卡,找到 WireMock插件,并点击 安装 (如果出现提示,请重启 IDE)。

创建 WireMock 存根

从头开始创建基本的 WireMock 存根

如果 JSON 文件放置在 映射 文件夹中或包含 "mappings" 键,IntelliJ IDEA 会将其识别为 WireMock stub 文件,并提供相应的编码支持。

  1. 项目 工具窗口中,右键点击文件夹(或按 Alt+Insert )并选择 新建 | 文件

  2. 在打开的 新建文件 对话框中,输入文件名。 例如,您可以输入 mappings/my-stub.json ,IntelliJ IDEA 会创建 映射 文件夹,并将新文件放入其中。

  3. 开始键入一个键以获取适用键及其快速文档的建议。

Wiremock 编码辅助

从 Endpoints 工具窗口创建 WireMock 存根

  1. 打开 端点 工具窗口 (查看 | 工具窗口 | 终结点)。

  2. 右键点击一个 endpoint 并选择 生成 WireMock 存根

从 Endpoints 创建 WireMock 存根

新建的存根文件作为 scratch保存于 临时文件和控制台 | WireMock存根

从 OpenAPI 规范创建 WireMock 存根

  1. 打开一个 OpenAPI 规范文件。

  2. 点击 并选择 生成 WireMock 存根

从 Endpoints 创建 WireMock 存根

新建的存根文件作为 scratch保存于 临时文件和控制台 | WireMock存根

运行 WireMock 服务器

  1. 请打开您的存根文件。

  2. 请点击 运行 WireMock ,该按钮位于编辑器的右上角。

    运行 WireMock

此操作将启动 WireMock 服务器,您可以在 服务 工具窗口中看到它正在运行(查看 | 工具窗口 | 服务 或按 Alt+8)。

服务中的 WireMock

要自定义 IntelliJ IDEA 启动 WireMock 服务器的方式,您可以 修改 WireMock 运行配置 或创建一个新的配置。

发送 HTTP 请求

使用 IntelliJ IDEA HTTP 客户端 向 WireMock 服务器发送 HTTP 请求并预览响应。

  1. 运行 您的 WireMock 服务器。

  2. 打开您的存根 JSON 文件。

  3. 将文本光标放在您的端点 URL 处,按 Alt+Enter (显示上下文操作 ),然后选择 在 HTTP 客户端中生成请求

您可以在 服务 工具窗口中查看存根响应。

对 WireMock 存根的 HTTP 请求

启用对 Handlebars 模板的支持

IntelliJ IDEA 提供对 WireMock 响应模板中使用的模板语言的编码辅助。 要使用此功能,您需要安装并启用 Handlebars/Mustache插件。

  1. 打开您的存根 JSON 文件。

  2. 在编辑器的右上角,点击 使用 Handlebars 模板)。 如果未安装 Handlebars/Mustache插件,该操作将安装它。

这将使 IntelliJ IDEA 将放置在 __files 目录中的 JSON 文件视为响应模板,并提供适当的 Handlebars 编码辅助,包括 Handlebars 助手的补全功能。

启用对 Handlebars 模板的支持

WireMock 运行配置

IntelliJ IDEA 自带一个专用的 WireMock 运行配置,允许您自定义如何启动 WireMock 服务器。

WireMock 运行配置

主要参数

名称

为运行配置指定名称。

存根文件

运行 WireMock 存根的 JSON 文件位置。

服务器端口

WireMock 服务器的 HTTP 端口号。 输入 0 以动态确定端口。

修改选项

详细输出

打开详细日志记录到 stdout(等同于 --verbose 选项)。

启用全局 Handlebars 模板化

通过传递 --global-response-templating Wiremock 命令行选项 ,使用 Handlebars 模板渲染所有响应定义。

JRE

如果您希望在与 JBR 不同的运行环境中运行 WireMock,请选择一个 JRE。

日志

请指定在 运行 工具窗口的专用选项卡中,应在控制台显示哪些运行应用程序时生成的日志文件。

启动前

选择在启动所选运行/调试配置之前要执行的任务。

最后修改日期: 2025年 4月 24日