«
PHP5 OOP编程中的代理与异常定制

时间：2008-5-31    作者：Deri    分类： 分享 

   <p>　　一、 DBQuery对象</p><p>　　现在，我们的DBQuery对象简单地模仿一个存储过程―一旦被执行，即返回一个必须进行保存的结果资源；并且如果你想使用该结果集上的函数（例如num_rows()或fetch_row()）的话，你必须传递MySqlDB对象。那么，如果由DBQuery对象来实现MySqlDB对象（其设计目的是对一个执行查询的结果进行操作）实现的函数，效果如何呢？让我们继续使用上一篇示例中的代码；并且让我们假定，现在由DBQuery对象管理我们的结果资源。DBQuery类的源码如列表1所示。</p><p>　　列表1.使用DBQuery类。</p><code>require 'mysql_db.php';<br />require_once 'query.php';<br />$db = new MySqlDb;<br />$db->connect('host'， 'username'， 'pass');<br />$db->query('use content_management_system');<br />$query = new DBQuery($db);<br />$query->prepare('SELECT fname，sname FROM users WHERE username=:1S AND pword=:2S AND expire_time<:3I');<br />try {<br />　if($query->execute("visualad"， "apron"， time()))->num_rows() == 1) {<br />echo('Correct Credentials');<br />　} else {<br />echo('Incorrect Credentials / Session Expired');<br />　}<br />} catch (QueryException $e) {<br />　echo('Error executing query: ' . $e);<br />}</code></p><p>　　上面修改后的代码中我们最感兴趣的是，catch语句和execute语句。</p><p>　　・ execute语句不再返回一个结果资源，现在它返回DBQuery对象本身。</p><p>　　・ DBQuery对象现在实现num_rows()函数―我们从DB接口中已经熟悉。</p>
