一文带你全面解析postman工具的使用(高级篇)

软件工具
742
0
0
2022-03-28
标签   Postman

说明:由于前面的一文篇幅太大,导致无法放在一文发布,故这篇文章只是postman工具介绍的最后一部分,

若回看第一部分内容:一文带你全面解析postman工具的使用(基础篇)

若回看第二部分: 一文带你全面解析postman工具的使用(效率篇)

接下来介绍的内容是将是postman的最后一部分-高级篇 。

四. 高级功能介绍

这里所谓的高级功能,都是个人的定义,之所以称为高级,可能比前面的功能使用起来稍显复杂,且使用频率也不是很高,但是这些功能都具有一定的场景性,也就是说当你遇到了解决某一类场景的问题时,正好它也提供了这方面的功能,那么使用起来就非常的方便 。

  • 读取外部文件进行参数化
  • 生成测试报告
  • 使用工作空间
  • 集合同步与分支管理
  • 编写接口文档
  • mock服务
  • 监控
  • 连接数据库

1.读取文件进行参数化

测试过程中,常会遇到一个接口要验证很多的测试数据,而输入参数又都是一样的。这时我们首先就会想到数据参数化(数据驱动),在postman中也提供了数据参数化功能,它需要把数据单独的存放在一个文件中管理,然后通过读取这个文件实现所有的数据的验证。

实现步骤 。

  1. 在本地电脑创建数据文件,支持数据格式文件分别为csv和json 。在文件中分别包括参数名和数据
  2. 其中,在postman中需要读取外部文件的参数名,通过参数名来获取文件中的数据;其中在不同的位置读取方式不同:在URL输入框,Params,Authorization,Headers,Body中读取数据方式为:{{参数名}}。在Pre-request Script和Tests中读取数据方式为:data.参数名
  3. 通过Runner-Data读取数据文件来运行。

案例说明

  • 请求天气接口,输入不同的城市id,会返回不同的城市和天气情况 ,需对返回城市和天气进行验证 。
  1. 创建city.json 或 city.json ,格式如下

一文带你全面解析postman工具的使用(高级篇)

  1. 在请求中替换参数名:city_id,city,weather .
其中city_id在URL中替换,故通过{{}}替换 。
city和weather在Tests中替换,需要通过data.city , data.weather

一文带你全面解析postman工具的使用(高级篇)

  1. 选择数据文件导入

一文带你全面解析postman工具的使用(高级篇)

  1. 查询运行结果

一文带你全面解析postman工具的使用(高级篇)


2.生成测试报告

postman生成测试报告需要一个插件:newman ,并且这个插件需要先安装 。

安装步骤:

  1. 安装nodejs: newman是由nodejs开发,所以要先安装它的运行环境,下载地址:http://nodejs.cn/download/ 。安装成功后需要验证:在cmd窗口中输入node -v,如果输出node的版本信息,则证明安装成功。
  2. 安装newman:安装成功nodejs后,会自动安装一个包管理工具npm(类似于python中的pip)。通过它就可以直接安装newman。 打开cmd窗口输入:npm install -g newman .安装成功后进行验证:newman -v 。如果输出newman的版本信息,则证明安装成功 。
  3. 安装newman-reporter-html:通过这个插件可以指定报告的生成路径和名称。同样打开cmd窗口输入:npm install -g newman-reporter-html.安装成功后进行验证:npm list -g --depth 0.如果能出现newman-reporter-html包及版本及证明安装成功 。

通过newman生成测试报告必须在cmd执行,命令执行:newman run <collection> [options] ,其中options中有很多参数,接下来我们来解析下这些参数。

命令解析:

  • -e : 可选,指定一个URL或者postman的环境变量脚本文件。如果集合中指定了环境变量,则需要添加这个参数。
  • -g:可选,指定一个URL或者postman的全局变量脚本文件,如果集合中指定了全局变量,则需要加这个参数 。
  • -r:可选,指定测试报告的类型,如果想生成对应的报告类型,需要添加这个参数,典型的有html,json,cli,若不添加,默认为cli。
  • -d:可选,指定一个数据参数化文件 ,如果有参数化文件,需要添加这个选项。
  • --reporter-html-export:可选,指定生成报告的路径和文件名,如果不添加该参数,默认会生成一个newman的文件夹,里面存放着生成的测试报告

