php单元测试进阶（5）- 入门 – 异常测试

本系列文章主要代码与文字来源于《单元测试的艺术》，原作者：Roy Osherove。译者：金迎。

本系列文章根据php的语法与使用习惯做了改编。所有代码在本机测试通过。如转载请注明出处。

新的需求，源代码中如果发现参数为空，将抛异常。
修改后的新的源代码如下

<?php
namespace app\index\controller;

/**
 * 日志分析器类，也是被测类
 *
 */
class LogAnalyzer
{
    /**
     * 判断文件名是否有效，.slf结尾的文件名就是有效的，返回真
     * @param string $filename
     */
    public function isValidLogFileName($filename)
    {
        if (empty(trim($filename))) {
            throw new \Exception("参数不能为空的异常出现");
        }
        if (!preg_match('/\.SLF$/i', $filename)){
            return false;
        }
        return true;
    }
}

为此需编写新的测试来判断异常，注意，异常的判断放到了php的方法注释里去了，看起来很先进的样子。同时注意到，这里不但断言了异常的类型是Exception，同时断言了异常包含的消息内容。也可以不断言消息内容，随意。
修改后的测试代码如下：

<?php
namespace tests\index\controller;

class LogAnalyzerTest extends \think\testing\TestCase
{

    /**
     * @test
     * @dataProvider isValidFileName_Provider
     * 注意，尽量使得测试的方法名称有意义，这非常重要，便于维护测试代码。有规律
     */
    public function isValidFileName_VariousExtensions_ChecksThem($filename, $boo)
    {
        $analyzer = new \app\index\controller\LogAnalyzer();
        $result = $analyzer->isValidLogFileName($filename);
        $this->assertEquals($result, $boo);
    }
    
    public function isValidFileName_Provider()
    {
        return array(
            array("file_with_bad_extension.foo", false),
            array("file_with_good_extension.slf", true),
            array("file_with_good_extension.SLF", true),
        );
    }
    
    /**
     * @test
     * @expectedException        Exception
     * @expectedExceptionMessage 参数不能为空的异常出现
     */
    public function isValidFileName_EmptyFileName_Throws()
    {
        $analyzer = new \app\index\controller\LogAnalyzer();
        $analyzer->isValidLogFileName('');
    }
    
}

cmd下，重新执行测试，通过。

上一篇：php单元测试进阶（4）- 入门 – 使用参数化测试
下一篇：php单元测试进阶（6）- 核心技术 – 桩件(stub)