113 lines
26 KiB
HTML
113 lines
26 KiB
HTML
|
|
<div id="content">
|
|
<h1 align="center">Source for file Firebird.php</h1>
|
|
<p>Documentation is available at <a href="../Doctrine/_Doctrine---Sequence---Firebird.php.html">Firebird.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: Firebird.php 1619 2007-06-10 19:28:47Z 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-id"><a href="../Doctrine/Doctrine.html">Doctrine</a></span><span class="src-sym">::</span><a href="../Doctrine/Doctrine.html#methodautoload">autoload</a><span class="src-sym">(</span><span class="src-str">'Doctrine_Sequence'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a22"></a><span class="src-doc">/**</span></div></li>
|
|
<li><div class="src-line"><a name="a23"></a><span class="src-doc"> * Doctrine_Sequence_Firebird</span></div></li>
|
|
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> *</span></div></li>
|
|
<li><div class="src-line"><a name="a25"></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="a26"></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="a27"></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="a28"></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="a29"></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="a30"></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="a31"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Revision: 1619 $</span></div></li>
|
|
<li><div class="src-line"><a name="a32"></a><span class="src-doc"> */</span></div></li>
|
|
<li><div class="src-line"><a name="a33"></a><span class="src-key">class </span><a href="../Doctrine/Doctrine_Sequence_Firebird.html">Doctrine_Sequence_Firebird</a> <span class="src-key">extends </span><a href="../Doctrine/Doctrine_Sequence.html">Doctrine_Sequence</a></div></li>
|
|
<li><div class="src-line"><a name="a34"></a><span class="src-sym">{</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-doc"> * Returns the next free id of a sequence</span></div></li>
|
|
<li><div class="src-line"><a name="a37"></a><span class="src-doc"> *</span></div></li>
|
|
<li><div class="src-line"><a name="a38"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$seqName </span><span class="src-doc"> name of the sequence</span></div></li>
|
|
<li><div class="src-line"><a name="a39"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">bool </span><span class="src-doc"> when true missing sequences are automatic created</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">@return </span><span class="src-doc-type">integer </span><span class="src-doc"> next id in the given sequence</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">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Sequence_Firebird.html#methodnextID">nextID</a><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">, </span><span class="src-var">$onDemand </span>= <span class="src-id">true</span><span class="src-sym">)</span></div></li>
|
|
<li><div class="src-line"><a name="a44"></a> <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a45"></a> <span class="src-var">$sequenceName </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">quoteIdentifier</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">formatter</span><span class="src-sym">-></span><span class="src-id">getSequenceName</span><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">)</span><span class="src-sym">, </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="a46"></a> </div></li>
|
|
<li><div class="src-line"><a name="a47"></a> <span class="src-var">$query </span>= <span class="src-str">'SELECT GEN_ID(' </span>. <span class="src-var">$sequenceName </span>. <span class="src-str">', 1) as the_value FROM RDB$DATABASE'</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a48"></a> try <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a49"></a> </div></li>
|
|
<li><div class="src-line"><a name="a50"></a> <span class="src-var">$result </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">fetchOne</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="a51"></a> </div></li>
|
|
<li><div class="src-line"><a name="a52"></a> <span class="src-sym">} </span>catch<span class="src-sym">(</span><span class="src-id"><a href="../Doctrine/Doctrine_Connection_Exception.html">Doctrine_Connection_Exception</a> </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="a53"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-var">$onDemand </span>&& <span class="src-var">$e</span><span class="src-sym">-></span><span class="src-id">getPortableCode</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">ERR_NOSUCHTABLE</span><span class="src-sym">) </span><span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a54"></a> <span class="src-comm">// Since we are creating the sequence on demand</span></div></li>
|
|
<li><div class="src-line"><a name="a55"></a> <span class="src-comm">// we know the first id = 1 so initialize the</span></div></li>
|
|
<li><div class="src-line"><a name="a56"></a> <span class="src-comm">// sequence at 2</span></div></li>
|
|
<li><div class="src-line"><a name="a57"></a> try <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a58"></a> <span class="src-var">$result </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">export</span><span class="src-sym">-></span><span class="src-id">createSequence</span><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">, </span><span class="src-num">2</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a59"></a> <span class="src-sym">} </span>catch<span class="src-sym">(</span><span class="src-id"><a href="../Doctrine/Doctrine_Exception.html">Doctrine_Exception</a> </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="a60"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Sequence_Exception.html">Doctrine_Sequence_Exception</a></span><span class="src-sym">(</span><span class="src-str">'on demand sequence ' </span>. <span class="src-var">$seqName </span>. <span class="src-str">' could not be created'</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a61"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a62"></a> <span class="src-comm">// First ID of a newly created sequence is 1</span></div></li>
|
|
<li><div class="src-line"><a name="a63"></a> <span class="src-comm">// return 1;</span></div></li>
|
|
<li><div class="src-line"><a name="a64"></a> <span class="src-comm">// BUT generators are not always reset, so return the actual value</span></div></li>
|
|
<li><div class="src-line"><a name="a65"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><span class="src-id">currID</span><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a66"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a67"></a> throw <span class="src-var">$e</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a68"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a69"></a> <span class="src-key">return </span><span class="src-var">$result</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a70"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a71"></a> <span class="src-doc">/**</span></div></li>
|
|
<li><div class="src-line"><a name="a72"></a><span class="src-doc"> * Returns the autoincrement ID if supported or $id or fetches the current</span></div></li>
|
|
<li><div class="src-line"><a name="a73"></a><span class="src-doc"> * ID in a sequence called: $table.(empty($field) ? '' : '_'.$field)</span></div></li>
|
|
<li><div class="src-line"><a name="a74"></a><span class="src-doc"> *</span></div></li>
|
|
<li><div class="src-line"><a name="a75"></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"> name of the table into which a new row was inserted</span></div></li>
|
|
<li><div class="src-line"><a name="a76"></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"> name of the field into which a new row was inserted</span></div></li>
|
|
<li><div class="src-line"><a name="a77"></a><span class="src-doc"> */</span></div></li>
|
|
<li><div class="src-line"><a name="a78"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Sequence_Firebird.html#methodlastInsertId">lastInsertId</a><span class="src-sym">(</span><span class="src-var">$table </span>= <span class="src-id">null</span><span class="src-sym">, </span><span class="src-var">$field </span>= <span class="src-id">null</span><span class="src-sym">)</span></div></li>
|
|
<li><div class="src-line"><a name="a79"></a> <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a80"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">getDbh</span><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">lastInsertId</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="a81"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a82"></a> <span class="src-doc">/**</span></div></li>
|
|
<li><div class="src-line"><a name="a83"></a><span class="src-doc"> * Returns the current id of a sequence</span></div></li>
|
|
<li><div class="src-line"><a name="a84"></a><span class="src-doc"> *</span></div></li>
|
|
<li><div class="src-line"><a name="a85"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">string </span><span class="src-doc-var">$seqName </span><span class="src-doc"> name of the sequence</span></div></li>
|
|
<li><div class="src-line"><a name="a86"></a><span class="src-doc"> *</span></div></li>
|
|
<li><div class="src-line"><a name="a87"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">integer </span><span class="src-doc"> current id in the given sequence</span></div></li>
|
|
<li><div class="src-line"><a name="a88"></a><span class="src-doc"> */</span></div></li>
|
|
<li><div class="src-line"><a name="a89"></a> <span class="src-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Sequence_Firebird.html#methodcurrId">currId</a><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">)</span></div></li>
|
|
<li><div class="src-line"><a name="a90"></a> <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a91"></a> <span class="src-var">$sequenceName </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">quoteIdentifier</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">formatter</span><span class="src-sym">-></span><span class="src-id">getSequenceName</span><span class="src-sym">(</span><span class="src-var">$seqName</span><span class="src-sym">)</span><span class="src-sym">, </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="a92"></a> </div></li>
|
|
<li><div class="src-line"><a name="a93"></a> </div></li>
|
|
<li><div class="src-line"><a name="a94"></a> <span class="src-var">$query </span>= <span class="src-str">'SELECT GEN_ID(' </span>. <span class="src-var">$sequenceName </span>. <span class="src-str">', 0) as the_value FROM RDB$DATABASE'</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a95"></a> try <span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a96"></a> <span class="src-var">$value </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Connection_Module.html#var$conn">conn</a><span class="src-sym">-></span><span class="src-id">fetchOne</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="a97"></a> <span class="src-sym">} </span>catch<span class="src-sym">(</span><span class="src-id"><a href="../Doctrine/Doctrine_Connection_Exception.html">Doctrine_Connection_Exception</a> </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="a98"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Sequence_Exception.html">Doctrine_Sequence_Exception</a></span><span class="src-sym">(</span><span class="src-str">'Unable to select from ' </span>. <span class="src-var">$seqName</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a99"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a100"></a> <span class="src-key">if </span><span class="src-sym">( </span><span class="src-sym">! </span><a href="http://www.php.net/is_numeric">is_numeric</a><span class="src-sym">(</span><span class="src-var">$value</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
|
|
<li><div class="src-line"><a name="a101"></a> throw <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Sequence_Exception.html">Doctrine_Sequence_Exception</a></span><span class="src-sym">(</span><span class="src-str">'could not find value in sequence table'</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-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a103"></a> <span class="src-key">return </span><span class="src-var">$value</span><span class="src-sym">;</span></div></li>
|
|
<li><div class="src-line"><a name="a104"></a> <span class="src-sym">}</span></div></li>
|
|
<li><div class="src-line"><a name="a105"></a><span class="src-sym">}</span></div></li>
|
|
</ol>
|
|
</span></div>
|
|
</div> |