输入的命令就可以是下面这样的 。

newman run collect_a.json [-e environment_b.json] [-r html] [--reporter-html-export report.html]  其中[]内的参数是可选的。

案例说明:

  • 案例1:通过newman生成测试报告,集合为一个URL。
命令:
newman run https://www.getpostman.com/collections/6e95413b91fe582ec78d  说明:run后面跟的链接可以通过分享得到
  • 案例2:通过newman生成测试报告,报告格式为默认:cli
newman run A.postman_collection.json  -r cli //默认的展示结果如下图所示。

一文带你全面解析postman工具的使用(高级篇)

  • 案例3:通过newman生成测试报告,需要添加环境变量文件,并且生成HTML报告 。
newman run B.postman_collection.json -e test.postman_environment.json -r html
  • 案例4:通过newman生成测试报告,需要制定报告路径和文件名称。
newman run B.postman_collection.json -e test.postman_environment.json -r html --reporter-html-export report.html   //生成的测试报告会存放在当前路径下,报告名为:report.html

更漂亮的报告

安装插件:newman-reporter-htmlextra

打开cmd窗口,输入命令:npm install -g newman-reporter-htmlextra

验证安装:npm list -g --depth 0

生成报告:

newman run APITest.postman_collection.json -r htmlextra --reporter-html-export htmlReport.html

一文带你全面解析postman工具的使用(高级篇)

虽然newman提供了强大的生成测试报告功能,但是目前为止,生成的测试报告都是在我们本地,那如果想要把报告展示给团队成员查看呢 ? 我们就可以通过jenkins进行持续集成,把生成的报告展示在Jenkins上,甚至可以将报告通过邮件发送给团队成员 。

3.使用工作空间

前面我们说集合(Collection)就像一个项目,通过建立一个集合,可以对其集合中的用例进行分类管理;当然如果有多个项目,也可以建多个而项目进行管理。而接下来要学习的工作空间更是对不同集合进行分类管理,比如说我要新建一个自己学习的工作空间,也可以新建一个用于工作的工作空间。这样就可以在不同的工作空间内管理不同的集合,达到集合的有效管理 。

接下来看下工作空间的主要功能介绍:

  • 将元素添加到另外一个工作空间
  • 邀请成员加入工作空间
  • 将集合和环境共享到工作空间
  • 查看工作空间的详细信息
  • 重命名工作区
  • 离开工作区
  • 编辑工作区的描述
  • 管理团队工作区的成员

将元素添加到另外一个工作空间

你可以将集合或环境从一个工作空间添加到另一个工作空间。这样就会使得数据在不同的工作空间内进行共享 。

实现步骤:

  1. 点击postman导航栏中间的工作空间(下三角),选择All workspaces .

一文带你全面解析postman工具的使用(高级篇)

  1. 在弹出的页面中,选择一个工作空间,点击Add to workspace.(向这个工作空间共享数据)

一文带你全面解析postman工具的使用(高级篇)

  • 当然除了添加到工作空间数据外,你也可以进行重命名,进行查看详情,添加成员以及删除工作空间 。具体操作点击Add to workspace后的(...)
  • 你可以将添加后的元素从工作空间删除,就是右击集合,点击‘Remove to workspace’,点击后从工作区中删除
  1. 选择一个要共享的工作空间,选择集合或环境,点击Add to this workspace

一文带你全面解析postman工具的使用(高级篇)

一文带你全面解析postman工具的使用(高级篇)

邀请成员加入工作空间

一个团队的工作空间,往往需要多个团队成员来共同维护,这时如果想往工作空间中加入新成员,就需要通过下面的邀请成员到工作区,具体如下:

