应用场景：在API的测试中，测试某些具体数据值，比如返回的结果是否是需求的类型，文件是否是符合且具备完整的数据结构。这些都是必须且很细致的测试工作。另外，组织、运行测试场景，以及演示测试结果这些也都使得测试人员要更加快速的找到合适的API测试方法。今天就详细地介绍如何用Karate组织、运行测试场景，以及验证Json 文件数据的正确性。

　　如果您想跟着以下示例操作，需要做好以下配置：

　　测试框架:Java + Karate + Junit 5

　　语言: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 的分配和运行状况。

作者：胡军英

来源：51Testing软件测试网原创