Testing of API（15步）

API测试的整体思路：（15步）

 

1，用文本存储用于测试用例的数据

   问题：如何在一个简单的文本里闯将并存储用于API测试用例的数据。
   方法：使用冒号作为分隔符的文本文件，这个文件包含一个唯一的测试用例ID，一个或者多个输入值和期望结果

2，读入测试用例数据

   问题：如何从测试用例文件（简单的文本文件）中读入每条测试用例。
   方法：通过while循环遍历测试用例文件的每一行，使用System.IO.StreamReader对象读入测试用例

3，将从文本中读出的string数据解析为测试用例

   问题：如何解析出由字符分隔开的测试用例的各个字段。
   方法：使用String.Split()方法，把分隔符作为方法的输入传给Split()方法，然后将返回值存入一个字符数组。
         Split()方法的参数是一个字符数组。

4，把数据转换为合适的类型

   问题：如何把测试用例的输入数据或者期望结果从string类型转换为其他的数据类型，这样就可以把转化后的数据传给待测方法或者把期望结果与实际结果进行比较。
   方法：通过选用合适的静态Parsee()方法，实施显式的类型转换。
 

5，判定测试用例是否通过
   问题：如何判定API测试用例是通过还是失败。
   方法：调用待测方法，传给它测试用例的输入，得到返回值，然后通过actual.ToString()转换成实际值的字符串与从测试用例中读入的期望结果expect的字符串比较，实质是进行字符串比较。看是否一致

6，记录测试用例结果

   问题：如何把测试用例的结果存入独立于测试程序的简单文本文件。
   方法：在处理测试用例的主循环中，使用一个System.IO.StreamWriter对象，把测试用例ID和测试结果写到一个文本文件中。

7，给测试用例加上时间戳

   问题：如何给测试用例结果加上时间戳，以便于区分不同批次的运行结果。
   方法：把DateTime.Now.ToString("s")属性作为字符串参数传给CreateDirectory()这个静态方法，创建一个带有时间戳的文件夹。或者，把DateTime.Now.ToString("s")属性作为字符串参数传给FileStream()的构造函数，来创建一个带时间戳的文件名。

8，通过计算对测试结果进行总结

   问题：如何计算测试用例的结果以追踪通过的（pass）用力和失败用例的个数。
   方法：使用简单的整数计数器，在每次开始运行测试的时候，把计数器初始化为0。

9，获得测试运行的总时间

   问题：如何获得测试运行的总时间
   方法：通过把DateTime.Now属性记录测试开始运行的时间start，以及测试结束的时间end，然后用一个TimeSpan对象=end-start计算本次运行的总时间。

10，处理输入为空或者期望值为空的情况
   问题：如何验证待测程序的API方法能否正确地处理传给它的null参数。
   方法：使用一个特殊的字符串标记来表示测试用例数据文件里的null值。在测试套件里添加相应的处理逻辑，把null标记转换成null输入值。

11，处理“方法抛出异常”的情况

   问题：如何测试一个抛出异常的方法。
   方法：在测试用例数据文件中嵌入一个特殊的字符串标记，用来表示应该有一个异常被抛出，把待调用的待测方法放到一个try块里，这样如果有异常抛出，就可以捕获它。

12，处理输入参数为空字符串的情况
   问题：如何测试传给待测API方法的参数为空字符串的情况
   方法：使用一个特殊的字符串标记来表示测试用例文件中的空字符串，并且在测试套件中加入相应的逻辑处理分支，把真正的空字符串作为参数传给待测得API方法。

13，编写程序，在测试用例失败时发送警告邮件。  
   问题：如何编写程序让测试套件在测试用例失败的时候发送邮件信息，或者将测试结果报告以邮件的方式发送。
   方法：使用System.Web.Mail命名空间里的MailMessage来创建一个MailMessage对象。然后为这个对象提供To和Subject等属性值，并且把测试用例失败的详细信息添加到它的Body属性。

14，自动运行测试套件。
   问题：如何让测试套件在某一时间自动开始运行
   方法：通过Windows Task Scheduler在Windows环境下可以很容易地实现任务调度。

15，多个轻量级测试套件自动执行

   问题：如何自顺次执行多个轻量级
   方法：如果有好几个轻量级自动化测试套件需要运行，则可以通过创建批处理.bat文件，在里面加上运行它们的命令，来实现批量处理。 此外，如果测试套件本身就能把测试用例结果记录到了外部文件，那么只需要在Bat里面写顺次执行他们的命令就好了。如果测试套件只是把测试用例结果输出到命令行程序，则可以通过系统重定向很容易把这些结果存储到外部文件。

****************************************************************************

待测方法:

using System; using System.Collections.Generic; using System.Linq; using System.Text; namespace MathLib { public class Method { public static double AverageMean(params int[] vals) { double result; int len = vals.Length; int i = 0, sum = 0; while (i <= len - 1) { sum += vals[i]; i++; } result = sum / len; return result; } public static int Sum(params int[] vals) { int sum = 0; for (int i = 0; i <= vals.Length - 1; i++) { sum += vals[i]; } return sum; } public double Sub(double x, double y) { if (x >= y) return x - y; else return y - x; } public double Multi(double x, double y) { return x * y; } public static double Div(int x, int y) { if (y != 0) { return x / y; } else { Console.WriteLine("The dividend is not available, please check"); return 0; } } } }

 