实现步骤:

  1. 点击postman导航栏中间的Invite.在弹出的对话输入框输入邮箱地址(邮箱一定要和账号绑定),点击Add 。
  2. 添加到文本域后,给账号设置角色,点击Send Invitarions 。
  3. 进入邮箱点击链接验证,验证成功后即可成员该空间的成员 。同时会自动将该空间的集合同步到本地 。备注:除了以上可添加成员后,也可以通过工作空间后的...,选择Add Members 也可以添加成员。

一文带你全面解析postman工具的使用(高级篇)

将集合和环境共享到工作空间

有时候,我们需要把在本地的集合或环境分享给团队的工作空间中,这样团队其他成员就都可以看到并使用了。

共享集合到工作空间

  1. 选择一个集合,点击(...)或者右键,点击Share Collection .
  2. 在弹出的界面中,选择要共享的工作空间,点击Share and Continue .
  3. 这样该集合就会被该工作空间的所有成员看到并有权限操作,当然上面也可以选择共享给工作空间中部分成员。

一文带你全面解析postman工具的使用(高级篇)

4.集合的分支管理

像git一样,在postman中也有源码管理功能,通过创建团队的workspace,团队成员可以在这个workspace中像git管理源代码一样,创建分支,合并分支,拉取分支等。创建workspace见XXX 。

接下来我们就先来了解下postman的这几个功能 。

  • 创建集合分支(Create a fork)
  • 合并变更(Merge changes)
  • 创建pull请求(Create Pull Request)

创建集合分支

分支的创建,需要基于某个集合中,集合分支创建后, 这就相当于这个集合的主分支,团队成员可以基于这个分支拉取一个新的分支开发,最后将修改的新的脚本合并到主分支上。接下来是创建一个分支:

  1. 选中一个集合,点击(...)或右键,点击“Create a fork”
  2. 在弹出的对话框中输入Fork Label ,选择团队的workspace ,点击“Fork collection” 。
  3. 进入到对应的workspace,就会查看到对应的collection ,这里的集合后都有一个fork的标志。

一文带你全面解析postman工具的使用(高级篇)

合并变更

当我们在集合中加了新的功能后,我们就需要把这些变更提交到主分支上,提交成功后,团队成员也能看到你最新的修改数据了,那么如何进行合并操作呢?

  1. 点击Collection右侧的(...),点击Merge Changes.
  2. 在弹出的页面中,点击右上角的Merge all changes .注意,这时merge时提示已经有最新更新了,postman会提示你pull Changes,这时你可以先拉取最新的变更 ,然后点击 Merge all changes。
  3. 在弹出的新对话框默认选择Merge changes,点击Merge 。

一文带你全面解析postman工具的使用(高级篇)

一文带你全面解析postman工具的使用(高级篇)

创建 Pull 请求

当团队提交了最新修改后,我们就可以通过Create pull Request拉取最新的修改数据 。

操作步骤:

  1. 点击Collection右侧的(...),点击Create pull Request.
  2. 在弹出的页面中,输入title和描述,点击 Create pull Request .
  3. 查看postman请求,最新的更新就会拉取到本地的分支集合中 。

一文带你全面解析postman工具的使用(高级篇)

在使用的过程中,postman中的Create a fork ,Create pull request, Merge change 就特别像git中的create branch ,pull ,push 。

5.编写接口文档

在做接口测试时,经常会出现填写的请求数据不太清楚,这时我们首先会想到的就是接口文档 。但很多时候开发写的文档也不是很完善,更新并不及时 ;亦或是更新了,我们也得跳出工具去找对应的接口文档,用户体验上不太好。所以,现在出现了一些工具既支持接口调试也同时支持文档的查看,无需在工具和文档之间来回切换 。那么在postman中也是支持编写接口文档的 ,而且它的文档功能还非常强大 。

接下来我们介绍postman跟接口文档的相关功能 。

  • 生成文档(链接)
  • 编写文档

生成文档

生成文档有两种方式,直接打开链接和新建API文档。

第一种:直接打开链接非常简单,就是选择一个集合,点击右三角,点击View in web 。

