三、 抛出异常
你可能已经从上面的代码中注意到,你捕获的是一个称为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类。
PHP5 OOP编程之代理与定制异常(2)
PHP5 OOP编程之代理与定制异常(2),PHP5 OOP编程之代理与定制异常(2)