VSCode 小鸡汤 第01期 - REST Client 简单好用的接口测试辅助工具

介绍

今天给大家介绍一个后端开发辅助的好工具 —— REST Client，插件如其名这就是一个 REST 的客户端插件，把我们的 VSCode 转化为一个 REST 接口测试的利器

我们一般都会用 PostMan 来完成接口测试的工作，因为用起来十分简单快捷，但是一直以来我也在寻找更好的方案，一个不用切换窗口多开一个 app 的方案 —— 终于在使用 VSCode 一段时版本间，我找到了 REST Client 插件，初看 REST Client 插件的时候，会觉得他十分的简陋，但是在使用一段时间后会发现在 REST Client 插件中已经有完成接口测试所需的所有东西

  • 优势

    • 基于 HTTP 语言，HTTP 语言是一门非常简单的语言，使用 HTTP 语言可以轻松的描述请求
    • 纯文本记录，不同于 PostMan 保存在云端，或是 Paw 那样保存二进制文件，并且纯文本可以使用 git 追踪内容的变化
    • 无需切换窗口，测试，调试，代码编辑都在一个 VSCode 中完成
  • 劣势
    • 操作和使用不像 PostMan 之类的图形化工具那么直观
    • 不支持请求前后对数据进行操作的脚本，不过这个已经在作者的开发计划中

很多时候我们只是需要写完代码后手边有一个小工具可以轻松愉快的看一眼接口是否正常，那么 REST Client 就是我们的首选了

使用介绍

安装和入门

插件的安装非常简单，搜索 restclient 即可安装

安装完成后，可以在命令菜单中找到 REST Client 相关的功能

简单请求

我们先从发送最简单的请求开始

首先需要新建一个 http 文件，创建文件时后缀为 http 即可，例如 test.http

之后输入下面的内容：

GET http://localhost:8000/api/v1/public/echo?msg=1345asdf HTTP/1.1

echo 是一个测试服务，他会返回你传入的 msg 的内容，输入完上面的

这时候请求上面会显示一个 “Send Request” 按钮，点击即可发送请求，请求完成后，插件会分割当前窗口将新的结果打开在右侧的窗口中，下图中显示了请求的所有相关信息

HTTP 语言基础

语言入门

HTTP 是一个非常简单的语言，入门仅需几分钟

最基本的 HTTP 语言语法入门可以参看上面的内容，配合 VSCode 的自动提示功能，用起来简直不要太快

也不用担心是否记得 header 里面那些选项，想不起来的时候 Ctrl + 空格 调出自动提示即可

要注意的地方

  1. 请求文本最后面需要有一个空行，或者一个 # 开头的行，建议空行，这样多个请求看起来会非常好看
  2. 如果需要把 form 类型的参数拆分为多行，那么第二个参数开始必须以 & 开始（如图）
  3. GET 请求也可以将参数拆分多行，每行开头必须以 ? 或者 & 开始

发送文件

一般来说，我们使用 multipart/form-data 请求方式来完成

如图配置，REST Client 就会将文件内容填充到相应的区域完成发送

保存请求结果

对于返回图片的接口在 VSCode 中是可以直接预览的，如果是 Excel 之类的二进制文件，那么这里可能会显示乱码（二进制文件）

选中相应结果页，右上角提供了保存结果的按钮

查看请求历史

使用 Ctrl + Alt + H（macOS 使用 Cmd + option + H）查看请求历史

使用变量

变量的好处，在开发过程中我们都知道，在 HTTP 语言中同样可以使用变量来帮助我们组织请求代码

自定义变量

我们可以在 http 文件中直接定义变量，使用 @ 符号开头，以 {{variable name}} 的格式来使用

@host = http://localhost:8000
@token = adsfasdfasdfadsfasdfasdfas

### test
GET {{host}}/api/v1/public/echo HTTP/1.1
    ?msg=1345asdf
    &bundle_id=demo
    &test=1
    &token={{token}}

### test request
POST {{host}}/api/v1/public/echo HTTP/1.1
Content-Type: application/x-www-form-urlencoded
User-Agent: iPhone

test=1
&bundle_id=demo
&msg=123123
&token={{token}}

这样在测试验证不同环境接口正确性的场合，我们可以很方便的在不同服务器之间切换，或是所有接口都使用同一个参数的时候非常方便例如上面的 token 应该是大部分接口都会使用到的

环境变量

除了使用自定义变量以外还可以对当前的项目或是创建编辑器全局的环境变量

"rest-client.environmentVariables": {
    "$shared": {
        "version": "v1"
    },
    "local": {
        "version": "v2",
        "host": "http://localhost:8000",
        "token": "tokentokentokentoken1"
    },
    "prod": {
        "host": "http://api.xxxxxx.com",
        "token": "tokentokentoken2"
    }
}

上面 $shared 中的变量表示在所有环境设置中都可以使用的

设置后可通过 Ctrl + Alt + E（Cmd + option + E）切换环境

系统变量

