php单元测试进阶（8）- 核心技术 - 桩件(stub) -

php单元测试进阶（8）- 核心技术 - 桩件(stub) - 属性注入桩件

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

本系列文章根据php的语法与使用习惯做了改编。所有代码在本机测试通过。如转载请注明出处。
上一篇文章介绍了如何用构造方法注入桩件，代码特别容易看懂。可是缺点是修改了原先的设计，改构造方法算是修改了代码意图，同时假如桩件太多，代码就特别丑陋。
可以用依赖注入类库例如pimple来解决，但还是不好。

本文介绍使用属性获取和设置的方法来注入桩件，代码易读易写。其实这个方法和构造方法注入没有多大差别。
一个接口和它的两个实现无需改代码，需要修改的类有被测类日志分析器类，和测试类。

源代码

（1）t2\application\index\controller下被测类，日志分析器
LogAnalyzer.php

<?php
namespace app\index\controller;

/**
 * 日志分析器类，也是被测类
 * 
 * 注意，这是用属性注入的例子。
 */
class LogAnalyzer
{
    /**
     * @var IExtensionManager
     */
    private $manager;
    
    public function __construct()
    {
        $this->manager = new FileExtensionManager();
    }
    
    public function setManager($mgr)
    {
        $this->manager = $mgr;
    }
    
    public function getManager()
    {
        return $this->manager;
    }
    
    /**
     * 判断文件名是否有效，调用另一个类来实现
     * @param string $filename
     */
    public function isValidLogFileName($filename)
    {
        return $this->manager->isValid($filename);
    }
}

测试代码

（2）t2\tests\index\controller\下，测试类，用属性注入桩件
LogAnalyzerTest.php

<?php
namespace tests\index\controller;

/**
 * 测试用的类
 */
class LogAnalyzerTest extends \think\testing\TestCase
{

    /**
     * @test
     * 使用属性注入桩件的方法 进行测试
     * 注意，尽量使得测试的方法名称有意义，这非常重要，便于维护测试代码。有规律
     */
    public function isValidFileName_NameSupportedExtension_ReturnTrue()
    {
        //准备好一个返回true的桩件
        $myFakeManager = new FakeExtensionManager();
        $myFakeManager->willBeValid = true; 
        
        //开始创建被测类的对象，准备测试
        $analyzer = new \app\index\controller\LogAnalyzer();
        $analyzer->setManager($myFakeManager); // 属性注入
        $result = $analyzer->isValidLogFileName("short.ext");
        $this->assertTrue($result);
    }
}

cmd下测试通过。

上一篇：php单元测试进阶（7）- 核心技术 - 桩件(stub) - 构造函数注入桩件
下一篇：php单元测试进阶（9）- 核心技术 - 桩件(stub) - 工厂类注入桩件