RESTClient 使用教程

简介: Wisdom RESTClient 一款自动化测试REST API的工具,它可以自动化测试RESTful API并生成精美的测试报告,同时基于测试过的历史API,可以生成精美的RESTful API文档。本文将介绍如何使用RESTClient测试REST API和生成API文档的详细步骤。

Wisdom RESTClient 一款自动化测试REST API的工具,它可以自动化测试RESTful API并生成精美的测试报告,同时基于测试过的历史API,可以生成精美的RESTful API文档。

1. 使用RESTClient前的准备工作

1.1 下载RESTClient

JAR包: restclient.jar

1.2 使用前安装Java

支持的Java版本 >=1.7

1.3 启动RESTClient软件

双击restclient.jar,或者执行命令java -jar restclient.jar启动RESTClient软件。

RESTClient主窗体包含:

  • 请求视图(Request)
  • 响应视图(Response)
  • 历史视图(History)
  • 菜单栏(File, Edit, Test, Apidoc, Help)

2. 使用RESTClient测试REST API步骤

2.1 请求视图中输入REST API所需的请求数据

在请求视图中对所测试的REST API输入的数据详情如下:

2.1.1 选择请求方法

RESTClient支持请求方法详情如下:

方法名 操作 备注
GET 查询 无需要填写请求体
POST 添加
PUT 修改
DELETE 删除 无需要填写请求体

2.1.2 输入访问REST API的URL

  • URL格式: HTTP协议://主机名:端口号/路径
  • URL示例: http://restclient.cn:8080/restapi

2.1.3 输入请求体(Body)

如果选择的请求方法是POST或者PUT则可以填写请求体,其他方法则无需填写

2.1.3.1 选择请求体类型(Body-Type)

  • 字符串(String)

直接在请求体的文本框中填写字符串;

  • 文件(File)

浏览并选择地文本文件,文件内容会被读取并作为请求体。

2.1.3.2 选择内容类型(Content-Type)

根据REST API消息体类型,对照下表,选择跟API匹配的内容类型,如果表中的内容类型都不是API所需要的类型,可以直接在内容类型文本框中输入所需类型
常见的内容类型详情如下:

内容类型(Content-Type) 数据格式
application/json JSON
application/xml XML
application/x-www-form-urlencoded Form表单
text/plain 纯文本
text/xml XML文本
text/html HTML文本
multipart/form-data 用于上传文件
application/xhtml+xml XHTML

2.1.4 选择字符集(Charset)

默认字符集是UTF-8,可以选择REST API所需要的字符集,如果下拉列表里的字符集都不是API所需要的,可以直接在字符集文本框中输入所需的字符集

2.1.5 填写消息头(Header)

可以根据REST API定义要求,以键值对的形式添加相应的消息头。
Header键值对示例:

Key   : Accept
Value : application/json

2.1.6 填写Cookie

可以根据REST API定义要求,以键值对的形式添加相应的Cookie。
如果API需要登录认证,请先使用浏览器完成API登录认证成功后,将浏览器生成的JSESSIONID填写到Cookie中,这样就可以无需登录认证,直接访问REST API了,免登陆使用详情参考资料
Cookie键值对示例:

Key   :JSESSIONID 
Value : MY0REST1COOKIE2DEMO3

2.1.7 完整的请求数据示例

填写完请求数据后点击Start按钮会触发API请求,在请求视图中输入完整的请求数据如图所示:
请求视图数据

2.2 响应视图中返回REST API响应的数据

REST API请求完成后得到响应数据如下:

  • 响应状态码(Status)
  • 响应消息体(Body)
  • 响应消息头(Header)
  • 原始的响应数据(Raw)

响应数据如图所示:
响应视图数据

2.3 历史视图中记录测试过的REST API

在历史视图中可以对API进行的可视化编辑如下:

  • 刷新API
  • 对选中的API进行顺序调整
  • 删除选中的API或者清空全部历史API
  • 可以编辑选中的API

历史API可视化编辑的快捷菜单如图所示:
API可视化编辑的快捷菜单

2.4 对历史REST API进行再测试

如果需要对历史API进行再测试,在RESTClient菜单栏点击 Test => Start Test
API再测试

记录的历史API测试完成后,在Windows系统中会使用默认的浏览器打开测试报告。其他系统可以根据提示框中的报告路径,手动打开测试报告。
测试报告如图所示:
API测试报告

2.5 对历史REST API生成API文档

如果需要生成API文档,在RESTClient菜单栏点击 Apidoc => Create
生成API文档

API文档生成完成后,在Windows系统中会使用默认的浏览器打开API文档。其他系统可以根据提示框中的文档路径,手动打开API文档。
API文档如图所示:
API文档

2.6 对历史REST API进行编辑

为了满足API再测试要求或者满足API文档数据要求,可以对API进行如下操作:

  • 调整API顺序
  • 删除冗余的、废弃的API
  • 对API进行可视化编辑

历史视图中选中API,快捷菜单中选择Edit打开API编辑窗体,如图所示:
API可视化编辑窗体

