二、 类型提示Type Hinting)
为了使代理能够工作,我们需要确保DBQuery对象的$db变量是一个实现了DB接口的对象的实例。类型提示是PHP 5中的一种新特征,它能够使你把函数参数强制转换成特定类型的对象。在PHP 5之前,唯一的确保函数参数是一个特定对象类型的方法是使用PHP中所提供的类型检查函数也即是is_a())。现在,你可以简单地强制转换对象类型—通过在函数参数的前面加上类型名。你已经从我们的DBQuery对象中看到了类型提示,这样可以确保一个实现DB接口的对象被传递到对象构造器中。
- public function __construct(DB $db)
- {
- $this->db = $db;
- }
当使用类型提示时,你不仅可以指定对象类型,还可以指定抽象类和接口。
三、 抛出异常
你可能已经从上面的代码中注意到,你捕获的是一个称为QueryException我们将在后面实现这个对象)的异常。一个异常类似于一个错误,然而却更具有一般性。描述一个异常的最好的方法是使用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;
- /*如果我们到达栈底,那么我们使用第一个调用者*/
- 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;
- }
- }
至此,在本节开始看到的代码可以工作了。
五、 结论
在本文中,你看到了PHP代理是怎样把与查询相联系的DB接口映射到针对一个特定的查询结果上的操作。DBQuery对象暴露相同的函数,例如fetch_assoc(),作为DB对象。然而,这些都是针对单个查询起作用。你还学习了如何使用定制异常来给出详细信息—一个错误发生在何时何地,以及它们怎样更好地控制错误的处理。
- Zend为Java提供的PHP解决方案
- PHP开发者:你GLAMMP了吗?
- PHP函数preg_match_all正则表达式的简单应用
- 10段PHP常用功能代码
- PHP实现文件上传的思路及实例
PHP之友评论