.

一、 DBQuery对象

现在，我们的DBQuery对象简单地效仿一个存储过程—一旦被执行，即返回一个必需进行保存的结果资源;并且假如你想使用该结果集上的函数 (例如num_rows()或fetch_row())的话，你必需传送MySqlDB对象。那么，假如由DBQuery对象来实现MySqlDB对象 (其设计目的是对一个执行查询的结果进行操作)实现的函数，效果如何呢?让我们持续使用上一篇示例中的代码;并且让我们假定，现在由DBQuery对象管 理我们的结果资源。DBQuery类的源码如列表1所示。

列表1.使用DBQuery类。

require ‘mysql_db.php’; require_once ‘query.php’; $db = new MySqlDb; $db->connect(‘host’， ‘username’， ‘pass’); $db->query(‘use content_management_system’); $query = new DBQuery($db); $query->prepare(‘SELECT fname，sname FROM users WHERE username=:1S AND pword=:2S AND expire_time<:3I’); try { if($query->execute(“visualad”， “apron”， time()))->num_rows() == 1) { echo(‘Correct Credentials’); } else { echo(‘Incorrect Credentials / Session Expired’); } } catch (QueryException $e) { echo(‘Error executing query: ‘ . $e); }

上面修改后的代码中我们最感爱好的是，catch语句和execute语句。

◆execute语句不再返回一个结果资源，现在它返回DBQuery对象本身。

◆DBQuery对象现在实现num_rows()函数—我们从DB接口中已经熟悉。

◆假如查询执行失败，它抛出一个QueryException类型的异常。当被转换成一个字符串时，它将返回发生的错误的细节信息。

为此，你需要使用PHP代理。事实上，你在我们的DBQuery对象中已经使用代理了，但是现在将更为深入地使用它来把它与MySqlDB对象 紧密绑定。该DBQuery对象已经被使用一个实现DB接口的对象初始化，并且它已经包含一个成员函数execute—由它调用DB对象的query() 方法来执行该查询。这个DBQuery对象本身并不实际地查询数据库，它把这项任务交由DB对象来完成。这就是代理，其实是一个进程—借助于这个进程，通 过把消息发送给另一个实现相同的或类像 破裂行为的对象，一个对象可以实现一个非常的行为。

为此，你需要修改DBQuery对象以便包括所有的函数—它们操作一个来自DB对象的结果资源。当执行查询以调用DB对象的相应函数并且返回它 的结果时，你需要使用存储的结果。下列函数将被添加：

列表2:使用代理扩展DBQuery类。

class DBQuery { ….. public function fetch_array() { if (! is_resource($this->result)) { throw new Exception(‘Query not executed.’); } return $this->db->fetch_array($this->result); } public function fetch_row() { if (! is_resource($this->result)) { throw new Exception(‘Query not executed.’); } return $this->db->fetch_row($this->result); } public function fetch_assoc() { if (! is_resource($this->result)) { throw new Exception(‘Query not executed.’); } return $this->db->fetch_assoc($this->result); } public function fetch_object() { if (! is_resource($this->result)) { throw new Exception(‘Query not executed.’); } return $this->db->fetch_object($this->result); } public function num_rows() { if (! is_resource($this->result)) { throw new Exception(‘Query not executed.’); } return $this->db->num_rows($this->result); } }

每个函数的实现相当简单。它首先进行检察，以确保已经执行查询，然后把任务代理倒DB对象，返回它的结果就好象它是查询对象本身(称作是基本数 据库函数)一样。

二、 类型提示(Type Hinting)

为了使代理能够工作，我们需要确保DBQuery对象的$db变量是一个实现了DB接口的对象的实例。类型提示是PHP 5中的一种新特征，它能够使你把函数参数强制转换成特定类型的对象。在PHP 5之前，{wy}的确保函数参数是一个特定对象类型的方法是使用PHP中所提供的类型检察函数(也即是is_a())。现在，你可以简单地强制转换对象类型— 通过在函数参数的前面加上类型名。你已经从我们的DBQuery对象中看倒了类型提示，这样可以确保一个实现DB接口的对象被传送倒对象构造器中。

public function __construct(DB $db) { $this->db = $db; }

当使用类型提示时，你不仅可以指定对象类型，还可以指定抽象类和接口。

三、 抛出异常

你可能已经从上面的代码中注重倒，你捕捉的是一个称为QueryException(我们将在后面实现这个对象)的异常。一个异常类像 破裂于一个错 误，然而却更具有一般性。描述一个异常的{zh0}的方法是使用emergency。无论一个emergency可以不会是“致命的”，但是还是必需处理它。当 在PHP中抛出一个异常时，执行的当前范围很快地被终止，不管它是一个函数，try..catch块还是脚本本身。然后，该异常遍历调用栈—终止每个执行 范围，直倒或者在一个try..catch块中捕捉它或者它倒达调用栈的顶部—此时它将生成一个致命错误。

异常处理是PHP 5中的另外一个新特征，当与面向对象编程联用时，它能够实现良好地操控错误处理和报告。一个try..catch块是一种处理异常的重要机制。一旦被捕 获，脚本将会从异常被捕捉和被处理的代码的下一行持续执行。

假如查询失败，你需要改变你的execute函数以抛出一个PHP异常。你将抛出一个称为QueryException的定制异常对象—导致错 误的DBQuery对象被传传送它。

列表3.抛出一个异常。

