298 lines
79 KiB
HTML
298 lines
79 KiB
HTML
|
|
||
|
|
<div id="content">
|
||
|
|
<h1 align="center">Source for file Pessimistic.php</h1>
|
||
|
|
<p>Documentation is available at <a href="../Doctrine/_Doctrine---Locking---Manager---Pessimistic.php.html">Pessimistic.php</a></p>
|
||
|
|
<div class="src-code"><span class="php">
|
||
|
|
<ol><li><div class="src-line"><a name="a1"></a><span class="src-php"><?php</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a2"></a><span class="src-comm">/*</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a3"></a><span class="src-comm"> * $Id: Pessimistic.php 1468 2007-05-24 16:54:42Z zYne $</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a4"></a><span class="src-comm"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a5"></a><span class="src-comm"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a6"></a><span class="src-comm"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a7"></a><span class="src-comm"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a8"></a><span class="src-comm"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a9"></a><span class="src-comm"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a10"></a><span class="src-comm"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a11"></a><span class="src-comm"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a12"></a><span class="src-comm"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a13"></a><span class="src-comm"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a14"></a><span class="src-comm"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a15"></a><span class="src-comm"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a16"></a><span class="src-comm"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a17"></a><span class="src-comm"> * This software consists of voluntary contributions made by many individuals</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a18"></a><span class="src-comm"> * and is licensed under the LGPL. For more information, see</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a19"></a><span class="src-comm"> * <http://www.phpdoctrine.com>.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a20"></a><span class="src-comm"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a21"></a><span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a22"></a><span class="src-doc"> * Offline locking of records comes in handy where you need to make sure that</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a23"></a><span class="src-doc"> * a time-consuming task on a record or many records, which is spread over several</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> * page requests can't be interfered by other users.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a25"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a26"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@link</span><span class="src-doc"> www.phpdoctrine.com</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a27"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Roman Borschel <roman@code-factory.org></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a28"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Pierre Minnieur <pm@pierre-minnieur.de></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a29"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@author</span><span class="src-doc"> Konsta Vesterinen <kvesteri@cc.hut.fi></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a30"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@license</span><span class="src-doc"> http://www.opensource.org/licenses/lgpl-license.php LGPL</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a31"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@since</span><span class="src-doc"> 1.0</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@package</span><span class="src-doc"> Doctrine</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a33"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@category</span><span class="src-doc"> Object Relational Mapping</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a34"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Revision: 1468 $</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a35"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a36"></a><span class="src-key">class </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html">Doctrine_Locking_Manager_Pessimistic</a></div></li>
|
||
|
|
<li><div class="src-line"><a name="a37"></a><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a38"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a39"></a><span class="src-doc"> * The conn that is used by the locking manager</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a40"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a41"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@var </span><span class="src-doc-type">Doctrine_Connection </span><span class="src-doc">object</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a42"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a43"></a> <span class="src-key">private </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">$conn</a><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a44"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a45"></a><span class="src-doc"> * The database table name for the lock tracking</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a46"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a47"></a> <span class="src-key">private </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">$_lockTable</a> = <span class="src-str">'doctrine_lock_tracking'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a48"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a49"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a50"></a><span class="src-doc"> * Constructs a new locking manager object</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a51"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a52"></a><span class="src-doc"> * When the CREATE_TABLES attribute of the connection on which the manager</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a53"></a><span class="src-doc"> * is supposed to work on is set to true, the locking table is created.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a54"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a55"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">Doctrine_Connection </span><span class="src-doc-var">$conn </span><span class="src-doc">The database connection to use</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a56"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a57"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#method__construct">__construct</a><span class="src-sym">(</span><span class="src-id">Doctrine_Connection </span><span class="src-var">$conn</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a58"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a59"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a> = <span class="src-var">$conn</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a60"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a61"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodgetAttribute">getAttribute</a><span class="src-sym">(</span><span class="src-id"><a href="../Doctrine/Doctrine.html">Doctrine</a></span><span class="src-sym">::</span><span class="src-id">ATTR_EXPORT</span><span class="src-sym">) </span><span class="src-sym">& </span><span class="src-id"><a href="../Doctrine/Doctrine.html">Doctrine</a></span><span class="src-sym">::</span><span class="src-id">EXPORT_TABLES</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a62"></a> <span class="src-var">$columns </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a63"></a> <span class="src-var">$columns</span><span class="src-sym">[</span><span class="src-str">'object_type'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'type' </span>=> <span class="src-str">'string'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a64"></a> <span class="src-str">'length' </span>=> <span class="src-num">50</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a65"></a> <span class="src-str">'notnull' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a66"></a> <span class="src-str">'primary' </span>=> <span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a67"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a68"></a> <span class="src-var">$columns</span><span class="src-sym">[</span><span class="src-str">'object_key'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'type' </span>=> <span class="src-str">'string'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a69"></a> <span class="src-str">'length' </span>=> <span class="src-num">250</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a70"></a> <span class="src-str">'notnull' </span>=> <span class="src-id">true</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a71"></a> <span class="src-str">'primary' </span>=> <span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a72"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a73"></a> <span class="src-var">$columns</span><span class="src-sym">[</span><span class="src-str">'user_ident'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'type' </span>=> <span class="src-str">'string'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a74"></a> <span class="src-str">'length' </span>=> <span class="src-num">50</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a75"></a> <span class="src-str">'notnull' </span>=> <span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a76"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a77"></a> <span class="src-var">$columns</span><span class="src-sym">[</span><span class="src-str">'timestamp_obtained'</span><span class="src-sym">] </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'type' </span>=> <span class="src-str">'integer'</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a78"></a> <span class="src-str">'length' </span>=> <span class="src-num">10</span><span class="src-sym">,</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a79"></a> <span class="src-str">'notnull' </span>=> <span class="src-id">true</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a80"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a81"></a> <span class="src-var">$options </span>= <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'primary' </span>=> <span class="src-key">array</span><span class="src-sym">(</span><span class="src-str">'object_type'</span><span class="src-sym">, </span><span class="src-str">'object_key'</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a82"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a83"></a> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-var">export</span><span class="src-sym">-></span><span class="src-id">createTable</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a><span class="src-sym">, </span><span class="src-var">$columns</span><span class="src-sym">, </span><span class="src-var">$options</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a84"></a> <span class="src-sym">} </span>catch<span class="src-sym">(</span><span class="src-id">Exception </span><span class="src-var">$e</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a85"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a86"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a87"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a88"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a89"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a90"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a91"></a><span class="src-doc"> * Obtains a lock on a </span><span class="src-doc-inlinetag">{@link Doctrine_Record}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a92"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a93"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">Doctrine_Record </span><span class="src-doc-var">$record </span><span class="src-doc"> The record that has to be locked</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a94"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">mixed </span><span class="src-doc"> </span><span class="src-doc-var">$userIdent </span><span class="src-doc"> A unique identifier of the locking user</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a95"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">boolean </span><span class="src-doc"> TRUE if the locking was successful, FALSE if another user</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a96"></a><span class="src-doc"> * holds a lock on this record</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a97"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@throws</span><span class="src-doc"> Doctrine_Locking_Exception If the locking failed due to database errors</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a98"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a99"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#methodgetLock">getLock</a><span class="src-sym">(</span><span class="src-id">Doctrine_Record </span><span class="src-var">$record</span><span class="src-sym">, </span><span class="src-var">$userIdent</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a100"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a101"></a> <span class="src-var">$objectType </span>= <span class="src-var">$record</span><span class="src-sym">-></span><span class="src-id">getTable</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">getComponentName</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a102"></a> <span class="src-var">$key </span>= <span class="src-var">$record</span><span class="src-sym">-></span><span class="src-id">obtainIdentifier</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a103"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a104"></a> <span class="src-var">$gotLock </span>= <span class="src-id">false</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a105"></a> <span class="src-var">$time </span>= <a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a106"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a107"></a> <span class="src-key">if </span><span class="src-sym">(</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$key</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a108"></a> <span class="src-comm">// Composite key</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a109"></a> <span class="src-var">$key </span>= <a href="http://www.php.net/implode">implode</a><span class="src-sym">(</span><span class="src-str">'|'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a110"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a111"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a112"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a113"></a> <span class="src-var">$dbh </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodgetDbh">getDbh</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a114"></a> <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">beginTransaction</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a115"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a116"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'INSERT INTO ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a></div></li>
|
||
|
|
<li><div class="src-line"><a name="a117"></a> . <span class="src-str">' (object_type, object_key, user_ident, timestamp_obtained)'</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a118"></a> . <span class="src-str">' VALUES (:object_type, :object_key, :user_ident, :ts_obtained)'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a119"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a120"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_type'</span><span class="src-sym">, </span><span class="src-var">$objectType</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a121"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_key'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a122"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':user_ident'</span><span class="src-sym">, </span><span class="src-var">$userIdent</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a123"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':ts_obtained'</span><span class="src-sym">, </span><span class="src-var">$time</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a124"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a125"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a126"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a127"></a> <span class="src-var">$gotLock </span>= <span class="src-id">true</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a128"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a129"></a> <span class="src-comm">// we catch an Exception here instead of PDOException since we might also be catching Doctrine_Exception</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a130"></a> <span class="src-sym">} </span>catch<span class="src-sym">(</span><span class="src-id">Exception </span><span class="src-var">$pkviolation</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a131"></a> <span class="src-comm">// PK violation occured => existing lock!</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a132"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a133"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a134"></a> <span class="src-key">if </span><span class="src-sym">( </span><span class="src-sym">! </span><span class="src-var">$gotLock</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a135"></a> <span class="src-var">$lockingUserIdent </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#method_getLockingUserIdent">_getLockingUserIdent</a><span class="src-sym">(</span><span class="src-var">$objectType</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a136"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$lockingUserIdent </span>!== <span class="src-id">null </span>&& <span class="src-var">$lockingUserIdent </span>== <span class="src-var">$userIdent</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a137"></a> <span class="src-var">$gotLock </span>= <span class="src-id">true</span><span class="src-sym">; </span><span class="src-comm">// The requesting user already has a lock</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a138"></a> <span class="src-comm">// Update timestamp</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a139"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'UPDATE ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a140"></a> . <span class="src-str">' SET timestamp_obtained = :ts'</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a141"></a> . <span class="src-str">' WHERE object_type = :object_type AND'</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a142"></a> . <span class="src-str">' object_key = :object_key AND'</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a143"></a> . <span class="src-str">' user_ident = :user_ident'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a144"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':ts'</span><span class="src-sym">, </span><span class="src-var">$time</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a145"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_type'</span><span class="src-sym">, </span><span class="src-var">$objectType</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a146"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_key'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a147"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':user_ident'</span><span class="src-sym">, </span><span class="src-var">$lockingUserIdent</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a148"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a149"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a150"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a151"></a> <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">commit</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a152"></a> <span class="src-sym">} </span>catch <span class="src-sym">(</span><span class="src-id">Exception </span><span class="src-var">$pdoe</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a153"></a> <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">rollback</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a154"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Locking_Exception.html">Doctrine_Locking_Exception</a></span><span class="src-sym">(</span><span class="src-var">$pdoe</span><span class="src-sym">-></span><span class="src-id">getMessage</span><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a155"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a156"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a157"></a> <span class="src-key">return </span><span class="src-var">$gotLock</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a158"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a159"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a160"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a161"></a><span class="src-doc"> * Releases a lock on a </span><span class="src-doc-inlinetag">{@link Doctrine_Record}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a162"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a163"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">Doctrine_Record </span><span class="src-doc-var">$record </span><span class="src-doc"> The record for which the lock has to be released</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a164"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">mixed </span><span class="src-doc"> </span><span class="src-doc-var">$userIdent </span><span class="src-doc">The unique identifier of the locking user</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a165"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">boolean </span><span class="src-doc"> TRUE if a lock was released, FALSE if no lock was released</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a166"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@throws</span><span class="src-doc"> Doctrine_Locking_Exception If the release procedure failed due to database errors</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a167"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a168"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#methodreleaseLock">releaseLock</a><span class="src-sym">(</span><span class="src-id">Doctrine_Record </span><span class="src-var">$record</span><span class="src-sym">, </span><span class="src-var">$userIdent</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a169"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a170"></a> <span class="src-var">$objectType </span>= <span class="src-var">$record</span><span class="src-sym">-></span><span class="src-id">getTable</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">getComponentName</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a171"></a> <span class="src-var">$key </span>= <span class="src-var">$record</span><span class="src-sym">-></span><span class="src-id">obtainIdentifier</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a172"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a173"></a> <span class="src-key">if </span><span class="src-sym">(</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$key</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a174"></a> <span class="src-comm">// Composite key</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a175"></a> <span class="src-var">$key </span>= <a href="http://www.php.net/implode">implode</a><span class="src-sym">(</span><span class="src-str">'|'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a176"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a177"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a178"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a179"></a> <span class="src-var">$dbh </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodgetDbh">getDbh</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a180"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">"</span><span class="src-str"><span class="src-id">DELETE</span> <span class="src-id">FROM</span> <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a> <span class="src-id">WHERE</span></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a181"></a></span><span class="src-str"> <span class="src-id">object_type</span> = :<span class="src-id">object_type</span> <span class="src-id">AND</span></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a182"></a></span><span class="src-str"> <span class="src-id">object_key</span> = :<span class="src-id">object_key</span> <span class="src-id">AND</span></span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a183"></a></span><span class="src-str"> <span class="src-id">user_ident</span> = :<span class="src-id">user_ident</span></span><span class="src-str">"</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a184"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_type'</span><span class="src-sym">, </span><span class="src-var">$objectType</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a185"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_key'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a186"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':user_ident'</span><span class="src-sym">, </span><span class="src-var">$userIdent</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a187"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a188"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a189"></a> <span class="src-var">$count </span>= <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">rowCount</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a190"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a191"></a> <span class="src-key">return </span><span class="src-sym">(</span><span class="src-var">$count </span>> <span class="src-num">0</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a192"></a> <span class="src-sym">} </span>catch <span class="src-sym">(</span><span class="src-id">PDOException </span><span class="src-var">$pdoe</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a193"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Locking_Exception.html">Doctrine_Locking_Exception</a></span><span class="src-sym">(</span><span class="src-var">$pdoe</span><span class="src-sym">-></span><span class="src-id">getMessage</span><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a194"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a195"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a196"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a197"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a198"></a><span class="src-doc"> * Gets the unique user identifier of a lock</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a199"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a200"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">string </span><span class="src-doc-var">$objectType </span><span class="src-doc"> The type of the object (component name)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a201"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">mixed </span><span class="src-doc"> </span><span class="src-doc-var">$key </span><span class="src-doc"> The unique key of the object</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a202"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">mixed </span><span class="src-doc"> The unique user identifier for the specified lock</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a203"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@throws</span><span class="src-doc"> Doctrine_Locking_Exception If the query failed due to database errors</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a204"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a205"></a> <span class="src-key">private </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#method_getLockingUserIdent">_getLockingUserIdent</a><span class="src-sym">(</span><span class="src-var">$objectType</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a206"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a207"></a> <span class="src-key">if </span><span class="src-sym">(</span><a href="http://www.php.net/is_array">is_array</a><span class="src-sym">(</span><span class="src-var">$key</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a208"></a> <span class="src-comm">// Composite key</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a209"></a> <span class="src-var">$key </span>= <a href="http://www.php.net/implode">implode</a><span class="src-sym">(</span><span class="src-str">'|'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a210"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a211"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a212"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a213"></a> <span class="src-var">$dbh </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodgetDbh">getDbh</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a214"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'SELECT user_ident FROM ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a></div></li>
|
||
|
|
<li><div class="src-line"><a name="a215"></a> . <span class="src-str">' WHERE object_type = :object_type AND object_key = :object_key'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a216"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_type'</span><span class="src-sym">, </span><span class="src-var">$objectType</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a217"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_key'</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a218"></a> <span class="src-var">$success </span>= <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a219"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a220"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-sym">!</span><span class="src-var">$success</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a221"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Locking_Exception.html">Doctrine_Locking_Exception</a></span><span class="src-sym">(</span><span class="src-str">"Failed to determine locking user"</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a222"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a223"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a224"></a> <span class="src-var">$userIdent </span>= <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">fetchColumn</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a225"></a> <span class="src-sym">} </span>catch <span class="src-sym">(</span><span class="src-id">PDOException </span><span class="src-var">$pdoe</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a226"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Locking_Exception.html">Doctrine_Locking_Exception</a></span><span class="src-sym">(</span><span class="src-var">$pdoe</span><span class="src-sym">-></span><span class="src-id">getMessage</span><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a227"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a228"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a229"></a> <span class="src-key">return </span><span class="src-var">$userIdent</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a230"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a231"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a232"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a233"></a><span class="src-doc"> * Gets the identifier that identifies the owner of the lock on the given</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a234"></a><span class="src-doc"> * record.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a235"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a236"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">Doctrine_Record </span><span class="src-doc-var">$lockedRecord </span><span class="src-doc"> The record.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a237"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">mixed </span><span class="src-doc">The unique user identifier that identifies the owner of the lock.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a238"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a239"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#methodgetLockOwner">getLockOwner</a><span class="src-sym">(</span><span class="src-var">$lockedRecord</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a240"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a241"></a> <span class="src-var">$objectType </span>= <span class="src-var">$lockedRecord</span><span class="src-sym">-></span><span class="src-id">getTable</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">getComponentName</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a242"></a> <span class="src-var">$key </span>= <span class="src-var">$lockedRecord</span><span class="src-sym">-></span><span class="src-id">obtainIdentifier</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a243"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#method_getLockingUserIdent">_getLockingUserIdent</a><span class="src-sym">(</span><span class="src-var">$objectType</span><span class="src-sym">, </span><span class="src-var">$key</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a244"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a245"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a246"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a247"></a><span class="src-doc"> * Releases locks older than a defined amount of seconds</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a248"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a249"></a><span class="src-doc"> * When called without parameters all locks older than 15 minutes are released.</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a250"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a251"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">integer </span><span class="src-doc-var">$age </span><span class="src-doc"> The maximum valid age of locks in seconds</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a252"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">string </span><span class="src-doc"> </span><span class="src-doc-var">$objectType </span><span class="src-doc"> The type of the object (component name)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a253"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc"> </span><span class="src-doc-type">mixed </span><span class="src-doc"> </span><span class="src-doc-var">$userIdent </span><span class="src-doc">The unique identifier of the locking user</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a254"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">integer </span><span class="src-doc">The number of locks that have been released</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a255"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@throws</span><span class="src-doc"> Doctrine_Locking_Exception If the release process failed due to database errors</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a256"></a><span class="src-doc"> */</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a257"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#methodreleaseAgedLocks">releaseAgedLocks</a><span class="src-sym">(</span><span class="src-var">$age </span>= <span class="src-num">900</span><span class="src-sym">, </span><span class="src-var">$objectType </span>= <span class="src-id">null</span><span class="src-sym">, </span><span class="src-var">$userIdent </span>= <span class="src-id">null</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a258"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a259"></a> <span class="src-var">$age </span>= <a href="http://www.php.net/time">time</a><span class="src-sym">(</span><span class="src-sym">) </span>- <span class="src-var">$age</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a260"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a261"></a> try <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a262"></a> <span class="src-var">$dbh </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$conn">conn</a><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection.html#methodgetDbh">getDbh</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a263"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-str">'DELETE FROM ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a> . <span class="src-str">' WHERE timestamp_obtained < :age'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a264"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':age'</span><span class="src-sym">, </span><span class="src-var">$age</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a265"></a> <span class="src-var">$query </span>= <span class="src-str">'DELETE FROM ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Locking_Manager_Pessimistic.html#var$_lockTable">_lockTable</a> . <span class="src-str">' WHERE timestamp_obtained < :age'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a266"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$objectType</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a267"></a> <span class="src-var">$query </span>.= <span class="src-str">' AND object_type = :object_type'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a268"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a269"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$userIdent</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a270"></a> <span class="src-var">$query </span>.= <span class="src-str">' AND user_ident = :user_ident'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a271"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a272"></a> <span class="src-var">$stmt </span>= <span class="src-var">$dbh</span><span class="src-sym">-></span><span class="src-id">prepare</span><span class="src-sym">(</span><span class="src-var">$query</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a273"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':age'</span><span class="src-sym">, </span><span class="src-var">$age</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a274"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$objectType</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a275"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':object_type'</span><span class="src-sym">, </span><span class="src-var">$objectType</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a276"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a277"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$userIdent</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a278"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">bindParam</span><span class="src-sym">(</span><span class="src-str">':user_ident'</span><span class="src-sym">, </span><span class="src-var">$userIdent</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a279"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a280"></a> <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a281"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a282"></a> <span class="src-var">$count </span>= <span class="src-var">$stmt</span><span class="src-sym">-></span><span class="src-id">rowCount</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a283"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a284"></a> <span class="src-key">return </span><span class="src-var">$count</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a285"></a> <span class="src-sym">} </span>catch <span class="src-sym">(</span><span class="src-id">PDOException </span><span class="src-var">$pdoe</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a286"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Locking_Exception.html">Doctrine_Locking_Exception</a></span><span class="src-sym">(</span><span class="src-var">$pdoe</span><span class="src-sym">-></span><span class="src-id">getMessage</span><span class="src-sym">(</span><span class="src-sym">))</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a287"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a288"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a289"></a> </div></li>
|
||
|
|
<li><div class="src-line"><a name="a290"></a><span class="src-sym">}</span></div></li>
|
||
|
|
</ol>
|
||
|
|
</span></div>
|
||
|
|
</div>
|