php单元测试进阶(13)- 核心技术 - mock对象 - 同时使用mock和stub

php单元测试进阶(13)- 核心技术 - mock对象 - 同时使用mock和stub

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

本系列文章根据php的语法与使用习惯做了改编。所有代码在本机测试通过。如转载请注明出处。
假设需求变更,更加复杂一些。
如文件名过短,则web服务记录日志,但万一记录过程中发生异常,需发送一封邮件。
要求测试发送邮件是成功的。

源代码有2个接口,一个被测类。
测试代码有2个伪对象类,一个测试类。

源代码

(1)\t2\application\index\controller下,错误日志接口
IWebService.php

(2)\t2\application\index\controller下,邮件接口
IEmailService.php

(3)被测类,实现万一抛异常,就发邮件这个功能。\t2\application\index\controller下,
LogAnalyzer.php

service = $service;
        $this->email = $email;
    }
    
    /**
     * 分析日志,省略无关功能,检查文件名过短,记录错误日志,可能发生异常。
     * @param string $filename
     */
    public function analyze($filename)
    {
        if (strlen($filename) < 8 ) {
            try {
                $this->service->logError("Filename too short:{$filename}");
            } catch ( \Exception $e ) {
                $this->email->sendEMail("[email protected]", "can not log", $e->getMessage());
            }
        }
        // 做一些其他的事情。
        // ... ...
    }
}

测试代码

(4)\t2\tests\index\controller下,实现错误日志接口的桩件类
FakeWebService.php

toThrow) {
            throw $this->toThrow;
        }
    }
}

(5)\t2\tests\index\controller下,实现邮件接口的mock类,要断言的
FakeEmailService.php

to = $to;
        $this->subject = $subject;
        $this->body = $body;
    }
}

(6)测试类,主要断言了抛异常时,邮件发送成功。\t2\tests\index\controller下,
LogAnalyzerTest.php

toThrow = new \Exception("fake exception");
        
        //创建mock对象,好断言
        $mockEmail = new FakeEmailService();
        
        // 创建被测类的对象,注入mock对象和桩件
        $analyzer = new \app\index\controller\LogAnalyzer($stubService, $mockEmail);
        $tooShortFileName= 'abc.ext';
        
        //调用被测对象
        $analyzer->analyze($tooShortFileName);
        
        // 注意是对mock对象断言!!
        $this->assertEquals($mockEmail->to, "[email protected]");
        $this->assertEquals($mockEmail->subject, "can not log");
        $this->assertEquals($mockEmail->body, "fake exception");
    }
}

cmd下测试通过。

总结

原作者认为:

  1. 一个测试中,应该最多只有一个mock对象,所有其他伪对象都应该是桩件。如有多个mock对象,应分成多个测试,确保每个测试只有一个mock对象。
  2. 一个测试只能断言工作单元三种最终结果中的一种。3种结果是,断言返回值,断言对象或系统状态,断言对象交互。目的要明确。如果有多个不同的测试意图,应分成多个测试。

你可能感兴趣的:(php单元测试进阶(13)- 核心技术 - mock对象 - 同时使用mock和stub)