第二种,操作步骤如下:

  1. 点击左上角的New,选择API Documentation .
  2. 弹出的第一个Tab页面有两个选项,是新建一个集合还是从已有集合选择 。根据自己的需求来选择。
  3. 进入到第二个Tab页面,输入对集合的一些基本描述 ,比如基本介绍,认证方式,错误码等 。
  4. 进入到第三个Tab页面,这时会弹出一个链接,直接点击链接就会进入到接口文档页面 。如下图

一文带你全面解析postman工具的使用(高级篇)

以上两个都可以进入文档链接,主要区别在于第二种可以加入一些整体性的说明,如系统概况,认证方式,错误码等 。

另外文档是以web形式展现,所以只要有人知道这个链接,就都可以在浏览器访问 。

编写文档

编写文档同样有两种方式,分别是在本地编辑,或者打开链接在浏览器中编辑 。无论哪种方式,保存成功后都会自动同步,也就是所有人都能看到 。

本地编辑步骤:

  1. 点击集合的右三角,会自动弹出RUN的窗口
  2. 选择一个请求点击后,会出现两个链接按钮,分别是Add a description和Open in builder 。
  3. 点击Add a description,这这里就可以填写接口描述。

在线编辑步骤:

  1. 点击集合的右三角,会自动弹出RUN的窗口
  2. 点击View in web,会在浏览器中自动打开该集合的web链接地址。
  3. 选择其中请求,点击Add a description .

以上两种方式都可以给接口添加文档描述,且都支持markdown语法,编写好的信息也能及时的文档中看到,如下图是给其中一个接口添加的文档信息 。

一文带你全面解析postman工具的使用(高级篇)

同时点击Open in builder这个链接按钮,也能直接打开对应的请求 。

以下是打开的web在线文档,在线文档还有个比较实用的功能,就是为每个请求自动生成不同语言的代码,如果你正好对如何用代码实现不太清楚,那么你就可以直接从这里拷贝

一文带你全面解析postman工具的使用(高级篇)

一文带你全面解析postman工具的使用(高级篇)

6.Mock服务

什么是Mock服务 ?

正常情况下,前端需要调用后端的接口才能完成一个完整的功能实现,但由于后端接口交付的延迟,严重影响了工作效率,这时为了减少对后端接口的依赖,前端开发人员创建一个mock服务器,以模拟每个请求对应的响应。开发人员更加模拟响应进行接口调试,而无需增加后端 。在postman中也支持创建mock服务器。

创建mock服务器

在postman中最常见创建mock服务的两种方式:在运行面板中创建和通过new窗口创建 。

new窗口创建步骤

  1. 点击左上角的New,选择弹出的窗口选择Mock Server。
  2. 需要为即将要创建的Mock Server , 可以从已有的选择,也可以重新创建一个集合 。
  3. 选择对应的mock名称,版本标签,环境等,点击Create Mock Server 。

一文带你全面解析postman工具的使用(高级篇)

面板中创建

  1. 选择集合,点击右三角,在弹出的面板中选择Mocks,点击Create a mock Server.
  2. 在弹出的界面中输入mock server name ,version tag , environment,点击Create mock server 。完成创建

以上两种方式创建,最终结果都会在mock标签中生成一个mock服务器的链接,具体如下:

一文带你全面解析postman工具的使用(高级篇)

创建mock请求

上文我们提到过,接口若不能准时提供给前端人员,我们就需要模拟对应的接口,但是模拟接口前,我们先要确定好接口的请求方法,请求路径,返回状态码,以及响应数据 。至于请求传递的参数我们无需关注 。所以无论通过何种工具去模拟,至少以上几个参数 。

那么通过postman模拟请求,就需要用到example.接下来我们就来了解下如何通过example模拟请求 。

example功能入口

一文带你全面解析postman工具的使用(高级篇)

通过example实现模拟请求步骤:

  1. 选择一个请求,通过发送请求后,点击Save Response中的Save as example。
  2. 这时会自动弹出一个tab页,打开的这个页面其实就是postman的example.也是我们要说的模拟请求 .
  3. 在弹出的example页面,需要将请求方法,请求路径,响应状态码及相应数据填写好 ,点击右上角的Save Example。
  4. 保存成功后,就会在右上角能看到我们要保存的example了 。
  5. 以上步骤相当于创建好了一个模拟请求了,接下来我们就可以通过工具请求这个example(模拟请求)了 。在postman打开一个新的tab页,请求方法填写保存好的example的方法,请求地址要填写mock服务器地址+请求路径,点击Send.就会将预期结果返回 。

