应用场景:在API的测试中,测试某些具体数据值,比如返回的结果是否是需求的类型,文件是否是符合且具备完整的数据结构。这些都是必须且很细致的测试工作。另外,组织、运行测试场景,以及演示测试结果这些也都使得测试人员要更加快速的找到合适的API测试方法。今天就详细地介绍如何用Karate组织、运行测试场景,以及验证Json 文件数据的正确性。
如果您想跟着以下示例操作,需要做好以下配置:
语言:Java, Cucumber
IDE:Intellij IDEA
项目类型:Maven
Karate 项目配置
为了能让跟着步骤操作的小伙伴们真正地运行起代码来,所以下面是有关配置的操作(注:如您已经熟悉这些配置,可以跳过。)
1.创建一个新的Maven 项目
2.POM配置 (这里介绍的清楚一些,有时就是因为配置没设好,脚本就是运行不起来。)
3.配置 Cucumber
依次打开Files > Settings > Plugins : 确保cucumber for Java 和Gherkin 插件已经安装成功。
创建 Karate 测试用例
1.创建测试场景 (feature 文件)
如下图显示,本示例中country-get.feature 文件前面有一个绿色的图标,这就是cucumber feature 文件的标识。
2.编写测试场景
背景 Background: 本示例中,url 和 header 是所有测试用例中共用的一部分,所以就把它们写在了Background中。
用例一:测试get method 并验证响应代码,文件长度以及第一个字段值 (期待成功)
文件长度:这里实际是指返回的一个json数组里包含了多个.json 文件,比如本实返回了250个文件
@Value: @ 注释 是测试人员组织测试用例时非常好用的小工具。我们可以一组类似的测试用例用 相同的 @ 把它它们标识出来,这样运行的时候根据需求也可以分组执行。
Given: path 从下图中可以看出,path 只是后面的一部分而已,当运行的时候,会和Background 中的url自动地连接在一起。 相当于https://restcountries.eu/rest/v2/all
When: 本例中我们测试 get 请求
Then, And : 这是本例中要验证的结果,期待请求发表以后,会收到成功的返回代码: 200, 并且包含有 250 文件,同时第一个.json文件的第一层nativeName 要等于验证的字符串。(注:在第二截图里显示了实际返回的nativeName 值)
用例二 :测试带有参数的get method 并验证响应代码,文件长度以及国家名称 (期待成功)
本例中多加了一个参数:相当于请求 https://restcountries.eu/rest/v2/name/aruba?fullText=true
用例三:测试带有参数的get method 并验证响应代码和返回的文件内容 (期待失败)
本示例是测试当请求有误时,系统的响应信息。和前一个示例不同的是,把国家的名字给错了,请求的url:https://restcountries.eu/rest/v2/name/arubaq?fullText=true
在验证时,第一个match 中期待返回的status 是一整型, 第二match中期待返回的status是一个字符型。根据实际返回信息 (如下图二), status应该是一个整型。
注: 这个用例中的@Contents 与前二个示例不同. (在运行文件中,您能切身体会有什么效果了。)
创建运行文件
如下图所示,这里创建5 种运行方式 ( @Karate.Test)。下面我们依次介绍如下:
·testTags(): 运行同一文件夹里country-get.feature 里面标记是@Value的测试场景
·testSingle(): 运行同一文件夹里country-get.feature 里面所有的测试场景
·testFullPath(): 指定运行feature 文件夹里country-get.feature 里面标记是@Contents 的测试场景
·testPost(): 想运行country-post.feature文件中的所有测试场景 (注:这里是一种错误的写法,文件运行不起来,因为当前文件夹下没有country-post.feature 文件)
·testinFeaturePost(): 指定运行featurepost 文件夹里country-post.feature文件中的所有测试场景
·testAll(): 指定运行同一文件夹里所有feature文件中的所有测试场景
现在各位朋友清楚了在feature文件中,各个场景里@的不同意义了吧。同时写这么多运行方式也是想让大家更加明了当你有不同的需求时,如何快捷地运行你的测试场景。
脚本运行
1.运行在IDE
右键点击CountryRunnerTest文件,在弹出的菜单列表中点击 Run CountryRunnerTest。 收割的时候到了,快看一下结果吧。
如下图(运行结果一)所示,从左边的窗口中, 可以看出
1) testAll() 运行了country-get.feature 和sample.feature 两个文件。country-get中显示运行了3个场景: 2 个成功,1个失败。
2)失败的场景结果中: 我们设计去验证status 应该是整型而不是字符型,右边窗口显示了指示出清晰的错误原因
3)testTags(): 只运行了两个成功的场景 @Value
4)testFullPath(): 只运了失败的场景 @Contents
运行结果一:
如下图(运行结果二)所示,从左边的窗口中, 可以看出
1)testTagsPost(): 没有运行,因为没有找到对应feature 文件或场景
2)testTagsPostinFeaturePost(): 运行正确
运行结果二:
2.运行通过命令行
·指定运行某一个方法
执行命令: mvn test -Dtest=CountryRunnerTest#testFullPath
CountryRunnerTest: java class 文件名
#testFullPath: 指定运行测试 (注:这里就是CountryRunnerTest文件中的运行方法)
·运行单个文件
移除其它的运行方法
执行命令: mvn test (注:当用这个命令时,运行的文件名必须是*Test.java)
3.并行运行Parallel Run
·创建CountryPallelTest.java 文件。 如下图所示,classpath:feature 是指当前的package feature, parallel: 示例中有2 thread to run country-get.feature and sample.feature (注: 把先前CountryRunnerTest文件名改为CountryRunner)
·执行 mvn test
·如下图示,结果中显示 threads: 2, passed: 2 , failed:1
(注: 这里的两个feature 文件运行了1个,ignored: 1, 是因为sample.feature 是一个空文件)
4.如果您在运行时遇到错误信息: The forked VM terminated without properly saying goodbye. VM crash or System.exit called? 可以执行: mvn clean install
报告测试结果
1.Karate 报表
以执行mvn test -Dtest=CountryRunnerTest#testFullPath 为例,运行完毕以后,target文件夹会自动生成,展开target > surefire-reports文件夹,找到feature.country-get.html,右键点击,在显示的菜单列表中点击Open in Browser ,选择您想要找开文件的browser。
如下图所示,karate 的报告中显示出很明确请求连接url与验证失败的原因。
2.并行运行报告
从产生的目录结构中,可以看出并行运行的结果与单个运行结果的报表是不同:
Timeline.html中很明确显示了3个测试场景在2 threads 的分配和运行状况。
邀你进群❤一起学习交流、听免费直播、答疑解惑
想要成为优秀的测试架构师,找到高薪工作,首先你得从人群中冒出来,要想冒出来,你就必须做到与众不同,要做到与众不同,你就要会得更多!
成为技术大牛梦想虽然很美好,但是要付出很多,都需要花费时间、金钱和精力,测试理论知识、缺陷管理规范、测试流程、设计及编写测试用例这些都是必备的技能。
我期待对测试感兴趣的人,都能成为软件测试生力军~
没有过不去的火焰山,没有破不掉的技术难题,只要你敢,肯下功夫,都会取得最终的胜利。只要你想学习,完全可以参照老师的学习路线图来执行哦。