<html> <head> <title>Coverage for Doctrine_Collection</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Collection</h1><p><a href="index.php">Back to coverage report</a></p><table> <tr><td>1</td> <td class="normal"><?php </td></tr> <tr><td>2</td> <td class="normal">/* </td></tr> <tr><td>3</td> <td class="normal"> * $Id: Collection.php 2761 2007-10-07 23:42:29Z zYne $ </td></tr> <tr><td>4</td> <td class="normal"> * </td></tr> <tr><td>5</td> <td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS </td></tr> <tr><td>6</td> <td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT </td></tr> <tr><td>7</td> <td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR </td></tr> <tr><td>8</td> <td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT </td></tr> <tr><td>9</td> <td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, </td></tr> <tr><td>10</td> <td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT </td></tr> <tr><td>11</td> <td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, </td></tr> <tr><td>12</td> <td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY </td></tr> <tr><td>13</td> <td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT </td></tr> <tr><td>14</td> <td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE </td></tr> <tr><td>15</td> <td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </td></tr> <tr><td>16</td> <td class="normal"> * </td></tr> <tr><td>17</td> <td class="normal"> * This software consists of voluntary contributions made by many individuals </td></tr> <tr><td>18</td> <td class="normal"> * and is licensed under the LGPL. For more information, see </td></tr> <tr><td>19</td> <td class="normal"> * <http://www.phpdoctrine.com>. </td></tr> <tr><td>20</td> <td class="normal"> */ </td></tr> <tr><td>21</td> <td class="covered">Doctrine::autoload('Doctrine_Access'); </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Collection </td></tr> <tr><td>24</td> <td class="normal"> * Collection of Doctrine_Record objects. </td></tr> <tr><td>25</td> <td class="normal"> * </td></tr> <tr><td>26</td> <td class="normal"> * @package Doctrine </td></tr> <tr><td>27</td> <td class="normal"> * @subpackage Collection </td></tr> <tr><td>28</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>29</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>30</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>31</td> <td class="normal"> * @version $Revision: 2761 $ </td></tr> <tr><td>32</td> <td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>33</td> <td class="normal"> */ </td></tr> <tr><td>34</td> <td class="covered">class Doctrine_Collection extends Doctrine_Access implements Countable, IteratorAggregate, Serializable </td></tr> <tr><td>35</td> <td class="normal">{ </td></tr> <tr><td>36</td> <td class="normal"> /** </td></tr> <tr><td>37</td> <td class="normal"> * @var array $data an array containing the records of this collection </td></tr> <tr><td>38</td> <td class="normal"> */ </td></tr> <tr><td>39</td> <td class="normal"> protected $data = array(); </td></tr> <tr><td>40</td> <td class="normal"> /** </td></tr> <tr><td>41</td> <td class="normal"> * @var Doctrine_Table $table each collection has only records of specified table </td></tr> <tr><td>42</td> <td class="normal"> */ </td></tr> <tr><td>43</td> <td class="normal"> protected $_table; </td></tr> <tr><td>44</td> <td class="normal"> /** </td></tr> <tr><td>45</td> <td class="normal"> * @var array $_snapshot a snapshot of the fetched data </td></tr> <tr><td>46</td> <td class="normal"> */ </td></tr> <tr><td>47</td> <td class="normal"> protected $_snapshot = array(); </td></tr> <tr><td>48</td> <td class="normal"> /** </td></tr> <tr><td>49</td> <td class="normal"> * @var Doctrine_Record $reference collection can belong to a record </td></tr> <tr><td>50</td> <td class="normal"> */ </td></tr> <tr><td>51</td> <td class="normal"> protected $reference; </td></tr> <tr><td>52</td> <td class="normal"> /** </td></tr> <tr><td>53</td> <td class="normal"> * @var string $referenceField the reference field of the collection </td></tr> <tr><td>54</td> <td class="normal"> */ </td></tr> <tr><td>55</td> <td class="normal"> protected $referenceField; </td></tr> <tr><td>56</td> <td class="normal"> /** </td></tr> <tr><td>57</td> <td class="normal"> * @var Doctrine_Relation the record this collection is related to, if any </td></tr> <tr><td>58</td> <td class="normal"> */ </td></tr> <tr><td>59</td> <td class="normal"> protected $relation; </td></tr> <tr><td>60</td> <td class="normal"> /** </td></tr> <tr><td>61</td> <td class="normal"> * @var string $keyColumn the name of the column that is used for collection key mapping </td></tr> <tr><td>62</td> <td class="normal"> */ </td></tr> <tr><td>63</td> <td class="normal"> protected $keyColumn; </td></tr> <tr><td>64</td> <td class="normal"> /** </td></tr> <tr><td>65</td> <td class="normal"> * @var Doctrine_Null $null used for extremely fast null value testing </td></tr> <tr><td>66</td> <td class="normal"> */ </td></tr> <tr><td>67</td> <td class="normal"> protected static $null; </td></tr> <tr><td>68</td> <td class="normal"> </td></tr> <tr><td>69</td> <td class="normal"> </td></tr> <tr><td>70</td> <td class="normal"> /** </td></tr> <tr><td>71</td> <td class="normal"> * constructor </td></tr> <tr><td>72</td> <td class="normal"> * </td></tr> <tr><td>73</td> <td class="normal"> * @param Doctrine_Table|string $table </td></tr> <tr><td>74</td> <td class="normal"> */ </td></tr> <tr><td>75</td> <td class="normal"> public function __construct($table, $keyColumn = null) </td></tr> <tr><td>76</td> <td class="normal"> { </td></tr> <tr><td>77</td> <td class="covered"> if ( ! ($table instanceof Doctrine_Table)) { </td></tr> <tr><td>78</td> <td class="covered"> $table = Doctrine_Manager::getInstance() </td></tr> <tr><td>79</td> <td class="covered"> ->getTable($table); </td></tr> <tr><td>80</td> <td class="covered"> } </td></tr> <tr><td>81</td> <td class="covered"> $this->_table = $table; </td></tr> <tr><td>82</td> <td class="normal"> </td></tr> <tr><td>83</td> <td class="covered"> if ($keyColumn === null) { </td></tr> <tr><td>84</td> <td class="covered"> $keyColumn = $table->getBoundQueryPart('indexBy'); </td></tr> <tr><td>85</td> <td class="covered"> } </td></tr> <tr><td>86</td> <td class="normal"> </td></tr> <tr><td>87</td> <td class="covered"> if ($keyColumn !== null) { </td></tr> <tr><td>88</td> <td class="covered"> $this->keyColumn = $keyColumn; </td></tr> <tr><td>89</td> <td class="covered"> } </td></tr> <tr><td>90</td> <td class="covered"> } </td></tr> <tr><td>91</td> <td class="normal"> /** </td></tr> <tr><td>92</td> <td class="normal"> * initNullObject </td></tr> <tr><td>93</td> <td class="normal"> * initializes the null object for this collection </td></tr> <tr><td>94</td> <td class="normal"> * </td></tr> <tr><td>95</td> <td class="normal"> * @return void </td></tr> <tr><td>96</td> <td class="normal"> */ </td></tr> <tr><td>97</td> <td class="normal"> public static function initNullObject(Doctrine_Null $null) </td></tr> <tr><td>98</td> <td class="normal"> { </td></tr> <tr><td>99</td> <td class="red"> self::$null = $null; </td></tr> <tr><td>100</td> <td class="red"> } </td></tr> <tr><td>101</td> <td class="normal"> /** </td></tr> <tr><td>102</td> <td class="normal"> * getTable </td></tr> <tr><td>103</td> <td class="normal"> * returns the table this collection belongs to </td></tr> <tr><td>104</td> <td class="normal"> * </td></tr> <tr><td>105</td> <td class="normal"> * @return Doctrine_Table </td></tr> <tr><td>106</td> <td class="normal"> */ </td></tr> <tr><td>107</td> <td class="normal"> public function getTable() </td></tr> <tr><td>108</td> <td class="normal"> { </td></tr> <tr><td>109</td> <td class="covered"> return $this->_table; </td></tr> <tr><td>110</td> <td class="orange"> } </td></tr> <tr><td>111</td> <td class="normal"> /** </td></tr> <tr><td>112</td> <td class="normal"> * setData </td></tr> <tr><td>113</td> <td class="normal"> * </td></tr> <tr><td>114</td> <td class="normal"> * @param array $data </td></tr> <tr><td>115</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>116</td> <td class="normal"> */ </td></tr> <tr><td>117</td> <td class="normal"> public function setData(array $data) </td></tr> <tr><td>118</td> <td class="normal"> { </td></tr> <tr><td>119</td> <td class="covered"> $this->data = $data; </td></tr> <tr><td>120</td> <td class="covered"> } </td></tr> <tr><td>121</td> <td class="normal"> /** </td></tr> <tr><td>122</td> <td class="normal"> * this method is automatically called when this Doctrine_Collection is serialized </td></tr> <tr><td>123</td> <td class="normal"> * </td></tr> <tr><td>124</td> <td class="normal"> * @return array </td></tr> <tr><td>125</td> <td class="normal"> */ </td></tr> <tr><td>126</td> <td class="normal"> public function serialize() </td></tr> <tr><td>127</td> <td class="normal"> { </td></tr> <tr><td>128</td> <td class="red"> $vars = get_object_vars($this); </td></tr> <tr><td>129</td> <td class="normal"> </td></tr> <tr><td>130</td> <td class="red"> unset($vars['reference']); </td></tr> <tr><td>131</td> <td class="red"> unset($vars['reference_field']); </td></tr> <tr><td>132</td> <td class="red"> unset($vars['relation']); </td></tr> <tr><td>133</td> <td class="red"> unset($vars['expandable']); </td></tr> <tr><td>134</td> <td class="red"> unset($vars['expanded']); </td></tr> <tr><td>135</td> <td class="red"> unset($vars['generator']); </td></tr> <tr><td>136</td> <td class="normal"> </td></tr> <tr><td>137</td> <td class="red"> $vars['_table'] = $vars['_table']->getComponentName(); </td></tr> <tr><td>138</td> <td class="normal"> </td></tr> <tr><td>139</td> <td class="red"> return serialize($vars); </td></tr> <tr><td>140</td> <td class="orange"> } </td></tr> <tr><td>141</td> <td class="normal"> /** </td></tr> <tr><td>142</td> <td class="normal"> * unseralize </td></tr> <tr><td>143</td> <td class="normal"> * this method is automatically called everytime a Doctrine_Collection object is unserialized </td></tr> <tr><td>144</td> <td class="normal"> * </td></tr> <tr><td>145</td> <td class="normal"> * @return void </td></tr> <tr><td>146</td> <td class="normal"> */ </td></tr> <tr><td>147</td> <td class="normal"> public function unserialize($serialized) </td></tr> <tr><td>148</td> <td class="normal"> { </td></tr> <tr><td>149</td> <td class="red"> $manager = Doctrine_Manager::getInstance(); </td></tr> <tr><td>150</td> <td class="red"> $connection = $manager->getCurrentConnection(); </td></tr> <tr><td>151</td> <td class="normal"> </td></tr> <tr><td>152</td> <td class="red"> $array = unserialize($serialized); </td></tr> <tr><td>153</td> <td class="normal"> </td></tr> <tr><td>154</td> <td class="red"> foreach ($array as $name => $values) { </td></tr> <tr><td>155</td> <td class="red"> $this->$name = $values; </td></tr> <tr><td>156</td> <td class="red"> } </td></tr> <tr><td>157</td> <td class="normal"> </td></tr> <tr><td>158</td> <td class="red"> $this->_table = $connection->getTable($this->_table); </td></tr> <tr><td>159</td> <td class="normal"> </td></tr> <tr><td>160</td> <td class="red"> if ($keyColumn === null) { </td></tr> <tr><td>161</td> <td class="red"> $keyColumn = $this->_table->getBoundQueryPart('indexBy'); </td></tr> <tr><td>162</td> <td class="red"> } </td></tr> <tr><td>163</td> <td class="normal"> </td></tr> <tr><td>164</td> <td class="red"> if ($keyColumn !== null) { </td></tr> <tr><td>165</td> <td class="red"> $this->keyColumn = $keyColumn; </td></tr> <tr><td>166</td> <td class="red"> } </td></tr> <tr><td>167</td> <td class="red"> } </td></tr> <tr><td>168</td> <td class="normal"> /** </td></tr> <tr><td>169</td> <td class="normal"> * setKeyColumn </td></tr> <tr><td>170</td> <td class="normal"> * sets the key column for this collection </td></tr> <tr><td>171</td> <td class="normal"> * </td></tr> <tr><td>172</td> <td class="normal"> * @param string $column </td></tr> <tr><td>173</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>174</td> <td class="normal"> */ </td></tr> <tr><td>175</td> <td class="normal"> public function setKeyColumn($column) </td></tr> <tr><td>176</td> <td class="normal"> { </td></tr> <tr><td>177</td> <td class="red"> $this->keyColumn = $column; </td></tr> <tr><td>178</td> <td class="normal"> </td></tr> <tr><td>179</td> <td class="red"> return $this; </td></tr> <tr><td>180</td> <td class="orange"> } </td></tr> <tr><td>181</td> <td class="normal"> /** </td></tr> <tr><td>182</td> <td class="normal"> * getKeyColumn </td></tr> <tr><td>183</td> <td class="normal"> * returns the name of the key column </td></tr> <tr><td>184</td> <td class="normal"> * </td></tr> <tr><td>185</td> <td class="normal"> * @return string </td></tr> <tr><td>186</td> <td class="normal"> */ </td></tr> <tr><td>187</td> <td class="normal"> public function getKeyColumn() </td></tr> <tr><td>188</td> <td class="normal"> { </td></tr> <tr><td>189</td> <td class="red"> return $this->column; </td></tr> <tr><td>190</td> <td class="orange"> } </td></tr> <tr><td>191</td> <td class="normal"> /** </td></tr> <tr><td>192</td> <td class="normal"> * getData </td></tr> <tr><td>193</td> <td class="normal"> * returns all the records as an array </td></tr> <tr><td>194</td> <td class="normal"> * </td></tr> <tr><td>195</td> <td class="normal"> * @return array </td></tr> <tr><td>196</td> <td class="normal"> */ </td></tr> <tr><td>197</td> <td class="normal"> public function getData() </td></tr> <tr><td>198</td> <td class="normal"> { </td></tr> <tr><td>199</td> <td class="covered"> return $this->data; </td></tr> <tr><td>200</td> <td class="orange"> } </td></tr> <tr><td>201</td> <td class="normal"> /** </td></tr> <tr><td>202</td> <td class="normal"> * getFirst </td></tr> <tr><td>203</td> <td class="normal"> * returns the first record in the collection </td></tr> <tr><td>204</td> <td class="normal"> * </td></tr> <tr><td>205</td> <td class="normal"> * @return mixed </td></tr> <tr><td>206</td> <td class="normal"> */ </td></tr> <tr><td>207</td> <td class="normal"> public function getFirst() </td></tr> <tr><td>208</td> <td class="normal"> { </td></tr> <tr><td>209</td> <td class="covered"> return reset($this->data); </td></tr> <tr><td>210</td> <td class="orange"> } </td></tr> <tr><td>211</td> <td class="normal"> /** </td></tr> <tr><td>212</td> <td class="normal"> * getLast </td></tr> <tr><td>213</td> <td class="normal"> * returns the last record in the collection </td></tr> <tr><td>214</td> <td class="normal"> * </td></tr> <tr><td>215</td> <td class="normal"> * @return mixed </td></tr> <tr><td>216</td> <td class="normal"> */ </td></tr> <tr><td>217</td> <td class="normal"> public function getLast() </td></tr> <tr><td>218</td> <td class="normal"> { </td></tr> <tr><td>219</td> <td class="covered"> return end($this->data); </td></tr> <tr><td>220</td> <td class="orange"> } </td></tr> <tr><td>221</td> <td class="normal"> /** </td></tr> <tr><td>222</td> <td class="normal"> * setReference </td></tr> <tr><td>223</td> <td class="normal"> * sets a reference pointer </td></tr> <tr><td>224</td> <td class="normal"> * </td></tr> <tr><td>225</td> <td class="normal"> * @return void </td></tr> <tr><td>226</td> <td class="normal"> */ </td></tr> <tr><td>227</td> <td class="normal"> public function setReference(Doctrine_Record $record, Doctrine_Relation $relation) </td></tr> <tr><td>228</td> <td class="normal"> { </td></tr> <tr><td>229</td> <td class="covered"> $this->reference = $record; </td></tr> <tr><td>230</td> <td class="covered"> $this->relation = $relation; </td></tr> <tr><td>231</td> <td class="normal"> </td></tr> <tr><td>232</td> <td class="covered"> if ($relation instanceof Doctrine_Relation_ForeignKey || </td></tr> <tr><td>233</td> <td class="covered"> $relation instanceof Doctrine_Relation_LocalKey) { </td></tr> <tr><td>234</td> <td class="normal"> </td></tr> <tr><td>235</td> <td class="covered"> $this->referenceField = $relation->getForeign(); </td></tr> <tr><td>236</td> <td class="normal"> </td></tr> <tr><td>237</td> <td class="covered"> $value = $record->get($relation->getLocal()); </td></tr> <tr><td>238</td> <td class="normal"> </td></tr> <tr><td>239</td> <td class="covered"> foreach ($this->data as $record) { </td></tr> <tr><td>240</td> <td class="covered"> if ($value !== null) { </td></tr> <tr><td>241</td> <td class="covered"> $record->set($this->referenceField, $value, false); </td></tr> <tr><td>242</td> <td class="covered"> } else { </td></tr> <tr><td>243</td> <td class="red"> $record->set($this->referenceField, $this->reference, false); </td></tr> <tr><td>244</td> <td class="normal"> } </td></tr> <tr><td>245</td> <td class="covered"> } </td></tr> <tr><td>246</td> <td class="covered"> } elseif ($relation instanceof Doctrine_Relation_Association) { </td></tr> <tr><td>247</td> <td class="normal"> </td></tr> <tr><td>248</td> <td class="covered"> } </td></tr> <tr><td>249</td> <td class="covered"> } </td></tr> <tr><td>250</td> <td class="normal"> /** </td></tr> <tr><td>251</td> <td class="normal"> * getReference </td></tr> <tr><td>252</td> <td class="normal"> * </td></tr> <tr><td>253</td> <td class="normal"> * @return mixed </td></tr> <tr><td>254</td> <td class="normal"> */ </td></tr> <tr><td>255</td> <td class="normal"> public function getReference() </td></tr> <tr><td>256</td> <td class="normal"> { </td></tr> <tr><td>257</td> <td class="red"> return $this->reference; </td></tr> <tr><td>258</td> <td class="orange"> } </td></tr> <tr><td>259</td> <td class="normal"> /** </td></tr> <tr><td>260</td> <td class="normal"> * remove </td></tr> <tr><td>261</td> <td class="normal"> * removes a specified collection element </td></tr> <tr><td>262</td> <td class="normal"> * </td></tr> <tr><td>263</td> <td class="normal"> * @param mixed $key </td></tr> <tr><td>264</td> <td class="normal"> * @return boolean </td></tr> <tr><td>265</td> <td class="normal"> */ </td></tr> <tr><td>266</td> <td class="normal"> public function remove($key) </td></tr> <tr><td>267</td> <td class="normal"> { </td></tr> <tr><td>268</td> <td class="covered"> $removed = $this->data[$key]; </td></tr> <tr><td>269</td> <td class="normal"> </td></tr> <tr><td>270</td> <td class="covered"> unset($this->data[$key]); </td></tr> <tr><td>271</td> <td class="covered"> return $removed; </td></tr> <tr><td>272</td> <td class="orange"> } </td></tr> <tr><td>273</td> <td class="normal"> /** </td></tr> <tr><td>274</td> <td class="normal"> * contains </td></tr> <tr><td>275</td> <td class="normal"> * whether or not this collection contains a specified element </td></tr> <tr><td>276</td> <td class="normal"> * </td></tr> <tr><td>277</td> <td class="normal"> * @param mixed $key the key of the element </td></tr> <tr><td>278</td> <td class="normal"> * @return boolean </td></tr> <tr><td>279</td> <td class="normal"> */ </td></tr> <tr><td>280</td> <td class="normal"> public function contains($key) </td></tr> <tr><td>281</td> <td class="normal"> { </td></tr> <tr><td>282</td> <td class="covered"> return isset($this->data[$key]); </td></tr> <tr><td>283</td> <td class="orange"> } </td></tr> <tr><td>284</td> <td class="normal"> public function search(Doctrine_Record $record) </td></tr> <tr><td>285</td> <td class="normal"> { </td></tr> <tr><td>286</td> <td class="red"> return array_search($record, $this->data, true); </td></tr> <tr><td>287</td> <td class="orange"> } </td></tr> <tr><td>288</td> <td class="normal"> /** </td></tr> <tr><td>289</td> <td class="normal"> * get </td></tr> <tr><td>290</td> <td class="normal"> * returns a record for given key </td></tr> <tr><td>291</td> <td class="normal"> * </td></tr> <tr><td>292</td> <td class="normal"> * There are two special cases: </td></tr> <tr><td>293</td> <td class="normal"> * </td></tr> <tr><td>294</td> <td class="normal"> * 1. if null is given as a key a new record is created and attached </td></tr> <tr><td>295</td> <td class="normal"> * at the end of the collection </td></tr> <tr><td>296</td> <td class="normal"> * </td></tr> <tr><td>297</td> <td class="normal"> * 2. if given key does not exist, then a new record is create and attached </td></tr> <tr><td>298</td> <td class="normal"> * to the given key </td></tr> <tr><td>299</td> <td class="normal"> * </td></tr> <tr><td>300</td> <td class="normal"> * Collection also maps referential information to newly created records </td></tr> <tr><td>301</td> <td class="normal"> * </td></tr> <tr><td>302</td> <td class="normal"> * @param mixed $key the key of the element </td></tr> <tr><td>303</td> <td class="normal"> * @return Doctrine_Record return a specified record </td></tr> <tr><td>304</td> <td class="normal"> */ </td></tr> <tr><td>305</td> <td class="normal"> public function get($key) </td></tr> <tr><td>306</td> <td class="normal"> { </td></tr> <tr><td>307</td> <td class="covered"> if ( ! isset($this->data[$key])) { </td></tr> <tr><td>308</td> <td class="covered"> $record = $this->_table->create(); </td></tr> <tr><td>309</td> <td class="normal"> </td></tr> <tr><td>310</td> <td class="covered"> if (isset($this->referenceField)) { </td></tr> <tr><td>311</td> <td class="covered"> $value = $this->reference->get($this->relation->getLocal()); </td></tr> <tr><td>312</td> <td class="normal"> </td></tr> <tr><td>313</td> <td class="covered"> if ($value !== null) { </td></tr> <tr><td>314</td> <td class="covered"> $record->set($this->referenceField, $value, false); </td></tr> <tr><td>315</td> <td class="covered"> } else { </td></tr> <tr><td>316</td> <td class="covered"> $record->set($this->referenceField, $this->reference, false); </td></tr> <tr><td>317</td> <td class="normal"> } </td></tr> <tr><td>318</td> <td class="covered"> } </td></tr> <tr><td>319</td> <td class="covered"> if ($key === null) { </td></tr> <tr><td>320</td> <td class="covered"> $this->data[] = $record; </td></tr> <tr><td>321</td> <td class="covered"> } else { </td></tr> <tr><td>322</td> <td class="covered"> $this->data[$key] = $record; </td></tr> <tr><td>323</td> <td class="normal"> } </td></tr> <tr><td>324</td> <td class="normal"> </td></tr> <tr><td>325</td> <td class="covered"> if (isset($this->keyColumn)) { </td></tr> <tr><td>326</td> <td class="normal"> </td></tr> <tr><td>327</td> <td class="covered"> $record->set($this->keyColumn, $key); </td></tr> <tr><td>328</td> <td class="covered"> } </td></tr> <tr><td>329</td> <td class="normal"> </td></tr> <tr><td>330</td> <td class="covered"> return $record; </td></tr> <tr><td>331</td> <td class="orange"> } </td></tr> <tr><td>332</td> <td class="normal"> </td></tr> <tr><td>333</td> <td class="covered"> return $this->data[$key]; </td></tr> <tr><td>334</td> <td class="orange"> } </td></tr> <tr><td>335</td> <td class="normal"> </td></tr> <tr><td>336</td> <td class="normal"> /** </td></tr> <tr><td>337</td> <td class="normal"> * @return array an array containing all primary keys </td></tr> <tr><td>338</td> <td class="normal"> */ </td></tr> <tr><td>339</td> <td class="normal"> public function getPrimaryKeys() </td></tr> <tr><td>340</td> <td class="normal"> { </td></tr> <tr><td>341</td> <td class="red"> $list = array(); </td></tr> <tr><td>342</td> <td class="red"> $name = $this->_table->getIdentifier(); </td></tr> <tr><td>343</td> <td class="normal"> </td></tr> <tr><td>344</td> <td class="red"> foreach ($this->data as $record) { </td></tr> <tr><td>345</td> <td class="red"> if (is_array($record) && isset($record[$name])) { </td></tr> <tr><td>346</td> <td class="red"> $list[] = $record[$name]; </td></tr> <tr><td>347</td> <td class="red"> } else { </td></tr> <tr><td>348</td> <td class="red"> $list[] = $record->getIncremented(); </td></tr> <tr><td>349</td> <td class="normal"> } </td></tr> <tr><td>350</td> <td class="red"> } </td></tr> <tr><td>351</td> <td class="red"> return $list; </td></tr> <tr><td>352</td> <td class="orange"> } </td></tr> <tr><td>353</td> <td class="normal"> /** </td></tr> <tr><td>354</td> <td class="normal"> * returns all keys </td></tr> <tr><td>355</td> <td class="normal"> * @return array </td></tr> <tr><td>356</td> <td class="normal"> */ </td></tr> <tr><td>357</td> <td class="normal"> public function getKeys() </td></tr> <tr><td>358</td> <td class="normal"> { </td></tr> <tr><td>359</td> <td class="red"> return array_keys($this->data); </td></tr> <tr><td>360</td> <td class="orange"> } </td></tr> <tr><td>361</td> <td class="normal"> /** </td></tr> <tr><td>362</td> <td class="normal"> * count </td></tr> <tr><td>363</td> <td class="normal"> * this class implements interface countable </td></tr> <tr><td>364</td> <td class="normal"> * returns the number of records in this collection </td></tr> <tr><td>365</td> <td class="normal"> * </td></tr> <tr><td>366</td> <td class="normal"> * @return integer </td></tr> <tr><td>367</td> <td class="normal"> */ </td></tr> <tr><td>368</td> <td class="normal"> public function count() </td></tr> <tr><td>369</td> <td class="normal"> { </td></tr> <tr><td>370</td> <td class="covered"> return count($this->data); </td></tr> <tr><td>371</td> <td class="orange"> } </td></tr> <tr><td>372</td> <td class="normal"> /** </td></tr> <tr><td>373</td> <td class="normal"> * set </td></tr> <tr><td>374</td> <td class="normal"> * @param integer $key </td></tr> <tr><td>375</td> <td class="normal"> * @param Doctrine_Record $record </td></tr> <tr><td>376</td> <td class="normal"> * @return void </td></tr> <tr><td>377</td> <td class="normal"> */ </td></tr> <tr><td>378</td> <td class="normal"> public function set($key, Doctrine_Record $record) </td></tr> <tr><td>379</td> <td class="normal"> { </td></tr> <tr><td>380</td> <td class="covered"> if (isset($this->referenceField)) { </td></tr> <tr><td>381</td> <td class="covered"> $record->set($this->referenceField, $this->reference, false); </td></tr> <tr><td>382</td> <td class="covered"> } </td></tr> <tr><td>383</td> <td class="normal"> </td></tr> <tr><td>384</td> <td class="covered"> $this->data[$key] = $record; </td></tr> <tr><td>385</td> <td class="covered"> } </td></tr> <tr><td>386</td> <td class="normal"> /** </td></tr> <tr><td>387</td> <td class="normal"> * adds a record to collection </td></tr> <tr><td>388</td> <td class="normal"> * @param Doctrine_Record $record record to be added </td></tr> <tr><td>389</td> <td class="normal"> * @param string $key optional key for the record </td></tr> <tr><td>390</td> <td class="normal"> * @return boolean </td></tr> <tr><td>391</td> <td class="normal"> */ </td></tr> <tr><td>392</td> <td class="normal"> public function add(Doctrine_Record $record, $key = null) </td></tr> <tr><td>393</td> <td class="normal"> { </td></tr> <tr><td>394</td> <td class="covered"> if (isset($this->referenceField)) { </td></tr> <tr><td>395</td> <td class="covered"> $value = $this->reference->get($this->relation->getLocal()); </td></tr> <tr><td>396</td> <td class="normal"> </td></tr> <tr><td>397</td> <td class="covered"> if ($value !== null) { </td></tr> <tr><td>398</td> <td class="covered"> $record->set($this->referenceField, $value, false); </td></tr> <tr><td>399</td> <td class="covered"> } else { </td></tr> <tr><td>400</td> <td class="red"> $record->set($this->referenceField, $this->reference, false); </td></tr> <tr><td>401</td> <td class="normal"> } </td></tr> <tr><td>402</td> <td class="covered"> } </td></tr> <tr><td>403</td> <td class="normal"> /** </td></tr> <tr><td>404</td> <td class="normal"> * for some weird reason in_array cannot be used here (php bug ?) </td></tr> <tr><td>405</td> <td class="normal"> * </td></tr> <tr><td>406</td> <td class="normal"> * if used it results in fatal error : [ nesting level too deep ] </td></tr> <tr><td>407</td> <td class="normal"> */ </td></tr> <tr><td>408</td> <td class="covered"> foreach ($this->data as $val) { </td></tr> <tr><td>409</td> <td class="covered"> if ($val === $record) { </td></tr> <tr><td>410</td> <td class="red"> return false; </td></tr> <tr><td>411</td> <td class="orange"> } </td></tr> <tr><td>412</td> <td class="covered"> } </td></tr> <tr><td>413</td> <td class="normal"> </td></tr> <tr><td>414</td> <td class="covered"> if (isset($key)) { </td></tr> <tr><td>415</td> <td class="red"> if (isset($this->data[$key])) { </td></tr> <tr><td>416</td> <td class="red"> return false; </td></tr> <tr><td>417</td> <td class="orange"> } </td></tr> <tr><td>418</td> <td class="red"> $this->data[$key] = $record; </td></tr> <tr><td>419</td> <td class="red"> return true; </td></tr> <tr><td>420</td> <td class="orange"> } </td></tr> <tr><td>421</td> <td class="normal"> </td></tr> <tr><td>422</td> <td class="covered"> if (isset($this->keyColumn)) { </td></tr> <tr><td>423</td> <td class="red"> $value = $record->get($this->keyColumn); </td></tr> <tr><td>424</td> <td class="red"> if ($value === null) { </td></tr> <tr><td>425</td> <td class="red"> throw new Doctrine_Collection_Exception("Couldn't create collection index. Record field '".$this->keyColumn."' was null."); </td></tr> <tr><td>426</td> <td class="orange"> } </td></tr> <tr><td>427</td> <td class="red"> $this->data[$value] = $record; </td></tr> <tr><td>428</td> <td class="red"> } else { </td></tr> <tr><td>429</td> <td class="covered"> $this->data[] = $record; </td></tr> <tr><td>430</td> <td class="normal"> } </td></tr> <tr><td>431</td> <td class="covered"> return true; </td></tr> <tr><td>432</td> <td class="orange"> } </td></tr> <tr><td>433</td> <td class="normal"> /** </td></tr> <tr><td>434</td> <td class="normal"> * loadRelated </td></tr> <tr><td>435</td> <td class="normal"> * </td></tr> <tr><td>436</td> <td class="normal"> * @param mixed $name </td></tr> <tr><td>437</td> <td class="normal"> * @return boolean </td></tr> <tr><td>438</td> <td class="normal"> */ </td></tr> <tr><td>439</td> <td class="normal"> public function loadRelated($name = null) </td></tr> <tr><td>440</td> <td class="normal"> { </td></tr> <tr><td>441</td> <td class="red"> $list = array(); </td></tr> <tr><td>442</td> <td class="red"> $query = new Doctrine_Query($this->_table->getConnection()); </td></tr> <tr><td>443</td> <td class="normal"> </td></tr> <tr><td>444</td> <td class="red"> if ( ! isset($name)) { </td></tr> <tr><td>445</td> <td class="red"> foreach ($this->data as $record) { </td></tr> <tr><td>446</td> <td class="red"> $value = $record->getIncremented(); </td></tr> <tr><td>447</td> <td class="red"> if ($value !== null) { </td></tr> <tr><td>448</td> <td class="red"> $list[] = $value; </td></tr> <tr><td>449</td> <td class="red"> } </td></tr> <tr><td>450</td> <td class="red"> } </td></tr> <tr><td>451</td> <td class="red"> $query->from($this->_table->getComponentName() . '(' . implode(", ",$this->_table->getPrimaryKeys()) . ')'); </td></tr> <tr><td>452</td> <td class="red"> $query->where($this->_table->getComponentName() . '.id IN (' . substr(str_repeat("?, ", count($list)),0,-2) . ')'); </td></tr> <tr><td>453</td> <td class="normal"> </td></tr> <tr><td>454</td> <td class="red"> return $query; </td></tr> <tr><td>455</td> <td class="orange"> } </td></tr> <tr><td>456</td> <td class="normal"> </td></tr> <tr><td>457</td> <td class="red"> $rel = $this->_table->getRelation($name); </td></tr> <tr><td>458</td> <td class="normal"> </td></tr> <tr><td>459</td> <td class="red"> if ($rel instanceof Doctrine_Relation_LocalKey || $rel instanceof Doctrine_Relation_ForeignKey) { </td></tr> <tr><td>460</td> <td class="red"> foreach ($this->data as $record) { </td></tr> <tr><td>461</td> <td class="red"> $list[] = $record[$rel->getLocal()]; </td></tr> <tr><td>462</td> <td class="red"> } </td></tr> <tr><td>463</td> <td class="red"> } else { </td></tr> <tr><td>464</td> <td class="red"> foreach ($this->data as $record) { </td></tr> <tr><td>465</td> <td class="red"> $value = $record->getIncremented(); </td></tr> <tr><td>466</td> <td class="red"> if ($value !== null) { </td></tr> <tr><td>467</td> <td class="red"> $list[] = $value; </td></tr> <tr><td>468</td> <td class="red"> } </td></tr> <tr><td>469</td> <td class="red"> } </td></tr> <tr><td>470</td> <td class="normal"> } </td></tr> <tr><td>471</td> <td class="normal"> </td></tr> <tr><td>472</td> <td class="red"> $dql = $rel->getRelationDql(count($list), 'collection'); </td></tr> <tr><td>473</td> <td class="normal"> </td></tr> <tr><td>474</td> <td class="red"> $coll = $query->query($dql, $list); </td></tr> <tr><td>475</td> <td class="normal"> </td></tr> <tr><td>476</td> <td class="red"> $this->populateRelated($name, $coll); </td></tr> <tr><td>477</td> <td class="red"> } </td></tr> <tr><td>478</td> <td class="normal"> /** </td></tr> <tr><td>479</td> <td class="normal"> * populateRelated </td></tr> <tr><td>480</td> <td class="normal"> * </td></tr> <tr><td>481</td> <td class="normal"> * @param string $name </td></tr> <tr><td>482</td> <td class="normal"> * @param Doctrine_Collection $coll </td></tr> <tr><td>483</td> <td class="normal"> * @return void </td></tr> <tr><td>484</td> <td class="normal"> */ </td></tr> <tr><td>485</td> <td class="normal"> public function populateRelated($name, Doctrine_Collection $coll) </td></tr> <tr><td>486</td> <td class="normal"> { </td></tr> <tr><td>487</td> <td class="red"> $rel = $this->_table->getRelation($name); </td></tr> <tr><td>488</td> <td class="red"> $table = $rel->getTable(); </td></tr> <tr><td>489</td> <td class="red"> $foreign = $rel->getForeign(); </td></tr> <tr><td>490</td> <td class="red"> $local = $rel->getLocal(); </td></tr> <tr><td>491</td> <td class="normal"> </td></tr> <tr><td>492</td> <td class="red"> if ($rel instanceof Doctrine_Relation_LocalKey) { </td></tr> <tr><td>493</td> <td class="red"> foreach ($this->data as $key => $record) { </td></tr> <tr><td>494</td> <td class="red"> foreach ($coll as $k => $related) { </td></tr> <tr><td>495</td> <td class="red"> if ($related[$foreign] == $record[$local]) { </td></tr> <tr><td>496</td> <td class="red"> $this->data[$key]->setRelated($name, $related); </td></tr> <tr><td>497</td> <td class="red"> } </td></tr> <tr><td>498</td> <td class="red"> } </td></tr> <tr><td>499</td> <td class="red"> } </td></tr> <tr><td>500</td> <td class="red"> } elseif ($rel instanceof Doctrine_Relation_ForeignKey) { </td></tr> <tr><td>501</td> <td class="red"> foreach ($this->data as $key => $record) { </td></tr> <tr><td>502</td> <td class="red"> if ( ! $record->exists()) { </td></tr> <tr><td>503</td> <td class="red"> continue; </td></tr> <tr><td>504</td> <td class="orange"> } </td></tr> <tr><td>505</td> <td class="red"> $sub = new Doctrine_Collection($table); </td></tr> <tr><td>506</td> <td class="normal"> </td></tr> <tr><td>507</td> <td class="red"> foreach ($coll as $k => $related) { </td></tr> <tr><td>508</td> <td class="red"> if ($related[$foreign] == $record[$local]) { </td></tr> <tr><td>509</td> <td class="red"> $sub->add($related); </td></tr> <tr><td>510</td> <td class="red"> $coll->remove($k); </td></tr> <tr><td>511</td> <td class="red"> } </td></tr> <tr><td>512</td> <td class="red"> } </td></tr> <tr><td>513</td> <td class="normal"> </td></tr> <tr><td>514</td> <td class="red"> $this->data[$key]->setRelated($name, $sub); </td></tr> <tr><td>515</td> <td class="red"> } </td></tr> <tr><td>516</td> <td class="red"> } elseif ($rel instanceof Doctrine_Relation_Association) { </td></tr> <tr><td>517</td> <td class="red"> $identifier = $this->_table->getIdentifier(); </td></tr> <tr><td>518</td> <td class="red"> $asf = $rel->getAssociationFactory(); </td></tr> <tr><td>519</td> <td class="red"> $name = $table->getComponentName(); </td></tr> <tr><td>520</td> <td class="normal"> </td></tr> <tr><td>521</td> <td class="red"> foreach ($this->data as $key => $record) { </td></tr> <tr><td>522</td> <td class="red"> if ( ! $record->exists()) { </td></tr> <tr><td>523</td> <td class="red"> continue; </td></tr> <tr><td>524</td> <td class="orange"> } </td></tr> <tr><td>525</td> <td class="red"> $sub = new Doctrine_Collection($table); </td></tr> <tr><td>526</td> <td class="red"> foreach ($coll as $k => $related) { </td></tr> <tr><td>527</td> <td class="red"> if ($related->get($local) == $record[$identifier]) { </td></tr> <tr><td>528</td> <td class="red"> $sub->add($related->get($name)); </td></tr> <tr><td>529</td> <td class="red"> } </td></tr> <tr><td>530</td> <td class="red"> } </td></tr> <tr><td>531</td> <td class="red"> $this->data[$key]->setRelated($name, $sub); </td></tr> <tr><td>532</td> <td class="normal"> </td></tr> <tr><td>533</td> <td class="red"> } </td></tr> <tr><td>534</td> <td class="red"> } </td></tr> <tr><td>535</td> <td class="red"> } </td></tr> <tr><td>536</td> <td class="normal"> /** </td></tr> <tr><td>537</td> <td class="normal"> * getNormalIterator </td></tr> <tr><td>538</td> <td class="normal"> * returns normal iterator - an iterator that will not expand this collection </td></tr> <tr><td>539</td> <td class="normal"> * </td></tr> <tr><td>540</td> <td class="normal"> * @return Doctrine_Iterator_Normal </td></tr> <tr><td>541</td> <td class="normal"> */ </td></tr> <tr><td>542</td> <td class="normal"> public function getNormalIterator() </td></tr> <tr><td>543</td> <td class="normal"> { </td></tr> <tr><td>544</td> <td class="red"> return new Doctrine_Collection_Iterator_Normal($this); </td></tr> <tr><td>545</td> <td class="orange"> } </td></tr> <tr><td>546</td> <td class="normal"> /** </td></tr> <tr><td>547</td> <td class="normal"> * takeSnapshot </td></tr> <tr><td>548</td> <td class="normal"> * takes a snapshot from this collection </td></tr> <tr><td>549</td> <td class="normal"> * </td></tr> <tr><td>550</td> <td class="normal"> * snapshots are used for diff processing, for example </td></tr> <tr><td>551</td> <td class="normal"> * when a fetched collection has three elements, then two of those </td></tr> <tr><td>552</td> <td class="normal"> * are being removed the diff would contain one element </td></tr> <tr><td>553</td> <td class="normal"> * </td></tr> <tr><td>554</td> <td class="normal"> * Doctrine_Collection::save() attaches the diff with the help of last </td></tr> <tr><td>555</td> <td class="normal"> * snapshot. </td></tr> <tr><td>556</td> <td class="normal"> * </td></tr> <tr><td>557</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>558</td> <td class="normal"> */ </td></tr> <tr><td>559</td> <td class="normal"> public function takeSnapshot() </td></tr> <tr><td>560</td> <td class="normal"> { </td></tr> <tr><td>561</td> <td class="covered"> $this->_snapshot = $this->data; </td></tr> <tr><td>562</td> <td class="normal"> </td></tr> <tr><td>563</td> <td class="covered"> return $this; </td></tr> <tr><td>564</td> <td class="orange"> } </td></tr> <tr><td>565</td> <td class="normal"> /** </td></tr> <tr><td>566</td> <td class="normal"> * getSnapshot </td></tr> <tr><td>567</td> <td class="normal"> * returns the data of the last snapshot </td></tr> <tr><td>568</td> <td class="normal"> * </td></tr> <tr><td>569</td> <td class="normal"> * @return array returns the data in last snapshot </td></tr> <tr><td>570</td> <td class="normal"> */ </td></tr> <tr><td>571</td> <td class="normal"> public function getSnapshot() </td></tr> <tr><td>572</td> <td class="normal"> { </td></tr> <tr><td>573</td> <td class="covered"> return $this->_snapshot; </td></tr> <tr><td>574</td> <td class="orange"> } </td></tr> <tr><td>575</td> <td class="normal"> /** </td></tr> <tr><td>576</td> <td class="normal"> * processDiff </td></tr> <tr><td>577</td> <td class="normal"> * processes the difference of the last snapshot and the current data </td></tr> <tr><td>578</td> <td class="normal"> * </td></tr> <tr><td>579</td> <td class="normal"> * an example: </td></tr> <tr><td>580</td> <td class="normal"> * Snapshot with the objects 1, 2 and 4 </td></tr> <tr><td>581</td> <td class="normal"> * Current data with objects 2, 3 and 5 </td></tr> <tr><td>582</td> <td class="normal"> * </td></tr> <tr><td>583</td> <td class="normal"> * The process would remove object 4 </td></tr> <tr><td>584</td> <td class="normal"> * </td></tr> <tr><td>585</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>586</td> <td class="normal"> */ </td></tr> <tr><td>587</td> <td class="normal"> public function processDiff() </td></tr> <tr><td>588</td> <td class="normal"> { </td></tr> <tr><td>589</td> <td class="covered"> foreach (array_udiff($this->_snapshot, $this->data, array($this, "compareRecords")) as $record) { </td></tr> <tr><td>590</td> <td class="covered"> $record->delete(); </td></tr> <tr><td>591</td> <td class="covered"> } </td></tr> <tr><td>592</td> <td class="normal"> </td></tr> <tr><td>593</td> <td class="covered"> return $this; </td></tr> <tr><td>594</td> <td class="orange"> } </td></tr> <tr><td>595</td> <td class="normal"> /** </td></tr> <tr><td>596</td> <td class="normal"> * toArray </td></tr> <tr><td>597</td> <td class="normal"> * Mimics the result of a $query->execute(array(), Doctrine::FETCH_ARRAY); </td></tr> <tr><td>598</td> <td class="normal"> * </td></tr> <tr><td>599</td> <td class="normal"> * @param boolean $deep </td></tr> <tr><td>600</td> <td class="normal"> */ </td></tr> <tr><td>601</td> <td class="normal"> public function toArray($deep = false, $prefixKey = false) </td></tr> <tr><td>602</td> <td class="normal"> { </td></tr> <tr><td>603</td> <td class="red"> $data = array(); </td></tr> <tr><td>604</td> <td class="red"> foreach ($this->data as $key => $record) { </td></tr> <tr><td>605</td> <td class="normal"> </td></tr> <tr><td>606</td> <td class="red"> $key = $prefixKey ? get_class($record) . '_' .$key:$key; </td></tr> <tr><td>607</td> <td class="normal"> </td></tr> <tr><td>608</td> <td class="red"> $data[$key] = $record->toArray($deep, $prefixKey); </td></tr> <tr><td>609</td> <td class="red"> } </td></tr> <tr><td>610</td> <td class="normal"> </td></tr> <tr><td>611</td> <td class="red"> return $data; </td></tr> <tr><td>612</td> <td class="orange"> } </td></tr> <tr><td>613</td> <td class="normal"> public function fromArray($array) </td></tr> <tr><td>614</td> <td class="normal"> { </td></tr> <tr><td>615</td> <td class="red"> $data = array(); </td></tr> <tr><td>616</td> <td class="red"> foreach ($array as $row) { </td></tr> <tr><td>617</td> <td class="red"> $record = $this->_table->getRecord(); </td></tr> <tr><td>618</td> <td class="red"> $record->fromArray($row); </td></tr> <tr><td>619</td> <td class="normal"> </td></tr> <tr><td>620</td> <td class="red"> $data[] = $record; </td></tr> <tr><td>621</td> <td class="red"> } </td></tr> <tr><td>622</td> <td class="normal"> </td></tr> <tr><td>623</td> <td class="red"> $this->data = $data; </td></tr> <tr><td>624</td> <td class="red"> } </td></tr> <tr><td>625</td> <td class="normal"> public function exportTo($type, $deep = false) </td></tr> <tr><td>626</td> <td class="normal"> { </td></tr> <tr><td>627</td> <td class="red"> if ($type == 'array') { </td></tr> <tr><td>628</td> <td class="red"> return $this->toArray($deep); </td></tr> <tr><td>629</td> <td class="orange"> } else { </td></tr> <tr><td>630</td> <td class="red"> return Doctrine_Parser::dump($this->toArray($deep, true), $type); </td></tr> <tr><td>631</td> <td class="normal"> } </td></tr> <tr><td>632</td> <td class="orange"> } </td></tr> <tr><td>633</td> <td class="normal"> public function importFrom($type, $data) </td></tr> <tr><td>634</td> <td class="normal"> { </td></tr> <tr><td>635</td> <td class="red"> if ($type == 'array') { </td></tr> <tr><td>636</td> <td class="red"> return $this->fromArray($data); </td></tr> <tr><td>637</td> <td class="orange"> } else { </td></tr> <tr><td>638</td> <td class="red"> return $this->fromArray(Doctrine_Parser::load($data, $type)); </td></tr> <tr><td>639</td> <td class="normal"> } </td></tr> <tr><td>640</td> <td class="orange"> } </td></tr> <tr><td>641</td> <td class="normal"> public function getDeleteDiff() </td></tr> <tr><td>642</td> <td class="normal"> { </td></tr> <tr><td>643</td> <td class="covered"> return array_udiff($this->_snapshot, $this->data, array($this, "compareRecords")); </td></tr> <tr><td>644</td> <td class="orange"> } </td></tr> <tr><td>645</td> <td class="normal"> public function getInsertDiff() </td></tr> <tr><td>646</td> <td class="normal"> { </td></tr> <tr><td>647</td> <td class="covered"> return array_udiff($this->data, $this->_snapshot, array($this, "compareRecords")); </td></tr> <tr><td>648</td> <td class="orange"> } </td></tr> <tr><td>649</td> <td class="normal"> /** </td></tr> <tr><td>650</td> <td class="normal"> * compareRecords </td></tr> <tr><td>651</td> <td class="normal"> * Compares two records. To be used on _snapshot diffs using array_udiff </td></tr> <tr><td>652</td> <td class="normal"> */ </td></tr> <tr><td>653</td> <td class="normal"> protected function compareRecords($a, $b) </td></tr> <tr><td>654</td> <td class="normal"> { </td></tr> <tr><td>655</td> <td class="covered"> if ($a->getOid() == $b->getOid()) return 0; </td></tr> <tr><td>656</td> <td class="covered"> return ($a->getOid() > $b->getOid()) ? 1 : -1; </td></tr> <tr><td>657</td> <td class="orange"> } </td></tr> <tr><td>658</td> <td class="normal"> /** </td></tr> <tr><td>659</td> <td class="normal"> * save </td></tr> <tr><td>660</td> <td class="normal"> * saves all records of this collection and processes the </td></tr> <tr><td>661</td> <td class="normal"> * difference of the last snapshot and the current data </td></tr> <tr><td>662</td> <td class="normal"> * </td></tr> <tr><td>663</td> <td class="normal"> * @param Doctrine_Connection $conn optional connection parameter </td></tr> <tr><td>664</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>665</td> <td class="normal"> */ </td></tr> <tr><td>666</td> <td class="normal"> public function save(Doctrine_Connection $conn = null) </td></tr> <tr><td>667</td> <td class="normal"> { </td></tr> <tr><td>668</td> <td class="covered"> if ($conn == null) { </td></tr> <tr><td>669</td> <td class="covered"> $conn = $this->_table->getConnection(); </td></tr> <tr><td>670</td> <td class="covered"> } </td></tr> <tr><td>671</td> <td class="covered"> $conn->beginTransaction(); </td></tr> <tr><td>672</td> <td class="normal"> </td></tr> <tr><td>673</td> <td class="covered"> $conn->transaction->addCollection($this); </td></tr> <tr><td>674</td> <td class="normal"> </td></tr> <tr><td>675</td> <td class="covered"> $this->processDiff(); </td></tr> <tr><td>676</td> <td class="normal"> </td></tr> <tr><td>677</td> <td class="covered"> foreach ($this->getData() as $key => $record) { </td></tr> <tr><td>678</td> <td class="covered"> $record->save($conn); </td></tr> <tr><td>679</td> <td class="covered"> } </td></tr> <tr><td>680</td> <td class="normal"> </td></tr> <tr><td>681</td> <td class="covered"> $conn->commit(); </td></tr> <tr><td>682</td> <td class="normal"> </td></tr> <tr><td>683</td> <td class="covered"> return $this; </td></tr> <tr><td>684</td> <td class="orange"> } </td></tr> <tr><td>685</td> <td class="normal"> /** </td></tr> <tr><td>686</td> <td class="normal"> * delete </td></tr> <tr><td>687</td> <td class="normal"> * single shot delete </td></tr> <tr><td>688</td> <td class="normal"> * deletes all records from this collection </td></tr> <tr><td>689</td> <td class="normal"> * and uses only one database query to perform this operation </td></tr> <tr><td>690</td> <td class="normal"> * </td></tr> <tr><td>691</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>692</td> <td class="normal"> */ </td></tr> <tr><td>693</td> <td class="normal"> public function delete(Doctrine_Connection $conn = null) </td></tr> <tr><td>694</td> <td class="normal"> { </td></tr> <tr><td>695</td> <td class="covered"> if ($conn == null) { </td></tr> <tr><td>696</td> <td class="covered"> $conn = $this->_table->getConnection(); </td></tr> <tr><td>697</td> <td class="covered"> } </td></tr> <tr><td>698</td> <td class="normal"> </td></tr> <tr><td>699</td> <td class="covered"> $conn->beginTransaction(); </td></tr> <tr><td>700</td> <td class="covered"> $conn->transaction->addCollection($this); </td></tr> <tr><td>701</td> <td class="normal"> </td></tr> <tr><td>702</td> <td class="covered"> foreach ($this as $key => $record) { </td></tr> <tr><td>703</td> <td class="covered"> $record->delete($conn); </td></tr> <tr><td>704</td> <td class="covered"> } </td></tr> <tr><td>705</td> <td class="normal"> </td></tr> <tr><td>706</td> <td class="covered"> $conn->commit(); </td></tr> <tr><td>707</td> <td class="normal"> </td></tr> <tr><td>708</td> <td class="covered"> $this->data = array(); </td></tr> <tr><td>709</td> <td class="normal"> </td></tr> <tr><td>710</td> <td class="covered"> return $this; </td></tr> <tr><td>711</td> <td class="orange"> } </td></tr> <tr><td>712</td> <td class="normal"> /** </td></tr> <tr><td>713</td> <td class="normal"> * getIterator </td></tr> <tr><td>714</td> <td class="normal"> * @return object ArrayIterator </td></tr> <tr><td>715</td> <td class="normal"> */ </td></tr> <tr><td>716</td> <td class="normal"> public function getIterator() </td></tr> <tr><td>717</td> <td class="normal"> { </td></tr> <tr><td>718</td> <td class="covered"> $data = $this->data; </td></tr> <tr><td>719</td> <td class="covered"> return new ArrayIterator($data); </td></tr> <tr><td>720</td> <td class="orange"> } </td></tr> <tr><td>721</td> <td class="normal"> /** </td></tr> <tr><td>722</td> <td class="normal"> * returns a string representation of this object </td></tr> <tr><td>723</td> <td class="normal"> */ </td></tr> <tr><td>724</td> <td class="normal"> public function __toString() </td></tr> <tr><td>725</td> <td class="normal"> { </td></tr> <tr><td>726</td> <td class="red"> return Doctrine_Lib::getCollectionAsString($this); </td></tr> <tr><td>727</td> <td class="orange"> } </td></tr> <tr><td>728</td> <td class="normal">} </td></tr> </table></body></html>