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

2024-05-04 23:00:24

字体：大中小

来源：转载

供稿：网友

本文来源于网页设计爱好者web开发社区http://www.html.org.cn收集整理，欢迎访问。

一、 dbquery对象

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

　　列表1.使用dbquery类。

require 'mysql_db.php';
require_once 'query.php';
$db = new mysqldb;
$db-＞connect('host'， 'username'， 'pass');
$db-＞query('use content_management_system');
$query = new dbquery($db);
$query-＞prepare('select fname，sname from users where username=:1s and pword=:2s and expire_time<:3i');
try {
　if($query-＞execute("visualad"， "apron"， time()))-＞num_rows() == 1) {
　　echo('correct credentials');
　} else {
　　echo('incorrect credentials / session expired');
　}
} catch (queryexception $e) {
　echo('error executing query: ' . $e);
}

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

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

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

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

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

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

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

class dbquery
{
　.....

　public function fetch_array()
　{
　　if (! is_resource($this-＞result)) {
　　　throw new exception('query not executed.');
　　}
　　return $this-＞db-＞fetch_array($this-＞result);
　}

　public function fetch_row()
　{
　　if (! is_resource($this-＞result)) {
　　　throw new exception('query not executed.');
　　}
　　return $this-＞db-＞fetch_row($this-＞result);
　}

　public function fetch_assoc()
　{
　　if (! is_resource($this-＞result)) {
　　　throw new exception('query not executed.');
　　}
　　return $this-＞db-＞fetch_assoc($this-＞result);
　}

　public function fetch_object()
　{
　　if (! is_resource($this-＞result)) {
　　　throw new exception('query not executed.');
　　}
　　return $this-＞db-＞fetch_object($this-＞result);
　}

　public function num_rows()
　{
　　if (! is_resource($this-＞result)) {
　　　throw new exception('query not executed.');
　　}
　　return $this-＞db-＞num_rows($this-＞result);
　}
}

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

　　二、类型提示（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中的另外一个新特征，当与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对象。然而，这些都是针对单个查询起作用。你还学习了如何使用定制异常来给出详细信息—一个错误发生在何时何地，以及它们怎样更好地控制错误的处理。

上一篇：PHP控制语句

下一篇：大型系统上PHP令人不爽的九大原因