PHP オブジェクト指向プログラミングにおけるプロキシと例外のカスタマイズ (1)

1. DBQuery オブジェクト

さて、DBQuery オブジェクトは単純にストアドプロシージャをエミュレートします。実行されると、保存する必要がある結果リソースが返されます。その結果セットで関数を使用したい場合は (例: num_rows())。または fetch_row()) を使用するには、MySqlDB オブジェクトを渡す必要があります。では、MySqlDB オブジェクト (実行されたクエリの結果を操作するように設計されている) によって実装される関数を DBQuery オブジェクトが実装すると、どのような影響があるのでしょうか?前の例のコードを引き続き使用し、結果リソースが DBQuery オブジェクトによって管理されていると仮定します。 DBQuery クラスのソースコードをリスト 1 に示します。

リスト 1. DBQuery クラスの使用。

<ol class="dp-c">
<li class="alt"><span><span class="keyword">require</span><span> </span><span class="string">'mysql_db.php'</span><span>;   </span></span></li>
<li>
<span class="keyword">require_once</span><span> </span><span class="string">'query.php'</span><span>;   </span>
</li>
<li class="alt">
<span class="vars">$db</span><span> = </span><span class="keyword">new</span><span> MySqlDb;   </span>
</li>
<li>
<span class="vars">$db</span><span>->connect(</span><span class="string">'host'</span><span>， </span><span class="string">'username'</span><span>， </span><span class="string">'pass'</span><span>);   </span>
</li>
<li class="alt">
<span class="vars">$db</span><span>->query(</span><span class="string">'use content_management_system'</span><span>);   </span>
</li>
<li>
<span class="vars">$query</span><span> = </span><span class="keyword">new</span><span> DBQuery(</span><span class="vars">$db</span><span>);   </span>
</li>
<li class="alt">
<span class="vars">$query</span><span>->prepare(</span><span class="string">'SELECT fname，sname FROM users WHERE username=:1S AND pword=:2S AND expire_time<:3i><span>);   </span><li><span>try {   </span></li>
<li class="alt">
<span>　</span><span class="keyword">if</span><span>(</span><span class="vars">$query</span><span>->execute(</span><span class="string">"visualad"</span><span>， </span><span class="string">"apron"</span><span>， time()))->num_rows() == 1) {   </span>
</li>
<li>
<span></span><span class="func">echo</span><span>(</span><span class="string">'Correct Credentials'</span><span>);   </span>
</li>
<li class="alt">
<span>　} </span><span class="keyword">else</span><span> {   </span>
</li>
<li>
<span></span><span class="func">echo</span><span>(</span><span class="string">'Incorrect Credentials / Session Expired'</span><span>);   </span>
</li>
<li class="alt"><span>　}   </span></li>
<li>
<span>} catch (QueryException </span><span class="vars">$e</span><span>) {   </span>
</li>
<li class="alt">
<span>　</span><span class="func">echo</span><span>(</span><span class="string">'Error executing query: '</span><span> . </span><span class="vars">$e</span><span>);   </span>
</li>
<li><span>}   </span></li></:3i></span>
</li>
</ol>

ログイン後にコピー

上記の変更されたコードで最も注目すべき点は、catch ステートメントとexecute ステートメントです。

◆execute ステートメントは結果リソースを返さなくなり、DBQuery オブジェクト自体を返すようになりました。

◆DBQuery オブジェクトは、DB インターフェースですでにおなじみの num_rows() 関数を実装するようになりました。

◆クエリの実行が失敗した場合、QueryException 型の例外がスローされます。文字列に変換すると、発生したエラーの詳細が返されます。

これには、PHP プロキシを使用する必要があります。実際、すでに DBQuery オブジェクトでプロキシを使用していますが、ここではそれをさらに深く使用して、MySqlDB オブジェクトに緊密にバインドします。 DBQuery オブジェクトは、DB インターフェイスを実装するオブジェクトで初期化されており、クエリを実行する DB オブジェクトの query() メソッドを呼び出すメンバー関数executeがすでに含まれています。 DBQuery オブジェクト自体は実際にはデータベースにクエリを実行せず、このタスクを DB オブジェクトに任せます。これはプロキシであり、同じまたは類似の動作を実装する別のオブジェクトにメッセージを送信することで、オブジェクトが特定の動作を実装できるプロセスです。

これを行うには、DBQuery オブジェクトを変更して、DB オブジェクトからの結果リソースを操作するすべての関数を含める必要があります。クエリを実行するときに保存された結果を使用して、DB オブジェクトの対応する関数を呼び出し、その結果を返す必要があります。次の関数が追加されます:

リスト 2: プロキシを使用した DBQuery クラスの拡張。

