一、DBQuery对象

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

列表1.使用DBQuery类。

 

require'mysql_db.php'; require_once'query.php'; $db=newMySqlDb; $db-＞connect('host'，'username'，'pass'); $db-＞query('usecontent_management_system'); $query=newDBQuery($db); $query-＞prepare('SELECTfname，snameFROMusersWHEREusername=:1SANDpword=:2SANDexpire_time<:3I'); try{ 　if($query-＞execute("visualad"，"apron"，time()))-＞num_rows()==1){ echo('CorrectCredentials'); 　}else{ echo('IncorrectCredentials/SessionExpired'); 　} }catch(QueryException$e){ 　echo('Errorexecutingquery:'.$e); }

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

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

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

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

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

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

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

classDBQuery { 　..... 　publicfunctionfetch_array() 　{ if(!is_resource($this-＞result)){ 　thrownewException('Querynotexecuted.'); } return$this-＞db-＞fetch_array($this-＞result); 　} 　publicfunctionfetch_row() 　{ if(!is_resource($this-＞result)){ 　thrownewException('Querynotexecuted.'); } return$this-＞db-＞fetch_row($this-＞result); 　} 　publicfunctionfetch_assoc() 　{ if(!is_resource($this-＞result)){ 　thrownewException('Querynotexecuted.'); } return$this-＞db-＞fetch_assoc($this-＞result); 　} 　publicfunctionfetch_object() 　{ if(!is_resource($this-＞result)){ 　thrownewException('Querynotexecuted.'); } return$this-＞db-＞fetch_object($this-＞result); 　} 　publicfunctionnum_rows() 　{ if(!is_resource($this-＞result)){ 　thrownewException('Querynotexecuted.'); } return$this-＞db-＞num_rows($this-＞result); 　} }

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

二、类型提示（TypeHinting）

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

publicfunction__construct(DB$db) { 　$this-＞db=$db; }

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

三、抛出异常

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

异常处理是PHP5中的另外一个新特征，当与OOP联用时，它能够实现良好地控制错误处理和报告。一个try..catch块是一种处理异常的重要机制。一旦被捕获，脚本将会从异常被捕获和被处理的代码的下一行继续执行。
如果查询失败，你需要改变你的execute函数以抛出一个异常。你将抛出一个称为QueryException的定制异常对象—导致错误的DBQuery对象被传递给它。

列表3.抛出一个异常。

/** *执行当前查询 * *执行当前查询—用提供的参数代替任何点位符 *. * *@参数：mixed$queryParams，...查询参数 *@返回：资源A—参考描述执行查询的资源。 */ publicfunctionexecute($queryParams='') { 　//例如:SELECT*FROMtableWHEREname=:1SANDtype=:2IANDlevel=: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){ thrownewQueryException($this); 　} 　$this-＞result=$result; 　/*注意现在我们怎么返回对象本身，这使我们能够从这个函数的返回结果中调用成员函数 　*/ 　return$this; }

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

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

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

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

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

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

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

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

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

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

列表4.抛出一个异常。

 

classDBQuery { 　/** 　*在调用compile()或execute()之后存储查询的编译版本 　* 　*@varstring$compiledQuery 　*/ 　protected$compiledQuery; 　/** 　*返回编译的查询而不执行它。 　*@参数：mixed$params，...查询参数 　*@返回：字符串—编译的查询 　*/ 　publicfunctioncompile($params='') 　{ if(!$this-＞stored_procedure){ 　thrownewException("存储过程没被初始化."); } /*代替参数*/ $params=func_get_args();//得到函数参数 $query=preg_replace("/(?compile_callback($params，1，"2")'，$this-＞query); return($this-＞compiledQuery=$this-＞add_strings($query));//把字符串放回查询中 　} 　publicfunctiongetDB() 　{ return$this-＞db; 　} 　publicfunctiongetCompiledQuery() 　{ return$this-＞compiledQuery; 　} }

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

列表5:QueryException类。

 

/** *查询异常 * *当试图执行一个查询时，如果一个错误发生，将由{@linkDBQuery}对象抛出错误 */ classQueryExceptionextendsException { 　/** 　*查询文本 　* 　*@var字符串$QueryText; 　*/ 　protected$QueryText; 　/** 　*来自数据库的错误号/代码 　* 　*@var字符串$ErrorCode 　*/ 　protected$ErrorNumber; 　/** 　*来自数据库的错误消息 　* 　*@var字符串$ErrorMessage 　*/ 　protected$ErrorMessage; 　/** 　*类构造器 　* 　*@参数：DBQuery$db，是抛出异常的查询对象 　*/ 　publicfunction__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('QueryError'，0); 　} 　/** 　*得到查询文本 　* 　*@返回字符串查询文本 　*/ 　publicfunctionGetQueryText() 　{ return$this-＞QueryText; 　} 　/** 　*得到错误号 　* 　*@返回字符串错误号 　*/ 　publicfunctionGetErrorNumber() 　{ return$this-＞ErrorNumber; 　} 　/** 　*得到错误消息 　* 　*@返回字符串错误消息 　*/ 　publicfunctionGetErrorMessage() 　{ return$this-＞ErrorMessage; 　} 　/** 　*当对象被转换为一个字符串时调用。 　*@返回字符串 　*/ 　publicfunction__toString() 　{ $output="QueryErrorin{$this-＞file}online{$this-＞line}nn"; $output.="Query:{$this-＞QueryText}n"; $output.="Error:{$this-＞ErrorMessage}({$this-＞ErrorNumber})nn"; return$output; 　} }

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

五、结论

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

评论 (0) All

登陆 还没注册？