PHP5 OOP编程之代理与定制异常(2)

三、 抛出异常

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

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

　　如果查询失败，你需要改变你的execute函数以抛出一个异常。你将抛出一个称为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的内置异常类。通过创建你自己的定制异常，你可以记录其它有关于该错误的信息，例如在一个日志文件中创建一个入口，或做你喜欢做的任何事情。你的定制异常将要做如下几件事情：

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

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

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

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

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

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

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

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

　　列表4.抛出一个异常。

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; 　　　　/*如果我们到达栈底，那么我们使用第一个调用者*/ 　　　　if (($x) ＞= count($backtrace)) { 　　　　　$x = count($backtrace); 　　　　　break; 　　　　} 　　　} 　　　/*如果上面的循环至少执行一次，那么我们可以把它减1以查找实际的引起错误的代码行 　　　*/ 　　　if ($x != 1) { 　　　　$x -= 1; 　　　} 　　　/*最后，我们可以设置文件和行号，这应该可以反映出引起错误的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; 　} }

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

　　 五、 结论

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