一文带你全面解析postman工具的使用(高级篇)


7.监控

postman的监控,和Jenkins中设置的定时任务差不多,用于监控接口的运行情况和性能 。同样的这个功能用于集合。你可以配置多长时间运行一次,到了时间点将自动遍历集合中的每个请求。那么很明显通过这个功能,真正地帮我们实现了自动化 。

创建监视器

同样的创建监视器有两种方法,分别是通过new创建和面板中创建 。 接下来就主要介绍下面板创建的步骤

面板创建实现步骤

  1. 选择集合,点击右三角,弹出的面板中选择Monitors,点击Create a monitor
  2. 在Configuration中配置环境,定时任务,运行地区,以及设置其他偏好,点击Create后即创建了监控。

一文带你全面解析postman工具的使用(高级篇)

一文带你全面解析postman工具的使用(高级篇)

查看监视器

创建好的监视器,就是通过编辑查看监视器中运行的数据 。

一文带你全面解析postman工具的使用(高级篇)


8.连接数据库

对于做接口测试,其中很重要的一个环节就是要连接数据库 , 那么对于我们使用的postman而言,是否也可以进行连库操作呢 ? 答案是肯定的 。这里就需要到一个插件:xmysql.

通过xmysql连库后,xmysql会将数据库中所有表以REST风格的接口形式生成 ,所以后续访问某张表其实就是访问的某个接口,那么对于postman而言,其实也就是相当于访问了某个接口而已。

安装

  1. 安装nodejs: xmysql是由nodejs开发,所以要先安装它的运行环境,下载地址:http://nodejs.cn/download/ 。安装成功后需要验证:在cmd窗口中输入node -v,如果输出node的版本信息,则证明安装成功。
  2. 安装xmysql:安装成功nodejs后,会自动安装一个包管理工具npm(类似于python中的pip)。通过它就可以直接安装xmysql。 打开cmd窗口输入:npm install -g xmysql.

连接数据库

xmysql命令参数介绍:

-h  连接数据库主机名
-u  连接数据库用户名
-p  连接数据库密码
-d  连接数据库名
-r  连接数据库输入的主机名,无这个选项默认为localhost
-n  连接这个服务设置的端口,无这个选项默认为3000

举例:

> xmysql -u username -p password -d databasename

连接本地数据库的示例,注意输入这条命令后,xmysql会以服务的形式启动 。所以当xmysql被停止掉,那么连库操作也会失败 。

一文带你全面解析postman工具的使用(高级篇)

数据库的基本操作

以下是我其中一张表t_book的数据,我们通过xmysql来对这张表分别进行增,删,改,查 。再次强调,无论何种操作,在postman中只是请求的是接口 。

一文带你全面解析postman工具的使用(高级篇)


需求1:查询t_book表的所有数据。

GET http://localhost:3000/api/t_book

一文带你全面解析postman工具的使用(高级篇)

需求2:查询t_book表title为三国演义的数据。

GET http://localhost:3000/api/t_book?_where=(title,eq,三国演义)

需求3:向t_book表插入一条数据

插入数据需要先知道表结构,t_book的表结构如下图,那么向这张表插入数据,其实就是将这些字段作为参数输入即可 。它支持两种请求,表单和json都可以请求

一文带你全面解析postman工具的使用(高级篇)

postman中是这样请求的,如果是修改数据直接把POST修改成PUT就可以了。

一文带你全面解析postman工具的使用(高级篇)


需求4:删除其中一条数据。

DELETE http://localhost:3000/api/t_book/5   //5是表中的ID值

xmysql用法

关系表

xmysql自动识别外键关系并提供GET API。

/api/blogs/103/comments

例如:blogs是父表,comments是子表。API调用将产生blogs主键103的所有注释。

