PHP面向对象编程中的代理与异常定制

开发 后端
本文向您介绍PHP面向对象编程中的PHP代理与PHP异常的处理,通过具体的实例代码逐步说明,教您如何铜鼓定制异常来有效控制程序错误处理。

一、 DBQuery对象

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

列表1.使用DBQuery类。

  1. require 'mysql_db.php';   
  2. require_once 'query.php';   
  3. $db = new MySqlDb;   
  4. $db->connect('host', 'username', 'pass');   
  5. $db->query('use content_management_system');   
  6. $query = new DBQuery($db);   
  7. $query->prepare('SELECT fname,sname FROM users WHERE username=:1S AND pword=:2S AND expire_time<:3I');   
  8. try {   
  9.  if($query->execute("visualad", "apron", time()))->num_rows() == 1) {   
  10.   echo('Correct Credentials');   
  11.  } else {   
  12.   echo('Incorrect Credentials / Session Expired');   
  13.  }   
  14. } catch (QueryException $e) {   
  15.  echo('Error executing query: ' . $e);   
  16. }   

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

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

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

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

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

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

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

  1. class DBQuery   
  2. {   
  3.  .....   
  4.  
  5.  public function fetch_array()   
  6.  {    
  7.   if (! is_resource($this->result)) {   
  8.    throw new Exception('Query not executed.');   
  9.   }   
  10.  
  11.   return $this->db->fetch_array($this->result);   
  12.  }   
  13.  
  14.  public function fetch_row()   
  15.  {   
  16.   if (! is_resource($this->result)) {   
  17.    throw new Exception('Query not executed.');   
  18.   }   
  19.  
  20.   return $this->db->fetch_row($this->result);   
  21.  }   
  22.  
  23.  public function fetch_assoc()   
  24.  {   
  25.   if (! is_resource($this->result)) {   
  26.    throw new Exception('Query not executed.');   
  27.   }   
  28.  
  29.   return $this->db->fetch_assoc($this->result);   
  30.  }   
  31.  
  32.  public function fetch_object()   
  33.  {   
  34.   if (! is_resource($this->result)) {   
  35.    throw new Exception('Query not executed.');   
  36.   }   
  37.  
  38.   return $this->db->fetch_object($this->result);   
  39.  }   
  40.  
  41.  public function num_rows()   
  42.  {   
  43.   if (! is_resource($this->result)) {   
  44.    throw new Exception('Query not executed.');   
  45.   }   
  46.  
  47.   return $this->db->num_rows($this->result);   
  48.  }   
  49. }  

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

二、 类型提示(Type Hinting)

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

  1. public function __construct(DB $db)  
  2. {  
  3.  $this->db = $db;  
  4. }  

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

三、 抛出异常

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

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

如果查询失败,你需要改变你的execute函数以抛出一个PHP异常。你将抛出一个称为QueryException的定制异常对象—导致错误的DBQuery对象被传递给它。