在API编辑窗体中,可以编辑如下内容:

  • 请求方法
  • 请求URL
  • 请求头(Header)
  • 请求体(Body)
  • 响应状态码(Status)
  • 响应的消息体(Text视图)
  • 是否校验返回的消息体(Assert Body)

默认勾选了Assert Body,API再测试会对返回的消息体进行完整匹配校验,如果不需要对返回的消息体进行匹配校验,可以去勾选。

如果返回的消息体中的某些JSON节点不需要进行再测试匹配校验,可以在Viewer视图上勾选排除这些节点,这样API再测试只对未排除的节点进行匹配校验。

2.7 定制API文档

如果生成的API文档不能满足要求,需要改动,可以修改数据文件work/apidoc/js/apidata.js来定制API文档,API定制详情可以参考资料

2.8 通过命令行(CLI)方式使用RESTClient实现自动化测试REST API

RESTClient支持通过执行命令的方式启动和再测试API以及生成API文档,RESTClient CLI使用详情参考资料

通过CLI方式,这样很容易在Jenkins中定时执行命令来调度RESTClient进行API再测试,从而实现自动化测试REST API和生成REST API文档。

3. 问题咨询与帮助

使用RESTClient过程中遇到问题可以查看RESTClient日志文件:work/log/rest-client.log,这样很容易排查出问题的具体原因。

更多的RESTClient使用示例,请参考相关的技术资料来获得更多的使用示例和帮助。

目录
相关文章
|
开发者 iOS开发
UniApp打包教程:使用HBuilder X和AppUploader完成原生App云打包和上架指南“
UniApp打包教程:使用HBuilder X和AppUploader完成原生App云打包和上架指南“
368 3
|
JavaScript 前端开发 安全
【vue】如何修改iview组件的样式(element同)
【vue】如何修改iview组件的样式(element同)
210 1
|
算法 Oracle Java
一文详解|从JDK8飞升到JDK17,再到未来的JDK21
本文深入浅出地解析了从JDK8到JDK17版本升级的新特性,并展望后续将会更新的JDK21.
10900 8
|
12月前
|
XML IDE 前端开发
IDEA忽略node_modules减少内存消耗,提升索引速度
在后端开发中,IDEA 在运行前端代码时,频繁扫描 `node_modules` 文件夹会导致高内存消耗和慢索引速度,甚至可能会导致软件卡死。为了改善这一问题,可以按照以下步骤将 `node_modules` 文件夹设为忽略:通过状态菜单右键排除该文件夹、在设置选项中将其加入忽略列表,并且手动修改项目的 `.iml` 文件以添加排除配置。这些操作可以有效提高IDE的运行性能、减少内存占用并简化项目结构,但需要注意的是,排除后将无法对该文件夹进行索引,操作文件时需谨慎。
954 4
IDEA忽略node_modules减少内存消耗,提升索引速度
|
Cloud Native Java 数据库
深入理解Micronaut依赖注入:提高应用灵活性的最佳实践
【9月更文挑战第5天】Micronaut是一个轻量级全栈业务框架,支持Java与Groovy语言,以其优秀的性能和对云原生特性的深度集成而备受关注。本文探讨Micronaut中的依赖注入机制,通过示例展示如何利用构造函数注入、字段注入及方法注入等方式提高应用灵活性。通过合理的依赖注入策略,如使用`@Qualifier`注解选择具体实现或条件化注册Bean,可构建更易扩展和维护的应用。Micronaut简化了这一过程,使开发者能专注于业务逻辑。
169 2
|
前端开发 索引
【IntelliJ IDEA】idea导入node_modules卡死,idea 忽略 node_modules 索引
【IntelliJ IDEA】idea导入node_modules卡死,idea 忽略 node_modules 索引
704 0
|
小程序 前端开发 JavaScript
微信小程序|智慧校园管理系统的设计与实现
微信小程序|智慧校园管理系统的设计与实现
185 1
|
Cloud Native 安全 Java
Micronaut对决Spring Boot:谁是微服务领域的王者?揭秘两者优劣,选对框架至关重要!
【9月更文挑战第5天】近年来,微服务架构备受关注,Micronaut和Spring Boot成为热门选择。Micronaut由OCI开发,基于注解的依赖注入,内置多种特性,轻量级且启动迅速;Spring Boot则简化了Spring应用开发,拥有丰富的生态支持。选择框架需考虑项目需求、团队经验、性能要求及社区支持等因素。希望本文能帮助您选择合适的微服务框架,助力您的软件开发项目取得成功!
564 2
|
Java API Spring
Gradle基础笔记
配置Gradle镜像为阿里云,修改`gradle-wrapper.properties`。使用`subprojects`管理父项目,设定编码为UTF-8。应用Spring Boot和依赖管理插件,子项目排除特定依赖,如`javax.servlet`。针对项目间依赖,使用`implementation`或`api`关键字。完整示例展示了多项目构建,包括仓库、依赖、源代码设置、任务和编码配置。
404 1
|
Java
关于RestTemplate postForObject方法请求 服务端Controller接受不到值的问题解决
关于RestTemplate postForObject方法请求 服务端Controller接受不到值的问题解决
307 0
关于RestTemplate postForObject方法请求 服务端Controller接受不到值的问题解决