分页

p和_size

p表示页面,size表示每页的数据量

默认情况下,每个GET请求在一个表上返回20条记录,最多返回100条记录。

/api/payments?_size=50
/api/payments?_p=2
/api/payments?_p=2&_size=50

当_size大于100时-记录数默认为100(即最大)

当_size小于或等于0时-记录数默认为20(即最小值)

排序

ASC(升序)

/api/payments?_sort=column1

例如:按column1升序排序

降序

/api/payments?_sort=-column1

例如:按column1降序排序

多个字段排序

/api/payments?_sort=column1,-column2

例如:按column1升序排序,按column2降序排序

列过滤/字段

/api/payments?_fields=customerNumber,checkNumber

例如:在每条记录的响应中仅获取customerNumber和checkNumber

/api/payments?_fields=-checkNumber

例如:获取表行中的所有字段,但不获取checkNumber

运算符

比较运算符

eq      -   '='         -  (colName,eq,colValue)
ne      -   '!='        -  (colName,ne,colValue)
gt      -   '>'         -  (colName,gt,colValue)
gte     -   '>='        -  (colName,gte,colValue)
lt      -   '<'         -  (colName,lt,colValue)
lte     -   '<='        -  (colName,lte,colValue)
is      -   'is'        -  (colName,is,true/false/null)
in      -   'in'        -  (colName,in,val1,val2,val3,val4)
bw      -   'between'   -  (colName,bw,val1,val2) 
like    -   'like'      -  (colName,like,~name)   note: use ~ in place of % 
nlike   -   'not like'  -  (colName,nlike,~name)  note: use ~ in place of %

使用比较运算符

/api/payments?_where=(checkNumber,eq,JM555205)~or((amount,gt,200)~and(amount,lt,2000))

逻辑运算符

~or     -   'or'
~and    -   'and'
~xor    -   'xor'

使用逻辑运算符

例如:简单的逻辑表达式

/api/payments?_where=(checkNumber,eq,JM555205)~or(checkNumber,eq,OM314933)

例如:复杂的逻辑表达式

/api/payments?_where=((checkNumber,eq,JM555205)~or(checkNumber,eq,OM314933))~and(amount,gt,100)

例如:具有排序(sort),分页(p),列过滤(_fields)的逻辑表达式

/api/payments?_where=(amount,gte,1000)&_sort=-amount&p=2&_fields=customerNumber

例如:使用_where的行过滤器也可用于关系路由URL。

/api/offices/1/employees?_where=(jobTitle,eq,Sales%20Rep)

查找一条数据

/api/tableName/findOne?_where=(id,eq,1)

与list相似,但仅返回前一个结果。与_where结合使用 ⤴️

计数

/api/tableName/count

返回表中的行数 ⤴️

判断是否存在

/api/tableName/1/exists

根据记录是否存在返回真或假 ⤴️

按查询参数分组

/api/offices?_groupby=country

例如:选择国家/地区,从办事处按国家/地区计数(*)

/api/offices?_groupby=country&_having=(_count,gt,1)

例如:SELECT country,count(1)as _count FROM office GROUP BY country_count> 1

以API分组

/api/offices/groupby?_fields=country

例如:选择国家/地区,从办事处按国家/地区计数(*)

/api/offices/groupby?_fields=country,city

例如:从办事处选择国家,城市,计数(*)GROUP BY国家,城市

/api/offices/groupby?_fields=country,city&_having=(_count,gt,1)

例如:SELECT country,city,count(*)as _count FROM office GROUP BY country_city _count> 1

分组依据,排序依据

/api/offices/groupby?_fields=country,city&_sort=city

例如:通过办事处选择国家,城市,数量(*),按国家,城市分组,按城市ASC

/api/offices/groupby?_fields=country,city&_sort=city,country

例如:从办事处选择国家,城市,数量(*)按国家分组,按城市ASC订购,国家ASC

/api/offices/groupby?_fields=country,city&_sort=city,-country

例如:从办事处选择国家,城市,计数(*)按国家分组,城市按城市ASC,国家DESC。