<ol class="dp-c">
<li class="alt"><span><span class="keyword">class</span><span> DBQuery   </span></span></li>
<li><span>{   </span></li>
<li class="alt"><span>　.....   </span></li>
<li><span> </span></li>
<li class="alt">
<span>　</span><span class="keyword">public</span><span> </span><span class="keyword">function</span><span> fetch_array()   </span>
</li>
<li><span>　{ 　  </span></li>
<li class="alt">
<span></span><span class="keyword">if</span><span> (! </span><span class="func">is_resource</span><span>(</span><span class="vars">$this</span><span>->result)) {   </span>
</li>
<li>
<span>　</span><span class="keyword">throw</span><span> </span><span class="keyword">new</span><span> Exception(</span><span class="string">'Query not executed.'</span><span>);   </span>
</li>
<li class="alt"><span>}   </span></li>
<li><span> </span></li>
<li class="alt">
<span></span><span class="keyword">return</span><span> </span><span class="vars">$this</span><span>->db->fetch_array(</span><span class="vars">$this</span><span>->result);   </span>
</li>
<li><span>　}   </span></li>
<li class="alt"><span> </span></li>
<li>
<span>　</span><span class="keyword">public</span><span> </span><span class="keyword">function</span><span> fetch_row()   </span>
</li>
<li class="alt"><span>　{   </span></li>
<li>
<span></span><span class="keyword">if</span><span> (! </span><span class="func">is_resource</span><span>(</span><span class="vars">$this</span><span>->result)) {   </span>
</li>
<li class="alt">
<span>　</span><span class="keyword">throw</span><span> </span><span class="keyword">new</span><span> Exception(</span><span class="string">'Query not executed.'</span><span>);   </span>
</li>
<li><span>}   </span></li>
<li class="alt"><span> </span></li>
<li>
<span></span><span class="keyword">return</span><span> </span><span class="vars">$this</span><span>->db->fetch_row(</span><span class="vars">$this</span><span>->result);   </span>
</li>
<li class="alt"><span>　}   </span></li>
<li><span> </span></li>
<li class="alt">
<span>　</span><span class="keyword">public</span><span> </span><span class="keyword">function</span><span> fetch_assoc()   </span>
</li>
<li><span>　{   </span></li>
<li class="alt">
<span></span><span class="keyword">if</span><span> (! </span><span class="func">is_resource</span><span>(</span><span class="vars">$this</span><span>->result)) {   </span>
</li>
<li>
<span>　</span><span class="keyword">throw</span><span> </span><span class="keyword">new</span><span> Exception(</span><span class="string">'Query not executed.'</span><span>);   </span>
</li>
<li class="alt"><span>}   </span></li>
<li><span> </span></li>
<li class="alt">
<span></span><span class="keyword">return</span><span> </span><span class="vars">$this</span><span>->db->fetch_assoc(</span><span class="vars">$this</span><span>->result);   </span>
</li>
<li><span>　}   </span></li>
<li class="alt"><span> </span></li>
<li>
<span>　</span><span class="keyword">public</span><span> </span><span class="keyword">function</span><span> fetch_object()   </span>
</li>
<li class="alt"><span>　{   </span></li>
<li>
<span></span><span class="keyword">if</span><span> (! </span><span class="func">is_resource</span><span>(</span><span class="vars">$this</span><span>->result)) {   </span>
</li>
<li class="alt">
<span>　</span><span class="keyword">throw</span><span> </span><span class="keyword">new</span><span> Exception(</span><span class="string">'Query not executed.'</span><span>);   </span>
</li>
<li><span>}   </span></li>
<li class="alt"><span> </span></li>
<li>
<span></span><span class="keyword">return</span><span> </span><span class="vars">$this</span><span>->db->fetch_object(</span><span class="vars">$this</span><span>->result);   </span>
</li>
<li class="alt"><span>　}   </span></li>
<li><span> </span></li>
<li class="alt">
<span>　</span><span class="keyword">public</span><span> </span><span class="keyword">function</span><span> num_rows()   </span>
</li>
<li><span>　{   </span></li>
<li class="alt">
<span></span><span class="keyword">if</span><span> (! </span><span class="func">is_resource</span><span>(</span><span class="vars">$this</span><span>->result)) {   </span>
</li>
<li>
<span>　</span><span class="keyword">throw</span><span> </span><span class="keyword">new</span><span> Exception(</span><span class="string">'Query not executed.'</span><span>);   </span>
</li>
<li class="alt"><span>}   </span></li>
<li><span> </span></li>
<li class="alt">
<span></span><span class="keyword">return</span><span> </span><span class="vars">$this</span><span>->db->num_rows(</span><span class="vars">$this</span><span>->result);   </span>
</li>
<li><span>　}   </span></li>
<li class="alt"><span>}  </span></li>
</ol>

ログイン後にコピー

各関数の実装は非常に簡単です。まずクエリが実行されたことを確認し、次にタスクを DB オブジェクトに委任し、あたかもクエリオブジェクトそのものであるかのように結果を返します (基本データベース関数と呼ばれます)。 1