软件测试论坛 › [测试用例设计] › 测试用例详解

lsekfe 发表于 2016-3-14 14:13:43

测试用例详解

在上篇文章中介绍了如何使用PHPUnit进行单元测试，现在我就来谈谈如何编写测试用例以及怎样保证测试的全面性。通常的测试用例继承自PHPUnit_Framework_TestCase类，其中的每个测试都以test开头，而且声明为公共类型public。每个测试用例都有一个构建方法setUp()和拆除方法tearDown()，分别在每个测试执行之前和之后执行，这两个方法都声明为被保护类型protected。测试语句的类型包括断言、标记跳过、标记未完成。自动生成的测试类使用标记未完成来表示该测试未完成，在测试条件不满足的情况下要使用标记跳过，如测试Oracle数据库驱动时没有Oracle数据库环境、Linux下无法测试SQL Server数据库驱动等。测试结果包括成功、失败和错误。出现错误的结果说明你的代码中有语法或运行时错误，这些错误要首先被解决。标记未完成在开始写测试用例时，我们使用标记跳过来表示测试是未完成的，这样做和什么都不写的区别是后者会认为测试是成功的，而你可能会在之后忘了写测试。PHP代码

[*]
[*]class UnitTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 测试Hello()方法
[*]   */
[*]    public function testHello()
[*]    {
[*]      $this->markTestIncomplete('这是一个未完成的测试');
[*]    }
[*]}
[*]?>

标记跳过使用标记跳过来跳过不满足测试条件的情况，避免出现错误而影响测试结果。PHP代码

[*]
[*]class UnitTest extends PHPUnit_Framework_TestCase
[*]{
[*]    protected function setUp()
[*]    {
[*]      // 该测试用例需要xxx扩展，如果不满足就跳过
[*]      if (!extension_loaded('xxx')) {
[*]            $this->markTestSkipped('这是一个跳过的测试');
[*]      }
[*]    }
[*]}
[*]?>

断言布尔类型
assertTrue   断言为真
assertFalse断言为假NULL类型
assertNull   断言为NULL
assertNotNull断言非NULL数字类型
assertEquals             断言等于
assertNotEquals          断言不等于
assertGreaterThan      断言大于
assertGreaterThanOrEqual 断言大于等于
assertLessThan         断言小于
assertLessThanOrEqual    断言小于等于字符类型
assertEquals          断言等于
assertNotEquals       断言不等于
assertContains      断言包含
assertNotContains   断言不包含
assertContainsOnly    断言只包含
assertNotContainsOnly 断言不只包含数组类型
assertEquals          断言等于
assertNotEquals       断言不等于
assertArrayHasKey   断言有键
assertArrayNotHasKey断言没有键
assertContains      断言包含
assertNotContains   断言不包含
assertContainsOnly    断言只包含
assertNotContainsOnly 断言不只包含对象类型
assertAttributeContains         断言属性包含
assertAttributeContainsOnly       断言属性只包含
assertAttributeEquals             断言属性等于
assertAttributeGreaterThan      断言属性大于
assertAttributeGreaterThanOrEqual 断言属性大于等于
assertAttributeLessThan         断言属性小于
assertAttributeLessThanOrEqual    断言属性小于等于
assertAttributeNotContains      断言不包含
assertAttributeNotContainsOnly    断言属性不只包含
assertAttributeNotEquals          断言属性不等于
assertAttributeNotSame            断言属性不相同
assertAttributeSame               断言属性相同
assertSame                        断言类型和值都相同
assertNotSame                     断言类型或值不相同
assertObjectHasAttribute          断言对象有某属性
assertObjectNotHasAttribute       断言对象没有某属性class类型
class类型包含对象类型的所有断言，还有
assertClassHasAttribute          断言类有某属性
assertClassHasStaticAttribute    断言类有某静态属性
assertClassNotHasAttribute       断言类没有某属性
assertClassNotHasStaticAttribute 断言类没有某静态属性文件相关
assertFileEquals   断言文件内容等于
assertFileExists   断言文件存在
assertFileNotEquals断言文件内容不等于
assertFileNotExists断言文件不存在XML相关
assertXmlFileEqualsXmlFile      断言XML文件内容相等
assertXmlFileNotEqualsXmlFile   断言XML文件内容不相等
assertXmlStringEqualsXmlFile      断言XML字符串等于XML文件内容
assertXmlStringEqualsXmlString    断言XML字符串相等
assertXmlStringNotEqualsXmlFile   断言XML字符串不等于XML文件内容
assertXmlStringNotEqualsXmlString 断言XML字符串不相等有返回值的方法或函数根据其类型选择相应的断言，下面是一个简单例子。PHP代码