/** *执行当前查询 * * 执行当前查询—用提供的参数代替任何点位符 * . * * @参数： mixed $queryParams，… 查询参数 * @返回：资源A—参考描述执行查询的资源。 */ public function execute($queryParams = ‘) { //例如: SELECT * FROM table WHERE name=:1S AND type=:2I AND level=:3N $args = func_get_args(); if ($this->stored_procedure) { /*调用compile函数以得倒查询*/ $query = call_user_func_array(array($this， ‘compile’)， $args); } else { /*一个存储过程没被初始化，因此，作为一种标准查询来执行之*/ $query = $queryParams; } $result = $this->db->query($query); if (! $result) { throw new QueryException($this); } $this->result = $result; /* 注重现在我们怎么返回对象本身，这使我们能够从这个函数的返回结果中调用成员函数 */ return $this; }

四、 使用继续抛出定制异常

在PHP中，你可以抛出任何对象作为一个PHP异常;但是，首先该异常应该继续自PHP的内置异常类。通过创建你自己的定制异常，你可以记录其 它有关于该错误的信息，例如在一个日志文件中创建一个入口，或做你喜爱做的任何事情。你的定制异常将要做如下几件事情：

◆记录由查询产生的来自DB对象的错误消息。

◆给出查询错误发生所在行代码的正确细节—通过检察调用栈。

◆显示错误消息和查询文本—当被转换成一个字符串时。

为了得倒错误信息和查询文本，需要对DBQuery对象作多处更改。

1. 一个新的protected属性—compiledQuery—需要被添加倒类中。

2. compile()函数使用查询文本更新查询compiledQuery属性。

3. 应该加入一个检索编译的查询文本的函数。

4. 还应该加入一个函数—它得倒当前的与DBQuery对象相关联的DB对象。

列表4.抛出一个PHP异常。

class DBQuery { /** *在调用compile()或execute()之后存储查询的编译版本 * * @var string $compiledQuery */ protected $compiledQuery; /** * 返回编译的查询而不执行它。 * @参数：mixed $params，…查询参数 * @返回：字符串—编译的查询 */ public function compile($params=’) { if (! $this->stored_procedure) { throw new Exception(“存储过程没被初始化.”); } /*代替参数*/ $params = func_get_args(); //得倒函数参数 $query = preg_replace(“/(?compile_callback($params， 1， “2″)’， $this->query); return ($this->compiledQuery = $this->add_strings($query)); //把字符串放回查询中 } public function getDB() { return $this->db; } public function getCompiledQuery() { return $this->compiledQuery; } }

现在，你可以实现QueryException类。注重你是如何遍历调用栈以在脚本中查找实际导致错误的位置的。这正好适用于当抛出异常的 DBQuery对象是一个继续自DBQuery对象的子类的情况。

列表5:QueryException类。

/** *查询异常 * *当试图执行一个查询时，假如一个错误发生，将由{@link DBQuery}对象抛出错误 */ class QueryException extends Exception { /** * 查询文本 * * @var字符串$QueryText; */ protected $QueryText; /** *来自数据库的错误号/代码 * * @var字符串$ErrorCode */ protected $ErrorNumber; /** *来自数据库的错误消息 * * @var字符串$ErrorMessage */ protected $ErrorMessage; /** *类构造器 * * @参数：DBQuery $db，是抛出异常的查询对象 */ public function __construct(DBQuery $query) { /*得倒调用栈*/ $backtrace = $this->GetTrace(); /*把行和文件设置倒错误实际发生的位置*/ if (count($backtrace) > 0) { $x = 1; /*假如查询类被继续，那么我们需要忽略由子类所进行的调用*/ while((! isset($backtrace[$x]['line'])) || (isset($backtrace[$x]['class']) && is_subclass_of($backtrace[$x]['class']， ‘DBQuery’)) || (strpos(strtolower(@$backtrace[$x]['function'])， ‘call_user_func’)) !== false ) { /*循环执行，只要没有行号或调用的函数是DBQuery类的一个子类*/ ++$x; /*假如我们倒达栈底，那么我们使用{dy}个调用者*/ if (($x) >= count($backtrace)) { $x = count($backtrace); break; } } /*假如上面的循环至少执行一次，那么我们可以把它减1以查找实际的引起错误的代码行 */ if ($x != 1) { $x -= 1; } /*{zh1}，我们可以设置文件和行号，这应该可以反应出引起错误的SQL语句*/ $this->line = $backtrace[$x]['line']; $this->file = $backtrace[$x]['file']; } $this->QueryText = $query->getCompiledQuery(); $this->ErrorNumber = $query->getDB()->errno(); $this->ErrorMessage = $query->getDB()->error(); /*调用超类的异常构造器*/ parent::__construct(‘Query Error’， 0); } /** *得倒查询文本 * * @返回字符串查询文本 */ public function GetQueryText() { return $this->QueryText; } /** *得倒错误号 * * @返回字符串错误号 */ public function GetErrorNumber() { return $this->ErrorNumber; } /** *得倒错误消息 * * @返回字符串错误消息 */ public function GetErrorMessage() { return $this->ErrorMessage; } /** *当对象被转换为一个字符串时调用。 * @返回字符串 */ public function __toString() { $output = “Query Error in {$this->file} on line {$this->line}nn”; $output .= “Query: {$this->QueryText}n”; $output .= “Error: {$this->ErrorMessage} ({$this->ErrorNumber})nn”; return $output; } }

至此，在本节开始看倒的代码可以工作了。

五、 结论

在本文中，你看倒了PHP代理是怎样把与查询相联系的DB接口映射倒针对一个特定的查询结果上的操作。DBQuery对象暴露相同的函数，例如 fetch_assoc()，作为DB对象。然而，这些都是针对单个查询起作用。你还学习了如何使用定制异常来给出具体信息—一个错误发生在何时何地，以 及它们怎样更好地操控错误的处理。