102 lines
24 KiB
HTML
102 lines
24 KiB
HTML
|
|
||
|
|
<div id="content">
|
||
|
|
<h1 align="center">Source for file Association.php</h1>
|
||
|
|
<p>Documentation is available at <a href="../Doctrine/_Doctrine---Relation---Association.php.html">Association.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: Association.php 2212 2007-08-11 18:24:19Z nightfreak $</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_Relation'</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_Relation_Association this class takes care of association mapping</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a24"></a><span class="src-doc"> * (= many-to-many relationships, where the relationship is handled with an additional relational table</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a25"></a><span class="src-doc"> * which holds 2 foreign keys)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a26"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a27"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a28"></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="a29"></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="a30"></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="a31"></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="a32"></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="a33"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@version</span><span class="src-doc"> $Revision: 2212 $</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a34"></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="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_Relation_Association.html">Doctrine_Relation_Association</a> <span class="src-key">extends </span><a href="../Doctrine/Doctrine_Relation.html">Doctrine_Relation</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"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">Doctrine_Table </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-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Relation_Association.html#methodgetAssociationFactory">getAssociationFactory</a><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a42"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a43"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'refTable'</span><span class="src-sym">]</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-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Relation_Association.html#methodgetAssociationTable">getAssociationTable</a><span class="src-sym">(</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a46"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a47"></a> <span class="src-key">return </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'refTable'</span><span class="src-sym">]</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a48"></a> <span class="src-sym">}</span></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"> * getRelationDql</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"> * </span><span class="src-doc-coretag">@param </span><span class="src-doc-type">integer </span><span class="src-doc-var">$count </span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a53"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">string </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-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Relation_Association.html#methodgetRelationDql">getRelationDql</a><span class="src-sym">(</span><span class="src-var">$count</span><span class="src-sym">, </span><span class="src-var">$context </span>= <span class="src-str">'record'</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a56"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a57"></a> <span class="src-var">$component </span>= <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'refTable'</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="a58"></a> <span class="src-key">switch </span><span class="src-sym">(</span><span class="src-var">$context</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-key">case </span><span class="src-str">"record"</span>:</div></li>
|
||
|
|
<li><div class="src-line"><a name="a60"></a> <span class="src-var">$sub </span>= <a href="http://www.php.net/substr">substr</a><span class="src-sym">(</span><a href="http://www.php.net/str_repeat">str_repeat</a><span class="src-sym">(</span><span class="src-str">"?, "</span><span class="src-sym">, </span><span class="src-var">$count</span><span class="src-sym">)</span><span class="src-sym">,</span><span class="src-num">0</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="a61"></a> <span class="src-var">$dql </span>= <span class="src-str">'FROM ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#methodgetTable">getTable</a><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="a62"></a> <span class="src-var">$dql </span>.= <span class="src-str">'.' </span>. <span class="src-var">$component</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a63"></a> <span class="src-var">$dql </span>.= <span class="src-str">' WHERE ' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#methodgetTable">getTable</a><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></div></li>
|
||
|
|
<li><div class="src-line"><a name="a64"></a> . <span class="src-str">'.' </span>. <span class="src-var">$component </span>. <span class="src-str">'.' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'local'</span><span class="src-sym">] </span>. <span class="src-str">' IN (' </span>. <span class="src-var">$sub </span>. <span class="src-str">')'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a65"></a> <span class="src-key">break</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a66"></a> <span class="src-key">case </span><span class="src-str">"collection"</span>:</div></li>
|
||
|
|
<li><div class="src-line"><a name="a67"></a> <span class="src-var">$sub </span>= <a href="http://www.php.net/substr">substr</a><span class="src-sym">(</span><a href="http://www.php.net/str_repeat">str_repeat</a><span class="src-sym">(</span><span class="src-str">"?, "</span><span class="src-sym">, </span><span class="src-var">$count</span><span class="src-sym">)</span><span class="src-sym">,</span><span class="src-num">0</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="a68"></a> <span class="src-var">$dql </span>= <span class="src-str">'FROM ' </span>. <span class="src-var">$component </span>. <span class="src-str">'.' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#methodgetTable">getTable</a><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="a69"></a> <span class="src-var">$dql </span>.= <span class="src-str">' WHERE ' </span>. <span class="src-var">$component </span>. <span class="src-str">'.' </span>. <span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'local'</span><span class="src-sym">] </span>. <span class="src-str">' IN (' </span>. <span class="src-var">$sub </span>. <span class="src-str">')'</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a70"></a> <span class="src-key">break</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a71"></a> <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-key">return </span><span class="src-var">$dql</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a74"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a75"></a> <span class="src-doc">/**</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a76"></a><span class="src-doc"> * fetchRelatedFor</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-doc"> * fetches a component related to given record</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a79"></a><span class="src-doc"> *</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a80"></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">$record </span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a81"></a><span class="src-doc"> * </span><span class="src-doc-coretag">@return </span><span class="src-doc-type">Doctrine_Record</span><span class="src-doc">|</span><span class="src-doc-type">Doctrine_Collection</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-key">public </span><span class="src-key">function </span><a href="../Doctrine/Doctrine_Relation_Association.html#methodfetchRelatedFor">fetchRelatedFor</a><span class="src-sym">(</span><span class="src-id">Doctrine_Record </span><span class="src-var">$record</span><span class="src-sym">)</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a84"></a> <span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a85"></a> <span class="src-var">$id </span>= <span class="src-var">$record</span><span class="src-sym">-></span><span class="src-id">getIncremented</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="a86"></a> <span class="src-key">if </span><span class="src-sym">(</span><span class="src-key">empty</span><span class="src-sym">(</span><span class="src-var">$id</span><span class="src-sym">) </span>|| <span class="src-sym">! </span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#var$definition">definition</a><span class="src-sym">[</span><span class="src-str">'table'</span><span class="src-sym">]</span><span class="src-sym">-></span><span class="src-id">getAttribute</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">ATTR_LOAD_REFERENCES</span><span class="src-sym">)) </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a87"></a> <span class="src-var">$coll </span>= <span class="src-key">new </span><span class="src-id"><a href="../Doctrine/Doctrine_Collection.html">Doctrine_Collection</a></span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation.html#methodgetTable">getTable</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="a88"></a> <span class="src-sym">} </span><span class="src-key">else </span><span class="src-sym">{</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a89"></a> <span class="src-var">$coll </span>= <span class="src-id"><a href="../Doctrine/Doctrine_Query.html">Doctrine_Query</a></span><span class="src-sym">::</span><a href="../Doctrine/Doctrine_Query.html#methodcreate">create</a><span class="src-sym">(</span><span class="src-sym">)</span><span class="src-sym">-></span><span class="src-id">parseQuery</span><span class="src-sym">(</span><span class="src-var">$this</span><span class="src-sym">-></span><a href="../Doctrine/Doctrine_Relation_Association.html#methodgetRelationDql">getRelationDql</a><span class="src-sym">(</span><span class="src-num">1</span><span class="src-sym">))</span><span class="src-sym">-></span><span class="src-id">execute</span><span class="src-sym">(</span><span class="src-key">array</span><span class="src-sym">(</span><span class="src-var">$id</span><span class="src-sym">))</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">$coll</span><span class="src-sym">-></span><span class="src-id">setReference</span><span class="src-sym">(</span><span class="src-var">$record</span><span class="src-sym">, </span><span class="src-var">$this</span><span class="src-sym">)</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a92"></a> <span class="src-key">return </span><span class="src-var">$coll</span><span class="src-sym">;</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a93"></a> <span class="src-sym">}</span></div></li>
|
||
|
|
<li><div class="src-line"><a name="a94"></a><span class="src-sym">}</span></div></li>
|
||
|
|
</ol>
|
||
|
|
</span></div>
|
||
|
|
</div>
|