[*]
[*]class UnitTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 测试返回值为布尔类型
[*]   */
[*]    public function testReturnBool()
[*]    {
[*]      // 实际情况把TRUE和FALSE换为被测试方法或函数
[*]      $this->assertTrue(TRUE);
[*]      $this->assertFalse(FALSE);
[*]    }
[*]    /**
[*]   * 测试返回值为字符串类型
[*]   */
[*]    public function testReturnString()
[*]    {
[*]      $expected = 'string';
[*]      // 实际情况把下面的'string'换为被测试方法或函数
[*]      $result = 'string';
[*]      $this->assertEquals($expected, $result);
[*]    }
[*]    /**
[*]   * 测试返回值是数字类型
[*]   */
[*]    public function testReturnInt()
[*]    {
[*]      $expected = 10;
[*]      // 实际情况把20换为被测试方法或函数
[*]      $result = 20;
[*]      $this->assertGreaterThan($expected, $result);
[*]    }
[*]    /**
[*]   * 测试返回值是数组类型
[*]   */
[*]    public function testReturnArray()
[*]    {
[*]      // 实际情况把$result赋值为被测试方法或函数
[*]      $result = array('test' => 'hello');
[*]      // 实际情况把'test'换为要测试的键名称
[*]      $this->assertArrayHasKey('test', $result);
[*]    }
[*]    /**
[*]   * 测试返回值是对象类型
[*]   */
[*]    public function testReturnObject()
[*]    {
[*]      // 实际情况把$this换为期望的对象
[*]      $expected = $this;
[*]      // 实际情况把$this换为被测试方法或函数
[*]      $result = $this;
[*]      $this->assertSame($expected, $result);
[*]    }
[*]}
[*]?>

无返回值的方法，可以通过其他方法读取属性，也可以使用对象类型中的断言来判断属性的改变。PHP代码

[*]
[*]/**
[*] * Unit类，有一个无返回值方法
[*] */
[*]class Unit
[*]{
[*]    protected $name;
[*]    /**
[*]   * 设置name属性
[*]   */
[*]    public function setName($value)
[*]    {
[*]      $this->name = $value;
[*]    }
[*]}
[*]?>

PHP代码

[*]
[*]require_once 'Unit.php';
[*]
[*]class UnitTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 测试无返回值的方法
[*]   */
[*]    public function testsetName()
[*]    {
[*]      $expected = 'Hello';
[*]      $o = new Unit();
[*]      $o->setName('Hello');
[*]      $this->assertAttributeEquals($expected, 'name', $o);
[*]    }
[*]}
[*]?>

编写测试编写测试的原则是，尽可能测试每种不同的参数调用和不同的返回结果类型，既要测试成功的情况，也要测试失败的情况；无返回值的情况，要测试属性改变、输出内容、异常类型等；测试后记得要恢复现场。在这里做了超出自己能力的事并不光荣。在你写某个函数之前，你只想让它做加法，但它却能做乘法，而且单元测试正确通过。我们来看看它是怎么做到的。PHP代码

[*]
[*]/**
[*] * 计算器类
[*] */
[*]class Calculator
[*]{
[*]    /**
[*]   * 做加法运算
[*]   *
[*]   * @paramint$a
[*]   * @paramint$b
[*]   * @return int
[*]   */
[*]    public function add($a, $b)
[*]    {
[*]      return $a * $b;
[*]    }
[*]}
[*]?>

PHP代码

[*]
[*]require_once 'Calculator.php';
[*]
[*]class CalcuatorTest extends PHPUnit_Framework_TestCase
[*]{
[*]    public function testadd()
[*]    {
[*]      // 创建实例
[*]      $c = new Calculator();
[*]      $expected = 4;
[*]      // 做加法
[*]      $result = $c->add(2, 2);
[*]      $this->assertEquals($expected, $result);
[*]    }
[*]}
[*]?>

合理的测试能帮助我们尽早发现错误。add()方法有两个参数，测试的时候用了两个值相同的参数。如果多做几次测试又太麻烦，对于这个测试我们按照科学的方法只需要一次。从概率学上讲，当你使用的参数差异越大时，结果相同的概率越低。对于只有几个返回值的情况，要测试全部，如布尔类型。PHP代码

[*]
[*]/**
[*] * File.php
[*] */
[*]
[*]/**
[*] * 在文件中写入数据并保存
[*] *
[*] * @paramstring$path
[*] * @paramstring$data
[*] * @return bool
[*] */
[*]function Save($path, $data)
[*]{
[*]    if (is_dir($path)) {
[*]      return FALSE;
[*]    }
[*]
[*]    return file_put_contents($path, $data);
[*]}
[*]?>