REST Client 提供了一些自带的系统变量，方便我们直接使用（这里由于我没有使用过 Azure 所以跳过了 Azure 相关的变量，大家可以参考文档使用）

  • {{$guid}}: 生成一个 UUID
  • {{$randomInt min max}}: 生成随机整数
  • {{$timestamp [offset option]}}: 生成时间戳，可以使用类似 {{$timestamp -3 d}} 生成3天前的时间戳，或是使用 {{$timestamp 2 h}} 这样的形式生成2小时后的时间戳
  • {{$datetime rfc1123|iso8601 [offset option]}}: 生成日期字符串

VSCode 提供的辅助功能

VSCode 对我们使用 HTTP 语言提供了包括自动提示，Outline 代码导航功能，方便我们编写接口测试代码

自动提示

Outline 以及代码导航

验证和证书

Basic Auth

Basic Auth 可以使用已经 Base64 后的 username:password，也可以直接填入 username 和 password，也就是下面两种形式都是可以的

使用 Base64 的结果

POST {{host}}/api/v1/public/echo HTTP/1.1
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=

使用 username 和 password

POST {{host}}/api/v1/public/echo HTTP/1.1
Authorization: Basic username password

Digest Auth

Digest Auth 直接填入 username 和 password 即可

POST {{host}}/api/v1/public/echo HTTP/1.1
Authorization: Digest username password

SSL 证书

ssl 证书在设置文件中对特定域名指定证书路径后，就可以自动生效了

"rest-client.certificates": {
    "localhost:8081": {
        "cert": "/Users/demo/Certificates/client.crt",
        "key": "/Users/demo/Keys/client.key"
    },
    "example.com": {
        "cert": "/Users/demo/Certificates/client.crt",
        "key": "/Users/demo/Keys/client.key"
    }
}

每个 host 我们可以设置下面的内容：

  • cert: x509 证书路径
  • key: 私钥路径
  • pfx: PKCS #12 或者 PFX 证书路径
  • passphrase: 证书密码（需要时设置）

代码生成

曾经使用 Postman 的时候，Postman 的代码生成功能为我提供了非常多的方便，REST Client 中提供了同样的功能

选中一个请求后，点击右键选择 Copy Request As cURL 可以把当前的请求复制成 curl 的命令，也可以使用 Ctrl + Alt + C（macOS 下Cmd + Option + C）呼出代码生成菜单，选择需要生成的语言

选择语言后选择具体代码调用的方式，比如 python 可以使用 http.client 库或者 Requests 库来发送请求

命名请求

之前我们发送的所有请求都是匿名请求，匿名请求和命名请求的区别就是在一个 http 文件内，可以引用命名请求的请求信息和响应信息，在请求之间有依赖关系时这个功能非常有用，例如每次登录成功后其他请求都需要更新登录返回的 token，命名请求可以用过 JSONPath 或者 XPath 获取响应数据

在响应中也会显示使用到当前命名请求的变量值的更新

一些有用的设置

设置响应显示内容

在 REST Client 设置中的 “Preview Option” 可以设置请求响应显示什么内容，总共有四种，full，body，header，exchang

我们分别来看下四种结果显示什么内容

  • full：Header + Body

  • body：只显示 Body

  • header：只显示 Header

  • exchange：显示请求 + Header + Body

其他常用的设置选项

  • rest-client.timeoutinmilliseconds: 设置请求超时，单位毫秒
  • rest-client.showResponseInDifferentTab: 每个响应请求创建一个新的 tab，为 false 时，每次请求会覆盖上一次的请求结果，设置为 true 时每次请求都会打开一个新的 tab，方便对比多次请求结果
  • rest-client.previewColumn: 请求结果显示，current 表示显示在当前的编辑器分组 beside 表示显示在侧面编辑器分组（这个侧面根据编辑器的 workbench.editor.openSideBySideDirection 选项会显示在右面或是下面
  • 代理：使用http.proxy 和 http.proxyStrictSSL

最后

其实 Postman 和 Paw 都提供更为强力的辅助工具，这里使用 REST Client 单纯觉得 Postman 和 Paw 大部分功能我其实都用不到，因为仅仅验证接口是否正常，业务是否能跑通，所以一直在寻找一个简单的工具，REST Client 刚好满足了我所有的需求

这里附上 REST Client 项目地址，里面也有对应的文档 https://github.com/Huachao/vscode-restclient

转载https://juejin.im/post/5c5503ffe51d457f5357e5dd

原文地址：https://www.cnblogs.com/LOVEYU/p/11458453.html

时间： 2024-08-11 09:57:37

VSCode 小鸡汤 第01期 - REST Client 简单好用的接口测试辅助工具的相关文章

Python实现的QQ空间3366小游戏彩色砖块的辅助工具

由于女朋友每天玩这个小游戏,每天挑战我……囧,只好写了一个辅助工具帮我自动满分,最后的结果是大家一起满分……本人不是程序员,请大家指正. 主要使用了PIL模块和pymouse模块,一个做图像识别,另一个做自动点击,这个小工具只在我的电脑,Python2.5+XP下测试通过. # -*- coding: utf-8 -*- #这是一个QQ空间3366小游戏中的彩色砖块游戏的辅助工具 #他可以帮你自动计算一种正确的算法,保证你得200分! #使用时不能有任何窗口遮挡游戏界面,同时也不能做其他操作 #

