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) - 工廠類注入樁件