《PHP设计模式介绍》第六章伪对象模式(2)--一起PHP技术联盟

《PHP设计模式介绍》第六章伪对象模式(2)

(接上)
最后一部分是创建响应。为了最终在浏览器中显示，我们必须处理那不断增长的HTML内容，如果必要的话我们也会讨论HTTP重定向。（你也可以执行其他的http头的操作——这样说是为了能构隐藏它——在一个成熟的做法中，但这里使用的是一段更简单的代码，是为了使例子容易理解与关注。）

class Response {
var $_head=’’;
var $_body=’’;
function addHead($content) {
$this->_head .= $content;
}
function addBody($content) {
$this->_body .= $content;
}
function display() {
echo $this->fetch();
}
function fetch() {
return ‘<html>’
.’<head>’.$this->_head.’</head>’
.’<body>’.$this->_body.’</body>’
.’</html>’;
}
function redirect($url, $exit=true) {
header(‘Location: ‘.$url);
if ($exit) exit;
}
}

给出了这些模块后，也是时候将这些新开发的、已测试的组件聚合到一个页面中了。让我们写一个最终的类来协调这个页面的所以行为，取个合适的名字PageDirector。类PageDirector具有一个很简单的运用程序接口：你在实例化后可以用调用它的run()方法。

这个“bootstrap”文件运行新程序时应如下所示：

