springdoc openapi 接口转换为JMeter测试计划实践指南_Java

1. 实践目标

为 demo-api 增加 springdoc-openapi 能力，自动暴露 openapi 文档。
基于 openapi generator，通过 cli 方式快速生成 jmeter 测试计划。
将生成出的 .jmx 文件作为接口测试起点，再结合 jmeter 进行调试和执行。

2. 实践步骤

第一步：启动 demo-api

先启动应用，确保服务运行在本机 8080 端口。

第二步：验证 openapi 文档

启动 demo-api 后，可访问：

openapi json：http://localhost:8080/v3/api-docs

在浏览器访问：

http://localhost:8080/v3/api-docs

如果能正常返回 json，说明 openapi 文档已经可用。
第三步：使用客户端工具

安装：https://openapi-generator.tech/docs/installation#jar
我采用的 scoop安装方式。

执行指令：确认安装成功

使用openapi生成jmeter脚本

ps c:\users\carter.li> openapi-generator-cli generate -i http://localhost:8080/v3/api-docs -g jmeter -o  d:\data\mydemo

执行结果：

[main] info  o.o.codegen.defaultgenerator - generating with dryrun=false
[main] info  o.o.c.ignore.codegenignoreprocessor - no .openapi-generator-ignore file found.
[main] info  o.o.codegen.defaultgenerator - openapi generator: jmeter (client)
[main] info  o.o.codegen.defaultgenerator - generator 'jmeter' is considered stable.
[main] warn  o.o.codegen.utils.examplesutils - no application/json content media type found in response. response examples can currently only be generated for application/json media type.
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo\hellocontrollerapi.jmx
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo\hellocontrollerapi.csv
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo\logincontrollerapi.jmx
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo\logincontrollerapi.csv
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo.openapi-generator-ignore
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo.openapi-generator\version
[main] info  o.o.codegen.templatemanager - writing file d:\data\mydemo.openapi-generator\files
############################################################################################
# thanks for using openapi generator.                                                      #
# we appreciate your support! please consider donation to help us maintain this project.   #
# https://opencollective.com/openapi_generator/donate                                      #
############################################################################################

第四步：确认生成结果