PHP代码

[*]
[*]/**
[*] * FileTest.php
[*] */
[*]
[*]require_once 'File.php';
[*]
[*]class FileTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 测试保存文件
[*]   */
[*]    public function testSave()
[*]    {
[*]      $file = 'IamFile.txt';
[*]      $dir = 'IamDir';
[*]      mkdir($dir);
[*]
[*]      // 测试返回值为真的情况
[*]      $this->assertTrue(Save($file, 'TestTrue'));
[*]
[*]      // 测试返回值为假的情况
[*]      $this->assertFalse(Save($dir, 'TestFalse'));
[*]
[*]      // 恢复现场
[*]      if (is_file($file)) {
[*]          unlink($file);
[*]      }
[*]      rmdir($dir);
[*]    }
[*]}
[*]?>

对于有多种类型返回值或不同参数的情况，分别测试每种类型和参数。下面是ThinkPHP源代码中的一个函数，有点复杂。这个例子不能单独运行，如需要请用SVN导出最新的ThinkPHP源代码（含单元测试）。PHP代码

[*]
[*]/**
[*] * URL生成函数
[*] *
[*] * @paramstring$action方法名
[*] * @paramstring$module模块名
[*] * @paramstring$route   路由名
[*] * @paramarray   $params参数
[*] */
[*]function url($action=ACTION_NAME,$module=MODULE_NAME,$route='',$app=APP_NAME,$params=array())
[*]{
[*]    if(C('DISPATCH_ON') && C('URL_MODEL')>0) {
[*]      switch(C('PATH_MODEL')) {
[*]            case 1:// 普通PATHINFO模式
[*]                $str    =   '/';
[*]                foreach ($params as $var=>$val)
[*]                  $str .= $var.'/'.$val.'/';
[*]                $str = substr($str,0,-1);
[*]                if(!emptyempty($route)) {
[*]                  $url    =   str_replace(APP_NAME,$app,).'/'.C('VAR_ROUTER').'/'.$route.'/'.$str;
[*]                }else{
[*]                  $url    =   str_replace(APP_NAME,$app,).'/'.C('VAR_MODULE').'/'.$module.'/'.C('VAR_ACTION').'/'.$action.$str;
[*]                }
[*]                break;
[*]            case 2:// 智能PATHINFO模式
[*]                $depr   =   C('PATH_DEPR');
[*]                $str    =   $depr;
[*]                foreach ($params as $var=>$val)
[*]                  $str .= $var.$depr.$val.$depr;
[*]                $str = substr($str,0,-1);
[*]                if(!emptyempty($route)) {
[*]                  $url    =   str_replace(APP_NAME,$app,).'/'.$route.$str;
[*]                }else{
[*]                  $url    =   str_replace(APP_NAME,$app,).'/'.$module.$depr.$action.$str;
[*]                }
[*]                break;
[*]      }
[*]      if(C('HTML_URL_SUFFIX')) {
[*]            $url .= C('HTML_URL_SUFFIX');
[*]      }
[*]    }else{
[*]      $params =   http_build_query($params);
[*]      if(!emptyempty($route)) {
[*]            $url    =   str_replace(APP_NAME,$app,).'?'.C('VAR_ROUTER').'='.$route.'&'.$params;
[*]      }else{
[*]            $url    =   str_replace(APP_NAME,$app,).'?'.C('VAR_MODULE').'='.$module.'&'.C('VAR_ACTION').'='.$action.'&'.$params;
[*]      }
[*]    }
[*]    return $url;
[*]}
[*]?>

PHP代码