<?php
require_once ‘classes.inc.php’;
define(‘SELF’, ‘http://www.example.com/path/to/page.php’);
$page =& new PageDirector(new Session, new Response);
$page->run();
?>

该文件包含了所需的已定义类，并为自己定义了一个常量，给PageDirector类（其用于传递类Session 和类Response所依赖的实例来组成构造函数）创建了一个实例来执行PageDirector::run()方法。

现在让我们来创建一些测试的实例来详细说明重构后的运用程序应该有的功能。

require_once ‘simpletest/unit_tester.php’;
require_once ‘simpletest/reporter.php’; require_once ‘simpletest/mock_objects.php’; require_once ‘simpletest/web_tester.php’;
require_once ‘classes.inc.php’; Session::init();
class PageWebTestCase extends WebTestCase { /*...*/ } class ResponseTestCase extends UnitTestCase { /*...*/ } class UserLoginTestCase extends UnitTestCase { /*...*/ } class SessionTestCase extends UnitTestCase { /*...*/ }
class PageDirectorTestCase extends UnitTestCase { /*...*/ }
$test = new GroupTest(‘Application PHP4 Unit Test’);
$test->addTestCase(new PageWebTestCase);
$test->addTestCase(new ResponseTestCase);
$test->addTestCase(new UserLoginTestCase);
$test->addTestCase(new SessionTestCase);
$test->addTestCase(new PageDirectorTestCase);

这段代码或多或少的展示了一个典型的运用程序的测试文件该是何种模样。它一开始就包含了一些SimpleTest文件，也包括了用伪对象来测试的mock_object.php文件。接着，那些辅助类被包含进来，方法Session::init()被调用，seesion开始。

紧接着的全是以“安全无害”为目标而开始的测试实例，类WebTestCase确保所有程序按要求执行，然后是单独的用于新设计的类的测试（尽管这种类本章不会详述）。最后是我们接下去会讨论的PageDirectorTestCase类。

类PageDirector的核心任务是协调类Session和类Response的对象，产生最终的网页输出结果。

Mock::Generate(‘Session’);
Mock::Generate(‘Response’);
define(‘SELF’, ‘testvalue’);
class PageDirectorTestCase extends UnitTestCase {
// ...
}

在这段代码的一开始，Mock::generate()创建了伪对象类的定义并定义了一个后面将要用到的常量。

假设对类Session 和类 Response的测试已经存在，下一步就是创建伪Session来模拟类 Session的状态。这个伪对象的设置和我们一开始所演示的例子极其类似。

因为PageDirector::run()方法正回显内容，你可以用输出缓存内容的办法来捕获它，看看是否正确。

class PageDirectorTestCase extends UnitTestCase {
// ...
function TestLoggedOutContent() {
$session =& new MockSession($this);
$session->setReturnValue(‘get’, null, array(‘user_name’));
$session->expectOnce(‘get’, array(‘user_name’));
$page =& new PageDirector($session, new Response);
ob_start();
$page->run();
$result = ob_get_clean();
$this->assertNoUnwantedPattern(‘/secret.*content/i’, $result);
$this->assertWantedPattern(‘/<form.*<input[^>]*text[^>]*’
.’name.*<input[^>]*password[^>]*passwd/ims’
,$result);
$session->tally();
}
}

这段代码证明了在SimpleTest中使用伪对象的必要性。我们来看看其中创建伪对象的一行代码$session =&new MockSession($this)。你可以使用继承自SimpleStub类（参见http://simpletest.sf.net/SimpleTest/MockObjects/SimpleStub.html#sec-methodsummary)的方法来创建你所希望的从对象(如同你在测试代码时所做的那样)返回的结果.下一步，实例化PageDirector类并用MockSession代替正式使用时的类来实例化相关代码。

注：setReturnValue()方法

setReturnValue()方法通过指定当伪对象的特定方法被调用时返回何值来让伪对象以一个“替身”的身份融入代码。已经有了一些这种方法的变体：比如指定以一定次序返回一系列值的做法，还有以参数代替值来返回结果的做法。

expectOnce()方法

expectOnce()方法通过建立一些假想，这些假想是关于什么时候方法被调用以及多久调用一次，来允许你的伪对象以“批评者”的角色来测试代码。这些假想当你在测试中调用伪对象的tally()方法时会被报告。

class PageDirector {
var $session;
var $response;
function PageDirector(&$session, &$response) {
$this->session =& $session;
$this->response =& $response;
}
}

因为PageDirector类认为自己不是处于一个测试环境而是处于一个真实正常的运用程序环境中，它回显结果到浏览器。既然你实际上在测试时并不希望这个动作，你就可以通过PHP输出缓存的特性（参见http://php.net/outcontrol）来捕获执行时它往浏览器发送了什么。

class PageDirector {
// ...
function run() {
if (!$this->isLoggedIn()) {
$this->showLogin();
}
this->response->display();
}
function isLoggedIn() {
return ($this->session->get(‘user_name’)) ? true : false;
}
function showLogin() {
$this->response->addBody(‘<form method=”post”>’);
$this->response->addBody(‘Name:<input type=”text” name=”name”>’);
$this->response->addBody(“\n”);
$this->response->addBody(
‘Password:<input type=”password” name=”passwd”>’);
$this->response->addBody(“\n”);
$this->response->addBody(‘<input type=”submit” value=”Login”>’);
$this->response->addBody(‘</form>’);
}
}
如同这段程序代码一样，测试代码本身也可以进行重构。在本例中，你可以看到缓存输出的诀窍是其将被多次复用，因此使用“析构法”重构可以使测试本身简化。（重新调用的那些以“test”为开头的方法是随整个测试一起自动运行的；你也可以自己创建一些使测试更简洁的方法。）

下面的代码段演示了缓存输出被重构为runPage方法的结果，它给人的感觉就像是当用户登录时另一个对输出的测试。

class PageDirectorTestCase extends UnitTestCase {
// ...
function TestLoggedOutContent() {
$session =& new MockSession($this);
$session->setReturnValue(‘get’, null, array(‘user_name’));
$session->expectOnce(‘get’, array(‘user_name’));
$page =& new PageDirector($session, new Response);
$result = $this->runPage($page);
$this->assertNoUnwantedPattern(‘/secret.*content/i’, $result);
$this->assertWantedPattern(‘/<form.*<input[^>]*text[^>]*’
.’name.*<input[^>]*password[^>]*passwd/ims’
,$result);
$session->tally();
}
function TestLoggedInContent() {
$session =& new MockSession($this);
$session->setReturnValue(‘get’, ‘admin’, array(‘user_name’));
$session->expectAtLeastOnce(‘get’);
$page =& new PageDirector($session, new Response);
$result = $this->runPage($page);
$this->assertWantedPattern(‘/secret.*content/i’, $result);
$this->assertNoUnwantedPattern(‘/<form.*<input[^>]*text[^>]*’
.’name.*<input[^>]*password[^>]*passwd/ims’
,$result);
$session->tally();
}
function runPage(&$page) {
ob_start();
$page->run();
return ob_get_clean();
}
}

接下来，将加入一个检查条件到PageDirector::run()方法来看看用户是否已经登录并决定显示什么模板：

class PageDirector {
// ...
function run() {
if ($this->isLoggedIn()) {
$this->showPage(
new UserLogin($this->session->get(‘user_name’)));
} else {
$this->showLogin();
}
$this->response->display();
}
function showPage(&$user) {
$vars = array(
‘name’ => $user->name()
,’self’ => SELF
);
$this->response->addBodyTemplate(‘page.tpl’, $vars);
}
}

page.tpl看上去可能像这样：

Welcome <?php echo $name; ?>
<br>Super secret member only content here.
<a href=”<?php echo $self; ?>?clear”>Logout</a>

此时，MockSession扮演了ServerStub的角色来控制决定用户是否登录的条件。它的功能也类似评判者，决定这个信息是否通过如下两个途径被正确的使用：一个是明确地被预先定义并通过tally()被验证，另一个是不直接的生成正确的输出，而是通过ServerStub返回的值来生成。

为了继续重构这段代码，下一步要跳到前面的进程。将要做两个动作：清除已经登录的用户和验证登录页面提交的用户名和密码是否存在。

让我们从注销功能上开始：

class PageDirectorTestCase extends UnitTestCase {
// ...
function TestClearLoginFunctionality() {
$_REQUEST[‘clear’] = null;
$session =& new MockSession($this);
$session->expectOnce(‘clear’, array(‘user_name’));
$session->setReturnValue(‘get’, null, array(‘user_name’));
$session->expectAtLeastOnce(‘get’);
$response = new MockResponse($this);
$response->expectOnce(‘redirect’, array(SELF));
$page =& new PageDirector($session, $response);
$this->assertEqual(‘’, $this->runPage($page));
$response->tally();
$session->tally();
unset($_REQUEST[‘clear’]);
}
}

在这段代码中，response是个伪对象，然而，一旦在Response::redirect()方法中调用了exit()，脚本将会停止执行。由于伪对象的存在，你可以核实方法是否被调用和方法传回了什么参数，且不会产生任何负面影响——如脚本停止——或被实际执行。

下面是是一些帮助你认识测试功能的代码：

class PageDirector {
// ...
function run() {
$this->processLogin();
if ($this->isLoggedIn()) {
$this->showPage(
new UserLogin($this->session->get(‘user_name’)));
} else {
$this->showLogin();
}
$this->response->display();
}
function processLogin() {
if (array_key_exists(‘clear’, $_REQUEST)) {
$this->session->clear(‘user_name’);
$this->response->redirect(SELF);
}
}
}

最后是对登录表单的处理进行的测试。

class PageDirectorTestCase extends UnitTestCase {
// ...
function TestLoginFromRequest() {
$_REQUEST[‘name’] = ‘admin’;
$_REQUEST[‘passwd’] = ‘secret’;
$session =& new MockSession($this);
$session->expectOnce(‘set’, array(‘user_name’,’admin’));
$response = new MockResponse($this);
$response->expectOnce(‘redirect’, array(SELF));
$page =& new PageDirector($session, $response);
$this->assertEqual(‘’, $this->runPage($page));
$response->tally();
$session->tally();
unset($_REQUEST[‘name’]);
unset($_REQUEST[‘passwd’]);
}
}

如下是实现上面测试所要求特性的代码：

class PageDirector {
// ...
function processLogin() {
if (array_key_exists(‘clear’, $_REQUEST)) {
$this->session->clear(‘user_name’);
$this->response->redirect(SELF);
}
if (array_key_exists(‘name’, $_REQUEST)
&& array_key_exists(‘passwd’, $_REQUEST)
&& UserLogin::validate(
$_REQUEST[‘name’], $_REQUEST[‘passwd’])) {
$this->session->set(‘user_name’, $_REQUEST[‘name’]);
$this->response->redirect(SELF);
}
}
}

这段程序已经重构而且也有充分的测试，因此可以对其进行一些附加的重构来清除像主脚本访问Session类，查询不经UserLogin类认可的字段而去访问‘user_name’字段，及session被当成资源调用等的小毛病。

当$_REQUEST这个超级变量被封装为一个类似Session类的资源以便与伪对象的创建时，为何让代码访问它？这段    代码有很多问题：但它毕竟是某种人为的用来逐渐了解这些概念的例子，它是为此而被创造的所以你不必深究。

更为重要的是，你已经学会利用伪对象测试模式来分离代码，以及在测试中分离$_SESSION之类的资源和避免相互关联的对象（如包含在Response类中的exit()）产生不希望的结果。

问题

使用伪对象来测试代码可以让你分离所开发的代码。你可以消除负面影响和潜在的问题，极大地减少你在整个测试工作中所花的时间。这是一个好消息，因为如果你花在测试上的时间越多，以后就会越省事，并且你也会希望测试不是只做一次，应该能够被重复进行。（译注：这句直译太别扭，所以加了些使其通顺的内容。）

在新重构的程序中仍然会有许多漏洞。比如$_REQUEST变量应该由一个类来封装以便于使用伪对象测试。又如   showLogin()方法的重新调用。再如所有那些addBody()方法的调用看起来是如此混乱。

这种编程风格的另一个缺点是你将无法使用任何所见即所得的HTML编辑工具，这是因为所有HTML代码都被包含在PHP的方法调用中了。为了避免这些限制，你可以加入一个简单的基于PHP的模板机制。你可以这样引入模板文件：

<form method=”post”>
Name:<input type=”text” name=”name”> Password:<input type=”password” name=”passwd”>
<input type=”submit” value=”Login”>
</form>

然后需要使用一个方法来调用它：

class Response {
// ...
/**
* adds a simple template mechanism to the response class
* @param string $template the path and name of the template file
* @return void
*/
function addBodyTemplate($template, $vars=array()) {
if (file_exists($template)) {
extract($vars);
ob_start();
include $template;
$this->_body .= ob_get_clean();
}
}
}

很明显的，世上没有最完美的模板引擎，但它确实使本章的示例代码精简整洁了。

在GoF中这种按任务进行分隔的概念是被鼓励的：

“分隔设计模式下对象被创建后，其子类的创建过程就可以不再关注了。”

	页数1/1: 首页 « 1 » 末页
发表回复：您还没有登陆，无法发表回复。请先[登陆]