WireMock
IntelliJ IDEA 支持 WireMock ,一种用于模拟 HTTP 服务的工具。 模拟涉及创建存根或设置 API 调用的响应,以模仿真实的 API 行为,而无需实际的服务器通信。
安装 WireMock 插件
此功能依赖于 WireMock 插件,您需要安装并启用该插件。
按 Ctrl+Alt+S 打开设置,然后选择 。
打开 Marketplace 选项卡,找到 WireMock插件,并点击 安装 (如果出现提示,请重启 IDE)。
创建 WireMock 存根
从头开始创建基本的 WireMock 存根
如果 JSON 文件放置在 映射 文件夹中或包含 "mappings" 键,IntelliJ IDEA 会将其识别为 WireMock stub 文件,并提供相应的编码支持。
在 项目 工具窗口中,右键点击文件夹(或按 Alt+Insert )并选择 。
在打开的 新建文件 对话框中,输入文件名。 例如,您可以输入
mappings/my-stub.json,IntelliJ IDEA 会创建 映射 文件夹,并将新文件放入其中。开始键入一个键以获取适用键及其快速文档的建议。

从 Endpoints 工具窗口创建 WireMock 存根
打开 端点 工具窗口 ()。
右键点击一个 endpoint 并选择 生成 WireMock 存根。

新建的存根文件作为 scratch保存于 。
从 OpenAPI 规范创建 WireMock 存根
打开一个 OpenAPI 规范文件。
点击
并选择 生成 WireMock 存根。

新建的存根文件作为 scratch保存于 。
运行 WireMock 服务器
请打开您的存根文件。
请点击
,该按钮位于编辑器的右上角。

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

要自定义 IntelliJ IDEA 启动 WireMock 服务器的方式,您可以 修改 WireMock 运行配置 或创建一个新的配置。
发送 HTTP 请求
使用 IntelliJ IDEA HTTP 客户端 向 WireMock 服务器发送 HTTP 请求并预览响应。
打开您的存根 JSON 文件。
将文本光标放在您的端点 URL 处,按 Alt+Enter (显示上下文操作 ),然后选择 在 HTTP 客户端中生成请求。
您可以在 服务 工具窗口中查看存根响应。

启用对 Handlebars 模板的支持
IntelliJ IDEA 提供对 WireMock 响应模板中使用的模板语言的编码辅助。 要使用此功能,您需要安装并启用 Handlebars/Mustache插件。
打开您的存根 JSON 文件。
在编辑器的右上角,点击
(使用 Handlebars 模板)。 如果未安装 Handlebars/Mustache插件,该操作将安装它。
这将使 IntelliJ IDEA 将放置在 __files 目录中的 JSON 文件视为响应模板,并提供适当的 Handlebars 编码辅助,包括 Handlebars 助手的补全功能。

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

主要参数
- 名称
为运行配置指定名称。
- 存根文件
运行 WireMock 存根的 JSON 文件位置。
- 服务器端口
WireMock 服务器的 HTTP 端口号。 输入
0以动态确定端口。
修改选项
- 详细输出
打开详细日志记录到 stdout(等同于
--verbose选项)。- 启用全局 Handlebars 模板化
通过传递
--global-response-templatingWiremock 命令行选项 ,使用 Handlebars 模板渲染所有响应定义。- JRE
如果您希望在与 JBR 不同的运行环境中运行 WireMock,请选择一个 JRE。
日志
请指定在 运行 工具窗口的专用选项卡中,应在控制台显示哪些运行应用程序时生成的日志文件。
启动前
选择在启动所选运行/调试配置之前要执行的任务。