php單元測試進階(11)- 核心技術(shù) - 樁件(stub) - 不使用樁件
本系列文章主要代碼與文字來源于《單元測試的藝術(shù)》柿究,原作者:Roy Osherove裕坊。譯者:金迎变抽。
本系列文章根據(jù)php的語法與使用習(xí)慣做了改編匕坯。所有代碼在本機測試通過蜻底。如轉(zhuǎn)載請注明出處骄崩。
上文介紹了通過創(chuàng)建一個局部的方法調(diào)用返回樁件聘鳞,然后測試時用派生的子類來進行測試薄辅。
但是對于本文的示例來說,還有更簡單的辦法抠璃,不用樁件站楚,也不用接口。
在被測類中搏嗡,不是添加返回樁件的方法窿春,而是添加直接返回計算結(jié)果的方法,然后在子類中覆蓋這個方法采盒,以此來回避對文件系統(tǒng)等外部依賴的調(diào)用旧乞。
因為這個方法最簡單,所以可以優(yōu)先考慮使用磅氨。
來對比一下上文的代碼:需要去除接口尺栖,去除測試類中的接口實現(xiàn)。保留文件管理器類烦租,保留被測類延赌。修改被測類子類,修改被測類叉橱。
上文是源代碼3個文件挫以,測試代碼3個文件。
現(xiàn)在是源代碼2個文件窃祝,測試代碼2個文件掐松。
下面是全部代碼:(所有的代碼都有改動)
源代碼
(1)t2\application\index\controller下文件管理器類,實現(xiàn)了上面的接口粪小,但是實際被排除在單元測試之外甩栈,不測它。應(yīng)該使用集成測試來測試此類糕再。
FileExtensionManager.php
<?php
namespace app\index\controller;
/**
* 文件管理器類
*
*/
class FileExtensionManager
{
/**
* 根據(jù)某個配置文件的內(nèi)容判斷文件名是否有效
* @param string $filename
*/
public function isValid($filename)
{
// 會使用file_get_contents函數(shù)讀取某個文件的內(nèi)容
// 這里為了簡略不寫量没,因為不是重點。
return true;
}
}
(2)t2\application\index\controller下被測類突想,日志分析器殴蹄。使用了調(diào)用直接返回計算結(jié)果的方式來寫代碼究抓,便于派生類覆蓋,然后測試
LogAnalyzer.php
<?php
namespace app\index\controller;
/**
* 日志分析器類袭灯,也是被測類
*
* 注意刺下,這是不用樁件和接口的例子。
*/
class LogAnalyzer
{
/**
* 判斷文件名是否有效稽荧,調(diào)用另一個類來實現(xiàn)
* @param string $filename
*/
public function isValidLogFileName($filename)
{
return $this->isValid($filename);
}
/**
* @param string $filename
* @return boolean
*/
protected function isValid($filename)
{
return (new FileExtensionManager())->isValid($filename);
}
}
測試代碼
(3)t2\tests\index\controller\下橘茉,被測試類的子類,用于覆蓋直接返回計算結(jié)果的方法姨丈,便于測試畅卓。因為這個子類測試專用,所以當(dāng)然放在測試文件夾下蟋恬。
LogAnalyzerExtend.php
<?php
namespace tests\index\controller;
/**
* 測試輔助類翁潘,是源代碼被測類的子類。用于覆蓋原被測類的方法歼争,便于測試拜马。
* 這里還允許外部注入屬性,以便于控制方法返回的結(jié)果沐绒。
*/
class LogAnalyzerExtend extends \app\index\controller\LogAnalyzer
{
/**
* @var boolean
*/
public $isSupported;
/**
* 覆蓋原方法俩莽,便于測試
* @return boolean
*/
protected function isValid($filename)
{
return $this->isSupported;
}
}
(4)t2\tests\index\controller\下,最后是測試類乔遮,但不是測試被測試類扮超,而是測試被測試類的子類。和上文不同的是申眼,覆蓋的是直接返回計算結(jié)果的方法瞒津。上文覆蓋返回產(chǎn)生樁件的方法。
LogAnalyzerTest.php
<?php
namespace tests\index\controller;
/**
* 測試用的類
*/
class LogAnalyzerTest extends \think\testing\TestCase
{
/**
* @test
* 使用覆蓋父類的直接返回計算結(jié)果的方法 進行測試
* 注意括尸,盡量使得測試的方法名稱有意義巷蚪,這非常重要,便于維護測試代碼濒翻。有規(guī)律
*/
public function isValidFileName_NameSupportedExtension_ReturnTrue()
{
//開始創(chuàng)建被測類的子類的對象屁柏,并注入控制的結(jié)果到字段里
$analyzer = new LogAnalyzerExtend();
$analyzer->isSupported = true;
//調(diào)用并斷言
$result = $analyzer->isValidLogFileName("short.ext");
$this->assertTrue($result);
}
}
cmd下測試通過。