如何基于 Swagger 使用 OpenAPI Generator生成 JMeter 脚本?

举报
zuozewei 发表于 2021/12/20 00:21:08 2021/12/20
【摘要】 作为性能工程师,我们花了大量的时间编写脚本。如果我们能找到一种能自动生成脚本的方法,那将是一个提高的能效的好事情。在本文中,我演示解释如何使用 Swagger & openapi-generator 生成用于 API 测试的 JMeter 脚本。

前言

作为性能工程师,我们花了大量的时间编写脚本。如果我们能找到一种能自动生成脚本的方法,那将是一个提高的能效的好事情。

在本文中,我演示解释如何使用 Swagger & openapi-generator 生成用于 API 测试的 JMeter 脚本。

预备知识

我从 https://swagger.io/docs/specification/about/ 复制了以下内容,其中解释了什么是 Swagger / OpenAPI 规范。

什么是 OpenAPI ?

OpenAPI 规范(以前称为 Swagger 规范)是 REST API 的 API 描述格式。OpenAPI 文件允许描述整个 API,包括:

  • 可用端点(/users)和操作上的每个端点(GET /users,POST /users)
  • 操作参数每次操作的输入和输出
  • 认证方式
  • 联系信息,许可,使用条款和其他信息。

API 规范可以用 YAML 或 JSON 编写。该格式易于学习,并且对人和机器都可读。

什么是 Swagger?

Swagger 是一套围绕 OpenAPI 规范构建的开源工具,它可以帮助您设计、构建、记录和使用 REST api。主要的 Swagger 工具包括:

  • Swagger Editor - 基于浏览器的编辑器,您可以编写OpenAPI规范。
  • Swagger UI - 渲染 OpenAPI 规范作为交互式 API 文档。
  • Swagger Codegen - 一个模板驱动引擎,根据 OpenAPI 规范生成 stubs 和 客户端代码。

为什么要使用 OpenAPI?

API 描述其自身结构的能力是 OpenAPI 中所有出色功能的根源。编写完成后,OpenAPI 规范和 Swagger 工具可以通过各种方式进一步推动 API 开发:

  • 设计优先的用户:使用 Swagger Codegen 为你的 API 生成服务器 stub 。剩下的唯一事情就是实现服务器逻辑——你的API已经准备好了!
  • 使用 Swagger Codegen 以 40 多种语言为您的 API 生成客户端库。
  • 使用 Swagger UI 生成交互式 API 文档,使您的用户可以直接在浏览器中尝试API调用。
  • 使用规范将与 API 相关的工具连接到您的 API。例如,将规范导入 SoapUI,以及您的 API 创建自动化测试。

OpenAPI Generator

Swagger 提供的客户端生成功能可用于生成 JMeter 脚本。但是出于安全考虑,为此目的使用 Swagger Editor 并不是理想的选择。Swagger 编辑器是一个托管解决方案。
我们可以在 https://openapi-generator.tech/docs/installation/ 下安装 Swagger Code Gen 或 Open API Generator 客户端。
使用 Code Gen Jar 客户端,您可以生成提供 API 规范的 JMeter 脚本,如以下命令所示:

java -jar openapi-generator-cli-4.1.2.jar generate -i swagger.json -g jmeter

我使用默认的 Petstore API Swagger(官方demo) 规范生成了 JMeter脚本。

官方提供的 demo 地址:http://petstore.swagger.io/

 java -jar openapi-generator-cli-4.3.1.jar generate -i https://petstore.swagger.io/v2/swagger.json -g jmeter

如下所示:

在这里插入图片描述

在目录下生成以下内容:

在这里插入图片描述

我们使用 Jmeter 打开其中一个脚本瞧瞧:

在这里插入图片描述

如在上面看到的,代码生成工具已成功生成 JMeter 脚本,用我们可以根据的项目要求轻松地对其进行脚本增强。如果我们去手动准备脚本,那可能要花很多时间。

小结

测试过程中要善于合理利用轮子,节省开发时间,提高工作效率。

相关资料:

参考资料:

【版权声明】本文为华为云社区用户原创内容,转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息, 否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。