<p> </p>

   <p>　　・ 如果查询执行失败，它抛出一个QueryException类型的异常。当被转换成一个字符串时，它将返回发生的错误的细节信息。</p><p>　　为此，你需要使用代理。事实上，你在我们的DBQuery对象中已经使用代理了，但是现在将更为深入地使用它来把它与MySqlDB对象紧密绑定。该DBQuery对象已经被使用一个实现DB接口的对象初始化，并且它已经包含一个成员函数execute―由它调用DB对象的query()方法来执行该查询。这个DBQuery对象本身并不实际地查询数据库，它把这项任务交由DB对象来完成。这就是代理，其实是一个进程―借助于这个进程，通过把消息发送给另一个实现相同的或类似行为的对象，一个对象可以实现一个特别的行为。</p><p>　　为此，你需要修改DBQuery对象以便包括所有的函数―它们操作一个来自DB对象的结果资源。当执行查询以调用DB对象的相应函数并且返回它的结果时，你需要使用存储的结果。下列函数将被添加：</p><p>　　列表2:使用代理扩展DBQuery类。</p><code>class DBQuery<br />{<br />　.....<br />　public function fetch_array()<br />　{ 　<br />if (! is_resource($this->result)) {<br />　throw new Exception('Query not executed.');<br />}<br />return $this->db->fetch_array($this->result);<br />　}<br />　public function fetch_row()<br />　{<br />if (! is_resource($this->result)) {<br />　throw new Exception('Query not executed.');<br />}<br />return $this->db->fetch_row($this->result);<br />　}<br />　public function fetch_assoc()<br />　{<br />if (! is_resource($this->result)) {<br />　throw new Exception('Query not executed.');<br />}<br />return $this->db->fetch_assoc($this->result);<br />　}<br />　public function fetch_object()<br />　{<br />if (! is_resource($this->result)) {<br />　throw new Exception('Query not executed.');<br />}<br />return $this->db->fetch_object($this->result);<br />　}<br />　public function num_rows()<br />　{<br />if (! is_resource($this->result)) {<br />　throw new Exception('Query not executed.');<br />}<br />return $this->db->num_rows($this->result);<br />　}<br />}</code></p>
 <p> </p>

   <p>　　每个函数的实现相当简单。它首先进行检查，以确保已经执行查询，然后把任务代理到DB对象，返回它的结果就好象它是查询对象本身（称作是基本数据库函数）一样。</p><p>　　二、 类型提示（Type Hinting）</p><p>　　为了使代理能够工作，我们需要确保DBQuery对象的$db变量是一个实现了DB接口的对象的实例。类型提示是PHP 5中的一种新特征，它能够使你把函数参数强制转换成特定类型的对象。在PHP 5之前，唯一的确保函数参数是一个特定对象类型的方法是使用PHP中所提供的类型检查函数（也即是is_a()）。现在，你可以简单地强制转换对象类型―通过在函数参数的前面加上类型名。你已经从我们的DBQuery对象中看到了类型提示，这样可以确保一个实现DB接口的对象被传递到对象构造器中。</p><code>public function __construct(DB $db)<br />{<br />　$this->db = $db;<br />}</code></p><p>　　当使用类型提示时，你不仅可以指定对象类型，还可以指定抽象类和接口。</p><p>　　三、 抛出异常</p><p>　　你可能已经从上面的代码中注意到，你捕获的是一个称为QueryException（我们将在后面实现这个对象）的异常。一个异常类似于一个错误，然而却更具有一般性。描述一个异常的最好的方法是使用emergency。尽管一个emergency可以不会是“致命的”，但是还是必须处理它。当在PHP中抛出一个异常时，执行的当前范围很快地被终止，不管它是一个函数，try..catch块还是脚本本身。然后，该异常遍历调用栈―终止每个执行范围，直到或者在一个try..catch块中捕获它或者它到达调用栈的顶部―此时它将生成一个致命错误。</p><p>　　异常处理是PHP 5中的另外一个新特征，当与OOP联用时，它能够实现良好地控制错误处理和报告。一个try..catch块是一种处理异常的重要机制。一旦被捕获，脚本将会从异常被捕获和被处理的代码的下一行继续执行。</p>
 <p> </p>

   <p>　　如果查询失败，你需要改变你的execute函数以抛出一个异常。你将抛出一个称为QueryException的定制异常对象―导致错误的DBQuery对象被传递给它。</p><p>　　列表3.抛出一个异常。</p><code>/**<br />*执行当前查询<br />*<br />* 执行当前查询―用提供的参数代替任何点位符<br />* .<br />*<br />* @参数： mixed $queryParams，... 查询参数<br />* @返回：资源A―参考描述执行查询的资源。<br />*/<br />public function execute($queryParams = '')<br />{<br />　//例如: SELECT * FROM table WHERE name=:1S AND type=:2I AND level=:3N<br />　$args = func_get_args();<br />　if ($this->stored_procedure) {<br />/*调用compile函数以得到查询*/<br />$query = call_user_func_array(array($this， 'compile')， $args);<br />　} else {<br />/*一个存储过程没被初始化，因此，作为一种标准查询来执行之*/<br />$query = $queryParams;<br />　}<br />　$result = $this->db->query($query);<br />　if (! $result) {<br />throw new QueryException($this);<br />　}<br />　$this->result = $result;<br />　/* 注意现在我们怎么返回对象本身，这使我们能够从这个函数的返回结果中调用成员函数<br />　*/<br />　return $this;<br />}</code></p><p>　　四、 使用继承抛出定制异常</p><p>　　在PHP中，你可以抛出任何对象作为一个异常；但是，首先该异常应该继承自PHP的内置异常类。通过创建你自己的定制异常，你可以记录其它有关于该错误的信息，例如在一个日志文件中创建一个入口，或做你喜欢做的任何事情。你的定制异常将要做如下几件事情：</p><p>　　・ 记录由查询产生的来自DB对象的错误消息。</p>
 <p> </p>

   <p>　　・ 给出查询错误发生所在行代码的准确细节―通过检查调用栈。</p><p>　　・ 显示错误消息和查询文本―当被转换成一个字符串时。</p><p>　　为了得到错误信息和查询文本，需要对DBQuery对象作多处更改。</p><p>　　1. 一个新的protected属性―compiledQuery―需要被添加到类中。</p><p>　　2. compile()函数使用查询文本更新查询compiledQuery属性。</p><p>　　3. 应该加入一个检索编译的查询文本的函数。</p><p>　　4. 还应该加入一个函数―它得到当前的与DBQuery对象相关联的DB对象。</p><p>　　列表4.抛出一个异常。</p><code>class DBQuery<br />{<br />　/**<br />　*在调用compile()或execute()之后存储查询的编译版本<br />　* 　<br />　* @var string $compiledQuery<br />　*/<br />　protected $compiledQuery;<br />　/**<br />　* 返回编译的查询而不执行它。<br />　* @参数：mixed $params，...查询参数<br />　* @返回：字符串―编译的查询<br />　*/<br />　public function compile($params='')<br />　{<br />if (! $this->stored_procedure) {<br />　throw new Exception("存储过程没被初始化.");<br />}<br />/*代替参数*/<br />$params = func_get_args(); //得到函数参数<br />$query = preg_replace("/(?compile_callback($params， 1， "2")'， $this->query);<br />return ($this->compiledQuery = $this->add_strings($query)); //把字符串放回查询中<br />　}<br />　public function getDB()<br />　{<br />return $this->db;<br />　}<br />　public function getCompiledQuery()<br />　{<br />return $this->compiledQuery;<br />　}<br />}</code></p>
 <p> </p>

   <p>　　现在，你可以实现QueryException类。注意你是如何遍历调用栈以在脚本中查找实际导致错误的位置的。这正好适用于当抛出异常的DBQuery对象是一个继承自DBQuery对象的子类的情况。</p><p>　　列表5:QueryException类。</p><code>/**<br />*查询异常<br />*<br />*当试图执行一个查询时，如果一个错误发生，将由{@link DBQuery}对象抛出错误<br />*/<br />class QueryException extends Exception<br />{<br />/**<br />* 查询文本<br />*<br />* @var字符串$QueryText;<br />*/<br />protected $QueryText;<br />/**<br />*来自数据库的错误号/代码<br />*<br />* @var字符串$ErrorCode<br />*/<br />protected $ErrorNumber;<br />/**<br />*来自数据库的错误消息<br />*<br />* @var字符串$ErrorMessage<br />*/<br />protected $ErrorMessage;<br />/**<br />*类构造器<br />*<br />* @参数：DBQuery $db，是抛出异常的查询对象<br />*/<br />public function __construct(DBQuery $query)<br />{<br />　/*得到调用栈*/<br />　$backtrace = $this->GetTrace();<br />　/*把行和文件设置到错误实际发生的位置*/<br />　if (count($backtrace) > 0) {<br />$x = 1;<br />/*如果查询类被继承，那么我们需要忽略由子类所进行的调用*/<br />while((! isset($backtrace[$x]['line'])) ||<br />(isset($backtrace[$x]['class']) && is_subclass_of($backtrace[$x]['class']， 'DBQuery')) ||<br />(strpos(strtolower(@$backtrace[$x]['function'])， 'call_user_func')) !== false ) {<br />　/*循环执行，只要没有行号或调用的函数是DBQuery类的一个子类*/<br />　++$x;<br />　/*如果我们到达栈底，那么我们使用第一个调用者*/<br />　if (($x) >= count($backtrace)) {<br />$x = count($backtrace);<br />break;<br />　}<br />　}<br />　/*如果上面的循环至少执行一次，那么我们可以把它减1以查找实际的引起错误的代码行<br />　*/<br />　if ($x != 1) {<br />$x -= 1;<br />　}<br />　/*最后，我们可以设置文件和行号，这应该可以反映出引起错误的SQL语句*/<br />　$this->line = $backtrace[$x]['line'];<br />　$this->file = $backtrace[$x]['file'];<br />}<br />$this->QueryText = $query->getCompiledQuery();<br />$this->ErrorNumber = $query->getDB()->errno();<br />$this->ErrorMessage = $query->getDB()->error();<br />/*调用超类的异常构造器*/<br />parent::__construct('Query Error'， 0);<br />}<br />/**<br />*得到查询文本<br />*<br />* @返回字符串查询文本<br />*/<br />public function GetQueryText()<br />{<br />　return $this->QueryText;<br />}<br />/**<br />*得到错误号<br />*<br />* @返回字符串错误号<br />*/<br />public function GetErrorNumber()<br />{<br />　return $this->ErrorNumber;<br />}<br />/**<br />*得到错误消息<br />*<br />* @返回字符串错误消息<br />*/<br />public function GetErrorMessage()<br />{<br />　return $this->ErrorMessage;<br />}<br />/**<br />*当对象被转换为一个字符串时调用。<br />* @返回字符串<br />*/<br />public function __toString()<br />{<br />　$output = "Query Error in {$this->file} on line {$this->line}nn";<br />　$output .= "Query: {$this->QueryText}n";<br />　$output .= "Error: {$this->ErrorMessage} ({$this->ErrorNumber})nn";<br />　return $output;<br />}<br />}</code></p></p><p>　　至此，在本节开始看到的代码可以工作了。</p><p>　　五、 结论</p><p>　　在本文中，你看到了代理是怎样把与查询相联系的DB接口映射到针对一个特定的查询结果上的操作。DBQuery对象暴露相同的函数，例如fetch_assoc()，作为DB对象。然而，这些都是针对单个查询起作用。你还学习了如何使用定制异常来给出详细信息―一个错误发生在何时何地，以及它们怎样更好地控制错误的处理。</p></p>