<html> <head> <title>Coverage for Doctrine_Hydrate</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Hydrate</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: Hydrate.php 2967 2007-10-21 09:00:40Z romanb $ </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="normal"> </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Hydrate is a base class for Doctrine_RawSql and Doctrine_Query. </td></tr> <tr><td>24</td> <td class="normal"> * Its purpose is to populate object graphs. </td></tr> <tr><td>25</td> <td class="normal"> * </td></tr> <tr><td>26</td> <td class="normal"> * </td></tr> <tr><td>27</td> <td class="normal"> * @package Doctrine </td></tr> <tr><td>28</td> <td class="normal"> * @subpackage Hydrate </td></tr> <tr><td>29</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>30</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>31</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>32</td> <td class="normal"> * @version $Revision: 2967 $ </td></tr> <tr><td>33</td> <td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>34</td> <td class="normal"> */ </td></tr> <tr><td>35</td> <td class="normal">class Doctrine_Hydrate extends Doctrine_Locator_Injectable implements Serializable </td></tr> <tr><td>36</td> <td class="normal">{ </td></tr> <tr><td>37</td> <td class="normal"> /** </td></tr> <tr><td>38</td> <td class="normal"> * QUERY TYPE CONSTANTS </td></tr> <tr><td>39</td> <td class="normal"> */ </td></tr> <tr><td>40</td> <td class="normal"> </td></tr> <tr><td>41</td> <td class="normal"> /** </td></tr> <tr><td>42</td> <td class="normal"> * constant for SELECT queries </td></tr> <tr><td>43</td> <td class="normal"> */ </td></tr> <tr><td>44</td> <td class="normal"> const SELECT = 0; </td></tr> <tr><td>45</td> <td class="normal"> </td></tr> <tr><td>46</td> <td class="normal"> /** </td></tr> <tr><td>47</td> <td class="normal"> * constant for DELETE queries </td></tr> <tr><td>48</td> <td class="normal"> */ </td></tr> <tr><td>49</td> <td class="normal"> const DELETE = 1; </td></tr> <tr><td>50</td> <td class="normal"> </td></tr> <tr><td>51</td> <td class="normal"> /** </td></tr> <tr><td>52</td> <td class="normal"> * constant for UPDATE queries </td></tr> <tr><td>53</td> <td class="normal"> */ </td></tr> <tr><td>54</td> <td class="normal"> const UPDATE = 2; </td></tr> <tr><td>55</td> <td class="normal"> </td></tr> <tr><td>56</td> <td class="normal"> /** </td></tr> <tr><td>57</td> <td class="normal"> * constant for INSERT queries </td></tr> <tr><td>58</td> <td class="normal"> */ </td></tr> <tr><td>59</td> <td class="normal"> const INSERT = 3; </td></tr> <tr><td>60</td> <td class="normal"> </td></tr> <tr><td>61</td> <td class="normal"> /** </td></tr> <tr><td>62</td> <td class="normal"> * constant for CREATE queries </td></tr> <tr><td>63</td> <td class="normal"> */ </td></tr> <tr><td>64</td> <td class="normal"> const CREATE = 4; </td></tr> <tr><td>65</td> <td class="normal"> </td></tr> <tr><td>66</td> <td class="normal"> /** </td></tr> <tr><td>67</td> <td class="normal"> * @var array $params query input parameters </td></tr> <tr><td>68</td> <td class="normal"> */ </td></tr> <tr><td>69</td> <td class="normal"> protected $_params = array('where' => array(), </td></tr> <tr><td>70</td> <td class="normal"> 'set' => array(), </td></tr> <tr><td>71</td> <td class="normal"> 'having' => array()); </td></tr> <tr><td>72</td> <td class="normal"> </td></tr> <tr><td>73</td> <td class="normal"> /** </td></tr> <tr><td>74</td> <td class="normal"> * @var Doctrine_Connection $conn Doctrine_Connection object </td></tr> <tr><td>75</td> <td class="normal"> */ </td></tr> <tr><td>76</td> <td class="normal"> protected $_conn; </td></tr> <tr><td>77</td> <td class="normal"> </td></tr> <tr><td>78</td> <td class="normal"> /** </td></tr> <tr><td>79</td> <td class="normal"> * @var Doctrine_View $_view Doctrine_View object, when set this object will use the </td></tr> <tr><td>80</td> <td class="normal"> * the query given by the view object for object population </td></tr> <tr><td>81</td> <td class="normal"> */ </td></tr> <tr><td>82</td> <td class="normal"> protected $_view; </td></tr> <tr><td>83</td> <td class="normal"> </td></tr> <tr><td>84</td> <td class="normal"> /** </td></tr> <tr><td>85</td> <td class="normal"> * @var array $_aliasMap two dimensional array containing the map for query aliases </td></tr> <tr><td>86</td> <td class="normal"> * Main keys are component aliases </td></tr> <tr><td>87</td> <td class="normal"> * </td></tr> <tr><td>88</td> <td class="normal"> * table table object associated with given alias </td></tr> <tr><td>89</td> <td class="normal"> * </td></tr> <tr><td>90</td> <td class="normal"> * relation the relation object owned by the parent </td></tr> <tr><td>91</td> <td class="normal"> * </td></tr> <tr><td>92</td> <td class="normal"> * parent the alias of the parent </td></tr> <tr><td>93</td> <td class="normal"> * </td></tr> <tr><td>94</td> <td class="normal"> * agg the aggregates of this component </td></tr> <tr><td>95</td> <td class="normal"> * </td></tr> <tr><td>96</td> <td class="normal"> * map the name of the column / aggregate value this </td></tr> <tr><td>97</td> <td class="normal"> * component is mapped to a collection </td></tr> <tr><td>98</td> <td class="normal"> */ </td></tr> <tr><td>99</td> <td class="normal"> protected $_aliasMap = array(); </td></tr> <tr><td>100</td> <td class="normal"> </td></tr> <tr><td>101</td> <td class="normal"> /** </td></tr> <tr><td>102</td> <td class="normal"> * </td></tr> <tr><td>103</td> <td class="normal"> */ </td></tr> <tr><td>104</td> <td class="normal"> protected $pendingAggregates = array(); </td></tr> <tr><td>105</td> <td class="normal"> </td></tr> <tr><td>106</td> <td class="normal"> /** </td></tr> <tr><td>107</td> <td class="normal"> * @var array $aggregateMap an array containing all aggregate aliases, keys as dql aliases </td></tr> <tr><td>108</td> <td class="normal"> * and values as sql aliases </td></tr> <tr><td>109</td> <td class="normal"> */ </td></tr> <tr><td>110</td> <td class="normal"> protected $aggregateMap = array(); </td></tr> <tr><td>111</td> <td class="normal"> </td></tr> <tr><td>112</td> <td class="normal"> /** </td></tr> <tr><td>113</td> <td class="normal"> * @var array $_options an array of options </td></tr> <tr><td>114</td> <td class="normal"> */ </td></tr> <tr><td>115</td> <td class="normal"> protected $_options = array( </td></tr> <tr><td>116</td> <td class="normal"> 'fetchMode' => Doctrine::FETCH_RECORD, </td></tr> <tr><td>117</td> <td class="normal"> 'parserCache' => false, </td></tr> <tr><td>118</td> <td class="normal"> 'resultSetCache' => false, </td></tr> <tr><td>119</td> <td class="normal"> ); </td></tr> <tr><td>120</td> <td class="normal"> </td></tr> <tr><td>121</td> <td class="normal"> /** </td></tr> <tr><td>122</td> <td class="normal"> * @var string $_sql cached SQL query </td></tr> <tr><td>123</td> <td class="normal"> */ </td></tr> <tr><td>124</td> <td class="normal"> protected $_sql; </td></tr> <tr><td>125</td> <td class="normal"> </td></tr> <tr><td>126</td> <td class="normal"> /** </td></tr> <tr><td>127</td> <td class="normal"> * @var array $parts SQL query string parts </td></tr> <tr><td>128</td> <td class="normal"> */ </td></tr> <tr><td>129</td> <td class="normal"> protected $parts = array( </td></tr> <tr><td>130</td> <td class="normal"> 'select' => array(), </td></tr> <tr><td>131</td> <td class="normal"> 'distinct' => false, </td></tr> <tr><td>132</td> <td class="normal"> 'forUpdate' => false, </td></tr> <tr><td>133</td> <td class="normal"> 'from' => array(), </td></tr> <tr><td>134</td> <td class="normal"> 'set' => array(), </td></tr> <tr><td>135</td> <td class="normal"> 'join' => array(), </td></tr> <tr><td>136</td> <td class="normal"> 'where' => array(), </td></tr> <tr><td>137</td> <td class="normal"> 'groupby' => array(), </td></tr> <tr><td>138</td> <td class="normal"> 'having' => array(), </td></tr> <tr><td>139</td> <td class="normal"> 'orderby' => array(), </td></tr> <tr><td>140</td> <td class="normal"> 'limit' => false, </td></tr> <tr><td>141</td> <td class="normal"> 'offset' => false, </td></tr> <tr><td>142</td> <td class="normal"> ); </td></tr> <tr><td>143</td> <td class="normal"> </td></tr> <tr><td>144</td> <td class="normal"> /** </td></tr> <tr><td>145</td> <td class="normal"> * @var integer $type the query type </td></tr> <tr><td>146</td> <td class="normal"> * </td></tr> <tr><td>147</td> <td class="normal"> * @see Doctrine_Query::* constants </td></tr> <tr><td>148</td> <td class="normal"> */ </td></tr> <tr><td>149</td> <td class="normal"> protected $type = self::SELECT; </td></tr> <tr><td>150</td> <td class="normal"> </td></tr> <tr><td>151</td> <td class="normal"> /** </td></tr> <tr><td>152</td> <td class="normal"> * @var array </td></tr> <tr><td>153</td> <td class="normal"> */ </td></tr> <tr><td>154</td> <td class="normal"> protected $_cache; </td></tr> <tr><td>155</td> <td class="normal"> </td></tr> <tr><td>156</td> <td class="normal"> /** </td></tr> <tr><td>157</td> <td class="normal"> * The current hydration mode. </td></tr> <tr><td>158</td> <td class="normal"> */ </td></tr> <tr><td>159</td> <td class="normal"> protected $_hydrationMode = Doctrine::HYDRATE_RECORD; </td></tr> <tr><td>160</td> <td class="normal"> </td></tr> <tr><td>161</td> <td class="normal"> /** </td></tr> <tr><td>162</td> <td class="normal"> * @var boolean $_expireCache a boolean value that indicates whether or not to force cache expiration </td></tr> <tr><td>163</td> <td class="normal"> */ </td></tr> <tr><td>164</td> <td class="normal"> protected $_expireCache = false; </td></tr> <tr><td>165</td> <td class="normal"> </td></tr> <tr><td>166</td> <td class="normal"> protected $_timeToLive; </td></tr> <tr><td>167</td> <td class="normal"> </td></tr> <tr><td>168</td> <td class="normal"> protected $_tableAliases = array(); </td></tr> <tr><td>169</td> <td class="normal"> </td></tr> <tr><td>170</td> <td class="normal"> /** </td></tr> <tr><td>171</td> <td class="normal"> * @var array $_tableAliasSeeds A simple array keys representing table aliases and values </td></tr> <tr><td>172</td> <td class="normal"> * as table alias seeds. The seeds are used for generating short table </td></tr> <tr><td>173</td> <td class="normal"> * aliases. </td></tr> <tr><td>174</td> <td class="normal"> */ </td></tr> <tr><td>175</td> <td class="normal"> protected $_tableAliasSeeds = array(); </td></tr> <tr><td>176</td> <td class="normal"> </td></tr> <tr><td>177</td> <td class="normal"> /** </td></tr> <tr><td>178</td> <td class="normal"> * constructor </td></tr> <tr><td>179</td> <td class="normal"> * </td></tr> <tr><td>180</td> <td class="normal"> * @param Doctrine_Connection|null $connection </td></tr> <tr><td>181</td> <td class="normal"> */ </td></tr> <tr><td>182</td> <td class="normal"> public function __construct($connection = null) </td></tr> <tr><td>183</td> <td class="normal"> { </td></tr> <tr><td>184</td> <td class="covered"> if ( ! ($connection instanceof Doctrine_Connection)) { </td></tr> <tr><td>185</td> <td class="covered"> $connection = Doctrine_Manager::getInstance()->getCurrentConnection(); </td></tr> <tr><td>186</td> <td class="covered"> } </td></tr> <tr><td>187</td> <td class="covered"> $this->_conn = $connection; </td></tr> <tr><td>188</td> <td class="covered"> } </td></tr> <tr><td>189</td> <td class="normal"> </td></tr> <tr><td>190</td> <td class="normal"> /** </td></tr> <tr><td>191</td> <td class="normal"> * getRootAlias </td></tr> <tr><td>192</td> <td class="normal"> * returns the alias of the the root component </td></tr> <tr><td>193</td> <td class="normal"> * </td></tr> <tr><td>194</td> <td class="normal"> * @return array </td></tr> <tr><td>195</td> <td class="normal"> */ </td></tr> <tr><td>196</td> <td class="normal"> public function getRootAlias() </td></tr> <tr><td>197</td> <td class="normal"> { </td></tr> <tr><td>198</td> <td class="covered"> if ( ! $this->_aliasMap) { </td></tr> <tr><td>199</td> <td class="red"> $this->getSql(); </td></tr> <tr><td>200</td> <td class="red"> } </td></tr> <tr><td>201</td> <td class="normal"> </td></tr> <tr><td>202</td> <td class="covered"> reset($this->_aliasMap); </td></tr> <tr><td>203</td> <td class="normal"> </td></tr> <tr><td>204</td> <td class="covered"> return key($this->_aliasMap); </td></tr> <tr><td>205</td> <td class="orange"> } </td></tr> <tr><td>206</td> <td class="normal"> </td></tr> <tr><td>207</td> <td class="normal"> /** </td></tr> <tr><td>208</td> <td class="normal"> * getRootDeclaration </td></tr> <tr><td>209</td> <td class="normal"> * returns the root declaration </td></tr> <tr><td>210</td> <td class="normal"> * </td></tr> <tr><td>211</td> <td class="normal"> * @return array </td></tr> <tr><td>212</td> <td class="normal"> */ </td></tr> <tr><td>213</td> <td class="normal"> public function getRootDeclaration() </td></tr> <tr><td>214</td> <td class="normal"> { </td></tr> <tr><td>215</td> <td class="covered"> $map = reset($this->_aliasMap); </td></tr> <tr><td>216</td> <td class="normal"> </td></tr> <tr><td>217</td> <td class="covered"> return $map; </td></tr> <tr><td>218</td> <td class="orange"> } </td></tr> <tr><td>219</td> <td class="normal"> </td></tr> <tr><td>220</td> <td class="normal"> /** </td></tr> <tr><td>221</td> <td class="normal"> * getRoot </td></tr> <tr><td>222</td> <td class="normal"> * returns the root component for this object </td></tr> <tr><td>223</td> <td class="normal"> * </td></tr> <tr><td>224</td> <td class="normal"> * @return Doctrine_Table root components table </td></tr> <tr><td>225</td> <td class="normal"> */ </td></tr> <tr><td>226</td> <td class="normal"> public function getRoot() </td></tr> <tr><td>227</td> <td class="normal"> { </td></tr> <tr><td>228</td> <td class="covered"> $map = reset($this->_aliasMap); </td></tr> <tr><td>229</td> <td class="normal"> </td></tr> <tr><td>230</td> <td class="covered"> if ( ! isset($map['table'])) { </td></tr> <tr><td>231</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Root component not initialized.'); </td></tr> <tr><td>232</td> <td class="orange"> } </td></tr> <tr><td>233</td> <td class="normal"> </td></tr> <tr><td>234</td> <td class="covered"> return $map['table']; </td></tr> <tr><td>235</td> <td class="orange"> } </td></tr> <tr><td>236</td> <td class="normal"> </td></tr> <tr><td>237</td> <td class="normal"> /** </td></tr> <tr><td>238</td> <td class="normal"> * getSql </td></tr> <tr><td>239</td> <td class="normal"> * return the sql associated with this object </td></tr> <tr><td>240</td> <td class="normal"> * </td></tr> <tr><td>241</td> <td class="normal"> * @return string sql query string </td></tr> <tr><td>242</td> <td class="normal"> */ </td></tr> <tr><td>243</td> <td class="normal"> public function getSql() </td></tr> <tr><td>244</td> <td class="normal"> { </td></tr> <tr><td>245</td> <td class="covered"> return $this->getQuery(); </td></tr> <tr><td>246</td> <td class="orange"> } </td></tr> <tr><td>247</td> <td class="normal"> </td></tr> <tr><td>248</td> <td class="normal"> /** </td></tr> <tr><td>249</td> <td class="normal"> * useCache </td></tr> <tr><td>250</td> <td class="normal"> * </td></tr> <tr><td>251</td> <td class="normal"> * @param Doctrine_Cache_Interface|bool $driver cache driver </td></tr> <tr><td>252</td> <td class="normal"> * @param integer $timeToLive how long the cache entry is valid </td></tr> <tr><td>253</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>254</td> <td class="normal"> */ </td></tr> <tr><td>255</td> <td class="normal"> public function useCache($driver = true, $timeToLive = null) </td></tr> <tr><td>256</td> <td class="normal"> { </td></tr> <tr><td>257</td> <td class="covered"> if ($driver !== null) { </td></tr> <tr><td>258</td> <td class="covered"> if ($driver !== true) { </td></tr> <tr><td>259</td> <td class="covered"> if ( ! ($driver instanceof Doctrine_Cache_Interface)) { </td></tr> <tr><td>260</td> <td class="red"> $msg = 'First argument should be instance of Doctrine_Cache_Interface or null.'; </td></tr> <tr><td>261</td> <td class="normal"> </td></tr> <tr><td>262</td> <td class="red"> throw new Doctrine_Hydrate_Exception($msg); </td></tr> <tr><td>263</td> <td class="orange"> } </td></tr> <tr><td>264</td> <td class="covered"> } </td></tr> <tr><td>265</td> <td class="covered"> } </td></tr> <tr><td>266</td> <td class="covered"> $this->_cache = $driver; </td></tr> <tr><td>267</td> <td class="normal"> </td></tr> <tr><td>268</td> <td class="covered"> return $this->setCacheLifeSpan($timeToLive); </td></tr> <tr><td>269</td> <td class="orange"> } </td></tr> <tr><td>270</td> <td class="normal"> </td></tr> <tr><td>271</td> <td class="normal"> /** </td></tr> <tr><td>272</td> <td class="normal"> * expireCache </td></tr> <tr><td>273</td> <td class="normal"> * </td></tr> <tr><td>274</td> <td class="normal"> * @param boolean $expire whether or not to force cache expiration </td></tr> <tr><td>275</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>276</td> <td class="normal"> */ </td></tr> <tr><td>277</td> <td class="normal"> public function expireCache($expire = true) </td></tr> <tr><td>278</td> <td class="normal"> { </td></tr> <tr><td>279</td> <td class="red"> $this->_expireCache = true; </td></tr> <tr><td>280</td> <td class="normal"> </td></tr> <tr><td>281</td> <td class="red"> return $this; </td></tr> <tr><td>282</td> <td class="orange"> } </td></tr> <tr><td>283</td> <td class="normal"> </td></tr> <tr><td>284</td> <td class="normal"> /** </td></tr> <tr><td>285</td> <td class="normal"> * setCacheLifeSpan </td></tr> <tr><td>286</td> <td class="normal"> * </td></tr> <tr><td>287</td> <td class="normal"> * @param integer $timeToLive how long the cache entry is valid </td></tr> <tr><td>288</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>289</td> <td class="normal"> */ </td></tr> <tr><td>290</td> <td class="normal"> public function setCacheLifeSpan($timeToLive) </td></tr> <tr><td>291</td> <td class="normal"> { </td></tr> <tr><td>292</td> <td class="covered"> if ($timeToLive !== null) { </td></tr> <tr><td>293</td> <td class="red"> $timeToLive = (int) $timeToLive; </td></tr> <tr><td>294</td> <td class="red"> } </td></tr> <tr><td>295</td> <td class="covered"> $this->_timeToLive = $timeToLive; </td></tr> <tr><td>296</td> <td class="normal"> </td></tr> <tr><td>297</td> <td class="covered"> return $this; </td></tr> <tr><td>298</td> <td class="orange"> } </td></tr> <tr><td>299</td> <td class="normal"> </td></tr> <tr><td>300</td> <td class="normal"> /** </td></tr> <tr><td>301</td> <td class="normal"> * getCacheDriver </td></tr> <tr><td>302</td> <td class="normal"> * returns the cache driver associated with this object </td></tr> <tr><td>303</td> <td class="normal"> * </td></tr> <tr><td>304</td> <td class="normal"> * @return Doctrine_Cache_Interface|boolean|null cache driver </td></tr> <tr><td>305</td> <td class="normal"> */ </td></tr> <tr><td>306</td> <td class="normal"> public function getCacheDriver() </td></tr> <tr><td>307</td> <td class="normal"> { </td></tr> <tr><td>308</td> <td class="covered"> if ($this->_cache instanceof Doctrine_Cache_Interface) { </td></tr> <tr><td>309</td> <td class="covered"> return $this->_cache; </td></tr> <tr><td>310</td> <td class="orange"> } else { </td></tr> <tr><td>311</td> <td class="covered"> return $this->_conn->getCacheDriver(); </td></tr> <tr><td>312</td> <td class="normal"> } </td></tr> <tr><td>313</td> <td class="orange"> } </td></tr> <tr><td>314</td> <td class="normal"> </td></tr> <tr><td>315</td> <td class="normal"> /** </td></tr> <tr><td>316</td> <td class="normal"> * Sets the fetchmode. </td></tr> <tr><td>317</td> <td class="normal"> * </td></tr> <tr><td>318</td> <td class="normal"> * @param integer $fetchmode One of the Doctrine::HYDRATE_* constants. </td></tr> <tr><td>319</td> <td class="normal"> */ </td></tr> <tr><td>320</td> <td class="normal"> public function setHydrationMode($hydrationMode) </td></tr> <tr><td>321</td> <td class="normal"> { </td></tr> <tr><td>322</td> <td class="covered"> $this->_hydrationMode = $hydrationMode; </td></tr> <tr><td>323</td> <td class="covered"> return $this; </td></tr> <tr><td>324</td> <td class="orange"> } </td></tr> <tr><td>325</td> <td class="normal"> </td></tr> <tr><td>326</td> <td class="normal"> /** </td></tr> <tr><td>327</td> <td class="normal"> * serialize </td></tr> <tr><td>328</td> <td class="normal"> * this method is automatically called when this Doctrine_Hydrate is serialized </td></tr> <tr><td>329</td> <td class="normal"> * </td></tr> <tr><td>330</td> <td class="normal"> * @return array an array of serialized properties </td></tr> <tr><td>331</td> <td class="normal"> */ </td></tr> <tr><td>332</td> <td class="normal"> public function serialize() </td></tr> <tr><td>333</td> <td class="normal"> { </td></tr> <tr><td>334</td> <td class="red"> $vars = get_object_vars($this); </td></tr> <tr><td>335</td> <td class="normal"> </td></tr> <tr><td>336</td> <td class="red"> } </td></tr> <tr><td>337</td> <td class="normal"> </td></tr> <tr><td>338</td> <td class="normal"> /** </td></tr> <tr><td>339</td> <td class="normal"> * unseralize </td></tr> <tr><td>340</td> <td class="normal"> * this method is automatically called everytime a Doctrine_Hydrate object is unserialized </td></tr> <tr><td>341</td> <td class="normal"> * </td></tr> <tr><td>342</td> <td class="normal"> * @param string $serialized Doctrine_Record as serialized string </td></tr> <tr><td>343</td> <td class="normal"> * @return void </td></tr> <tr><td>344</td> <td class="normal"> */ </td></tr> <tr><td>345</td> <td class="normal"> public function unserialize($serialized) </td></tr> <tr><td>346</td> <td class="normal"> { </td></tr> <tr><td>347</td> <td class="normal"> </td></tr> <tr><td>348</td> <td class="red"> } </td></tr> <tr><td>349</td> <td class="normal"> </td></tr> <tr><td>350</td> <td class="normal"> /** </td></tr> <tr><td>351</td> <td class="normal"> * generateNewTableAlias </td></tr> <tr><td>352</td> <td class="normal"> * generates a new alias from given table alias </td></tr> <tr><td>353</td> <td class="normal"> * </td></tr> <tr><td>354</td> <td class="normal"> * @param string $tableAlias table alias from which to generate the new alias from </td></tr> <tr><td>355</td> <td class="normal"> * @return string the created table alias </td></tr> <tr><td>356</td> <td class="normal"> */ </td></tr> <tr><td>357</td> <td class="normal"> public function generateNewTableAlias($tableAlias) </td></tr> <tr><td>358</td> <td class="normal"> { </td></tr> <tr><td>359</td> <td class="covered"> if (isset($this->_tableAliases[$tableAlias])) { </td></tr> <tr><td>360</td> <td class="normal"> // generate a new alias </td></tr> <tr><td>361</td> <td class="covered"> $name = substr($tableAlias, 0, 1); </td></tr> <tr><td>362</td> <td class="covered"> $i = ((int) substr($tableAlias, 1)); </td></tr> <tr><td>363</td> <td class="normal"> </td></tr> <tr><td>364</td> <td class="covered"> if ($i == 0) { </td></tr> <tr><td>365</td> <td class="covered"> $i = 1; </td></tr> <tr><td>366</td> <td class="covered"> } </td></tr> <tr><td>367</td> <td class="normal"> </td></tr> <tr><td>368</td> <td class="covered"> $newIndex = ($this->_tableAliasSeeds[$name] + $i); </td></tr> <tr><td>369</td> <td class="normal"> </td></tr> <tr><td>370</td> <td class="covered"> return $name . $newIndex; </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="red"> return $tableAlias; </td></tr> <tr><td>374</td> <td class="orange"> } </td></tr> <tr><td>375</td> <td class="normal"> </td></tr> <tr><td>376</td> <td class="normal"> /** </td></tr> <tr><td>377</td> <td class="normal"> * hasTableAlias </td></tr> <tr><td>378</td> <td class="normal"> * whether or not this object has given tableAlias </td></tr> <tr><td>379</td> <td class="normal"> * </td></tr> <tr><td>380</td> <td class="normal"> * @param string $tableAlias the table alias to be checked </td></tr> <tr><td>381</td> <td class="normal"> * @return boolean true if this object has given alias, otherwise false </td></tr> <tr><td>382</td> <td class="normal"> */ </td></tr> <tr><td>383</td> <td class="normal"> public function hasTableAlias($tableAlias) </td></tr> <tr><td>384</td> <td class="normal"> { </td></tr> <tr><td>385</td> <td class="covered"> return (isset($this->_tableAliases[$tableAlias])); </td></tr> <tr><td>386</td> <td class="orange"> } </td></tr> <tr><td>387</td> <td class="normal"> </td></tr> <tr><td>388</td> <td class="normal"> /** </td></tr> <tr><td>389</td> <td class="normal"> * getComponentAlias </td></tr> <tr><td>390</td> <td class="normal"> * get component alias associated with given table alias </td></tr> <tr><td>391</td> <td class="normal"> * </td></tr> <tr><td>392</td> <td class="normal"> * @param string $tableAlias the table alias that identifies the component alias </td></tr> <tr><td>393</td> <td class="normal"> * @return string component alias </td></tr> <tr><td>394</td> <td class="normal"> */ </td></tr> <tr><td>395</td> <td class="normal"> public function getComponentAlias($tableAlias) </td></tr> <tr><td>396</td> <td class="normal"> { </td></tr> <tr><td>397</td> <td class="covered"> if ( ! isset($this->_tableAliases[$tableAlias])) { </td></tr> <tr><td>398</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown table alias ' . $tableAlias); </td></tr> <tr><td>399</td> <td class="orange"> } </td></tr> <tr><td>400</td> <td class="covered"> return $this->_tableAliases[$tableAlias]; </td></tr> <tr><td>401</td> <td class="orange"> } </td></tr> <tr><td>402</td> <td class="normal"> </td></tr> <tr><td>403</td> <td class="normal"> /** </td></tr> <tr><td>404</td> <td class="normal"> * getTableAliasSeed </td></tr> <tr><td>405</td> <td class="normal"> * returns the alias seed for given table alias </td></tr> <tr><td>406</td> <td class="normal"> * </td></tr> <tr><td>407</td> <td class="normal"> * @param string $tableAlias table alias that identifies the alias seed </td></tr> <tr><td>408</td> <td class="normal"> * @return integer table alias seed </td></tr> <tr><td>409</td> <td class="normal"> */ </td></tr> <tr><td>410</td> <td class="normal"> public function getTableAliasSeed($tableAlias) </td></tr> <tr><td>411</td> <td class="normal"> { </td></tr> <tr><td>412</td> <td class="red"> if ( ! isset($this->_tableAliasSeeds[$tableAlias])) { </td></tr> <tr><td>413</td> <td class="red"> return 0; </td></tr> <tr><td>414</td> <td class="orange"> } </td></tr> <tr><td>415</td> <td class="red"> return $this->_tableAliasSeeds[$tableAlias]; </td></tr> <tr><td>416</td> <td class="orange"> } </td></tr> <tr><td>417</td> <td class="normal"> </td></tr> <tr><td>418</td> <td class="normal"> /** </td></tr> <tr><td>419</td> <td class="normal"> * generateTableAlias </td></tr> <tr><td>420</td> <td class="normal"> * generates a table alias from given table name and associates </td></tr> <tr><td>421</td> <td class="normal"> * it with given component alias </td></tr> <tr><td>422</td> <td class="normal"> * </td></tr> <tr><td>423</td> <td class="normal"> * @param string $componentAlias the component alias to be associated with generated table alias </td></tr> <tr><td>424</td> <td class="normal"> * @param string $tableName the table name from which to generate the table alias </td></tr> <tr><td>425</td> <td class="normal"> * @return string the generated table alias </td></tr> <tr><td>426</td> <td class="normal"> */ </td></tr> <tr><td>427</td> <td class="normal"> public function generateTableAlias($componentAlias, $tableName) </td></tr> <tr><td>428</td> <td class="normal"> { </td></tr> <tr><td>429</td> <td class="covered"> $char = strtolower(substr($tableName, 0, 1)); </td></tr> <tr><td>430</td> <td class="normal"> </td></tr> <tr><td>431</td> <td class="covered"> $alias = $char; </td></tr> <tr><td>432</td> <td class="normal"> </td></tr> <tr><td>433</td> <td class="covered"> if ( ! isset($this->_tableAliasSeeds[$alias])) { </td></tr> <tr><td>434</td> <td class="covered"> $this->_tableAliasSeeds[$alias] = 1; </td></tr> <tr><td>435</td> <td class="covered"> } </td></tr> <tr><td>436</td> <td class="normal"> </td></tr> <tr><td>437</td> <td class="covered"> while (isset($this->_tableAliases[$alias])) { </td></tr> <tr><td>438</td> <td class="covered"> if ( ! isset($this->_tableAliasSeeds[$alias])) { </td></tr> <tr><td>439</td> <td class="red"> $this->_tableAliasSeeds[$alias] = 1; </td></tr> <tr><td>440</td> <td class="red"> } </td></tr> <tr><td>441</td> <td class="covered"> $alias = $char . ++$this->_tableAliasSeeds[$alias]; </td></tr> <tr><td>442</td> <td class="covered"> } </td></tr> <tr><td>443</td> <td class="normal"> </td></tr> <tr><td>444</td> <td class="covered"> $this->_tableAliases[$alias] = $componentAlias; </td></tr> <tr><td>445</td> <td class="normal"> </td></tr> <tr><td>446</td> <td class="covered"> return $alias; </td></tr> <tr><td>447</td> <td class="orange"> } </td></tr> <tr><td>448</td> <td class="normal"> </td></tr> <tr><td>449</td> <td class="normal"> /** </td></tr> <tr><td>450</td> <td class="normal"> * getTableAliases </td></tr> <tr><td>451</td> <td class="normal"> * returns all table aliases </td></tr> <tr><td>452</td> <td class="normal"> * </td></tr> <tr><td>453</td> <td class="normal"> * @return array table aliases as an array </td></tr> <tr><td>454</td> <td class="normal"> */ </td></tr> <tr><td>455</td> <td class="normal"> public function getTableAliases() </td></tr> <tr><td>456</td> <td class="normal"> { </td></tr> <tr><td>457</td> <td class="covered"> return $this->_tableAliases; </td></tr> <tr><td>458</td> <td class="orange"> } </td></tr> <tr><td>459</td> <td class="normal"> </td></tr> <tr><td>460</td> <td class="normal"> /** </td></tr> <tr><td>461</td> <td class="normal"> * addTableAlias </td></tr> <tr><td>462</td> <td class="normal"> * adds an alias for table and associates it with given component alias </td></tr> <tr><td>463</td> <td class="normal"> * </td></tr> <tr><td>464</td> <td class="normal"> * @param string $componentAlias the alias for the query component associated with given tableAlias </td></tr> <tr><td>465</td> <td class="normal"> * @param string $tableAlias the table alias to be added </td></tr> <tr><td>466</td> <td class="normal"> * @return Doctrine_Hydrate </td></tr> <tr><td>467</td> <td class="normal"> */ </td></tr> <tr><td>468</td> <td class="normal"> public function addTableAlias($tableAlias, $componentAlias) </td></tr> <tr><td>469</td> <td class="normal"> { </td></tr> <tr><td>470</td> <td class="covered"> $this->_tableAliases[$tableAlias] = $componentAlias; </td></tr> <tr><td>471</td> <td class="normal"> </td></tr> <tr><td>472</td> <td class="covered"> return $this; </td></tr> <tr><td>473</td> <td class="orange"> } </td></tr> <tr><td>474</td> <td class="normal"> </td></tr> <tr><td>475</td> <td class="normal"> /** </td></tr> <tr><td>476</td> <td class="normal"> * getTableAlias </td></tr> <tr><td>477</td> <td class="normal"> * some database such as Oracle need the identifier lengths to be < ~30 chars </td></tr> <tr><td>478</td> <td class="normal"> * hence Doctrine creates as short identifier aliases as possible </td></tr> <tr><td>479</td> <td class="normal"> * </td></tr> <tr><td>480</td> <td class="normal"> * this method is used for the creation of short table aliases, its also </td></tr> <tr><td>481</td> <td class="normal"> * smart enough to check if an alias already exists for given component (componentAlias) </td></tr> <tr><td>482</td> <td class="normal"> * </td></tr> <tr><td>483</td> <td class="normal"> * @param string $componentAlias the alias for the query component to search table alias for </td></tr> <tr><td>484</td> <td class="normal"> * @param string $tableName the table name from which the table alias is being created </td></tr> <tr><td>485</td> <td class="normal"> * @return string the generated / fetched short alias </td></tr> <tr><td>486</td> <td class="normal"> */ </td></tr> <tr><td>487</td> <td class="normal"> public function getTableAlias($componentAlias, $tableName = null) </td></tr> <tr><td>488</td> <td class="normal"> { </td></tr> <tr><td>489</td> <td class="covered"> $alias = array_search($componentAlias, $this->_tableAliases); </td></tr> <tr><td>490</td> <td class="normal"> </td></tr> <tr><td>491</td> <td class="covered"> if ($alias !== false) { </td></tr> <tr><td>492</td> <td class="covered"> return $alias; </td></tr> <tr><td>493</td> <td class="orange"> } </td></tr> <tr><td>494</td> <td class="normal"> </td></tr> <tr><td>495</td> <td class="covered"> if ($tableName === null) { </td></tr> <tr><td>496</td> <td class="red"> throw new Doctrine_Hydrate_Exception("Couldn't get short alias for " . $componentAlias); </td></tr> <tr><td>497</td> <td class="orange"> } </td></tr> <tr><td>498</td> <td class="normal"> </td></tr> <tr><td>499</td> <td class="covered"> return $this->generateTableAlias($componentAlias, $tableName); </td></tr> <tr><td>500</td> <td class="orange"> } </td></tr> <tr><td>501</td> <td class="normal"> </td></tr> <tr><td>502</td> <td class="normal"> /** </td></tr> <tr><td>503</td> <td class="normal"> * addQueryPart </td></tr> <tr><td>504</td> <td class="normal"> * adds a query part in the query part array </td></tr> <tr><td>505</td> <td class="normal"> * </td></tr> <tr><td>506</td> <td class="normal"> * @param string $name the name of the query part to be added </td></tr> <tr><td>507</td> <td class="normal"> * @param string $part query part string </td></tr> <tr><td>508</td> <td class="normal"> * @throws Doctrine_Hydrate_Exception if trying to add unknown query part </td></tr> <tr><td>509</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>510</td> <td class="normal"> */ </td></tr> <tr><td>511</td> <td class="normal"> public function addQueryPart($name, $part) </td></tr> <tr><td>512</td> <td class="normal"> { </td></tr> <tr><td>513</td> <td class="covered"> if ( ! isset($this->parts[$name])) { </td></tr> <tr><td>514</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown query part ' . $name); </td></tr> <tr><td>515</td> <td class="orange"> } </td></tr> <tr><td>516</td> <td class="covered"> if (is_array($part)) { </td></tr> <tr><td>517</td> <td class="covered"> $this->parts[$name] = array_merge($this->parts[$name], $part); </td></tr> <tr><td>518</td> <td class="covered"> } else { </td></tr> <tr><td>519</td> <td class="covered"> $this->parts[$name][] = $part; </td></tr> <tr><td>520</td> <td class="normal"> } </td></tr> <tr><td>521</td> <td class="covered"> return $this; </td></tr> <tr><td>522</td> <td class="orange"> } </td></tr> <tr><td>523</td> <td class="normal"> </td></tr> <tr><td>524</td> <td class="normal"> /** </td></tr> <tr><td>525</td> <td class="normal"> * setQueryPart </td></tr> <tr><td>526</td> <td class="normal"> * sets a query part in the query part array </td></tr> <tr><td>527</td> <td class="normal"> * </td></tr> <tr><td>528</td> <td class="normal"> * @param string $name the name of the query part to be set </td></tr> <tr><td>529</td> <td class="normal"> * @param string $part query part string </td></tr> <tr><td>530</td> <td class="normal"> * @throws Doctrine_Hydrate_Exception if trying to set unknown query part </td></tr> <tr><td>531</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>532</td> <td class="normal"> */ </td></tr> <tr><td>533</td> <td class="normal"> public function getQueryPart($part) </td></tr> <tr><td>534</td> <td class="normal"> { </td></tr> <tr><td>535</td> <td class="covered"> if ( ! isset($this->parts[$part])) { </td></tr> <tr><td>536</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown query part ' . $part); </td></tr> <tr><td>537</td> <td class="orange"> } </td></tr> <tr><td>538</td> <td class="normal"> </td></tr> <tr><td>539</td> <td class="covered"> return $this->parts[$part]; </td></tr> <tr><td>540</td> <td class="orange"> } </td></tr> <tr><td>541</td> <td class="normal"> </td></tr> <tr><td>542</td> <td class="normal"> /** </td></tr> <tr><td>543</td> <td class="normal"> * removeQueryPart </td></tr> <tr><td>544</td> <td class="normal"> * removes a query part from the query part array </td></tr> <tr><td>545</td> <td class="normal"> * </td></tr> <tr><td>546</td> <td class="normal"> * @param string $name the name of the query part to be removed </td></tr> <tr><td>547</td> <td class="normal"> * @throws Doctrine_Hydrate_Exception if trying to remove unknown query part </td></tr> <tr><td>548</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>549</td> <td class="normal"> */ </td></tr> <tr><td>550</td> <td class="normal"> public function removeQueryPart($name) </td></tr> <tr><td>551</td> <td class="normal"> { </td></tr> <tr><td>552</td> <td class="covered"> if (isset($this->parts[$name])) { </td></tr> <tr><td>553</td> <td class="covered"> if ($name == 'limit' || $name == 'offset') { </td></tr> <tr><td>554</td> <td class="covered"> $this->parts[$name] = false; </td></tr> <tr><td>555</td> <td class="covered"> } else { </td></tr> <tr><td>556</td> <td class="covered"> $this->parts[$name] = array(); </td></tr> <tr><td>557</td> <td class="normal"> } </td></tr> <tr><td>558</td> <td class="covered"> } else { </td></tr> <tr><td>559</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown query part ' . $name); </td></tr> <tr><td>560</td> <td class="normal"> } </td></tr> <tr><td>561</td> <td class="covered"> return $this; </td></tr> <tr><td>562</td> <td class="orange"> } </td></tr> <tr><td>563</td> <td class="normal"> </td></tr> <tr><td>564</td> <td class="normal"> /** </td></tr> <tr><td>565</td> <td class="normal"> * setQueryPart </td></tr> <tr><td>566</td> <td class="normal"> * sets a query part in the query part array </td></tr> <tr><td>567</td> <td class="normal"> * </td></tr> <tr><td>568</td> <td class="normal"> * @param string $name the name of the query part to be set </td></tr> <tr><td>569</td> <td class="normal"> * @param string $part query part string </td></tr> <tr><td>570</td> <td class="normal"> * @throws Doctrine_Hydrate_Exception if trying to set unknown query part </td></tr> <tr><td>571</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>572</td> <td class="normal"> */ </td></tr> <tr><td>573</td> <td class="normal"> public function setQueryPart($name, $part) </td></tr> <tr><td>574</td> <td class="normal"> { </td></tr> <tr><td>575</td> <td class="covered"> if ( ! isset($this->parts[$name])) { </td></tr> <tr><td>576</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown query part ' . $name); </td></tr> <tr><td>577</td> <td class="orange"> } </td></tr> <tr><td>578</td> <td class="normal"> </td></tr> <tr><td>579</td> <td class="covered"> if ($name !== 'limit' && $name !== 'offset') { </td></tr> <tr><td>580</td> <td class="covered"> if (is_array($part)) { </td></tr> <tr><td>581</td> <td class="red"> $this->parts[$name] = $part; </td></tr> <tr><td>582</td> <td class="red"> } else { </td></tr> <tr><td>583</td> <td class="covered"> $this->parts[$name] = array($part); </td></tr> <tr><td>584</td> <td class="normal"> } </td></tr> <tr><td>585</td> <td class="covered"> } else { </td></tr> <tr><td>586</td> <td class="covered"> $this->parts[$name] = $part; </td></tr> <tr><td>587</td> <td class="normal"> } </td></tr> <tr><td>588</td> <td class="normal"> </td></tr> <tr><td>589</td> <td class="covered"> return $this; </td></tr> <tr><td>590</td> <td class="orange"> } </td></tr> <tr><td>591</td> <td class="normal"> </td></tr> <tr><td>592</td> <td class="normal"> /** </td></tr> <tr><td>593</td> <td class="normal"> * hasAliasDeclaration </td></tr> <tr><td>594</td> <td class="normal"> * whether or not this object has a declaration for given component alias </td></tr> <tr><td>595</td> <td class="normal"> * </td></tr> <tr><td>596</td> <td class="normal"> * @param string $componentAlias the component alias the retrieve the declaration from </td></tr> <tr><td>597</td> <td class="normal"> * @return boolean </td></tr> <tr><td>598</td> <td class="normal"> */ </td></tr> <tr><td>599</td> <td class="normal"> public function hasAliasDeclaration($componentAlias) </td></tr> <tr><td>600</td> <td class="normal"> { </td></tr> <tr><td>601</td> <td class="red"> return isset($this->_aliasMap[$componentAlias]); </td></tr> <tr><td>602</td> <td class="orange"> } </td></tr> <tr><td>603</td> <td class="normal"> </td></tr> <tr><td>604</td> <td class="normal"> /** </td></tr> <tr><td>605</td> <td class="normal"> * getAliasDeclaration </td></tr> <tr><td>606</td> <td class="normal"> * get the declaration for given component alias </td></tr> <tr><td>607</td> <td class="normal"> * </td></tr> <tr><td>608</td> <td class="normal"> * @param string $componentAlias the component alias the retrieve the declaration from </td></tr> <tr><td>609</td> <td class="normal"> * @return array the alias declaration </td></tr> <tr><td>610</td> <td class="normal"> */ </td></tr> <tr><td>611</td> <td class="normal"> public function getAliasDeclaration($componentAlias) </td></tr> <tr><td>612</td> <td class="normal"> { </td></tr> <tr><td>613</td> <td class="covered"> if ( ! isset($this->_aliasMap[$componentAlias])) { </td></tr> <tr><td>614</td> <td class="red"> throw new Doctrine_Hydrate_Exception('Unknown component alias ' . $componentAlias); </td></tr> <tr><td>615</td> <td class="orange"> } </td></tr> <tr><td>616</td> <td class="normal"> </td></tr> <tr><td>617</td> <td class="covered"> return $this->_aliasMap[$componentAlias]; </td></tr> <tr><td>618</td> <td class="orange"> } </td></tr> <tr><td>619</td> <td class="normal"> </td></tr> <tr><td>620</td> <td class="normal"> /** </td></tr> <tr><td>621</td> <td class="normal"> * copyAliases </td></tr> <tr><td>622</td> <td class="normal"> * copy aliases from another Hydrate object </td></tr> <tr><td>623</td> <td class="normal"> * </td></tr> <tr><td>624</td> <td class="normal"> * this method is needed by DQL subqueries which need the aliases </td></tr> <tr><td>625</td> <td class="normal"> * of the parent query </td></tr> <tr><td>626</td> <td class="normal"> * </td></tr> <tr><td>627</td> <td class="normal"> * @param Doctrine_Hydrate $query the query object from which the </td></tr> <tr><td>628</td> <td class="normal"> * aliases are copied from </td></tr> <tr><td>629</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>630</td> <td class="normal"> */ </td></tr> <tr><td>631</td> <td class="normal"> public function copyAliases(Doctrine_Hydrate $query) </td></tr> <tr><td>632</td> <td class="normal"> { </td></tr> <tr><td>633</td> <td class="covered"> $this->_tableAliases = $query->_tableAliases; </td></tr> <tr><td>634</td> <td class="covered"> $this->_aliasMap = $query->_aliasMap; </td></tr> <tr><td>635</td> <td class="covered"> $this->_tableAliasSeeds = $query->_tableAliasSeeds; </td></tr> <tr><td>636</td> <td class="covered"> return $this; </td></tr> <tr><td>637</td> <td class="orange"> } </td></tr> <tr><td>638</td> <td class="normal"> </td></tr> <tr><td>639</td> <td class="normal"> /** </td></tr> <tr><td>640</td> <td class="normal"> * createSubquery </td></tr> <tr><td>641</td> <td class="normal"> * creates a subquery </td></tr> <tr><td>642</td> <td class="normal"> * </td></tr> <tr><td>643</td> <td class="normal"> * @return Doctrine_Hydrate </td></tr> <tr><td>644</td> <td class="normal"> */ </td></tr> <tr><td>645</td> <td class="normal"> public function createSubquery() </td></tr> <tr><td>646</td> <td class="normal"> { </td></tr> <tr><td>647</td> <td class="covered"> $class = get_class($this); </td></tr> <tr><td>648</td> <td class="covered"> $obj = new $class(); </td></tr> <tr><td>649</td> <td class="normal"> </td></tr> <tr><td>650</td> <td class="normal"> // copy the aliases to the subquery </td></tr> <tr><td>651</td> <td class="covered"> $obj->copyAliases($this); </td></tr> <tr><td>652</td> <td class="normal"> </td></tr> <tr><td>653</td> <td class="normal"> // this prevents the 'id' being selected, re ticket #307 </td></tr> <tr><td>654</td> <td class="covered"> $obj->isSubquery(true); </td></tr> <tr><td>655</td> <td class="normal"> </td></tr> <tr><td>656</td> <td class="covered"> return $obj; </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"> /** </td></tr> <tr><td>660</td> <td class="normal"> * limitSubqueryUsed </td></tr> <tr><td>661</td> <td class="normal"> * whether or not limit subquery was used </td></tr> <tr><td>662</td> <td class="normal"> * </td></tr> <tr><td>663</td> <td class="normal"> * @return boolean </td></tr> <tr><td>664</td> <td class="normal"> */ </td></tr> <tr><td>665</td> <td class="normal"> public function isLimitSubqueryUsed() </td></tr> <tr><td>666</td> <td class="normal"> { </td></tr> <tr><td>667</td> <td class="covered"> return false; </td></tr> <tr><td>668</td> <td class="orange"> } </td></tr> <tr><td>669</td> <td class="normal"> </td></tr> <tr><td>670</td> <td class="normal"> /** </td></tr> <tr><td>671</td> <td class="normal"> * clear </td></tr> <tr><td>672</td> <td class="normal"> * resets all the variables </td></tr> <tr><td>673</td> <td class="normal"> * </td></tr> <tr><td>674</td> <td class="normal"> * @return void </td></tr> <tr><td>675</td> <td class="normal"> */ </td></tr> <tr><td>676</td> <td class="normal"> protected function clear() </td></tr> <tr><td>677</td> <td class="normal"> { </td></tr> <tr><td>678</td> <td class="red"> $this->parts = array( </td></tr> <tr><td>679</td> <td class="covered"> 'select' => array(), </td></tr> <tr><td>680</td> <td class="covered"> 'distinct' => false, </td></tr> <tr><td>681</td> <td class="covered"> 'forUpdate' => false, </td></tr> <tr><td>682</td> <td class="covered"> 'from' => array(), </td></tr> <tr><td>683</td> <td class="covered"> 'set' => array(), </td></tr> <tr><td>684</td> <td class="covered"> 'join' => array(), </td></tr> <tr><td>685</td> <td class="covered"> 'where' => array(), </td></tr> <tr><td>686</td> <td class="covered"> 'groupby' => array(), </td></tr> <tr><td>687</td> <td class="covered"> 'having' => array(), </td></tr> <tr><td>688</td> <td class="covered"> 'orderby' => array(), </td></tr> <tr><td>689</td> <td class="covered"> 'limit' => false, </td></tr> <tr><td>690</td> <td class="covered"> 'offset' => false, </td></tr> <tr><td>691</td> <td class="normal"> ); </td></tr> <tr><td>692</td> <td class="covered"> $this->inheritanceApplied = false; </td></tr> <tr><td>693</td> <td class="covered"> } </td></tr> <tr><td>694</td> <td class="normal"> </td></tr> <tr><td>695</td> <td class="normal"> /** </td></tr> <tr><td>696</td> <td class="normal"> * getConnection </td></tr> <tr><td>697</td> <td class="normal"> * </td></tr> <tr><td>698</td> <td class="normal"> * @return Doctrine_Connection </td></tr> <tr><td>699</td> <td class="normal"> */ </td></tr> <tr><td>700</td> <td class="normal"> public function getConnection() </td></tr> <tr><td>701</td> <td class="normal"> { </td></tr> <tr><td>702</td> <td class="covered"> return $this->_conn; </td></tr> <tr><td>703</td> <td class="orange"> } </td></tr> <tr><td>704</td> <td class="normal"> </td></tr> <tr><td>705</td> <td class="normal"> /** </td></tr> <tr><td>706</td> <td class="normal"> * setView </td></tr> <tr><td>707</td> <td class="normal"> * sets a database view this query object uses </td></tr> <tr><td>708</td> <td class="normal"> * this method should only be called internally by doctrine </td></tr> <tr><td>709</td> <td class="normal"> * </td></tr> <tr><td>710</td> <td class="normal"> * @param Doctrine_View $view database view </td></tr> <tr><td>711</td> <td class="normal"> * @return void </td></tr> <tr><td>712</td> <td class="normal"> */ </td></tr> <tr><td>713</td> <td class="normal"> public function setView(Doctrine_View $view) </td></tr> <tr><td>714</td> <td class="normal"> { </td></tr> <tr><td>715</td> <td class="covered"> $this->_view = $view; </td></tr> <tr><td>716</td> <td class="covered"> } </td></tr> <tr><td>717</td> <td class="normal"> </td></tr> <tr><td>718</td> <td class="normal"> /** </td></tr> <tr><td>719</td> <td class="normal"> * getView </td></tr> <tr><td>720</td> <td class="normal"> * returns the view associated with this query object (if any) </td></tr> <tr><td>721</td> <td class="normal"> * </td></tr> <tr><td>722</td> <td class="normal"> * @return Doctrine_View the view associated with this query object </td></tr> <tr><td>723</td> <td class="normal"> */ </td></tr> <tr><td>724</td> <td class="normal"> public function getView() </td></tr> <tr><td>725</td> <td class="normal"> { </td></tr> <tr><td>726</td> <td class="covered"> return $this->_view; </td></tr> <tr><td>727</td> <td class="orange"> } </td></tr> <tr><td>728</td> <td class="normal"> </td></tr> <tr><td>729</td> <td class="normal"> /** </td></tr> <tr><td>730</td> <td class="normal"> * getParams </td></tr> <tr><td>731</td> <td class="normal"> * </td></tr> <tr><td>732</td> <td class="normal"> * @return array </td></tr> <tr><td>733</td> <td class="normal"> */ </td></tr> <tr><td>734</td> <td class="normal"> public function getParams() </td></tr> <tr><td>735</td> <td class="normal"> { </td></tr> <tr><td>736</td> <td class="covered"> return array_merge($this->_params['set'], $this->_params['where'], $this->_params['having']); </td></tr> <tr><td>737</td> <td class="orange"> } </td></tr> <tr><td>738</td> <td class="normal"> </td></tr> <tr><td>739</td> <td class="normal"> /** </td></tr> <tr><td>740</td> <td class="normal"> * setParams </td></tr> <tr><td>741</td> <td class="normal"> * </td></tr> <tr><td>742</td> <td class="normal"> * @param array $params </td></tr> <tr><td>743</td> <td class="normal"> */ </td></tr> <tr><td>744</td> <td class="normal"> public function setParams(array $params = array()) { </td></tr> <tr><td>745</td> <td class="red"> $this->_params = $params; </td></tr> <tr><td>746</td> <td class="red"> } </td></tr> <tr><td>747</td> <td class="normal"> public function convertEnums($params) </td></tr> <tr><td>748</td> <td class="normal"> { </td></tr> <tr><td>749</td> <td class="covered"> return $params; </td></tr> <tr><td>750</td> <td class="orange"> } </td></tr> <tr><td>751</td> <td class="normal"> </td></tr> <tr><td>752</td> <td class="normal"> /** </td></tr> <tr><td>753</td> <td class="normal"> * setAliasMap </td></tr> <tr><td>754</td> <td class="normal"> * sets the whole component alias map </td></tr> <tr><td>755</td> <td class="normal"> * </td></tr> <tr><td>756</td> <td class="normal"> * @param array $map alias map </td></tr> <tr><td>757</td> <td class="normal"> * @return Doctrine_Hydrate this object </td></tr> <tr><td>758</td> <td class="normal"> */ </td></tr> <tr><td>759</td> <td class="normal"> public function setAliasMap(array $map) </td></tr> <tr><td>760</td> <td class="normal"> { </td></tr> <tr><td>761</td> <td class="red"> $this->_aliasMap = $map; </td></tr> <tr><td>762</td> <td class="normal"> </td></tr> <tr><td>763</td> <td class="red"> return $this; </td></tr> <tr><td>764</td> <td class="orange"> } </td></tr> <tr><td>765</td> <td class="normal"> </td></tr> <tr><td>766</td> <td class="normal"> /** </td></tr> <tr><td>767</td> <td class="normal"> * getAliasMap </td></tr> <tr><td>768</td> <td class="normal"> * returns the component alias map </td></tr> <tr><td>769</td> <td class="normal"> * </td></tr> <tr><td>770</td> <td class="normal"> * @return array component alias map </td></tr> <tr><td>771</td> <td class="normal"> */ </td></tr> <tr><td>772</td> <td class="normal"> public function getAliasMap() </td></tr> <tr><td>773</td> <td class="normal"> { </td></tr> <tr><td>774</td> <td class="covered"> return $this->_aliasMap; </td></tr> <tr><td>775</td> <td class="orange"> } </td></tr> <tr><td>776</td> <td class="normal"> </td></tr> <tr><td>777</td> <td class="normal"> /** </td></tr> <tr><td>778</td> <td class="normal"> * getCachedForm </td></tr> <tr><td>779</td> <td class="normal"> * returns the cached form of this query for given resultSet </td></tr> <tr><td>780</td> <td class="normal"> * </td></tr> <tr><td>781</td> <td class="normal"> * @param array $resultSet </td></tr> <tr><td>782</td> <td class="normal"> * @return string serialized string representation of this query </td></tr> <tr><td>783</td> <td class="normal"> */ </td></tr> <tr><td>784</td> <td class="normal"> public function getCachedForm(array $resultSet) </td></tr> <tr><td>785</td> <td class="normal"> { </td></tr> <tr><td>786</td> <td class="covered"> $map = ''; </td></tr> <tr><td>787</td> <td class="normal"> </td></tr> <tr><td>788</td> <td class="covered"> foreach ($this->getAliasMap() as $k => $v) { </td></tr> <tr><td>789</td> <td class="covered"> if ( ! isset($v['parent'])) { </td></tr> <tr><td>790</td> <td class="covered"> $map[$k][] = $v['table']->getComponentName(); </td></tr> <tr><td>791</td> <td class="covered"> } else { </td></tr> <tr><td>792</td> <td class="covered"> $map[$k][] = $v['parent'] . '.' . $v['relation']->getAlias(); </td></tr> <tr><td>793</td> <td class="normal"> } </td></tr> <tr><td>794</td> <td class="covered"> if (isset($v['agg'])) { </td></tr> <tr><td>795</td> <td class="red"> $map[$k][] = $v['agg']; </td></tr> <tr><td>796</td> <td class="red"> } </td></tr> <tr><td>797</td> <td class="covered"> } </td></tr> <tr><td>798</td> <td class="normal"> </td></tr> <tr><td>799</td> <td class="covered"> return serialize(array($resultSet, $map, $this->getTableAliases())); </td></tr> <tr><td>800</td> <td class="orange"> } </td></tr> <tr><td>801</td> <td class="normal"> public function _execute($params) </td></tr> <tr><td>802</td> <td class="normal"> { </td></tr> <tr><td>803</td> <td class="covered"> $params = $this->_conn->convertBooleans($params); </td></tr> <tr><td>804</td> <td class="normal"> </td></tr> <tr><td>805</td> <td class="covered"> if ( ! $this->_view) { </td></tr> <tr><td>806</td> <td class="covered"> $query = $this->getQuery($params); </td></tr> <tr><td>807</td> <td class="covered"> } else { </td></tr> <tr><td>808</td> <td class="covered"> $query = $this->_view->getSelectSql(); </td></tr> <tr><td>809</td> <td class="normal"> } </td></tr> <tr><td>810</td> <td class="normal"> </td></tr> <tr><td>811</td> <td class="covered"> $params = $this->convertEnums($params); </td></tr> <tr><td>812</td> <td class="normal"> </td></tr> <tr><td>813</td> <td class="covered"> if ($this->isLimitSubqueryUsed() && </td></tr> <tr><td>814</td> <td class="covered"> $this->_conn->getAttribute(Doctrine::ATTR_DRIVER_NAME) !== 'mysql') { </td></tr> <tr><td>815</td> <td class="normal"> </td></tr> <tr><td>816</td> <td class="covered"> $params = array_merge($params, $params); </td></tr> <tr><td>817</td> <td class="covered"> } </td></tr> <tr><td>818</td> <td class="normal"> </td></tr> <tr><td>819</td> <td class="covered"> if ($this->type !== self::SELECT) { </td></tr> <tr><td>820</td> <td class="covered"> return $this->_conn->exec($query, $params); </td></tr> <tr><td>821</td> <td class="orange"> } </td></tr> <tr><td>822</td> <td class="normal"> </td></tr> <tr><td>823</td> <td class="covered"> $stmt = $this->_conn->execute($query, $params); </td></tr> <tr><td>824</td> <td class="covered"> return $stmt; </td></tr> <tr><td>825</td> <td class="orange"> } </td></tr> <tr><td>826</td> <td class="normal"> </td></tr> <tr><td>827</td> <td class="normal"> /** </td></tr> <tr><td>828</td> <td class="normal"> * execute </td></tr> <tr><td>829</td> <td class="normal"> * executes the query and populates the data set </td></tr> <tr><td>830</td> <td class="normal"> * </td></tr> <tr><td>831</td> <td class="normal"> * @param string $params </td></tr> <tr><td>832</td> <td class="normal"> * @return Doctrine_Collection the root collection </td></tr> <tr><td>833</td> <td class="normal"> */ </td></tr> <tr><td>834</td> <td class="normal"> public function execute($params = array(), $hydrationMode = null) </td></tr> <tr><td>835</td> <td class="normal"> { </td></tr> <tr><td>836</td> <td class="covered"> $params = array_merge($this->_params['set'], </td></tr> <tr><td>837</td> <td class="covered"> $this->_params['where'], </td></tr> <tr><td>838</td> <td class="covered"> $this->_params['having'], </td></tr> <tr><td>839</td> <td class="covered"> $params); </td></tr> <tr><td>840</td> <td class="covered"> if ($this->_cache) { </td></tr> <tr><td>841</td> <td class="covered"> $cacheDriver = $this->getCacheDriver(); </td></tr> <tr><td>842</td> <td class="normal"> </td></tr> <tr><td>843</td> <td class="covered"> $dql = $this->getDql(); </td></tr> <tr><td>844</td> <td class="normal"> // calculate hash for dql query </td></tr> <tr><td>845</td> <td class="covered"> $hash = md5($dql . var_export($params, true)); </td></tr> <tr><td>846</td> <td class="normal"> </td></tr> <tr><td>847</td> <td class="covered"> $cached = ($this->_expireCache) ? false : $cacheDriver->fetch($hash); </td></tr> <tr><td>848</td> <td class="normal"> </td></tr> <tr><td>849</td> <td class="normal"> </td></tr> <tr><td>850</td> <td class="covered"> if ($cached === false) { </td></tr> <tr><td>851</td> <td class="normal"> // cache miss </td></tr> <tr><td>852</td> <td class="covered"> $stmt = $this->_execute($params); </td></tr> <tr><td>853</td> <td class="covered"> $array = $this->parseData2($stmt, Doctrine::HYDRATE_ARRAY); </td></tr> <tr><td>854</td> <td class="normal"> </td></tr> <tr><td>855</td> <td class="covered"> $cached = $this->getCachedForm($array); </td></tr> <tr><td>856</td> <td class="normal"> </td></tr> <tr><td>857</td> <td class="covered"> $cacheDriver->save($hash, $cached, $this->_timeToLive); </td></tr> <tr><td>858</td> <td class="covered"> } else { </td></tr> <tr><td>859</td> <td class="covered"> $cached = unserialize($cached); </td></tr> <tr><td>860</td> <td class="covered"> $this->_tableAliases = $cached[2]; </td></tr> <tr><td>861</td> <td class="covered"> $array = $cached[0]; </td></tr> <tr><td>862</td> <td class="normal"> </td></tr> <tr><td>863</td> <td class="covered"> $map = array(); </td></tr> <tr><td>864</td> <td class="covered"> foreach ($cached[1] as $k => $v) { </td></tr> <tr><td>865</td> <td class="covered"> $e = explode('.', $v[0]); </td></tr> <tr><td>866</td> <td class="covered"> if (count($e) === 1) { </td></tr> <tr><td>867</td> <td class="covered"> $map[$k]['table'] = $this->_conn->getTable($e[0]); </td></tr> <tr><td>868</td> <td class="covered"> } else { </td></tr> <tr><td>869</td> <td class="covered"> $map[$k]['parent'] = $e[0]; </td></tr> <tr><td>870</td> <td class="covered"> $map[$k]['relation'] = $map[$e[0]]['table']->getRelation($e[1]); </td></tr> <tr><td>871</td> <td class="covered"> $map[$k]['table'] = $map[$k]['relation']->getTable(); </td></tr> <tr><td>872</td> <td class="normal"> } </td></tr> <tr><td>873</td> <td class="covered"> if (isset($v[1])) { </td></tr> <tr><td>874</td> <td class="red"> $map[$k]['agg'] = $v[1]; </td></tr> <tr><td>875</td> <td class="red"> } </td></tr> <tr><td>876</td> <td class="covered"> } </td></tr> <tr><td>877</td> <td class="covered"> $this->_aliasMap = $map; </td></tr> <tr><td>878</td> <td class="normal"> } </td></tr> <tr><td>879</td> <td class="covered"> } else { </td></tr> <tr><td>880</td> <td class="covered"> $stmt = $this->_execute($params); </td></tr> <tr><td>881</td> <td class="normal"> </td></tr> <tr><td>882</td> <td class="covered"> if (is_integer($stmt)) { </td></tr> <tr><td>883</td> <td class="covered"> return $stmt; </td></tr> <tr><td>884</td> <td class="orange"> } </td></tr> <tr><td>885</td> <td class="normal"> </td></tr> <tr><td>886</td> <td class="covered"> $array = $this->parseData2($stmt, $hydrationMode); </td></tr> <tr><td>887</td> <td class="normal"> } </td></tr> <tr><td>888</td> <td class="covered"> return $array; </td></tr> <tr><td>889</td> <td class="orange"> } </td></tr> <tr><td>890</td> <td class="normal"> </td></tr> <tr><td>891</td> <td class="normal"> /** </td></tr> <tr><td>892</td> <td class="normal"> * getType </td></tr> <tr><td>893</td> <td class="normal"> * </td></tr> <tr><td>894</td> <td class="normal"> * returns the type of this query object </td></tr> <tr><td>895</td> <td class="normal"> * by default the type is Doctrine_Hydrate::SELECT but if update() or delete() </td></tr> <tr><td>896</td> <td class="normal"> * are being called the type is Doctrine_Hydrate::UPDATE and Doctrine_Hydrate::DELETE, </td></tr> <tr><td>897</td> <td class="normal"> * respectively </td></tr> <tr><td>898</td> <td class="normal"> * </td></tr> <tr><td>899</td> <td class="normal"> * @see Doctrine_Hydrate::SELECT </td></tr> <tr><td>900</td> <td class="normal"> * @see Doctrine_Hydrate::UPDATE </td></tr> <tr><td>901</td> <td class="normal"> * @see Doctrine_Hydrate::DELETE </td></tr> <tr><td>902</td> <td class="normal"> * </td></tr> <tr><td>903</td> <td class="normal"> * @return integer return the query type </td></tr> <tr><td>904</td> <td class="normal"> */ </td></tr> <tr><td>905</td> <td class="normal"> public function getType() </td></tr> <tr><td>906</td> <td class="normal"> { </td></tr> <tr><td>907</td> <td class="covered"> return $this->type; </td></tr> <tr><td>908</td> <td class="orange"> } </td></tr> <tr><td>909</td> <td class="normal"> </td></tr> <tr><td>910</td> <td class="normal"> /** </td></tr> <tr><td>911</td> <td class="normal"> * applyInheritance </td></tr> <tr><td>912</td> <td class="normal"> * applies column aggregation inheritance to DQL / SQL query </td></tr> <tr><td>913</td> <td class="normal"> * </td></tr> <tr><td>914</td> <td class="normal"> * @return string </td></tr> <tr><td>915</td> <td class="normal"> */ </td></tr> <tr><td>916</td> <td class="normal"> public function applyInheritance() </td></tr> <tr><td>917</td> <td class="normal"> { </td></tr> <tr><td>918</td> <td class="normal"> // get the inheritance maps </td></tr> <tr><td>919</td> <td class="covered"> $array = array(); </td></tr> <tr><td>920</td> <td class="normal"> </td></tr> <tr><td>921</td> <td class="covered"> foreach ($this->_aliasMap as $componentAlias => $data) { </td></tr> <tr><td>922</td> <td class="covered"> $tableAlias = $this->getTableAlias($componentAlias); </td></tr> <tr><td>923</td> <td class="covered"> $array[$tableAlias][] = $data['table']->inheritanceMap; </td></tr> <tr><td>924</td> <td class="covered"> } </td></tr> <tr><td>925</td> <td class="normal"> </td></tr> <tr><td>926</td> <td class="normal"> // apply inheritance maps </td></tr> <tr><td>927</td> <td class="covered"> $str = ''; </td></tr> <tr><td>928</td> <td class="covered"> $c = array(); </td></tr> <tr><td>929</td> <td class="normal"> </td></tr> <tr><td>930</td> <td class="covered"> $index = 0; </td></tr> <tr><td>931</td> <td class="covered"> foreach ($array as $tableAlias => $maps) { </td></tr> <tr><td>932</td> <td class="covered"> $a = array(); </td></tr> <tr><td>933</td> <td class="normal"> </td></tr> <tr><td>934</td> <td class="normal"> // don't use table aliases if the query isn't a select query </td></tr> <tr><td>935</td> <td class="covered"> if ($this->type !== Doctrine_Query::SELECT) { </td></tr> <tr><td>936</td> <td class="covered"> $tableAlias = ''; </td></tr> <tr><td>937</td> <td class="covered"> } else { </td></tr> <tr><td>938</td> <td class="covered"> $tableAlias .= '.'; </td></tr> <tr><td>939</td> <td class="normal"> } </td></tr> <tr><td>940</td> <td class="normal"> </td></tr> <tr><td>941</td> <td class="covered"> foreach ($maps as $map) { </td></tr> <tr><td>942</td> <td class="covered"> $b = array(); </td></tr> <tr><td>943</td> <td class="covered"> foreach ($map as $field => $value) { </td></tr> <tr><td>944</td> <td class="covered"> $identifier = $this->_conn->quoteIdentifier($tableAlias . $field); </td></tr> <tr><td>945</td> <td class="normal"> </td></tr> <tr><td>946</td> <td class="covered"> if ($index > 0) { </td></tr> <tr><td>947</td> <td class="covered"> $b[] = '(' . $identifier . ' = ' . $this->_conn->quote($value) </td></tr> <tr><td>948</td> <td class="covered"> . ' OR ' . $identifier . ' IS NULL)'; </td></tr> <tr><td>949</td> <td class="covered"> } else { </td></tr> <tr><td>950</td> <td class="covered"> $b[] = $identifier . ' = ' . $this->_conn->quote($value); </td></tr> <tr><td>951</td> <td class="normal"> } </td></tr> <tr><td>952</td> <td class="covered"> } </td></tr> <tr><td>953</td> <td class="normal"> </td></tr> <tr><td>954</td> <td class="covered"> if ( ! empty($b)) { </td></tr> <tr><td>955</td> <td class="covered"> $a[] = implode(' AND ', $b); </td></tr> <tr><td>956</td> <td class="covered"> } </td></tr> <tr><td>957</td> <td class="covered"> } </td></tr> <tr><td>958</td> <td class="normal"> </td></tr> <tr><td>959</td> <td class="covered"> if ( ! empty($a)) { </td></tr> <tr><td>960</td> <td class="covered"> $c[] = implode(' AND ', $a); </td></tr> <tr><td>961</td> <td class="covered"> } </td></tr> <tr><td>962</td> <td class="covered"> $index++; </td></tr> <tr><td>963</td> <td class="covered"> } </td></tr> <tr><td>964</td> <td class="normal"> </td></tr> <tr><td>965</td> <td class="covered"> $str .= implode(' AND ', $c); </td></tr> <tr><td>966</td> <td class="normal"> </td></tr> <tr><td>967</td> <td class="covered"> return $str; </td></tr> <tr><td>968</td> <td class="orange"> } </td></tr> <tr><td>969</td> <td class="normal"> </td></tr> <tr><td>970</td> <td class="normal"> /** </td></tr> <tr><td>971</td> <td class="normal"> * fetchArray </td></tr> <tr><td>972</td> <td class="normal"> * Convenience method to execute using array fetching as hydration mode. </td></tr> <tr><td>973</td> <td class="normal"> * </td></tr> <tr><td>974</td> <td class="normal"> * @param string $params </td></tr> <tr><td>975</td> <td class="normal"> * @return array </td></tr> <tr><td>976</td> <td class="normal"> */ </td></tr> <tr><td>977</td> <td class="normal"> public function fetchArray($params = array()) { </td></tr> <tr><td>978</td> <td class="covered"> return $this->execute($params, Doctrine::HYDRATE_ARRAY); </td></tr> <tr><td>979</td> <td class="orange"> } </td></tr> <tr><td>980</td> <td class="normal"> </td></tr> <tr><td>981</td> <td class="normal"> /** </td></tr> <tr><td>982</td> <td class="normal"> * fetchOne </td></tr> <tr><td>983</td> <td class="normal"> * Convenience method to execute the query and return the first item </td></tr> <tr><td>984</td> <td class="normal"> * of the collection. </td></tr> <tr><td>985</td> <td class="normal"> * </td></tr> <tr><td>986</td> <td class="normal"> * @param string $params Parameters </td></tr> <tr><td>987</td> <td class="normal"> * @param int $hydrationMode Hydration mode </td></tr> <tr><td>988</td> <td class="normal"> * @return mixed Array or Doctrine_Collection or false if no result. </td></tr> <tr><td>989</td> <td class="normal"> */ </td></tr> <tr><td>990</td> <td class="normal"> public function fetchOne($params = array(), $hydrationMode = null) </td></tr> <tr><td>991</td> <td class="normal"> { </td></tr> <tr><td>992</td> <td class="covered"> if (is_null($hydrationMode)) { </td></tr> <tr><td>993</td> <td class="covered"> $hydrationMode = $this->_hydrationMode; </td></tr> <tr><td>994</td> <td class="covered"> } </td></tr> <tr><td>995</td> <td class="normal"> </td></tr> <tr><td>996</td> <td class="covered"> $collection = $this->execute($params, $hydrationMode); </td></tr> <tr><td>997</td> <td class="normal"> </td></tr> <tr><td>998</td> <td class="covered"> if (count($collection) === 0) { </td></tr> <tr><td>999</td> <td class="covered"> return false; </td></tr> <tr><td>1000</td> <td class="orange"> } </td></tr> <tr><td>1001</td> <td class="normal"> </td></tr> <tr><td>1002</td> <td class="normal"> switch ($hydrationMode) { </td></tr> <tr><td>1003</td> <td class="covered"> case Doctrine::HYDRATE_RECORD: </td></tr> <tr><td>1004</td> <td class="covered"> return $collection->getFirst(); </td></tr> <tr><td>1005</td> <td class="covered"> case Doctrine::HYDRATE_ARRAY: </td></tr> <tr><td>1006</td> <td class="covered"> return array_shift($collection); </td></tr> <tr><td>1007</td> <td class="orange"> } </td></tr> <tr><td>1008</td> <td class="normal"> </td></tr> <tr><td>1009</td> <td class="red"> return false; </td></tr> <tr><td>1010</td> <td class="orange"> } </td></tr> <tr><td>1011</td> <td class="normal"> </td></tr> <tr><td>1012</td> <td class="normal"> /** </td></tr> <tr><td>1013</td> <td class="normal"> * parseData </td></tr> <tr><td>1014</td> <td class="normal"> * parses the data returned by statement object </td></tr> <tr><td>1015</td> <td class="normal"> * </td></tr> <tr><td>1016</td> <td class="normal"> * This is method defines the core of Doctrine object population algorithm </td></tr> <tr><td>1017</td> <td class="normal"> * hence this method strives to be as fast as possible </td></tr> <tr><td>1018</td> <td class="normal"> * </td></tr> <tr><td>1019</td> <td class="normal"> * The key idea is the loop over the rowset only once doing all the needed operations </td></tr> <tr><td>1020</td> <td class="normal"> * within this massive loop. </td></tr> <tr><td>1021</td> <td class="normal"> * </td></tr> <tr><td>1022</td> <td class="normal"> * @param mixed $stmt </td></tr> <tr><td>1023</td> <td class="normal"> * @return array </td></tr> <tr><td>1024</td> <td class="normal"> */ </td></tr> <tr><td>1025</td> <td class="normal"> public function parseData2($stmt, $hydrationMode) </td></tr> <tr><td>1026</td> <td class="normal"> { </td></tr> <tr><td>1027</td> <td class="normal"> </td></tr> <tr><td>1028</td> <td class="covered"> $cache = array(); </td></tr> <tr><td>1029</td> <td class="covered"> $rootMap = reset($this->_aliasMap); </td></tr> <tr><td>1030</td> <td class="covered"> $rootAlias = key($this->_aliasMap); </td></tr> <tr><td>1031</td> <td class="covered"> $componentName = $rootMap['table']->getComponentName(); </td></tr> <tr><td>1032</td> <td class="covered"> $isSimpleQuery = count($this->_aliasMap) <= 1; </td></tr> <tr><td>1033</td> <td class="normal"> </td></tr> <tr><td>1034</td> <td class="covered"> if ($hydrationMode === null) { </td></tr> <tr><td>1035</td> <td class="covered"> $hydrationMode = $this->_hydrationMode; </td></tr> <tr><td>1036</td> <td class="covered"> } </td></tr> <tr><td>1037</td> <td class="normal"> </td></tr> <tr><td>1038</td> <td class="covered"> if ($hydrationMode === Doctrine::HYDRATE_ARRAY) { </td></tr> <tr><td>1039</td> <td class="covered"> $driver = new Doctrine_Hydrate_Array(); </td></tr> <tr><td>1040</td> <td class="covered"> } else { </td></tr> <tr><td>1041</td> <td class="covered"> $driver = new Doctrine_Hydrate_Record(); </td></tr> <tr><td>1042</td> <td class="normal"> } </td></tr> <tr><td>1043</td> <td class="normal"> </td></tr> <tr><td>1044</td> <td class="covered"> $array = $driver->getElementCollection($componentName); </td></tr> <tr><td>1045</td> <td class="normal"> </td></tr> <tr><td>1046</td> <td class="covered"> if ($stmt === false || $stmt === 0) { </td></tr> <tr><td>1047</td> <td class="red"> return $array; </td></tr> <tr><td>1048</td> <td class="orange"> } </td></tr> <tr><td>1049</td> <td class="normal"> </td></tr> <tr><td>1050</td> <td class="covered"> $event = new Doctrine_Event(Doctrine_Event::HYDRATE, null); </td></tr> <tr><td>1051</td> <td class="normal"> </td></tr> <tr><td>1052</td> <td class="normal"> // for every getRecordListener() there is a little bit </td></tr> <tr><td>1053</td> <td class="normal"> // logic behind it, hence calling it multiple times on </td></tr> <tr><td>1054</td> <td class="normal"> // large result sets can be quite expensive. </td></tr> <tr><td>1055</td> <td class="normal"> // So for efficiency we use little listener caching here </td></tr> <tr><td>1056</td> <td class="covered"> foreach ($this->_aliasMap as $alias => $data) { </td></tr> <tr><td>1057</td> <td class="covered"> $componentName = $data['table']->getComponentName(); </td></tr> <tr><td>1058</td> <td class="covered"> $listeners[$componentName] = $data['table']->getRecordListener(); </td></tr> <tr><td>1059</td> <td class="covered"> } </td></tr> <tr><td>1060</td> <td class="normal"> </td></tr> <tr><td>1061</td> <td class="covered"> while ($data = $stmt->fetch(Doctrine::FETCH_ASSOC)) { </td></tr> <tr><td>1062</td> <td class="covered"> $currData = array(); </td></tr> <tr><td>1063</td> <td class="covered"> $identifiable = array(); </td></tr> <tr><td>1064</td> <td class="normal"> </td></tr> <tr><td>1065</td> <td class="covered"> foreach ($data as $key => $value) { </td></tr> <tr><td>1066</td> <td class="normal"> </td></tr> <tr><td>1067</td> <td class="normal"> // The following little cache solution ensures that field aliases are </td></tr> <tr><td>1068</td> <td class="normal"> // parsed only once. This increases speed on large result sets by an order </td></tr> <tr><td>1069</td> <td class="normal"> // of magnitude. </td></tr> <tr><td>1070</td> <td class="covered"> if ( ! isset($cache[$key])) { </td></tr> <tr><td>1071</td> <td class="covered"> $e = explode('__', $key); </td></tr> <tr><td>1072</td> <td class="covered"> $cache[$key]['field'] = $field = strtolower(array_pop($e)); </td></tr> <tr><td>1073</td> <td class="covered"> $cache[$key]['alias'] = $this->_tableAliases[strtolower(implode('__', $e))]; </td></tr> <tr><td>1074</td> <td class="covered"> } </td></tr> <tr><td>1075</td> <td class="normal"> </td></tr> <tr><td>1076</td> <td class="normal"> </td></tr> <tr><td>1077</td> <td class="covered"> $map = $this->_aliasMap[$cache[$key]['alias']]; </td></tr> <tr><td>1078</td> <td class="covered"> $table = $map['table']; </td></tr> <tr><td>1079</td> <td class="covered"> $alias = $cache[$key]['alias']; </td></tr> <tr><td>1080</td> <td class="covered"> $field = $cache[$key]['field']; </td></tr> <tr><td>1081</td> <td class="normal"> </td></tr> <tr><td>1082</td> <td class="covered"> if (isset($this->_aliasMap[$alias]['agg'][$field])) { </td></tr> <tr><td>1083</td> <td class="covered"> $field = $this->_aliasMap[$alias]['agg'][$field]; </td></tr> <tr><td>1084</td> <td class="covered"> } </td></tr> <tr><td>1085</td> <td class="normal"> </td></tr> <tr><td>1086</td> <td class="normal"> </td></tr> <tr><td>1087</td> <td class="covered"> if ( ! isset($currData[$alias])) { </td></tr> <tr><td>1088</td> <td class="covered"> $currData[$alias] = array(); </td></tr> <tr><td>1089</td> <td class="covered"> } </td></tr> <tr><td>1090</td> <td class="normal"> </td></tr> <tr><td>1091</td> <td class="covered"> if ( ! isset($prev[$alias])) { </td></tr> <tr><td>1092</td> <td class="covered"> $prev[$alias] = array(); </td></tr> <tr><td>1093</td> <td class="covered"> } </td></tr> <tr><td>1094</td> <td class="normal"> </td></tr> <tr><td>1095</td> <td class="covered"> $currData[$alias][$field] = $table->prepareValue($field, $value); </td></tr> <tr><td>1096</td> <td class="covered"> if ($value !== null) { </td></tr> <tr><td>1097</td> <td class="covered"> $identifiable[$alias] = true; </td></tr> <tr><td>1098</td> <td class="covered"> } </td></tr> <tr><td>1099</td> <td class="covered"> } </td></tr> <tr><td>1100</td> <td class="normal"> </td></tr> <tr><td>1101</td> <td class="normal"> </td></tr> <tr><td>1102</td> <td class="normal"> // dealing with root component </td></tr> <tr><td>1103</td> <td class="covered"> $table = $this->_aliasMap[$rootAlias]['table']; </td></tr> <tr><td>1104</td> <td class="covered"> $componentName = $table->getComponentName(); </td></tr> <tr><td>1105</td> <td class="covered"> $event->set('data', $currData[$rootAlias]); </td></tr> <tr><td>1106</td> <td class="covered"> $listeners[$componentName]->preHydrate($event); </td></tr> <tr><td>1107</td> <td class="covered"> $element = $driver->getElement($currData[$rootAlias], $componentName); </td></tr> <tr><td>1108</td> <td class="normal"> </td></tr> <tr><td>1109</td> <td class="covered"> $oneToOne = false; </td></tr> <tr><td>1110</td> <td class="normal"> </td></tr> <tr><td>1111</td> <td class="covered"> $index = $isSimpleQuery ? false : $driver->search($element, $array); </td></tr> <tr><td>1112</td> <td class="normal"> </td></tr> <tr><td>1113</td> <td class="covered"> if ($index === false) { </td></tr> <tr><td>1114</td> <td class="covered"> $event->set('data', $element); </td></tr> <tr><td>1115</td> <td class="covered"> $listeners[$componentName]->postHydrate($event); </td></tr> <tr><td>1116</td> <td class="normal"> </td></tr> <tr><td>1117</td> <td class="covered"> if (isset($this->_aliasMap[$rootAlias]['map'])) { </td></tr> <tr><td>1118</td> <td class="covered"> $key = $this->_aliasMap[$rootAlias]['map']; </td></tr> <tr><td>1119</td> <td class="normal"> </td></tr> <tr><td>1120</td> <td class="covered"> if (isset($array[$key])) { </td></tr> <tr><td>1121</td> <td class="red"> throw new Doctrine_Hydrate_Exception("Couldn't hydrate. Found non-unique key mapping."); </td></tr> <tr><td>1122</td> <td class="orange"> } </td></tr> <tr><td>1123</td> <td class="normal"> </td></tr> <tr><td>1124</td> <td class="covered"> if ( ! isset($element[$key])) { </td></tr> <tr><td>1125</td> <td class="red"> throw new Doctrine_Hydrate_Exception("Couldn't hydrate. Found a non-existent key."); </td></tr> <tr><td>1126</td> <td class="orange"> } </td></tr> <tr><td>1127</td> <td class="normal"> </td></tr> <tr><td>1128</td> <td class="covered"> $array[$element[$key]] = $element; </td></tr> <tr><td>1129</td> <td class="covered"> } else { </td></tr> <tr><td>1130</td> <td class="covered"> $array[] = $element; </td></tr> <tr><td>1131</td> <td class="normal"> } </td></tr> <tr><td>1132</td> <td class="covered"> } </td></tr> <tr><td>1133</td> <td class="covered"> $this->_setLastElement($prev, $array, $index, $rootAlias, $oneToOne); </td></tr> <tr><td>1134</td> <td class="covered"> unset($currData[$rootAlias]); </td></tr> <tr><td>1135</td> <td class="normal"> </td></tr> <tr><td>1136</td> <td class="covered"> foreach ($currData as $alias => $data) { </td></tr> <tr><td>1137</td> <td class="covered"> $index = false; </td></tr> <tr><td>1138</td> <td class="covered"> $map = $this->_aliasMap[$alias]; </td></tr> <tr><td>1139</td> <td class="covered"> $table = $this->_aliasMap[$alias]['table']; </td></tr> <tr><td>1140</td> <td class="covered"> $componentName = $table->getComponentName(); </td></tr> <tr><td>1141</td> <td class="covered"> $event->set('data', $data); </td></tr> <tr><td>1142</td> <td class="covered"> $listeners[$componentName]->preHydrate($event); </td></tr> <tr><td>1143</td> <td class="normal"> </td></tr> <tr><td>1144</td> <td class="covered"> $element = $driver->getElement($data, $componentName); </td></tr> <tr><td>1145</td> <td class="normal"> </td></tr> <tr><td>1146</td> <td class="covered"> $parent = $map['parent']; </td></tr> <tr><td>1147</td> <td class="covered"> $relation = $map['relation']; </td></tr> <tr><td>1148</td> <td class="covered"> $componentAlias = $map['relation']->getAlias(); </td></tr> <tr><td>1149</td> <td class="normal"> </td></tr> <tr><td>1150</td> <td class="covered"> if ( ! isset($prev[$parent])) { </td></tr> <tr><td>1151</td> <td class="covered"> break; </td></tr> <tr><td>1152</td> <td class="orange"> } </td></tr> <tr><td>1153</td> <td class="normal"> </td></tr> <tr><td>1154</td> <td class="normal"> // check the type of the relation </td></tr> <tr><td>1155</td> <td class="covered"> if ( ! $relation->isOneToOne()) { </td></tr> <tr><td>1156</td> <td class="normal"> // initialize the collection </td></tr> <tr><td>1157</td> <td class="normal"> </td></tr> <tr><td>1158</td> <td class="covered"> if ($driver->initRelated($prev[$parent], $componentAlias)) { </td></tr> <tr><td>1159</td> <td class="normal"> </td></tr> <tr><td>1160</td> <td class="normal"> // append element </td></tr> <tr><td>1161</td> <td class="covered"> if (isset($identifiable[$alias])) { </td></tr> <tr><td>1162</td> <td class="covered"> $index = $isSimpleQuery ? false : $driver->search($element, $prev[$parent][$componentAlias]); </td></tr> <tr><td>1163</td> <td class="normal"> </td></tr> <tr><td>1164</td> <td class="covered"> if ($index === false) { </td></tr> <tr><td>1165</td> <td class="covered"> $event->set('data', $element); </td></tr> <tr><td>1166</td> <td class="covered"> $listeners[$componentName]->postHydrate($event); </td></tr> <tr><td>1167</td> <td class="normal"> </td></tr> <tr><td>1168</td> <td class="covered"> if (isset($map['map'])) { </td></tr> <tr><td>1169</td> <td class="covered"> $key = $map['map']; </td></tr> <tr><td>1170</td> <td class="covered"> if (isset($prev[$parent][$componentAlias][$key])) { </td></tr> <tr><td>1171</td> <td class="red"> throw new Doctrine_Hydrate_Exception("Couldn't hydrate. Found non-unique key mapping."); </td></tr> <tr><td>1172</td> <td class="orange"> } </td></tr> <tr><td>1173</td> <td class="covered"> if ( ! isset($element[$key])) { </td></tr> <tr><td>1174</td> <td class="red"> throw new Doctrine_Hydrate_Exception("Couldn't hydrate. Found a non-existent key."); </td></tr> <tr><td>1175</td> <td class="orange"> } </td></tr> <tr><td>1176</td> <td class="covered"> $prev[$parent][$componentAlias][$element[$key]] = $element; </td></tr> <tr><td>1177</td> <td class="covered"> } else { </td></tr> <tr><td>1178</td> <td class="covered"> $prev[$parent][$componentAlias][] = $element; </td></tr> <tr><td>1179</td> <td class="normal"> } </td></tr> <tr><td>1180</td> <td class="covered"> } </td></tr> <tr><td>1181</td> <td class="covered"> } </td></tr> <tr><td>1182</td> <td class="normal"> // register collection for later snapshots </td></tr> <tr><td>1183</td> <td class="covered"> $driver->registerCollection($prev[$parent][$componentAlias]); </td></tr> <tr><td>1184</td> <td class="covered"> } </td></tr> <tr><td>1185</td> <td class="covered"> } else { </td></tr> <tr><td>1186</td> <td class="covered"> if ( ! isset($identifiable[$alias])) { </td></tr> <tr><td>1187</td> <td class="covered"> $prev[$parent][$componentAlias] = $driver->getNullPointer(); </td></tr> <tr><td>1188</td> <td class="covered"> } else { </td></tr> <tr><td>1189</td> <td class="covered"> $prev[$parent][$componentAlias] = $element; </td></tr> <tr><td>1190</td> <td class="normal"> } </td></tr> <tr><td>1191</td> <td class="covered"> $oneToOne = true; </td></tr> <tr><td>1192</td> <td class="normal"> } </td></tr> <tr><td>1193</td> <td class="covered"> $coll =& $prev[$parent][$componentAlias]; </td></tr> <tr><td>1194</td> <td class="covered"> $this->_setLastElement($prev, $coll, $index, $alias, $oneToOne); </td></tr> <tr><td>1195</td> <td class="covered"> } </td></tr> <tr><td>1196</td> <td class="covered"> } </td></tr> <tr><td>1197</td> <td class="normal"> </td></tr> <tr><td>1198</td> <td class="covered"> $driver->flush(); </td></tr> <tr><td>1199</td> <td class="normal"> </td></tr> <tr><td>1200</td> <td class="covered"> $stmt->closeCursor(); </td></tr> <tr><td>1201</td> <td class="covered"> return $array; </td></tr> <tr><td>1202</td> <td class="orange"> } </td></tr> <tr><td>1203</td> <td class="normal"> </td></tr> <tr><td>1204</td> <td class="normal"> /** </td></tr> <tr><td>1205</td> <td class="normal"> * _setLastElement </td></tr> <tr><td>1206</td> <td class="normal"> * </td></tr> <tr><td>1207</td> <td class="normal"> * sets the last element of given data array / collection </td></tr> <tr><td>1208</td> <td class="normal"> * as previous element </td></tr> <tr><td>1209</td> <td class="normal"> * </td></tr> <tr><td>1210</td> <td class="normal"> * @param boolean|integer $index </td></tr> <tr><td>1211</td> <td class="normal"> * @return void </td></tr> <tr><td>1212</td> <td class="normal"> */ </td></tr> <tr><td>1213</td> <td class="normal"> public function _setLastElement(&$prev, &$coll, $index, $alias, $oneToOne) </td></tr> <tr><td>1214</td> <td class="normal"> { </td></tr> <tr><td>1215</td> <td class="covered"> if ($coll === self::$_null) { </td></tr> <tr><td>1216</td> <td class="covered"> return false; </td></tr> <tr><td>1217</td> <td class="orange"> } </td></tr> <tr><td>1218</td> <td class="covered"> if ($index !== false) { </td></tr> <tr><td>1219</td> <td class="covered"> $prev[$alias] =& $coll[$index]; </td></tr> <tr><td>1220</td> <td class="covered"> } else { </td></tr> <tr><td>1221</td> <td class="normal"> // first check the count (we do not want to get the last element </td></tr> <tr><td>1222</td> <td class="normal"> // of an empty collection/array) </td></tr> <tr><td>1223</td> <td class="covered"> if (count($coll) > 0) { </td></tr> <tr><td>1224</td> <td class="covered"> if (is_array($coll)) { </td></tr> <tr><td>1225</td> <td class="covered"> if ($oneToOne) { </td></tr> <tr><td>1226</td> <td class="covered"> $prev[$alias] =& $coll; </td></tr> <tr><td>1227</td> <td class="covered"> } else { </td></tr> <tr><td>1228</td> <td class="covered"> end($coll); </td></tr> <tr><td>1229</td> <td class="covered"> $prev[$alias] =& $coll[key($coll)]; </td></tr> <tr><td>1230</td> <td class="normal"> } </td></tr> <tr><td>1231</td> <td class="covered"> } else { </td></tr> <tr><td>1232</td> <td class="covered"> $prev[$alias] = $coll->getLast(); </td></tr> <tr><td>1233</td> <td class="normal"> } </td></tr> <tr><td>1234</td> <td class="covered"> } else { </td></tr> <tr><td>1235</td> <td class="covered"> if (isset($prev[$alias])) { </td></tr> <tr><td>1236</td> <td class="covered"> unset($prev[$alias]); </td></tr> <tr><td>1237</td> <td class="covered"> } </td></tr> <tr><td>1238</td> <td class="normal"> } </td></tr> <tr><td>1239</td> <td class="normal"> } </td></tr> <tr><td>1240</td> <td class="covered"> } </td></tr> <tr><td>1241</td> <td class="normal"> </td></tr> <tr><td>1242</td> <td class="normal"> /** </td></tr> <tr><td>1243</td> <td class="normal"> * @return string returns a string representation of this object </td></tr> <tr><td>1244</td> <td class="normal"> */ </td></tr> <tr><td>1245</td> <td class="normal"> public function __toString() </td></tr> <tr><td>1246</td> <td class="normal"> { </td></tr> <tr><td>1247</td> <td class="red"> return Doctrine_Lib::formatSql($this->getQuery()); </td></tr> <tr><td>1248</td> <td class="orange"> } </td></tr> <tr><td>1249</td> <td class="normal">} </td></tr> </table></body></html>