[*]
[*]require_once 'functions.php';
[*]
[*]class functionsTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 确认url()返回预期的字符串
[*]   */
[*]    public function testurl()
[*]    {
[*]      define('', 'index.php');
[*]
[*]      C('VAR_MODULE', 'module');
[*]      C('VAR_ACTION', 'action');
[*]      C('VAR_ROUTER', 'route');
[*]
[*]      // 测试通常模式URL
[*]      $uri = url('Index', 'Home', '', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php?module=Home&action=Index&q=test&msg=OK', $uri);
[*]
[*]      // 测试通常模式路由
[*]      $uri = url('Index', 'Home', 'default', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php?route=default&q=test&msg=OK', $uri);
[*]
[*]
[*]      C('DISPATCH_ON', true);
[*]      C('URL_MODEL', 1);
[*]      C('PATH_MODEL', 1);
[*]
[*]      // 测试普通PATHINFO模式URL
[*]      $uri = url('Index', 'Home', '', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php/module/Home/action/Index/q/test/msg/OK', $uri);
[*]
[*]      // 测试普通PATHINFO模式路由
[*]      $uri = url('Index', 'Home', 'default', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php/route/default/q/test/msg/OK', $uri);
[*]
[*]      C('PATH_MODEL', 2);
[*]      C('PATH_DEPR', '/');
[*]
[*]      // 测试智能PATHINFO模式URL
[*]      $uri = url('Index', 'Home', '', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php/Home/Index/q/test/msg/OK', $uri);
[*]
[*]      // 测试智能PATHINFO模式路由
[*]      $uri = url('Index', 'Home', 'default', APP_NAME, array('q' => 'test', 'msg' => 'OK'));
[*]      $this->assertEquals('index.php/default/q/test/msg/OK', $uri);
[*]    }
[*]}
[*]?>

异常测试有时程序执行了非法操作而抛出异常，我们需要模拟某个异常，然后捕捉它是否触发了该异常。PHP代码

[*]
[*]class UnitTest extends PHPUnit_Framework_TestCase
[*]{
[*]    /**
[*]   * 测试异常
[*]   */
[*]    public function testException()
[*]    {
[*]      // 期望Exception异常
[*]      $this->setExpectedException('Exception');
[*]
[*]      // 抛出Exception异常
[*]      throw new Exception('TestException');
[*]    }
[*]}
[*]?>

输出测试有时某个方法并不返回而输出某些内容，我们需要继承PHPUnit_Extensions_OutputTestCase类来捕捉输出内容。PHPUnit默认不载入扩展类，需要自己加载。PHP代码

[*]
[*]// 载入输出测试用例扩展
[*]require_once 'PHPUnit/Extensions/OutputTestCase.php';
[*]
[*]class UnitTest extends PHPUnit_Extensions_OutputTestCase
[*]{
[*]    /**
[*]   * 测试输出
[*]   */
[*]    public function testOutput()
[*]    {
[*]      // 期望输出的内容是字符串 'Hello'
[*]      $this->expectOutputString('Hello');
[*]
[*]      // 输出 'Hello'
[*]      echo 'Hello';
[*]    }
[*]}
[*]?>

数据库测试PHPUnit的数据库测试并不完善，只提供了assertTablesEqual和assertDataSetsEqual两个断言与createFlatXMLDataSet和createXMLDataSet创建XML数据集的方法。无法进行全面的数据操作测试，建议使用DBUnit。附录PHPUnit断言参考
assertArrayHasKey($key, array $array, $message = '')
assertArrayNotHasKey($key, array $array, $message = '')
assertAttributeContains($needle, $haystackAttributeName, $haystackClassOrObject, $message = '')
assertAttributeContainsOnly($type, $haystackAttributeName, $haystackClassOrObject, $isNativeType = NULL, $message = '')
assertAttributeEquals($expected, $actualAttributeName, $actualClassOrObject, $message = '', $delta = 0, $maxDepth = 10, $canonicalizeEol = FALSE)
assertAttributeGreaterThan($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertAttributeGreaterThanOrEqual($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertAttributeLessThan($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertAttributeLessThanOrEqual($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertAttributeNotContains($needle, $haystackAttributeName, $haystackClassOrObject, $message = '')
assertAttributeNotContainsOnly($type, $haystackAttributeName, $haystackClassOrObject, $isNativeType = NULL, $message = '')
assertAttributeNotEquals($expected, $actualAttributeName, $actualClassOrObject, $message = '', $delta = 0, $maxDepth = 10, $canonicalizeEol = FALSE)
assertAttributeNotSame($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertAttributeSame($expected, $actualAttributeName, $actualClassOrObject, $message = '')
assertClassHasAttribute($attributeName, $className, $message = '')
assertClassHasStaticAttribute($attributeName, $className, $message = '')
assertClassNotHasAttribute($attributeName, $className, $message = '')
assertClassNotHasStaticAttribute($attributeName, $className, $message = '')
assertContains($needle, $haystack, $message = '')
assertContainsOnly($type, $haystack, $isNativeType = NULL, $message = '')
assertEqualXMLStructure(DOMNode $expectedNode, DOMNode $actualNode, $checkAttributes = FALSE, $message = '')
assertEquals($expected, $actual, $message = '', $delta = 0, $maxDepth = 10, $canonicalizeEol = FALSE)
assertFalse($condition, $message = '')
assertFileEquals($expected, $actual, $message = '', $canonicalizeEol = FALSE)
PHPUnit官方文档
http://www.phpunit.de/manual/3.3/en/index.html

Miss_love 发表于 2016-3-14 16:24:18

白盒用例

cheny3628 发表于 2016-6-1 17:48:47

感谢分享！

查看完整版本: 测试用例详解