用文本记录的测试Case信息数据:

0001:AverageMean:2 4 8:4.6667 0002:Multi:1 5:3.0000 0003:AverageMean:1 2 4 6 16 32:10.5000 0004:Div:36 3:12.0000

 

测试程序:

using System; using System.Collections.Generic; using System.Linq; using System.Text; using MathLib; using System.IO; using System.Xml; //using System.Runtime.InteropServices; namespace APITesting { class Program { static void Main(string[] args) { try { #region 文件流操作 //读取文件 FileStream ifs = new FileStream(@"C:/Users/btslabs/Desktop/TE/API/TestData/testData.txt", FileMode.Open); StreamReader sr = new StreamReader(ifs); //创建文件，并且写入数据 FileStream ofs = new FileStream(@"C:/Users/btslabs/Desktop/TE/API/TestData/testResult.txt", FileMode.CreateNew); StreamWriter sw = new StreamWriter(ofs); #endregion string line; //string cnt; //while ((line = sr.ReadLine())!= null) //{ // //Display each line of the data file. // cnt = line; // cnt += "/n"; // Console.WriteLine(cnt); //} //Console.ReadLine(); //disassemble the data file and get the test data string method, caseID; string expected; double actual = 0.0; string[] tokens, tempInput; //定义两个变量，作为case,pass 与 fail的计数器 int numPass = 0, numFail = 0; //用一个while循环读取文本中的测试数据，并且逐行执行测试用例 #region 读取文本中的测试数据，并且执行测试 while ((line = sr.ReadLine()) != null) { //string.Split(char[]),Split()方法的参数是一个字符数组。 //把一行测试用例数据读入一个字符串变量后，调用split()方法， //把冒号作为参数传给split()方法，意味着一个只有一个字符元素':'的字符数组. //得到的结果就是原字符串中以冒号分开的各个部分， //然后把这些子字符串作为数组元素赋给字符串数组tokens.每一个tokens的数组元素都是一项测试数据。 //每一行是一个case, 每个case有4个字段，先通过split()方法解析出每个字段 //其值暂时未string类型，以待以后用parse()方法转换为期望类型。 tokens = line.Split(':'); caseID = tokens[0]; method = tokens[1]; tempInput = tokens[2].Split(' '); expected = tokens[3]; //将字符串类型用parse()方法转换为期望类型int,赋值给一个整型数组 int[] input = new int[tempInput.Length]; for (int i = 0; i <= tempInput.Length - 1; i++) { input[i] = int.Parse(tempInput[i]); } //if (method == "AverageMean") //{ // actual = Method.AverageMean(input); // if (actual.ToString("F4") == expected) // Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", // caseID,method,actual.ToString("F4")); // else // Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", // caseID, method, expected, actual.ToString("F4")); //} //else if (method == "Sum") //{ // actual = Method.Sum(input); // if (actual.ToString("F4") == expected) // Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", // caseID, method, actual.ToString("F4")); // else // Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", // caseID, method, expected, actual.ToString("F4")); //} //else if.................... //因为待测方法较多，分支较多，所以这里用switch较好。 switch (method) { case "AverageMean": actual = Method.AverageMean(input); if (actual.ToString("F4") == expected) { Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); sw.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); ++numPass; } else { Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); sw.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); ++numFail; } break; case "Sum": actual = Method.Sum(input); if (actual.ToString("F4") == expected) { Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); sw.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); ++numPass; } else { Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); sw.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); ++numFail; } break; case "Sub": Method mtd = new Method(); actual = mtd.Sub((double)input[1], (double)input[0]); if (actual.ToString("F4") == expected) { Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); sw.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); ++numPass; } else { Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); sw.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); ++numFail; } break; case "Multi": Method mtd1 = new Method(); actual = mtd1.Multi((double)input[1], (double)input[0]); if (actual.ToString("F4") == expected) { Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); sw.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); ++numPass; } else { Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); sw.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); ++numFail; } break; case "Div": actual = Method.Div(input[0], input[1]); if (actual.ToString("F4") == expected) { Console.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); sw.WriteLine("Case {0} Passed, the method is {1}, Value is {2}", caseID, method, actual.ToString("F4")); ++numPass; } else { Console.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); sw.WriteLine("Case {0} Failed, the method is {1}, expected is {2}, but the actual is {3}", caseID, method, expected, actual.ToString("F4")); ++numFail; } break; } } #endregion Console.WriteLine("/n===================end test run===================="); Console.WriteLine("/nPass= " + numPass.ToString() + "/nFail= " + numFail.ToString()); Console.ReadKey(); sw.WriteLine("/n===================end test run===================="); sw.WriteLine("Pass= " + numPass.ToString()); sw.WriteLine("Fail= " + numFail.ToString()); sr.Close(); ifs.Close(); sw.Close(); ofs.Close(); } catch (Exception ex) { Console.WriteLine("Fatal error: " + ex.Message); } Console.ReadLine(); } } }

 

测试输出结果:

Case 0001 Failed, the method is AverageMean, expected is 4.6667, but the actual is 4.0000 Case 0002 Failed, the method is Multi, expected is 3.0000, but the actual is 5.0000 Case 0003 Failed, the method is AverageMean, expected is 10.5000, but the actual is 10.0000 Case 0004 Passed, the method is Div, Value is 12.0000 ===================end test run==================== Pass= 1 Fail= 3