【转】【Android应用开发详解】第01期：第三方授权认证（一）实现第三方授权登录、分享以及获取用户资料

转载请注明出处:http://blog.csdn.net/yangyu20121224/article/details/9057257 由于公司项目的需要,要实现在项目中使用第三方授权登录以及分享文字和图片等这样的效果,几经波折,查阅了一番资料,做了一个Demo.实现起来的效果还是不错的,不敢独享,决定写一个总结的教程,供大家互相交流.学习和参考,博主只求能和大家共同进步.希望能多多支持! 这篇文章中,我们使用到了Share SDK,它是为iOS.Android.WP8的APP提供社会化功能的一

小程序的红利期

其实一直都有人问我,小程序是否还有机会.我必须承认,一开始我就看错了,也许现在还是错的,不过没关系,跟大家分享一下,如果又错了,就继续攒经验值.对创业者而言,很多时候,做错总比错过有价值. 我最近常说的是,小程序的价值,在于寄生. 小程序自身的入口,只有一个,是附近的小程序.当然,这个入口也是有价值的,但不足以支撑腾讯关于小程序生态的野心. 那么其他的入口,全部是寄生关系. 我们来数一数. 1.公众号 以前公众号只可以绑定3个小程序,后来放开50个.我们注意到这段时间很多公众号都绑定了小程序,这

我与小娜（01）：回到过去，探索未知

我与小娜(01):回到过去,探索未知? 1月16日,微软全球资深副总裁.微软亚太研发集团主席兼微软亚洲研究院院长洪小文,公开描绘了在微软心中的未来是什么样子的.该公司正在利用更有效率的高科技平台(巨型云计算数据中心)帮助全球人们去完成更多的事情. 借助微软的这种“动力”(势头),思考良久,我决定带领小娜,回到过去(60年之前),探索未知. 进入2016年,在全球范围之内,人工智能(AI)“风头”很硬. 在六十年前,世界上并没有人工智能.那时的实际情景如何?小娜是怎么看的?这是一件很有意思的事情.

[原创工具]YunFile网盘资源下载辅助工具V2019_1.01

软件名称:YunFile网盘资源下载辅助工具V2019 软件版本:V1.01 软件功能:免广告.免填验证码下载Yunfile网盘资源 使用建议:建议下载资源尺寸较小的文件 软件界面: 注意事项: 1.当资源尺寸小于200kb会自动下载 2.当资源尺寸大于200kb时,会推送链接至Aria2(最好提前熟悉下怎么用它),请提前打开相关服务,软件只负责推送链接 3.30秒验证等待和10分钟下载限制,请根据相关提示等待即可 4.软件退出后,会保存本次解析日志到 根目录\DownloadLog文件夹下 下

IOS－小项目（饿了么 网络部分 简单实现）

在介绍小项目之前,在此说明一下此代码并非本人所写,我只是随笔的整理者. 在介绍之前先展现一下效果图. 看过效果图大家应该很熟悉了,就是饿了么的一个界面而已,值得注意的是,实现时并没有采用本地连接,而是实打实的网络连接.看一下文件架构. 这一采用的是MVC设计模式,虽然文件很少,但是也可以看. 下面开始正式介绍小项目的实现. 首先介绍Model的实现,很简单,实现模型即可, Shop.h // // Shop.h // CX-小项目(饿了么 网络部分 简单实现) // // Created by

几个数据库的小案例（二）：极其简单的省市联动

总用有两个文件(frmMain.cs SqlHelper.cs) //frmMain.cs//作者:Meusing System; using System.Collections.Generic; using System.ComponentModel; using System.Data; using System.Drawing; using System.Linq; using System.Text; using System.Windows.Forms; namespace 省市联动

vscode小程序代码高亮

vscode无法识别wxml,wxss语法: wxml文件设置: (1)任意打开一wxml文件,点击下方语言模式选择,这里已关联wxm所以当前显示wxml.默认关联为纯文本或者html或其他语法,点击即可.如下图 (2)点击".wxml"的配置文件关联....如下图 (3)下拉选择wxml关联即可,这里vscode安装了小程序的各种插件,没有wxml时关联html可以起到同样的效果.如下图 (4)wxss方法相同,关联wxss语法或者css语法即可.效果如下图 原文地址:https:/

[Java]Java小知识总结01

Title>初识Java 1>小概念 IDE (集成开发环境)是一类软件,它将程序开发环境和程序调试环境集合在一起, 一般包括代码编辑器.编译器.调试器和图形用户界面等工具帮助程序员开发软件. JRE (Java Runtime Environment,Java运行环境),运行JAVA程序所必须的环境的集合,包含JVM标准实现及Java核心类库. JDK 是 Java 语言的软件开发工具包,主要用于移动设备.嵌入式设备上的java应用程序. JDK是整个java开发的核心,它包含了JAVA的运