列表3.抛出一个异常。

  1. /**  
  2. *执行当前查询  
  3. *  
  4. * 执行当前查询—用提供的参数代替任何点位符  
  5. * .   
  6.  
  7. * @参数: mixed $queryParams,... 查询参数  
  8. * @返回:资源A—参考描述执行查询的资源。  
  9. */   
  10. public function execute($queryParams = ')   
  11. {   
  12.  //例如: SELECT * FROM table WHERE name=:1S AND type=:2I AND level=:3N   
  13.  $args = func_get_args();   
  14.  if ($this->stored_procedure) {   
  15.   /*调用compile函数以得到查询*/ 
  16.   $query = call_user_func_array(array($this, 'compile'), $args);   
  17.  } else {   
  18.   /*一个存储过程没被初始化,因此,作为一种标准查询来执行之*/   
  19.   $query = $queryParams;   
  20.  }   
  21.  $result = $this->db->query($query);   
  22.  if (! $result) {   
  23.   throw new QueryException($this);   
  24.  }   
  25.  $this->result = $result;   
  26.  /* 注意现在我们怎么返回对象本身,这使我们能够从这个函数的返回结果中调用成员函数  
  27.  */ 
  28.  return $this;   
  29. }  

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

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

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

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

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

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

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

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

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

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

列表4.抛出一个PHP异常。

  1. class DBQuery   
  2. {   
  3.  /**   
  4.  *在调用compile()或execute()之后存储查询的编译版本  
  5.  *    
  6.  * @var string $compiledQuery   
  7.  */   
  8.  protected $compiledQuery;   
  9.  /**   
  10.  * 返回编译的查询而不执行它。  
  11.  * @参数:mixed $params,...查询参数  
  12.  * @返回:字符串—编译的查询  
  13.  */   
  14.  public function compile($params=')   
  15.  {   
  16.   if (! $this->stored_procedure) {   
  17.    throw new Exception("存储过程没被初始化.");   
  18.   }   
  19.   /*代替参数*/ 
  20.   $params = func_get_args(); //得到函数参数  
  21.   $query = preg_replace("/(?compile_callback($params, 1, "2")', $this->query);   
  22.   return ($this->compiledQuery = $this->add_strings($query)); //把字符串放回查询中  
  23.  }   
  24.  public function getDB()   
  25.  {   
  26.   return $this->db;   
  27.  }   
  28.  public function getCompiledQuery()   
  29.  {   
  30.   return $this->compiledQuery;   
  31.  }   
  32. }  

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

列表5:QueryException类。

  1. /**  
  2. *查询异常  
  3. *  
  4. *当试图执行一个查询时,如果一个错误发生,将由{@link DBQuery}对象抛出错误  
  5. */ 
  6. class QueryException extends Exception   
  7. {  
  8. /**   
  9. * 查询文本  
  10. *  
  11. * @var字符串$QueryText;  
  12. */ 
  13. protected $QueryText;  
  14. /**   
  15. *来自数据库的错误号/代码  
  16. *  
  17. * @var字符串$ErrorCode   
  18. */   
  19. protected $ErrorNumber;   
  20. /**   
  21. *来自数据库的错误消息  
  22.  
  23. * @var字符串$ErrorMessage   
  24. */   
  25. protected $ErrorMessage;   
  26. /**  
  27. *类构造器  
  28. *  
  29. * @参数:DBQuery $db,是抛出异常的查询对象  
  30. */ 
  31. public function __construct(DBQuery $query)   
  32. {  
  33.  /*得到调用栈*/ 
  34.  $backtrace = $this->GetTrace();   
  35.  /*把行和文件设置到错误实际发生的位置*/ 
  36.  if (count($backtrace) > 0) {   
  37.   $x = 1;   
  38.   /*如果查询类被继承,那么我们需要忽略由子类所进行的调用*/ 
  39.   while((! isset($backtrace[$x]['line'])) ||   
  40. (isset($backtrace[$x]['class']) && is_subclass_of($backtrace[$x]['class'], 'DBQuery')) ||   
  41. (strpos(strtolower(@$backtrace[$x]['function']), 'call_user_func')) !== false ) {   
  42.    /*循环执行,只要没有行号或调用的函数是DBQuery类的一个子类*/ 
  43.    ++$x;   
  44.    /*如果我们到达栈底,那么我们使用***个调用者*/ 
  45.    if (($x) >= count($backtrace)) {   
  46.     $x = count($backtrace);   
  47.     break;   
  48.    }   
  49.  }  
  50.  /*如果上面的循环至少执行一次,那么我们可以把它减1以查找实际的引起错误的代码行  
  51.  */ 
  52.  if ($x != 1) {   
  53.   $x -= 1;   
  54.  }   
  55.  /****,我们可以设置文件和行号,这应该可以反映出引起错误的SQL语句*/ 
  56.  $this->line = $backtrace[$x]['line'];   
  57.  $this->file = $backtrace[$x]['file'];   
  58. }   
  59. $this->QueryText = $query->getCompiledQuery();   
  60. $this->ErrorNumber = $query->getDB()->errno();   
  61. $this->ErrorMessage = $query->getDB()->error();   
  62. /*调用超类的异常构造器*/   
  63. parent::__construct('Query Error', 0);   
  64. }   
  65. /**   
  66. *得到查询文本  
  67.  
  68. * @返回字符串查询文本  
  69. */   
  70. public function GetQueryText()   
  71. {   
  72.  return $this->QueryText;   
  73. }   
  74. /**   
  75. *得到错误号  
  76.  
  77. * @返回字符串错误号  
  78. */   
  79. public function GetErrorNumber()   
  80. {   
  81.  return $this->ErrorNumber;   
  82. }   
  83. /**   
  84. *得到错误消息  
  85.  
  86. * @返回字符串错误消息  
  87. */   
  88. public function GetErrorMessage()   
  89. {   
  90.  return $this->ErrorMessage;   
  91. }   
  92. /**   
  93. *当对象被转换为一个字符串时调用。  
  94. * @返回字符串  
  95. */   
  96. public function __toString()   
  97. {   
  98.  $output = "Query Error in {$this->file} on line {$this->line}nn";   
  99.  $output .= "Query: {$this->QueryText}n";   
  100.  $output .= "Error: {$this->ErrorMessage} ({$this->ErrorNumber})nn";   
  101.  
  102.  return $output;   
  103. }   
  104. }  

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

五、 结论

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

 

【编辑推荐】

  1. Zend为Java提供的PHP解决方案
  2. PHP开发者:你GLAMMP了吗?
  3. PHP函数preg_match_all正则表达式的简单应用
  4. 10段PHP常用功能代码
  5. PHP实现文件上传的思路及实例
责任编辑:佚名 来源: 天极网
相关推荐

2009-11-23 19:24:01

PHP面向对象编程

2010-01-20 09:48:44

面向对象

2010-07-20 09:13:55

Perl面向对象编程

2010-04-26 08:53:06

面向方面编程.NET

2012-01-17 09:34:52

JavaScript

2017-04-21 09:07:39

JavaScript对象编程

2009-01-16 08:52:26

面向对象OOP编程

2023-04-19 08:43:52

Python面向对象编程

2011-07-21 17:19:47

java面向对象

2010-11-17 11:31:22

Scala基础面向对象Scala

2024-01-03 13:38:00

C++面向对象编程OOP

2010-07-20 13:44:02

Perl方法

2012-02-27 09:30:22

JavaScript

2022-07-30 23:41:53

面向过程面向对象面向协议编程

2023-11-02 07:55:31

Python对象编程

2012-12-13 11:01:42

IBMdW

2021-10-21 18:47:37

JavaScript面向对象

2010-07-20 09:33:14

Perl方法

2011-05-25 11:15:02

Javascript继承

2011-05-25 10:59:26

Javascript继承
点赞
收藏

51CTO技术栈公众号