<html> <head> <title>Coverage for Doctrine_Table</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Table</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: Table.php 3206 2007-11-22 22:02:35Z 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="normal"> </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Table represents a database table </td></tr> <tr><td>24</td> <td class="normal"> * each Doctrine_Table holds the information of foreignKeys and associations </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"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>28</td> <td class="normal"> * @package Doctrine </td></tr> <tr><td>29</td> <td class="normal"> * @subpackage Table </td></tr> <tr><td>30</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>31</td> <td class="normal"> * @version $Revision: 3206 $ </td></tr> <tr><td>32</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>33</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>34</td> <td class="normal"> */ </td></tr> <tr><td>35</td> <td class="normal">class Doctrine_Table extends Doctrine_Configurable implements Countable </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"> * @var array $data temporary data which is then loaded into Doctrine_Record::$_data </td></tr> <tr><td>39</td> <td class="normal"> */ </td></tr> <tr><td>40</td> <td class="normal"> protected $_data = array(); </td></tr> <tr><td>41</td> <td class="normal"> </td></tr> <tr><td>42</td> <td class="normal"> /** </td></tr> <tr><td>43</td> <td class="normal"> * @var mixed $identifier The field names of all fields that are part of the identifier/primary key </td></tr> <tr><td>44</td> <td class="normal"> */ </td></tr> <tr><td>45</td> <td class="normal"> protected $_identifier = array(); </td></tr> <tr><td>46</td> <td class="normal"> </td></tr> <tr><td>47</td> <td class="normal"> /** </td></tr> <tr><td>48</td> <td class="normal"> * @see Doctrine_Identifier constants </td></tr> <tr><td>49</td> <td class="normal"> * @var integer $identifierType the type of identifier this table uses </td></tr> <tr><td>50</td> <td class="normal"> */ </td></tr> <tr><td>51</td> <td class="normal"> protected $_identifierType; </td></tr> <tr><td>52</td> <td class="normal"> </td></tr> <tr><td>53</td> <td class="normal"> /** </td></tr> <tr><td>54</td> <td class="normal"> * @var Doctrine_Connection $conn Doctrine_Connection object that created this table </td></tr> <tr><td>55</td> <td class="normal"> */ </td></tr> <tr><td>56</td> <td class="normal"> protected $_conn; </td></tr> <tr><td>57</td> <td class="normal"> </td></tr> <tr><td>58</td> <td class="normal"> /** </td></tr> <tr><td>59</td> <td class="normal"> * @var array $identityMap first level cache </td></tr> <tr><td>60</td> <td class="normal"> */ </td></tr> <tr><td>61</td> <td class="normal"> protected $_identityMap = array(); </td></tr> <tr><td>62</td> <td class="normal"> </td></tr> <tr><td>63</td> <td class="normal"> /** </td></tr> <tr><td>64</td> <td class="normal"> * @var Doctrine_Table_Repository $repository record repository </td></tr> <tr><td>65</td> <td class="normal"> */ </td></tr> <tr><td>66</td> <td class="normal"> protected $_repository; </td></tr> <tr><td>67</td> <td class="normal"> </td></tr> <tr><td>68</td> <td class="normal"> /** </td></tr> <tr><td>69</td> <td class="normal"> * @var array $columns an array of column definitions, </td></tr> <tr><td>70</td> <td class="normal"> * keys are column names and values are column definitions </td></tr> <tr><td>71</td> <td class="normal"> * </td></tr> <tr><td>72</td> <td class="normal"> * the definition array has atleast the following values: </td></tr> <tr><td>73</td> <td class="normal"> * </td></tr> <tr><td>74</td> <td class="normal"> * -- type the column type, eg. 'integer' </td></tr> <tr><td>75</td> <td class="normal"> * -- length the column length, eg. 11 </td></tr> <tr><td>76</td> <td class="normal"> * </td></tr> <tr><td>77</td> <td class="normal"> * additional keys: </td></tr> <tr><td>78</td> <td class="normal"> * -- notnull whether or not the column is marked as notnull </td></tr> <tr><td>79</td> <td class="normal"> * -- values enum values </td></tr> <tr><td>80</td> <td class="normal"> * -- notblank notblank validator + notnull constraint </td></tr> <tr><td>81</td> <td class="normal"> * ... many more </td></tr> <tr><td>82</td> <td class="normal"> */ </td></tr> <tr><td>83</td> <td class="normal"> protected $_columns = array(); </td></tr> <tr><td>84</td> <td class="normal"> </td></tr> <tr><td>85</td> <td class="normal"> /** </td></tr> <tr><td>86</td> <td class="normal"> * @var array $_fieldNames an array of field names. used to look up field names </td></tr> <tr><td>87</td> <td class="normal"> * from column names. </td></tr> <tr><td>88</td> <td class="normal"> * keys are column names and values are field names </td></tr> <tr><td>89</td> <td class="normal"> */ </td></tr> <tr><td>90</td> <td class="normal"> protected $_fieldNames = array(); </td></tr> <tr><td>91</td> <td class="normal"> </td></tr> <tr><td>92</td> <td class="normal"> /** </td></tr> <tr><td>93</td> <td class="normal"> * </td></tr> <tr><td>94</td> <td class="normal"> * @var array $_columnNames an array of column names </td></tr> <tr><td>95</td> <td class="normal"> * keys are field names and values column names. </td></tr> <tr><td>96</td> <td class="normal"> * used to look up column names from field names. </td></tr> <tr><td>97</td> <td class="normal"> * this is the reverse lookup map of $_fieldNames. </td></tr> <tr><td>98</td> <td class="normal"> */ </td></tr> <tr><td>99</td> <td class="normal"> protected $_columnNames = 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"> * @var integer $columnCount cached column count, Doctrine_Record uses this column count in when </td></tr> <tr><td>103</td> <td class="normal"> * determining its state </td></tr> <tr><td>104</td> <td class="normal"> */ </td></tr> <tr><td>105</td> <td class="normal"> protected $columnCount; </td></tr> <tr><td>106</td> <td class="normal"> </td></tr> <tr><td>107</td> <td class="normal"> /** </td></tr> <tr><td>108</td> <td class="normal"> * @var boolean $hasDefaultValues whether or not this table has default values </td></tr> <tr><td>109</td> <td class="normal"> */ </td></tr> <tr><td>110</td> <td class="normal"> protected $hasDefaultValues; </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 containing all options </td></tr> <tr><td>114</td> <td class="normal"> * </td></tr> <tr><td>115</td> <td class="normal"> * -- name name of the component, for example component name of the GroupTable is 'Group' </td></tr> <tr><td>116</td> <td class="normal"> * </td></tr> <tr><td>117</td> <td class="normal"> * -- parents the parent classes of this component </td></tr> <tr><td>118</td> <td class="normal"> * </td></tr> <tr><td>119</td> <td class="normal"> * -- declaringClass name of the table definition declaring class (when using inheritance the class </td></tr> <tr><td>120</td> <td class="normal"> * that defines the table structure can be any class in the inheritance hierarchy, </td></tr> <tr><td>121</td> <td class="normal"> * hence we need reflection to check out which class actually calls setTableDefinition) </td></tr> <tr><td>122</td> <td class="normal"> * </td></tr> <tr><td>123</td> <td class="normal"> * -- tableName database table name, in most cases this is the same as component name but in some cases </td></tr> <tr><td>124</td> <td class="normal"> * where one-table-multi-class inheritance is used this will be the name of the inherited table </td></tr> <tr><td>125</td> <td class="normal"> * </td></tr> <tr><td>126</td> <td class="normal"> * -- sequenceName Some databases need sequences instead of auto incrementation primary keys, </td></tr> <tr><td>127</td> <td class="normal"> * you can set specific sequence for your table by calling setOption('sequenceName', $seqName) </td></tr> <tr><td>128</td> <td class="normal"> * where $seqName is the name of the desired sequence </td></tr> <tr><td>129</td> <td class="normal"> * </td></tr> <tr><td>130</td> <td class="normal"> * -- enumMap enum value arrays </td></tr> <tr><td>131</td> <td class="normal"> * </td></tr> <tr><td>132</td> <td class="normal"> * -- inheritanceMap inheritanceMap is used for inheritance mapping, keys representing columns and values </td></tr> <tr><td>133</td> <td class="normal"> * the column values that should correspond to child classes </td></tr> <tr><td>134</td> <td class="normal"> * </td></tr> <tr><td>135</td> <td class="normal"> * -- type table type (mysql example: INNODB) </td></tr> <tr><td>136</td> <td class="normal"> * </td></tr> <tr><td>137</td> <td class="normal"> * -- charset character set </td></tr> <tr><td>138</td> <td class="normal"> * </td></tr> <tr><td>139</td> <td class="normal"> * -- foreignKeys the foreign keys of this table </td></tr> <tr><td>140</td> <td class="normal"> * </td></tr> <tr><td>141</td> <td class="normal"> * -- checks the check constraints of this table, eg. 'price > dicounted_price' </td></tr> <tr><td>142</td> <td class="normal"> * </td></tr> <tr><td>143</td> <td class="normal"> * -- collation collation attribute </td></tr> <tr><td>144</td> <td class="normal"> * </td></tr> <tr><td>145</td> <td class="normal"> * -- indexes the index definitions of this table </td></tr> <tr><td>146</td> <td class="normal"> * </td></tr> <tr><td>147</td> <td class="normal"> * -- treeImpl the tree implementation of this table (if any) </td></tr> <tr><td>148</td> <td class="normal"> * </td></tr> <tr><td>149</td> <td class="normal"> * -- treeOptions the tree options </td></tr> <tr><td>150</td> <td class="normal"> * </td></tr> <tr><td>151</td> <td class="normal"> * -- queryParts the bound query parts </td></tr> <tr><td>152</td> <td class="normal"> * </td></tr> <tr><td>153</td> <td class="normal"> * -- versioning </td></tr> <tr><td>154</td> <td class="normal"> */ </td></tr> <tr><td>155</td> <td class="normal"> protected $_options = array('name' => null, </td></tr> <tr><td>156</td> <td class="normal"> 'tableName' => null, </td></tr> <tr><td>157</td> <td class="normal"> 'sequenceName' => null, </td></tr> <tr><td>158</td> <td class="normal"> 'inheritanceMap' => array(), </td></tr> <tr><td>159</td> <td class="normal"> 'enumMap' => array(), </td></tr> <tr><td>160</td> <td class="normal"> 'type' => null, </td></tr> <tr><td>161</td> <td class="normal"> 'charset' => null, </td></tr> <tr><td>162</td> <td class="normal"> 'collation' => null, </td></tr> <tr><td>163</td> <td class="normal"> 'treeImpl' => null, </td></tr> <tr><td>164</td> <td class="normal"> 'treeOptions' => null, </td></tr> <tr><td>165</td> <td class="normal"> 'indexes' => array(), </td></tr> <tr><td>166</td> <td class="normal"> 'parents' => array(), </td></tr> <tr><td>167</td> <td class="normal"> 'queryParts' => array(), </td></tr> <tr><td>168</td> <td class="normal"> 'versioning' => null, </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"> /** </td></tr> <tr><td>172</td> <td class="normal"> * @var Doctrine_Tree $tree tree object associated with this table </td></tr> <tr><td>173</td> <td class="normal"> */ </td></tr> <tr><td>174</td> <td class="normal"> protected $_tree; </td></tr> <tr><td>175</td> <td class="normal"> </td></tr> <tr><td>176</td> <td class="normal"> /** </td></tr> <tr><td>177</td> <td class="normal"> * @var Doctrine_Relation_Parser $_parser relation parser object </td></tr> <tr><td>178</td> <td class="normal"> */ </td></tr> <tr><td>179</td> <td class="normal"> protected $_parser; </td></tr> <tr><td>180</td> <td class="normal"> </td></tr> <tr><td>181</td> <td class="normal"> /** </td></tr> <tr><td>182</td> <td class="normal"> * @var array $_templates an array containing all templates attached to this table </td></tr> <tr><td>183</td> <td class="normal"> */ </td></tr> <tr><td>184</td> <td class="normal"> protected $_templates = array(); </td></tr> <tr><td>185</td> <td class="normal"> </td></tr> <tr><td>186</td> <td class="normal"> /** </td></tr> <tr><td>187</td> <td class="normal"> * @var array $_filters an array containing all record filters attached to this table </td></tr> <tr><td>188</td> <td class="normal"> */ </td></tr> <tr><td>189</td> <td class="normal"> protected $_filters = array(); </td></tr> <tr><td>190</td> <td class="normal"> </td></tr> <tr><td>191</td> <td class="normal"> /** </td></tr> <tr><td>192</td> <td class="normal"> * @var array $_invokedMethods method invoker cache </td></tr> <tr><td>193</td> <td class="normal"> */ </td></tr> <tr><td>194</td> <td class="normal"> protected $_invokedMethods = array(); </td></tr> <tr><td>195</td> <td class="normal"> </td></tr> <tr><td>196</td> <td class="normal"> </td></tr> <tr><td>197</td> <td class="normal"> </td></tr> <tr><td>198</td> <td class="normal"> /** </td></tr> <tr><td>199</td> <td class="normal"> * the constructor </td></tr> <tr><td>200</td> <td class="normal"> * </td></tr> <tr><td>201</td> <td class="normal"> * @throws Doctrine_Connection_Exception if there are no opened connections </td></tr> <tr><td>202</td> <td class="normal"> * @param string $name the name of the component </td></tr> <tr><td>203</td> <td class="normal"> * @param Doctrine_Connection $conn the connection associated with this table </td></tr> <tr><td>204</td> <td class="normal"> */ </td></tr> <tr><td>205</td> <td class="normal"> public function __construct($name, Doctrine_Connection $conn, $initDefinition = false) </td></tr> <tr><td>206</td> <td class="normal"> { </td></tr> <tr><td>207</td> <td class="covered"> $this->_conn = $conn; </td></tr> <tr><td>208</td> <td class="normal"> </td></tr> <tr><td>209</td> <td class="covered"> $this->setParent($this->_conn); </td></tr> <tr><td>210</td> <td class="normal"> </td></tr> <tr><td>211</td> <td class="covered"> $this->_options['name'] = $name; </td></tr> <tr><td>212</td> <td class="covered"> $this->_parser = new Doctrine_Relation_Parser($this); </td></tr> <tr><td>213</td> <td class="normal"> </td></tr> <tr><td>214</td> <td class="covered"> if ($initDefinition) { </td></tr> <tr><td>215</td> <td class="covered"> $record = $this->initDefinition(); </td></tr> <tr><td>216</td> <td class="normal"> </td></tr> <tr><td>217</td> <td class="covered"> $this->initIdentifier(); </td></tr> <tr><td>218</td> <td class="normal"> </td></tr> <tr><td>219</td> <td class="covered"> $record->setUp(); </td></tr> <tr><td>220</td> <td class="normal"> </td></tr> <tr><td>221</td> <td class="normal"> // if tree, set up tree </td></tr> <tr><td>222</td> <td class="covered"> if ($this->isTree()) { </td></tr> <tr><td>223</td> <td class="covered"> $this->getTree()->setUp(); </td></tr> <tr><td>224</td> <td class="covered"> } </td></tr> <tr><td>225</td> <td class="covered"> } </td></tr> <tr><td>226</td> <td class="covered"> $this->_filters[] = new Doctrine_Record_Filter_Standard(); </td></tr> <tr><td>227</td> <td class="covered"> $this->_repository = new Doctrine_Table_Repository($this); </td></tr> <tr><td>228</td> <td class="covered"> } </td></tr> <tr><td>229</td> <td class="normal"> </td></tr> <tr><td>230</td> <td class="normal"> /** </td></tr> <tr><td>231</td> <td class="normal"> * Initializes the in-memory table definition. </td></tr> <tr><td>232</td> <td class="normal"> * </td></tr> <tr><td>233</td> <td class="normal"> * @param string $name </td></tr> <tr><td>234</td> <td class="normal"> */ </td></tr> <tr><td>235</td> <td class="normal"> public function initDefinition() </td></tr> <tr><td>236</td> <td class="normal"> { </td></tr> <tr><td>237</td> <td class="covered"> $name = $this->_options['name']; </td></tr> <tr><td>238</td> <td class="covered"> if ( ! class_exists($name) || empty($name)) { </td></tr> <tr><td>239</td> <td class="covered"> throw new Doctrine_Exception("Couldn't find class " . $name); </td></tr> <tr><td>240</td> <td class="orange"> } </td></tr> <tr><td>241</td> <td class="covered"> $record = new $name($this); </td></tr> <tr><td>242</td> <td class="normal"> </td></tr> <tr><td>243</td> <td class="covered"> $names = array(); </td></tr> <tr><td>244</td> <td class="normal"> </td></tr> <tr><td>245</td> <td class="covered"> $class = $name; </td></tr> <tr><td>246</td> <td class="normal"> </td></tr> <tr><td>247</td> <td class="normal"> // get parent classes </td></tr> <tr><td>248</td> <td class="normal"> </td></tr> <tr><td>249</td> <td class="normal"> do { </td></tr> <tr><td>250</td> <td class="covered"> if ($class === 'Doctrine_Record') { </td></tr> <tr><td>251</td> <td class="covered"> break; </td></tr> <tr><td>252</td> <td class="orange"> } </td></tr> <tr><td>253</td> <td class="normal"> </td></tr> <tr><td>254</td> <td class="covered"> $name = $class; </td></tr> <tr><td>255</td> <td class="covered"> $names[] = $name; </td></tr> <tr><td>256</td> <td class="covered"> } while ($class = get_parent_class($class)); </td></tr> <tr><td>257</td> <td class="normal"> </td></tr> <tr><td>258</td> <td class="covered"> if ($class === false) { </td></tr> <tr><td>259</td> <td class="red"> throw new Doctrine_Table_Exception('Unknown component.'); </td></tr> <tr><td>260</td> <td class="orange"> } </td></tr> <tr><td>261</td> <td class="normal"> </td></tr> <tr><td>262</td> <td class="normal"> // reverse names </td></tr> <tr><td>263</td> <td class="covered"> $names = array_reverse($names); </td></tr> <tr><td>264</td> <td class="normal"> // save parents </td></tr> <tr><td>265</td> <td class="covered"> array_pop($names); </td></tr> <tr><td>266</td> <td class="covered"> $this->_options['parents'] = $names; </td></tr> <tr><td>267</td> <td class="normal"> </td></tr> <tr><td>268</td> <td class="normal"> // create database table </td></tr> <tr><td>269</td> <td class="covered"> if (method_exists($record, 'setTableDefinition')) { </td></tr> <tr><td>270</td> <td class="covered"> $record->setTableDefinition(); </td></tr> <tr><td>271</td> <td class="normal"> // get the declaring class of setTableDefinition method </td></tr> <tr><td>272</td> <td class="covered"> $method = new ReflectionMethod($this->_options['name'], 'setTableDefinition'); </td></tr> <tr><td>273</td> <td class="covered"> $class = $method->getDeclaringClass(); </td></tr> <tr><td>274</td> <td class="normal"> </td></tr> <tr><td>275</td> <td class="covered"> } else { </td></tr> <tr><td>276</td> <td class="covered"> $class = new ReflectionClass($class); </td></tr> <tr><td>277</td> <td class="normal"> } </td></tr> <tr><td>278</td> <td class="normal"> </td></tr> <tr><td>279</td> <td class="covered"> $this->_options['joinedParents'] = array(); </td></tr> <tr><td>280</td> <td class="normal"> </td></tr> <tr><td>281</td> <td class="covered"> foreach (array_reverse($this->_options['parents']) as $parent) { </td></tr> <tr><td>282</td> <td class="normal"> </td></tr> <tr><td>283</td> <td class="covered"> if ($parent === $class->getName()) { </td></tr> <tr><td>284</td> <td class="covered"> continue; </td></tr> <tr><td>285</td> <td class="orange"> } </td></tr> <tr><td>286</td> <td class="covered"> $ref = new ReflectionClass($parent); </td></tr> <tr><td>287</td> <td class="normal"> </td></tr> <tr><td>288</td> <td class="covered"> if ($ref->isAbstract()) { </td></tr> <tr><td>289</td> <td class="covered"> continue; </td></tr> <tr><td>290</td> <td class="orange"> } </td></tr> <tr><td>291</td> <td class="covered"> $parentTable = $this->_conn->getTable($parent); </td></tr> <tr><td>292</td> <td class="normal"> </td></tr> <tr><td>293</td> <td class="covered"> $found = false; </td></tr> <tr><td>294</td> <td class="covered"> $parentColumns = $parentTable->getColumns(); </td></tr> <tr><td>295</td> <td class="normal"> </td></tr> <tr><td>296</td> <td class="covered"> foreach ($parentColumns as $columnName => $definition) { </td></tr> <tr><td>297</td> <td class="covered"> if ( ! isset($definition['primary'])) { </td></tr> <tr><td>298</td> <td class="covered"> if (isset($this->_columns[$columnName])) { </td></tr> <tr><td>299</td> <td class="covered"> $found = true; </td></tr> <tr><td>300</td> <td class="covered"> break; </td></tr> <tr><td>301</td> <td class="orange"> } else { </td></tr> <tr><td>302</td> <td class="covered"> if ( ! isset($parentColumns[$columnName]['owner'])) { </td></tr> <tr><td>303</td> <td class="covered"> $parentColumns[$columnName]['owner'] = $parentTable->getComponentName(); </td></tr> <tr><td>304</td> <td class="covered"> } </td></tr> <tr><td>305</td> <td class="normal"> </td></tr> <tr><td>306</td> <td class="covered"> $this->_options['joinedParents'][] = $parentColumns[$columnName]['owner']; </td></tr> <tr><td>307</td> <td class="normal"> } </td></tr> <tr><td>308</td> <td class="covered"> } else { </td></tr> <tr><td>309</td> <td class="covered"> unset($parentColumns[$columnName]); </td></tr> <tr><td>310</td> <td class="normal"> } </td></tr> <tr><td>311</td> <td class="covered"> } </td></tr> <tr><td>312</td> <td class="normal"> </td></tr> <tr><td>313</td> <td class="covered"> if ($found) { </td></tr> <tr><td>314</td> <td class="covered"> continue; </td></tr> <tr><td>315</td> <td class="orange"> } </td></tr> <tr><td>316</td> <td class="normal"> </td></tr> <tr><td>317</td> <td class="covered"> foreach ($parentColumns as $columnName => $definition) { </td></tr> <tr><td>318</td> <td class="covered"> $fullName = $columnName . ' as ' . $parentTable->getFieldName($columnName); </td></tr> <tr><td>319</td> <td class="covered"> $this->setColumn($fullName, $definition['type'], $definition['length'], $definition, true); </td></tr> <tr><td>320</td> <td class="covered"> } </td></tr> <tr><td>321</td> <td class="normal"> </td></tr> <tr><td>322</td> <td class="covered"> break; </td></tr> <tr><td>323</td> <td class="red"> } </td></tr> <tr><td>324</td> <td class="normal"> </td></tr> <tr><td>325</td> <td class="covered"> $this->_options['joinedParents'] = array_values(array_unique($this->_options['joinedParents'])); </td></tr> <tr><td>326</td> <td class="normal"> </td></tr> <tr><td>327</td> <td class="covered"> $this->_options['declaringClass'] = $class; </td></tr> <tr><td>328</td> <td class="normal"> </td></tr> <tr><td>329</td> <td class="normal"> // set the table definition for the given tree implementation </td></tr> <tr><td>330</td> <td class="covered"> if ($this->isTree()) { </td></tr> <tr><td>331</td> <td class="covered"> $this->getTree()->setTableDefinition(); </td></tr> <tr><td>332</td> <td class="covered"> } </td></tr> <tr><td>333</td> <td class="normal"> </td></tr> <tr><td>334</td> <td class="covered"> $this->columnCount = count($this->_columns); </td></tr> <tr><td>335</td> <td class="normal"> </td></tr> <tr><td>336</td> <td class="covered"> if ( ! isset($this->_options['tableName'])) { </td></tr> <tr><td>337</td> <td class="covered"> $this->_options['tableName'] = Doctrine::tableize($class->getName()); </td></tr> <tr><td>338</td> <td class="covered"> } </td></tr> <tr><td>339</td> <td class="normal"> </td></tr> <tr><td>340</td> <td class="covered"> return $record; </td></tr> <tr><td>341</td> <td class="orange"> } </td></tr> <tr><td>342</td> <td class="normal"> </td></tr> <tr><td>343</td> <td class="normal"> /** </td></tr> <tr><td>344</td> <td class="normal"> * Initializes the table identifier(s)/primary key(s) </td></tr> <tr><td>345</td> <td class="normal"> * </td></tr> <tr><td>346</td> <td class="normal"> */ </td></tr> <tr><td>347</td> <td class="normal"> public function initIdentifier() </td></tr> <tr><td>348</td> <td class="normal"> { </td></tr> <tr><td>349</td> <td class="covered"> switch (count($this->_identifier)) { </td></tr> <tr><td>350</td> <td class="covered"> case 0: </td></tr> <tr><td>351</td> <td class="covered"> if ( ! empty($this->_options['joinedParents'])) { </td></tr> <tr><td>352</td> <td class="covered"> $root = current($this->_options['joinedParents']); </td></tr> <tr><td>353</td> <td class="normal"> </td></tr> <tr><td>354</td> <td class="covered"> $table = $this->_conn->getTable($root); </td></tr> <tr><td>355</td> <td class="normal"> </td></tr> <tr><td>356</td> <td class="covered"> $this->_identifier = $table->getIdentifier(); </td></tr> <tr><td>357</td> <td class="normal"> </td></tr> <tr><td>358</td> <td class="covered"> $this->_identifierType = ($table->getIdentifierType() !== Doctrine::IDENTIFIER_AUTOINC) </td></tr> <tr><td>359</td> <td class="covered"> ? $table->getIdentifierType() : Doctrine::IDENTIFIER_NATURAL; </td></tr> <tr><td>360</td> <td class="normal"> </td></tr> <tr><td>361</td> <td class="normal"> // add all inherited primary keys </td></tr> <tr><td>362</td> <td class="covered"> foreach ((array) $this->_identifier as $id) { </td></tr> <tr><td>363</td> <td class="covered"> $definition = $table->getDefinitionOf($id); </td></tr> <tr><td>364</td> <td class="normal"> </td></tr> <tr><td>365</td> <td class="normal"> // inherited primary keys shouldn't contain autoinc </td></tr> <tr><td>366</td> <td class="normal"> // and sequence definitions </td></tr> <tr><td>367</td> <td class="covered"> unset($definition['autoincrement']); </td></tr> <tr><td>368</td> <td class="covered"> unset($definition['sequence']); </td></tr> <tr><td>369</td> <td class="normal"> </td></tr> <tr><td>370</td> <td class="normal"> // add the inherited primary key column </td></tr> <tr><td>371</td> <td class="covered"> $fullName = $id . ' as ' . $table->getFieldName($id); </td></tr> <tr><td>372</td> <td class="covered"> $this->setColumn($fullName, $definition['type'], $definition['length'], </td></tr> <tr><td>373</td> <td class="covered"> $definition, true); </td></tr> <tr><td>374</td> <td class="covered"> } </td></tr> <tr><td>375</td> <td class="covered"> } else { </td></tr> <tr><td>376</td> <td class="covered"> $definition = array('type' => 'integer', </td></tr> <tr><td>377</td> <td class="covered"> 'length' => 20, </td></tr> <tr><td>378</td> <td class="covered"> 'autoincrement' => true, </td></tr> <tr><td>379</td> <td class="covered"> 'primary' => true); </td></tr> <tr><td>380</td> <td class="covered"> $this->setColumn('id', $definition['type'], $definition['length'], $definition, true); </td></tr> <tr><td>381</td> <td class="covered"> $this->_identifier = 'id'; </td></tr> <tr><td>382</td> <td class="covered"> $this->_identifierType = Doctrine::IDENTIFIER_AUTOINC; </td></tr> <tr><td>383</td> <td class="normal"> } </td></tr> <tr><td>384</td> <td class="covered"> $this->columnCount++; </td></tr> <tr><td>385</td> <td class="covered"> break; </td></tr> <tr><td>386</td> <td class="covered"> case 1: </td></tr> <tr><td>387</td> <td class="covered"> foreach ($this->_identifier as $pk) { </td></tr> <tr><td>388</td> <td class="covered"> $columnName = $this->getColumnName($pk); </td></tr> <tr><td>389</td> <td class="covered"> $e = $this->_columns[$columnName]; </td></tr> <tr><td>390</td> <td class="normal"> </td></tr> <tr><td>391</td> <td class="covered"> $found = false; </td></tr> <tr><td>392</td> <td class="normal"> </td></tr> <tr><td>393</td> <td class="covered"> foreach ($e as $option => $value) { </td></tr> <tr><td>394</td> <td class="covered"> if ($found) { </td></tr> <tr><td>395</td> <td class="covered"> break; </td></tr> <tr><td>396</td> <td class="orange"> } </td></tr> <tr><td>397</td> <td class="normal"> </td></tr> <tr><td>398</td> <td class="covered"> $e2 = explode(':', $option); </td></tr> <tr><td>399</td> <td class="normal"> </td></tr> <tr><td>400</td> <td class="covered"> switch (strtolower($e2[0])) { </td></tr> <tr><td>401</td> <td class="covered"> case 'autoincrement': </td></tr> <tr><td>402</td> <td class="covered"> case 'autoinc': </td></tr> <tr><td>403</td> <td class="covered"> $this->_identifierType = Doctrine::IDENTIFIER_AUTOINC; </td></tr> <tr><td>404</td> <td class="covered"> $found = true; </td></tr> <tr><td>405</td> <td class="covered"> break; </td></tr> <tr><td>406</td> <td class="covered"> case 'seq': </td></tr> <tr><td>407</td> <td class="covered"> case 'sequence': </td></tr> <tr><td>408</td> <td class="covered"> $this->_identifierType = Doctrine::IDENTIFIER_SEQUENCE; </td></tr> <tr><td>409</td> <td class="covered"> $found = true; </td></tr> <tr><td>410</td> <td class="normal"> </td></tr> <tr><td>411</td> <td class="covered"> if ($value) { </td></tr> <tr><td>412</td> <td class="covered"> $this->_options['sequenceName'] = $value; </td></tr> <tr><td>413</td> <td class="covered"> } else { </td></tr> <tr><td>414</td> <td class="red"> if (($sequence = $this->getAttribute(Doctrine::ATTR_DEFAULT_SEQUENCE)) !== null) { </td></tr> <tr><td>415</td> <td class="red"> $this->_options['sequenceName'] = $sequence; </td></tr> <tr><td>416</td> <td class="red"> } else { </td></tr> <tr><td>417</td> <td class="red"> $this->_options['sequenceName'] = $this->_conn->getSequenceName($this->_options['tableName']); </td></tr> <tr><td>418</td> <td class="normal"> } </td></tr> <tr><td>419</td> <td class="normal"> } </td></tr> <tr><td>420</td> <td class="covered"> break; </td></tr> <tr><td>421</td> <td class="red"> } </td></tr> <tr><td>422</td> <td class="covered"> } </td></tr> <tr><td>423</td> <td class="covered"> if ( ! isset($this->_identifierType)) { </td></tr> <tr><td>424</td> <td class="covered"> $this->_identifierType = Doctrine::IDENTIFIER_NATURAL; </td></tr> <tr><td>425</td> <td class="covered"> } </td></tr> <tr><td>426</td> <td class="covered"> } </td></tr> <tr><td>427</td> <td class="normal"> </td></tr> <tr><td>428</td> <td class="covered"> $this->_identifier = $pk; </td></tr> <tr><td>429</td> <td class="normal"> </td></tr> <tr><td>430</td> <td class="covered"> break; </td></tr> <tr><td>431</td> <td class="covered"> default: </td></tr> <tr><td>432</td> <td class="covered"> $this->_identifierType = Doctrine::IDENTIFIER_COMPOSITE; </td></tr> <tr><td>433</td> <td class="covered"> } </td></tr> <tr><td>434</td> <td class="covered"> } </td></tr> <tr><td>435</td> <td class="normal"> </td></tr> <tr><td>436</td> <td class="normal"> /** </td></tr> <tr><td>437</td> <td class="normal"> * Gets the owner of a column. </td></tr> <tr><td>438</td> <td class="normal"> * The owner of a column is the name of the component in a hierarchy that </td></tr> <tr><td>439</td> <td class="normal"> * defines the column. </td></tr> <tr><td>440</td> <td class="normal"> * </td></tr> <tr><td>441</td> <td class="normal"> * @param string $columnName The column name </td></tr> <tr><td>442</td> <td class="normal"> * @return string The name of the owning/defining component </td></tr> <tr><td>443</td> <td class="normal"> */ </td></tr> <tr><td>444</td> <td class="normal"> public function getColumnOwner($columnName) </td></tr> <tr><td>445</td> <td class="normal"> { </td></tr> <tr><td>446</td> <td class="covered"> if (isset($this->_columns[$columnName]['owner'])) { </td></tr> <tr><td>447</td> <td class="covered"> return $this->_columns[$columnName]['owner']; </td></tr> <tr><td>448</td> <td class="orange"> } else { </td></tr> <tr><td>449</td> <td class="covered"> return $this->getComponentName(); </td></tr> <tr><td>450</td> <td class="normal"> } </td></tr> <tr><td>451</td> <td class="orange"> } </td></tr> <tr><td>452</td> <td class="normal"> </td></tr> <tr><td>453</td> <td class="normal"> /** </td></tr> <tr><td>454</td> <td class="normal"> * Checks whether a column is inherited from a component further up in the hierarchy. </td></tr> <tr><td>455</td> <td class="normal"> * </td></tr> <tr><td>456</td> <td class="normal"> * @param $columnName The column name </td></tr> <tr><td>457</td> <td class="normal"> * @return boolean TRUE if column is inherited, FALSE otherwise. </td></tr> <tr><td>458</td> <td class="normal"> */ </td></tr> <tr><td>459</td> <td class="normal"> public function isInheritedColumn($columnName) </td></tr> <tr><td>460</td> <td class="normal"> { </td></tr> <tr><td>461</td> <td class="red"> return (isset($this->_columns[$columnName]['owner'])); </td></tr> <tr><td>462</td> <td class="orange"> } </td></tr> <tr><td>463</td> <td class="normal"> </td></tr> <tr><td>464</td> <td class="normal"> /** </td></tr> <tr><td>465</td> <td class="normal"> * Checks whether a field is part of the table identifier/primary key field(s). </td></tr> <tr><td>466</td> <td class="normal"> * </td></tr> <tr><td>467</td> <td class="normal"> * @param string $fieldName The field name </td></tr> <tr><td>468</td> <td class="normal"> * @return boolean TRUE if the field is part of the table identifier/primary key field(s), </td></tr> <tr><td>469</td> <td class="normal"> * FALSE otherwise. </td></tr> <tr><td>470</td> <td class="normal"> */ </td></tr> <tr><td>471</td> <td class="normal"> public function isIdentifier($fieldName) </td></tr> <tr><td>472</td> <td class="normal"> { </td></tr> <tr><td>473</td> <td class="covered"> return ($fieldName === $this->getIdentifier() || </td></tr> <tr><td>474</td> <td class="covered"> in_array($fieldName, (array) $this->getIdentifier())); </td></tr> <tr><td>475</td> <td class="orange"> } </td></tr> <tr><td>476</td> <td class="normal"> </td></tr> <tr><td>477</td> <td class="normal"> public function getMethodOwner($method) </td></tr> <tr><td>478</td> <td class="normal"> { </td></tr> <tr><td>479</td> <td class="covered"> return (isset($this->_invokedMethods[$method])) ? </td></tr> <tr><td>480</td> <td class="covered"> $this->_invokedMethods[$method] : false; </td></tr> <tr><td>481</td> <td class="orange"> } </td></tr> <tr><td>482</td> <td class="normal"> </td></tr> <tr><td>483</td> <td class="normal"> public function setMethodOwner($method, $class) </td></tr> <tr><td>484</td> <td class="normal"> { </td></tr> <tr><td>485</td> <td class="covered"> $this->_invokedMethods[$method] = $class; </td></tr> <tr><td>486</td> <td class="covered"> } </td></tr> <tr><td>487</td> <td class="normal"> </td></tr> <tr><td>488</td> <td class="normal"> /** </td></tr> <tr><td>489</td> <td class="normal"> * getTemplates </td></tr> <tr><td>490</td> <td class="normal"> * returns all templates attached to this table </td></tr> <tr><td>491</td> <td class="normal"> * </td></tr> <tr><td>492</td> <td class="normal"> * @return array an array containing all templates </td></tr> <tr><td>493</td> <td class="normal"> */ </td></tr> <tr><td>494</td> <td class="normal"> public function getTemplates() </td></tr> <tr><td>495</td> <td class="normal"> { </td></tr> <tr><td>496</td> <td class="covered"> return $this->_templates; </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="normal"> /** </td></tr> <tr><td>500</td> <td class="normal"> * export </td></tr> <tr><td>501</td> <td class="normal"> * exports this table to database based on column and option definitions </td></tr> <tr><td>502</td> <td class="normal"> * </td></tr> <tr><td>503</td> <td class="normal"> * @throws Doctrine_Connection_Exception if some error other than Doctrine::ERR_ALREADY_EXISTS </td></tr> <tr><td>504</td> <td class="normal"> * occurred during the create table operation </td></tr> <tr><td>505</td> <td class="normal"> * @return boolean whether or not the export operation was successful </td></tr> <tr><td>506</td> <td class="normal"> * false if table already existed in the database </td></tr> <tr><td>507</td> <td class="normal"> */ </td></tr> <tr><td>508</td> <td class="normal"> public function export() </td></tr> <tr><td>509</td> <td class="normal"> { </td></tr> <tr><td>510</td> <td class="red"> $this->_conn->export->exportTable($this); </td></tr> <tr><td>511</td> <td class="red"> } </td></tr> <tr><td>512</td> <td class="normal"> </td></tr> <tr><td>513</td> <td class="normal"> /** </td></tr> <tr><td>514</td> <td class="normal"> * getExportableFormat </td></tr> <tr><td>515</td> <td class="normal"> * returns exportable presentation of this object </td></tr> <tr><td>516</td> <td class="normal"> * </td></tr> <tr><td>517</td> <td class="normal"> * @return array </td></tr> <tr><td>518</td> <td class="normal"> */ </td></tr> <tr><td>519</td> <td class="normal"> public function getExportableFormat($parseForeignKeys = true) </td></tr> <tr><td>520</td> <td class="normal"> { </td></tr> <tr><td>521</td> <td class="covered"> $columns = array(); </td></tr> <tr><td>522</td> <td class="covered"> $primary = array(); </td></tr> <tr><td>523</td> <td class="normal"> </td></tr> <tr><td>524</td> <td class="covered"> foreach ($this->getColumns() as $name => $definition) { </td></tr> <tr><td>525</td> <td class="normal"> </td></tr> <tr><td>526</td> <td class="covered"> if (isset($definition['owner'])) { </td></tr> <tr><td>527</td> <td class="covered"> continue; </td></tr> <tr><td>528</td> <td class="orange"> } </td></tr> <tr><td>529</td> <td class="normal"> </td></tr> <tr><td>530</td> <td class="covered"> switch ($definition['type']) { </td></tr> <tr><td>531</td> <td class="covered"> case 'enum': </td></tr> <tr><td>532</td> <td class="covered"> if (isset($definition['default'])) { </td></tr> <tr><td>533</td> <td class="covered"> $definition['default'] = $this->enumIndex($name, $definition['default']); </td></tr> <tr><td>534</td> <td class="covered"> } </td></tr> <tr><td>535</td> <td class="covered"> break; </td></tr> <tr><td>536</td> <td class="covered"> case 'boolean': </td></tr> <tr><td>537</td> <td class="covered"> if (isset($definition['default'])) { </td></tr> <tr><td>538</td> <td class="covered"> $definition['default'] = $this->getConnection()->convertBooleans($definition['default']); </td></tr> <tr><td>539</td> <td class="covered"> } </td></tr> <tr><td>540</td> <td class="covered"> break; </td></tr> <tr><td>541</td> <td class="red"> } </td></tr> <tr><td>542</td> <td class="covered"> $columns[$name] = $definition; </td></tr> <tr><td>543</td> <td class="normal"> </td></tr> <tr><td>544</td> <td class="covered"> if (isset($definition['primary']) && $definition['primary']) { </td></tr> <tr><td>545</td> <td class="covered"> $primary[] = $name; </td></tr> <tr><td>546</td> <td class="covered"> } </td></tr> <tr><td>547</td> <td class="covered"> } </td></tr> <tr><td>548</td> <td class="covered"> $options['foreignKeys'] = array(); </td></tr> <tr><td>549</td> <td class="normal"> </td></tr> <tr><td>550</td> <td class="normal"> </td></tr> <tr><td>551</td> <td class="covered"> if ($parseForeignKeys && $this->getAttribute(Doctrine::ATTR_EXPORT) </td></tr> <tr><td>552</td> <td class="covered"> & Doctrine::EXPORT_CONSTRAINTS) { </td></tr> <tr><td>553</td> <td class="normal"> </td></tr> <tr><td>554</td> <td class="covered"> $constraints = array(); </td></tr> <tr><td>555</td> <td class="normal"> </td></tr> <tr><td>556</td> <td class="covered"> $emptyIntegrity = array('onUpdate' => null, </td></tr> <tr><td>557</td> <td class="covered"> 'onDelete' => null); </td></tr> <tr><td>558</td> <td class="normal"> </td></tr> <tr><td>559</td> <td class="covered"> foreach ($this->getRelations() as $name => $relation) { </td></tr> <tr><td>560</td> <td class="covered"> $fk = $relation->toArray(); </td></tr> <tr><td>561</td> <td class="covered"> $fk['foreignTable'] = $relation->getTable()->getTableName(); </td></tr> <tr><td>562</td> <td class="normal"> </td></tr> <tr><td>563</td> <td class="covered"> if ($relation->getTable() === $this && in_array($relation->getLocal(), $primary)) { </td></tr> <tr><td>564</td> <td class="covered"> if ($relation->hasConstraint()) { </td></tr> <tr><td>565</td> <td class="red"> throw new Doctrine_Table_Exception("Badly constructed integrity constraints."); </td></tr> <tr><td>566</td> <td class="orange"> } </td></tr> <tr><td>567</td> <td class="covered"> continue; </td></tr> <tr><td>568</td> <td class="orange"> } </td></tr> <tr><td>569</td> <td class="normal"> </td></tr> <tr><td>570</td> <td class="covered"> $integrity = array('onUpdate' => $fk['onUpdate'], </td></tr> <tr><td>571</td> <td class="covered"> 'onDelete' => $fk['onDelete']); </td></tr> <tr><td>572</td> <td class="normal"> </td></tr> <tr><td>573</td> <td class="covered"> if ($relation instanceof Doctrine_Relation_LocalKey) { </td></tr> <tr><td>574</td> <td class="covered"> $def = array('local' => $relation->getLocal(), </td></tr> <tr><td>575</td> <td class="covered"> 'foreign' => $relation->getForeign(), </td></tr> <tr><td>576</td> <td class="covered"> 'foreignTable' => $relation->getTable()->getTableName()); </td></tr> <tr><td>577</td> <td class="normal"> </td></tr> <tr><td>578</td> <td class="covered"> if (($key = array_search($def, $options['foreignKeys'])) === false) { </td></tr> <tr><td>579</td> <td class="covered"> $options['foreignKeys'][] = $def; </td></tr> <tr><td>580</td> <td class="covered"> $constraints[] = $integrity; </td></tr> <tr><td>581</td> <td class="covered"> } else { </td></tr> <tr><td>582</td> <td class="covered"> if ($integrity !== $emptyIntegrity) { </td></tr> <tr><td>583</td> <td class="covered"> $constraints[$key] = $integrity; </td></tr> <tr><td>584</td> <td class="covered"> } </td></tr> <tr><td>585</td> <td class="normal"> } </td></tr> <tr><td>586</td> <td class="covered"> } </td></tr> <tr><td>587</td> <td class="covered"> } </td></tr> <tr><td>588</td> <td class="normal"> </td></tr> <tr><td>589</td> <td class="covered"> foreach ($constraints as $k => $def) { </td></tr> <tr><td>590</td> <td class="covered"> $options['foreignKeys'][$k] = array_merge($options['foreignKeys'][$k], $def); </td></tr> <tr><td>591</td> <td class="covered"> } </td></tr> <tr><td>592</td> <td class="covered"> } </td></tr> <tr><td>593</td> <td class="normal"> </td></tr> <tr><td>594</td> <td class="covered"> $options['primary'] = $primary; </td></tr> <tr><td>595</td> <td class="normal"> </td></tr> <tr><td>596</td> <td class="covered"> return array('tableName' => $this->getOption('tableName'), </td></tr> <tr><td>597</td> <td class="covered"> 'columns' => $columns, </td></tr> <tr><td>598</td> <td class="covered"> 'options' => array_merge($this->getOptions(), $options)); </td></tr> <tr><td>599</td> <td class="orange"> } </td></tr> <tr><td>600</td> <td class="normal"> </td></tr> <tr><td>601</td> <td class="normal"> /** </td></tr> <tr><td>602</td> <td class="normal"> * exportConstraints </td></tr> <tr><td>603</td> <td class="normal"> * exports the constraints of this table into database based on option definitions </td></tr> <tr><td>604</td> <td class="normal"> * </td></tr> <tr><td>605</td> <td class="normal"> * @throws Doctrine_Connection_Exception if something went wrong on db level </td></tr> <tr><td>606</td> <td class="normal"> * @return void </td></tr> <tr><td>607</td> <td class="normal"> */ </td></tr> <tr><td>608</td> <td class="normal"> public function exportConstraints() </td></tr> <tr><td>609</td> <td class="normal"> { </td></tr> <tr><td>610</td> <td class="normal"> try { </td></tr> <tr><td>611</td> <td class="red"> $this->_conn->beginTransaction(); </td></tr> <tr><td>612</td> <td class="normal"> </td></tr> <tr><td>613</td> <td class="red"> foreach ($this->_options['index'] as $index => $definition) { </td></tr> <tr><td>614</td> <td class="red"> $this->_conn->export->createIndex($this->_options['tableName'], $index, $definition); </td></tr> <tr><td>615</td> <td class="red"> } </td></tr> <tr><td>616</td> <td class="red"> $this->_conn->commit(); </td></tr> <tr><td>617</td> <td class="red"> } catch (Doctrine_Connection_Exception $e) { </td></tr> <tr><td>618</td> <td class="orange"> $this->_conn->rollback(); </td></tr> <tr><td>619</td> <td class="orange"> throw $e; </td></tr> <tr><td>620</td> <td class="normal"> } </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="normal"> /** </td></tr> <tr><td>624</td> <td class="normal"> * getRelationParser </td></tr> <tr><td>625</td> <td class="normal"> * return the relation parser associated with this table </td></tr> <tr><td>626</td> <td class="normal"> * </td></tr> <tr><td>627</td> <td class="normal"> * @return Doctrine_Relation_Parser relation parser object </td></tr> <tr><td>628</td> <td class="normal"> */ </td></tr> <tr><td>629</td> <td class="normal"> public function getRelationParser() </td></tr> <tr><td>630</td> <td class="normal"> { </td></tr> <tr><td>631</td> <td class="covered"> return $this->_parser; </td></tr> <tr><td>632</td> <td class="orange"> } </td></tr> <tr><td>633</td> <td class="normal"> </td></tr> <tr><td>634</td> <td class="normal"> /** </td></tr> <tr><td>635</td> <td class="normal"> * __get </td></tr> <tr><td>636</td> <td class="normal"> * an alias for getOption </td></tr> <tr><td>637</td> <td class="normal"> * </td></tr> <tr><td>638</td> <td class="normal"> * @param string $option </td></tr> <tr><td>639</td> <td class="normal"> */ </td></tr> <tr><td>640</td> <td class="normal"> public function __get($option) </td></tr> <tr><td>641</td> <td class="normal"> { </td></tr> <tr><td>642</td> <td class="covered"> if (isset($this->_options[$option])) { </td></tr> <tr><td>643</td> <td class="covered"> return $this->_options[$option]; </td></tr> <tr><td>644</td> <td class="orange"> } </td></tr> <tr><td>645</td> <td class="covered"> return null; </td></tr> <tr><td>646</td> <td class="orange"> } </td></tr> <tr><td>647</td> <td class="normal"> </td></tr> <tr><td>648</td> <td class="normal"> /** </td></tr> <tr><td>649</td> <td class="normal"> * __isset </td></tr> <tr><td>650</td> <td class="normal"> * </td></tr> <tr><td>651</td> <td class="normal"> * @param string $option </td></tr> <tr><td>652</td> <td class="normal"> */ </td></tr> <tr><td>653</td> <td class="normal"> public function __isset($option) </td></tr> <tr><td>654</td> <td class="normal"> { </td></tr> <tr><td>655</td> <td class="red"> return isset($this->_options[$option]); </td></tr> <tr><td>656</td> <td class="orange"> } </td></tr> <tr><td>657</td> <td class="normal"> </td></tr> <tr><td>658</td> <td class="normal"> /** </td></tr> <tr><td>659</td> <td class="normal"> * getOptions </td></tr> <tr><td>660</td> <td class="normal"> * returns all options of this table and the associated values </td></tr> <tr><td>661</td> <td class="normal"> * </td></tr> <tr><td>662</td> <td class="normal"> * @return array all options and their values </td></tr> <tr><td>663</td> <td class="normal"> */ </td></tr> <tr><td>664</td> <td class="normal"> public function getOptions() </td></tr> <tr><td>665</td> <td class="normal"> { </td></tr> <tr><td>666</td> <td class="covered"> return $this->_options; </td></tr> <tr><td>667</td> <td class="orange"> } </td></tr> <tr><td>668</td> <td class="normal"> </td></tr> <tr><td>669</td> <td class="normal"> /** </td></tr> <tr><td>670</td> <td class="normal"> * addForeignKey </td></tr> <tr><td>671</td> <td class="normal"> * </td></tr> <tr><td>672</td> <td class="normal"> * adds a foreignKey to this table </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"> public function addForeignKey(array $definition) </td></tr> <tr><td>677</td> <td class="normal"> { </td></tr> <tr><td>678</td> <td class="red"> $this->_options['foreignKeys'][] = $definition; </td></tr> <tr><td>679</td> <td class="red"> } </td></tr> <tr><td>680</td> <td class="normal"> </td></tr> <tr><td>681</td> <td class="normal"> /** </td></tr> <tr><td>682</td> <td class="normal"> * addCheckConstraint </td></tr> <tr><td>683</td> <td class="normal"> * </td></tr> <tr><td>684</td> <td class="normal"> * adds a check constraint to this table </td></tr> <tr><td>685</td> <td class="normal"> * </td></tr> <tr><td>686</td> <td class="normal"> * @return void </td></tr> <tr><td>687</td> <td class="normal"> */ </td></tr> <tr><td>688</td> <td class="normal"> public function addCheckConstraint($definition, $name) </td></tr> <tr><td>689</td> <td class="normal"> { </td></tr> <tr><td>690</td> <td class="red"> if (is_string($name)) { </td></tr> <tr><td>691</td> <td class="red"> $this->_options['checks'][$name] = $definition; </td></tr> <tr><td>692</td> <td class="red"> } else { </td></tr> <tr><td>693</td> <td class="red"> $this->_options['checks'][] = $definition; </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="red"> return $this; </td></tr> <tr><td>697</td> <td class="orange"> } </td></tr> <tr><td>698</td> <td class="normal"> </td></tr> <tr><td>699</td> <td class="normal"> /** </td></tr> <tr><td>700</td> <td class="normal"> * addIndex </td></tr> <tr><td>701</td> <td class="normal"> * </td></tr> <tr><td>702</td> <td class="normal"> * adds an index to this table </td></tr> <tr><td>703</td> <td class="normal"> * </td></tr> <tr><td>704</td> <td class="normal"> * @return void </td></tr> <tr><td>705</td> <td class="normal"> */ </td></tr> <tr><td>706</td> <td class="normal"> public function addIndex($index, array $definition) </td></tr> <tr><td>707</td> <td class="normal"> { </td></tr> <tr><td>708</td> <td class="covered"> $this->_options['indexes'][$index] = $definition; </td></tr> <tr><td>709</td> <td class="covered"> } </td></tr> <tr><td>710</td> <td class="normal"> </td></tr> <tr><td>711</td> <td class="normal"> /** </td></tr> <tr><td>712</td> <td class="normal"> * getIndex </td></tr> <tr><td>713</td> <td class="normal"> * </td></tr> <tr><td>714</td> <td class="normal"> * @return array|boolean array on success, FALSE on failure </td></tr> <tr><td>715</td> <td class="normal"> */ </td></tr> <tr><td>716</td> <td class="normal"> public function getIndex($index) </td></tr> <tr><td>717</td> <td class="normal"> { </td></tr> <tr><td>718</td> <td class="red"> if (isset($this->_options['indexes'][$index])) { </td></tr> <tr><td>719</td> <td class="red"> return $this->_options['indexes'][$index]; </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="red"> return false; </td></tr> <tr><td>723</td> <td class="orange"> } </td></tr> <tr><td>724</td> <td class="normal"> </td></tr> <tr><td>725</td> <td class="normal"> /** </td></tr> <tr><td>726</td> <td class="normal"> * DESCRIBE WHAT THIS METHOD DOES, PLEASE! </td></tr> <tr><td>727</td> <td class="normal"> * </td></tr> <tr><td>728</td> <td class="normal"> * @todo Name proposal: addRelation </td></tr> <tr><td>729</td> <td class="normal"> */ </td></tr> <tr><td>730</td> <td class="normal"> public function bind($args, $type) </td></tr> <tr><td>731</td> <td class="normal"> { </td></tr> <tr><td>732</td> <td class="covered"> $options = array(); </td></tr> <tr><td>733</td> <td class="covered"> $options['type'] = $type; </td></tr> <tr><td>734</td> <td class="normal"> </td></tr> <tr><td>735</td> <td class="covered"> if ( ! isset($args[1])) { </td></tr> <tr><td>736</td> <td class="red"> $args[1] = array(); </td></tr> <tr><td>737</td> <td class="red"> } </td></tr> <tr><td>738</td> <td class="normal"> </td></tr> <tr><td>739</td> <td class="normal"> // the following is needed for backwards compatibility </td></tr> <tr><td>740</td> <td class="covered"> if (is_string($args[1])) { </td></tr> <tr><td>741</td> <td class="covered"> if ( ! isset($args[2])) { </td></tr> <tr><td>742</td> <td class="covered"> $args[2] = array(); </td></tr> <tr><td>743</td> <td class="covered"> } elseif (is_string($args[2])) { </td></tr> <tr><td>744</td> <td class="covered"> $args[2] = (array) $args[2]; </td></tr> <tr><td>745</td> <td class="covered"> } </td></tr> <tr><td>746</td> <td class="normal"> </td></tr> <tr><td>747</td> <td class="covered"> $classes = array_merge($this->_options['parents'], array($this->getComponentName())); </td></tr> <tr><td>748</td> <td class="normal"> </td></tr> <tr><td>749</td> <td class="normal"> </td></tr> <tr><td>750</td> <td class="covered"> $e = explode('.', $args[1]); </td></tr> <tr><td>751</td> <td class="covered"> if (in_array($e[0], $classes)) { </td></tr> <tr><td>752</td> <td class="covered"> if ($options['type'] >= Doctrine_Relation::MANY) { </td></tr> <tr><td>753</td> <td class="covered"> $options['foreign'] = $e[1]; </td></tr> <tr><td>754</td> <td class="covered"> } else { </td></tr> <tr><td>755</td> <td class="covered"> $options['local'] = $e[1]; </td></tr> <tr><td>756</td> <td class="normal"> } </td></tr> <tr><td>757</td> <td class="covered"> } else { </td></tr> <tr><td>758</td> <td class="covered"> $e2 = explode(' as ', $args[0]); </td></tr> <tr><td>759</td> <td class="covered"> if ($e[0] !== $e2[0] && ( ! isset($e2[1]) || $e[0] !== $e2[1])) { </td></tr> <tr><td>760</td> <td class="covered"> $options['refClass'] = $e[0]; </td></tr> <tr><td>761</td> <td class="covered"> } </td></tr> <tr><td>762</td> <td class="normal"> </td></tr> <tr><td>763</td> <td class="covered"> $options['foreign'] = $e[1]; </td></tr> <tr><td>764</td> <td class="normal"> } </td></tr> <tr><td>765</td> <td class="normal"> </td></tr> <tr><td>766</td> <td class="covered"> $options = array_merge($args[2], $options); </td></tr> <tr><td>767</td> <td class="normal"> </td></tr> <tr><td>768</td> <td class="covered"> $this->_parser->bind($args[0], $options); </td></tr> <tr><td>769</td> <td class="covered"> } else { </td></tr> <tr><td>770</td> <td class="covered"> $options = array_merge($args[1], $options); </td></tr> <tr><td>771</td> <td class="covered"> $this->_parser->bind($args[0], $options); </td></tr> <tr><td>772</td> <td class="normal"> } </td></tr> <tr><td>773</td> <td class="covered"> } </td></tr> <tr><td>774</td> <td class="normal"> </td></tr> <tr><td>775</td> <td class="normal"> /** </td></tr> <tr><td>776</td> <td class="normal"> * hasRelation </td></tr> <tr><td>777</td> <td class="normal"> * </td></tr> <tr><td>778</td> <td class="normal"> * @param string $alias the relation to check if exists </td></tr> <tr><td>779</td> <td class="normal"> * @return boolean true if the relation exists otherwise false </td></tr> <tr><td>780</td> <td class="normal"> */ </td></tr> <tr><td>781</td> <td class="normal"> public function hasRelation($alias) </td></tr> <tr><td>782</td> <td class="normal"> { </td></tr> <tr><td>783</td> <td class="covered"> return $this->_parser->hasRelation($alias); </td></tr> <tr><td>784</td> <td class="orange"> } </td></tr> <tr><td>785</td> <td class="normal"> </td></tr> <tr><td>786</td> <td class="normal"> /** </td></tr> <tr><td>787</td> <td class="normal"> * getRelation </td></tr> <tr><td>788</td> <td class="normal"> * </td></tr> <tr><td>789</td> <td class="normal"> * @param string $alias relation alias </td></tr> <tr><td>790</td> <td class="normal"> */ </td></tr> <tr><td>791</td> <td class="normal"> public function getRelation($alias, $recursive = true) </td></tr> <tr><td>792</td> <td class="normal"> { </td></tr> <tr><td>793</td> <td class="covered"> return $this->_parser->getRelation($alias, $recursive); </td></tr> <tr><td>794</td> <td class="orange"> } </td></tr> <tr><td>795</td> <td class="normal"> </td></tr> <tr><td>796</td> <td class="normal"> /** </td></tr> <tr><td>797</td> <td class="normal"> * getRelations </td></tr> <tr><td>798</td> <td class="normal"> * returns an array containing all relation objects </td></tr> <tr><td>799</td> <td class="normal"> * </td></tr> <tr><td>800</td> <td class="normal"> * @return array an array of Doctrine_Relation objects </td></tr> <tr><td>801</td> <td class="normal"> */ </td></tr> <tr><td>802</td> <td class="normal"> public function getRelations() </td></tr> <tr><td>803</td> <td class="normal"> { </td></tr> <tr><td>804</td> <td class="covered"> return $this->_parser->getRelations(); </td></tr> <tr><td>805</td> <td class="orange"> } </td></tr> <tr><td>806</td> <td class="normal"> </td></tr> <tr><td>807</td> <td class="normal"> /** </td></tr> <tr><td>808</td> <td class="normal"> * createQuery </td></tr> <tr><td>809</td> <td class="normal"> * creates a new Doctrine_Query object and adds the component name </td></tr> <tr><td>810</td> <td class="normal"> * of this table as the query 'from' part </td></tr> <tr><td>811</td> <td class="normal"> * </td></tr> <tr><td>812</td> <td class="normal"> * @param string Optional alias name for component aliasing. </td></tr> <tr><td>813</td> <td class="normal"> * </td></tr> <tr><td>814</td> <td class="normal"> * @return Doctrine_Query </td></tr> <tr><td>815</td> <td class="normal"> */ </td></tr> <tr><td>816</td> <td class="normal"> public function createQuery($alias = '') </td></tr> <tr><td>817</td> <td class="normal"> { </td></tr> <tr><td>818</td> <td class="covered"> if ( ! empty($alias)) { </td></tr> <tr><td>819</td> <td class="red"> $alias = ' ' . trim($alias); </td></tr> <tr><td>820</td> <td class="red"> } </td></tr> <tr><td>821</td> <td class="covered"> return Doctrine_Query::create($this->_conn)->from($this->getComponentName() . $alias); </td></tr> <tr><td>822</td> <td class="orange"> } </td></tr> <tr><td>823</td> <td class="normal"> </td></tr> <tr><td>824</td> <td class="normal"> /** </td></tr> <tr><td>825</td> <td class="normal"> * getRepository </td></tr> <tr><td>826</td> <td class="normal"> * </td></tr> <tr><td>827</td> <td class="normal"> * @return Doctrine_Table_Repository </td></tr> <tr><td>828</td> <td class="normal"> */ </td></tr> <tr><td>829</td> <td class="normal"> public function getRepository() </td></tr> <tr><td>830</td> <td class="normal"> { </td></tr> <tr><td>831</td> <td class="covered"> return $this->_repository; </td></tr> <tr><td>832</td> <td class="orange"> } </td></tr> <tr><td>833</td> <td class="normal"> </td></tr> <tr><td>834</td> <td class="normal"> /** </td></tr> <tr><td>835</td> <td class="normal"> * setOption </td></tr> <tr><td>836</td> <td class="normal"> * sets an option and returns this object in order to </td></tr> <tr><td>837</td> <td class="normal"> * allow flexible method chaining </td></tr> <tr><td>838</td> <td class="normal"> * </td></tr> <tr><td>839</td> <td class="normal"> * @see Doctrine_Table::$_options for available options </td></tr> <tr><td>840</td> <td class="normal"> * @param string $name the name of the option to set </td></tr> <tr><td>841</td> <td class="normal"> * @param mixed $value the value of the option </td></tr> <tr><td>842</td> <td class="normal"> * @return Doctrine_Table this object </td></tr> <tr><td>843</td> <td class="normal"> */ </td></tr> <tr><td>844</td> <td class="normal"> public function setOption($name, $value) </td></tr> <tr><td>845</td> <td class="normal"> { </td></tr> <tr><td>846</td> <td class="normal"> switch ($name) { </td></tr> <tr><td>847</td> <td class="covered"> case 'name': </td></tr> <tr><td>848</td> <td class="covered"> case 'tableName': </td></tr> <tr><td>849</td> <td class="covered"> break; </td></tr> <tr><td>850</td> <td class="covered"> case 'enumMap': </td></tr> <tr><td>851</td> <td class="covered"> case 'inheritanceMap': </td></tr> <tr><td>852</td> <td class="covered"> case 'index': </td></tr> <tr><td>853</td> <td class="covered"> case 'treeOptions': </td></tr> <tr><td>854</td> <td class="covered"> if ( ! is_array($value)) { </td></tr> <tr><td>855</td> <td class="red"> throw new Doctrine_Table_Exception($name . ' should be an array.'); </td></tr> <tr><td>856</td> <td class="orange"> } </td></tr> <tr><td>857</td> <td class="covered"> break; </td></tr> <tr><td>858</td> <td class="orange"> } </td></tr> <tr><td>859</td> <td class="covered"> $this->_options[$name] = $value; </td></tr> <tr><td>860</td> <td class="covered"> } </td></tr> <tr><td>861</td> <td class="normal"> </td></tr> <tr><td>862</td> <td class="normal"> /** </td></tr> <tr><td>863</td> <td class="normal"> * getOption </td></tr> <tr><td>864</td> <td class="normal"> * returns the value of given option </td></tr> <tr><td>865</td> <td class="normal"> * </td></tr> <tr><td>866</td> <td class="normal"> * @param string $name the name of the option </td></tr> <tr><td>867</td> <td class="normal"> * @return mixed the value of given option </td></tr> <tr><td>868</td> <td class="normal"> */ </td></tr> <tr><td>869</td> <td class="normal"> public function getOption($name) </td></tr> <tr><td>870</td> <td class="normal"> { </td></tr> <tr><td>871</td> <td class="covered"> if (isset($this->_options[$name])) { </td></tr> <tr><td>872</td> <td class="covered"> return $this->_options[$name]; </td></tr> <tr><td>873</td> <td class="orange"> } </td></tr> <tr><td>874</td> <td class="red"> return null; </td></tr> <tr><td>875</td> <td class="orange"> } </td></tr> <tr><td>876</td> <td class="normal"> </td></tr> <tr><td>877</td> <td class="normal"> /** </td></tr> <tr><td>878</td> <td class="normal"> * getColumnName </td></tr> <tr><td>879</td> <td class="normal"> * </td></tr> <tr><td>880</td> <td class="normal"> * returns a column name for column alias </td></tr> <tr><td>881</td> <td class="normal"> * if the actual name for the alias cannot be found </td></tr> <tr><td>882</td> <td class="normal"> * this method returns the given alias </td></tr> <tr><td>883</td> <td class="normal"> * </td></tr> <tr><td>884</td> <td class="normal"> * @param string $alias column alias </td></tr> <tr><td>885</td> <td class="normal"> * @return string column name </td></tr> <tr><td>886</td> <td class="normal"> */ </td></tr> <tr><td>887</td> <td class="normal"> public function getColumnName($fieldName) </td></tr> <tr><td>888</td> <td class="normal"> { </td></tr> <tr><td>889</td> <td class="covered"> if (isset($this->_columnNames[$fieldName])) { </td></tr> <tr><td>890</td> <td class="covered"> return $this->_columnNames[$fieldName]; </td></tr> <tr><td>891</td> <td class="orange"> } </td></tr> <tr><td>892</td> <td class="covered"> return $fieldName; </td></tr> <tr><td>893</td> <td class="orange"> } </td></tr> <tr><td>894</td> <td class="normal"> </td></tr> <tr><td>895</td> <td class="normal"> /** </td></tr> <tr><td>896</td> <td class="normal"> * </td></tr> <tr><td>897</td> <td class="normal"> * </td></tr> <tr><td>898</td> <td class="normal"> */ </td></tr> <tr><td>899</td> <td class="normal"> public function getColumnDefinition($columnName) </td></tr> <tr><td>900</td> <td class="normal"> { </td></tr> <tr><td>901</td> <td class="covered"> if ( ! isset($this->_columns[$columnName])) { </td></tr> <tr><td>902</td> <td class="covered"> return false; </td></tr> <tr><td>903</td> <td class="orange"> } </td></tr> <tr><td>904</td> <td class="covered"> return $this->_columns[$columnName]; </td></tr> <tr><td>905</td> <td class="orange"> } </td></tr> <tr><td>906</td> <td class="normal"> </td></tr> <tr><td>907</td> <td class="normal"> /** </td></tr> <tr><td>908</td> <td class="normal"> * getColumnAlias </td></tr> <tr><td>909</td> <td class="normal"> * </td></tr> <tr><td>910</td> <td class="normal"> * returns a column alias for a column name </td></tr> <tr><td>911</td> <td class="normal"> * if no alias can be found the column name is returned. </td></tr> <tr><td>912</td> <td class="normal"> * </td></tr> <tr><td>913</td> <td class="normal"> * @param string $columnName column name </td></tr> <tr><td>914</td> <td class="normal"> * @return string column alias </td></tr> <tr><td>915</td> <td class="normal"> */ </td></tr> <tr><td>916</td> <td class="normal"> public function getFieldName($columnName) </td></tr> <tr><td>917</td> <td class="normal"> { </td></tr> <tr><td>918</td> <td class="covered"> if (isset($this->_fieldNames[$columnName])) { </td></tr> <tr><td>919</td> <td class="covered"> return $this->_fieldNames[$columnName]; </td></tr> <tr><td>920</td> <td class="orange"> } </td></tr> <tr><td>921</td> <td class="covered"> return $columnName; </td></tr> <tr><td>922</td> <td class="orange"> } </td></tr> <tr><td>923</td> <td class="normal"> </td></tr> <tr><td>924</td> <td class="normal"> /** </td></tr> <tr><td>925</td> <td class="normal"> * setColumn </td></tr> <tr><td>926</td> <td class="normal"> * </td></tr> <tr><td>927</td> <td class="normal"> * @param string $name </td></tr> <tr><td>928</td> <td class="normal"> * @param string $type </td></tr> <tr><td>929</td> <td class="normal"> * @param integer $length </td></tr> <tr><td>930</td> <td class="normal"> * @param mixed $options </td></tr> <tr><td>931</td> <td class="normal"> * @param boolean $prepend Whether to prepend or append the new column to the column list. </td></tr> <tr><td>932</td> <td class="normal"> * By default the column gets appended. </td></tr> <tr><td>933</td> <td class="normal"> * @throws Doctrine_Table_Exception if trying use wrongly typed parameter </td></tr> <tr><td>934</td> <td class="normal"> * @return void </td></tr> <tr><td>935</td> <td class="normal"> */ </td></tr> <tr><td>936</td> <td class="normal"> public function setColumn($name, $type, $length = null, $options = array(), $prepend = false) </td></tr> <tr><td>937</td> <td class="normal"> { </td></tr> <tr><td>938</td> <td class="covered"> if (is_string($options)) { </td></tr> <tr><td>939</td> <td class="covered"> $options = explode('|', $options); </td></tr> <tr><td>940</td> <td class="covered"> } </td></tr> <tr><td>941</td> <td class="normal"> </td></tr> <tr><td>942</td> <td class="covered"> foreach ($options as $k => $option) { </td></tr> <tr><td>943</td> <td class="covered"> if (is_numeric($k)) { </td></tr> <tr><td>944</td> <td class="covered"> if ( ! empty($option)) { </td></tr> <tr><td>945</td> <td class="covered"> $options[$option] = true; </td></tr> <tr><td>946</td> <td class="covered"> } </td></tr> <tr><td>947</td> <td class="covered"> unset($options[$k]); </td></tr> <tr><td>948</td> <td class="covered"> } </td></tr> <tr><td>949</td> <td class="covered"> } </td></tr> <tr><td>950</td> <td class="normal"> </td></tr> <tr><td>951</td> <td class="normal"> // extract column name & field name </td></tr> <tr><td>952</td> <td class="covered"> $parts = explode(' as ', $name); </td></tr> <tr><td>953</td> <td class="covered"> if (count($parts) > 1) { </td></tr> <tr><td>954</td> <td class="covered"> $fieldName = $parts[1]; </td></tr> <tr><td>955</td> <td class="covered"> } else { </td></tr> <tr><td>956</td> <td class="covered"> $fieldName = $parts[0]; </td></tr> <tr><td>957</td> <td class="normal"> } </td></tr> <tr><td>958</td> <td class="covered"> $name = strtolower($parts[0]); </td></tr> <tr><td>959</td> <td class="covered"> if ($prepend) { </td></tr> <tr><td>960</td> <td class="covered"> $this->_columnNames = array_merge(array($fieldName => $name), $this->_columnNames); </td></tr> <tr><td>961</td> <td class="covered"> $this->_fieldNames = array_merge(array($name => $fieldName), $this->_fieldNames); </td></tr> <tr><td>962</td> <td class="covered"> } else { </td></tr> <tr><td>963</td> <td class="covered"> $this->_columnNames[$fieldName] = $name; </td></tr> <tr><td>964</td> <td class="covered"> $this->_fieldNames[$name] = $fieldName; </td></tr> <tr><td>965</td> <td class="normal"> } </td></tr> <tr><td>966</td> <td class="normal"> </td></tr> <tr><td>967</td> <td class="covered"> if ($length == null) { </td></tr> <tr><td>968</td> <td class="normal"> switch ($type) { </td></tr> <tr><td>969</td> <td class="covered"> case 'string': </td></tr> <tr><td>970</td> <td class="covered"> case 'clob': </td></tr> <tr><td>971</td> <td class="covered"> case 'float': </td></tr> <tr><td>972</td> <td class="covered"> case 'integer': </td></tr> <tr><td>973</td> <td class="covered"> case 'array': </td></tr> <tr><td>974</td> <td class="covered"> case 'object': </td></tr> <tr><td>975</td> <td class="covered"> case 'blob': </td></tr> <tr><td>976</td> <td class="covered"> case 'gzip': </td></tr> <tr><td>977</td> <td class="normal"> // use php int max </td></tr> <tr><td>978</td> <td class="covered"> $length = 2147483647; </td></tr> <tr><td>979</td> <td class="covered"> break; </td></tr> <tr><td>980</td> <td class="covered"> case 'boolean': </td></tr> <tr><td>981</td> <td class="covered"> $length = 1; </td></tr> <tr><td>982</td> <td class="covered"> case 'date': </td></tr> <tr><td>983</td> <td class="normal"> // YYYY-MM-DD ISO 8601 </td></tr> <tr><td>984</td> <td class="covered"> $length = 10; </td></tr> <tr><td>985</td> <td class="covered"> case 'time': </td></tr> <tr><td>986</td> <td class="normal"> // HH:NN:SS+00:00 ISO 8601 </td></tr> <tr><td>987</td> <td class="covered"> $length = 14; </td></tr> <tr><td>988</td> <td class="covered"> case 'timestamp': </td></tr> <tr><td>989</td> <td class="normal"> // YYYY-MM-DDTHH:MM:SS+00:00 ISO 8601 </td></tr> <tr><td>990</td> <td class="covered"> $length = 25; </td></tr> <tr><td>991</td> <td class="covered"> break; </td></tr> <tr><td>992</td> <td class="orange"> } </td></tr> <tr><td>993</td> <td class="covered"> } </td></tr> <tr><td>994</td> <td class="normal"> </td></tr> <tr><td>995</td> <td class="covered"> $options['type'] = $type; </td></tr> <tr><td>996</td> <td class="covered"> $options['length'] = $length; </td></tr> <tr><td>997</td> <td class="normal"> </td></tr> <tr><td>998</td> <td class="covered"> if ($prepend) { </td></tr> <tr><td>999</td> <td class="covered"> $this->_columns = array_merge(array($name => $options), $this->_columns); </td></tr> <tr><td>1000</td> <td class="covered"> } else { </td></tr> <tr><td>1001</td> <td class="covered"> $this->_columns[$name] = $options; </td></tr> <tr><td>1002</td> <td class="normal"> } </td></tr> <tr><td>1003</td> <td class="normal"> </td></tr> <tr><td>1004</td> <td class="covered"> if (isset($options['primary'])) { </td></tr> <tr><td>1005</td> <td class="covered"> if (isset($this->_identifier)) { </td></tr> <tr><td>1006</td> <td class="covered"> $this->_identifier = (array) $this->_identifier; </td></tr> <tr><td>1007</td> <td class="covered"> } </td></tr> <tr><td>1008</td> <td class="covered"> if ( ! in_array($fieldName, $this->_identifier)) { </td></tr> <tr><td>1009</td> <td class="covered"> $this->_identifier[] = $fieldName; </td></tr> <tr><td>1010</td> <td class="covered"> } </td></tr> <tr><td>1011</td> <td class="covered"> } </td></tr> <tr><td>1012</td> <td class="covered"> if (isset($options['default'])) { </td></tr> <tr><td>1013</td> <td class="covered"> $this->hasDefaultValues = true; </td></tr> <tr><td>1014</td> <td class="covered"> } </td></tr> <tr><td>1015</td> <td class="covered"> } </td></tr> <tr><td>1016</td> <td class="normal"> </td></tr> <tr><td>1017</td> <td class="normal"> /** </td></tr> <tr><td>1018</td> <td class="normal"> * hasDefaultValues </td></tr> <tr><td>1019</td> <td class="normal"> * returns true if this table has default values, otherwise false </td></tr> <tr><td>1020</td> <td class="normal"> * </td></tr> <tr><td>1021</td> <td class="normal"> * @return boolean </td></tr> <tr><td>1022</td> <td class="normal"> */ </td></tr> <tr><td>1023</td> <td class="normal"> public function hasDefaultValues() </td></tr> <tr><td>1024</td> <td class="normal"> { </td></tr> <tr><td>1025</td> <td class="covered"> return $this->hasDefaultValues; </td></tr> <tr><td>1026</td> <td class="orange"> } </td></tr> <tr><td>1027</td> <td class="normal"> </td></tr> <tr><td>1028</td> <td class="normal"> /** </td></tr> <tr><td>1029</td> <td class="normal"> * getDefaultValueOf </td></tr> <tr><td>1030</td> <td class="normal"> * returns the default value(if any) for given column </td></tr> <tr><td>1031</td> <td class="normal"> * </td></tr> <tr><td>1032</td> <td class="normal"> * @param string $fieldName </td></tr> <tr><td>1033</td> <td class="normal"> * @return mixed </td></tr> <tr><td>1034</td> <td class="normal"> */ </td></tr> <tr><td>1035</td> <td class="normal"> public function getDefaultValueOf($fieldName) </td></tr> <tr><td>1036</td> <td class="normal"> { </td></tr> <tr><td>1037</td> <td class="covered"> $columnName = $this->getColumnName($fieldName); </td></tr> <tr><td>1038</td> <td class="covered"> if ( ! isset($this->_columns[$columnName])) { </td></tr> <tr><td>1039</td> <td class="red"> throw new Doctrine_Table_Exception("Couldn't get default value. Column ".$columnName." doesn't exist."); </td></tr> <tr><td>1040</td> <td class="orange"> } </td></tr> <tr><td>1041</td> <td class="covered"> if (isset($this->_columns[$columnName]['default'])) { </td></tr> <tr><td>1042</td> <td class="covered"> return $this->_columns[$columnName]['default']; </td></tr> <tr><td>1043</td> <td class="orange"> } else { </td></tr> <tr><td>1044</td> <td class="covered"> return null; </td></tr> <tr><td>1045</td> <td class="normal"> } </td></tr> <tr><td>1046</td> <td class="orange"> } </td></tr> <tr><td>1047</td> <td class="normal"> </td></tr> <tr><td>1048</td> <td class="normal"> /** </td></tr> <tr><td>1049</td> <td class="normal"> * @return mixed </td></tr> <tr><td>1050</td> <td class="normal"> */ </td></tr> <tr><td>1051</td> <td class="normal"> public function getIdentifier() </td></tr> <tr><td>1052</td> <td class="normal"> { </td></tr> <tr><td>1053</td> <td class="covered"> return $this->_identifier; </td></tr> <tr><td>1054</td> <td class="orange"> } </td></tr> <tr><td>1055</td> <td class="normal"> </td></tr> <tr><td>1056</td> <td class="normal"> /** </td></tr> <tr><td>1057</td> <td class="normal"> * @return integer </td></tr> <tr><td>1058</td> <td class="normal"> */ </td></tr> <tr><td>1059</td> <td class="normal"> public function getIdentifierType() </td></tr> <tr><td>1060</td> <td class="normal"> { </td></tr> <tr><td>1061</td> <td class="covered"> return $this->_identifierType; </td></tr> <tr><td>1062</td> <td class="orange"> } </td></tr> <tr><td>1063</td> <td class="normal"> </td></tr> <tr><td>1064</td> <td class="normal"> /** </td></tr> <tr><td>1065</td> <td class="normal"> * hasColumn </td></tr> <tr><td>1066</td> <td class="normal"> * @return boolean </td></tr> <tr><td>1067</td> <td class="normal"> */ </td></tr> <tr><td>1068</td> <td class="normal"> public function hasColumn($columnName) </td></tr> <tr><td>1069</td> <td class="normal"> { </td></tr> <tr><td>1070</td> <td class="covered"> return isset($this->_columns[$columnName]); </td></tr> <tr><td>1071</td> <td class="orange"> } </td></tr> <tr><td>1072</td> <td class="normal"> </td></tr> <tr><td>1073</td> <td class="normal"> /** </td></tr> <tr><td>1074</td> <td class="normal"> * sets the connection for this class </td></tr> <tr><td>1075</td> <td class="normal"> * </td></tr> <tr><td>1076</td> <td class="normal"> * @params Doctrine_Connection a connection object </td></tr> <tr><td>1077</td> <td class="normal"> * @return Doctrine_Table this object </td></tr> <tr><td>1078</td> <td class="normal"> */ </td></tr> <tr><td>1079</td> <td class="normal"> public function setConnection(Doctrine_Connection $conn) </td></tr> <tr><td>1080</td> <td class="normal"> { </td></tr> <tr><td>1081</td> <td class="red"> $this->_conn = $conn; </td></tr> <tr><td>1082</td> <td class="normal"> </td></tr> <tr><td>1083</td> <td class="red"> $this->setParent($this->_conn); </td></tr> <tr><td>1084</td> <td class="normal"> </td></tr> <tr><td>1085</td> <td class="red"> return $this; </td></tr> <tr><td>1086</td> <td class="orange"> } </td></tr> <tr><td>1087</td> <td class="normal"> </td></tr> <tr><td>1088</td> <td class="normal"> /** </td></tr> <tr><td>1089</td> <td class="normal"> * returns the connection associated with this table (if any) </td></tr> <tr><td>1090</td> <td class="normal"> * </td></tr> <tr><td>1091</td> <td class="normal"> * @return Doctrine_Connection|null the connection object </td></tr> <tr><td>1092</td> <td class="normal"> */ </td></tr> <tr><td>1093</td> <td class="normal"> public function getConnection() </td></tr> <tr><td>1094</td> <td class="normal"> { </td></tr> <tr><td>1095</td> <td class="covered"> return $this->_conn; </td></tr> <tr><td>1096</td> <td class="orange"> } </td></tr> <tr><td>1097</td> <td class="normal"> </td></tr> <tr><td>1098</td> <td class="normal"> /** </td></tr> <tr><td>1099</td> <td class="normal"> * creates a new record </td></tr> <tr><td>1100</td> <td class="normal"> * </td></tr> <tr><td>1101</td> <td class="normal"> * @param $array an array where keys are field names and </td></tr> <tr><td>1102</td> <td class="normal"> * values representing field values </td></tr> <tr><td>1103</td> <td class="normal"> * @return Doctrine_Record the created record object </td></tr> <tr><td>1104</td> <td class="normal"> */ </td></tr> <tr><td>1105</td> <td class="normal"> public function create(array $array = array()) </td></tr> <tr><td>1106</td> <td class="normal"> { </td></tr> <tr><td>1107</td> <td class="covered"> $record = new $this->_options['name']($this, true); </td></tr> <tr><td>1108</td> <td class="covered"> $record->fromArray($array); </td></tr> <tr><td>1109</td> <td class="normal"> </td></tr> <tr><td>1110</td> <td class="covered"> return $record; </td></tr> <tr><td>1111</td> <td class="orange"> } </td></tr> <tr><td>1112</td> <td class="normal"> </td></tr> <tr><td>1113</td> <td class="normal"> /** </td></tr> <tr><td>1114</td> <td class="normal"> * finds a record by its identifier </td></tr> <tr><td>1115</td> <td class="normal"> * </td></tr> <tr><td>1116</td> <td class="normal"> * @param $id database row id </td></tr> <tr><td>1117</td> <td class="normal"> * @param int $hydrationMode Doctrine::HYDRATE_ARRAY or Doctrine::HYDRATE_RECORD </td></tr> <tr><td>1118</td> <td class="normal"> * @return mixed Array or Doctrine_Record or false if no result </td></tr> <tr><td>1119</td> <td class="normal"> */ </td></tr> <tr><td>1120</td> <td class="normal"> public function find($id, $hydrationMode = null) </td></tr> <tr><td>1121</td> <td class="normal"> { </td></tr> <tr><td>1122</td> <td class="covered"> if (is_null($id)) { </td></tr> <tr><td>1123</td> <td class="covered"> return false; </td></tr> <tr><td>1124</td> <td class="orange"> } </td></tr> <tr><td>1125</td> <td class="normal"> </td></tr> <tr><td>1126</td> <td class="covered"> $id = is_array($id) ? array_values($id) : array($id); </td></tr> <tr><td>1127</td> <td class="normal"> </td></tr> <tr><td>1128</td> <td class="covered"> return $this->createQuery() </td></tr> <tr><td>1129</td> <td class="covered"> ->where(implode(' = ? AND ', $this->getIdentifierColumnNames()) . ' = ?') </td></tr> <tr><td>1130</td> <td class="covered"> ->fetchOne($id, $hydrationMode); </td></tr> <tr><td>1131</td> <td class="orange"> } </td></tr> <tr><td>1132</td> <td class="normal"> </td></tr> <tr><td>1133</td> <td class="normal"> /** </td></tr> <tr><td>1134</td> <td class="normal"> * findAll </td></tr> <tr><td>1135</td> <td class="normal"> * returns a collection of records </td></tr> <tr><td>1136</td> <td class="normal"> * </td></tr> <tr><td>1137</td> <td class="normal"> * @param int $hydrationMode Doctrine::FETCH_ARRAY or Doctrine::FETCH_RECORD </td></tr> <tr><td>1138</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>1139</td> <td class="normal"> */ </td></tr> <tr><td>1140</td> <td class="normal"> public function findAll($hydrationMode = null) </td></tr> <tr><td>1141</td> <td class="normal"> { </td></tr> <tr><td>1142</td> <td class="covered"> return $this->createQuery()->execute(array(), $hydrationMode); </td></tr> <tr><td>1143</td> <td class="orange"> } </td></tr> <tr><td>1144</td> <td class="normal"> </td></tr> <tr><td>1145</td> <td class="normal"> /** </td></tr> <tr><td>1146</td> <td class="normal"> * findByDql </td></tr> <tr><td>1147</td> <td class="normal"> * finds records with given DQL where clause </td></tr> <tr><td>1148</td> <td class="normal"> * returns a collection of records </td></tr> <tr><td>1149</td> <td class="normal"> * </td></tr> <tr><td>1150</td> <td class="normal"> * @param string $dql DQL after WHERE clause </td></tr> <tr><td>1151</td> <td class="normal"> * @param array $params query parameters </td></tr> <tr><td>1152</td> <td class="normal"> * @param int $hydrationMode Doctrine::FETCH_ARRAY or Doctrine::FETCH_RECORD </td></tr> <tr><td>1153</td> <td class="normal"> * @return Doctrine_Collection </td></tr> <tr><td>1154</td> <td class="normal"> */ </td></tr> <tr><td>1155</td> <td class="normal"> public function findBySql($dql, array $params = array(), $hydrationMode = null) </td></tr> <tr><td>1156</td> <td class="normal"> { </td></tr> <tr><td>1157</td> <td class="covered"> return $this->createQuery()->where($dql)->execute($params, $hydrationMode); </td></tr> <tr><td>1158</td> <td class="orange"> } </td></tr> <tr><td>1159</td> <td class="normal"> </td></tr> <tr><td>1160</td> <td class="normal"> public function findByDql($dql, array $params = array(), $hydrationMode = null) </td></tr> <tr><td>1161</td> <td class="normal"> { </td></tr> <tr><td>1162</td> <td class="covered"> return $this->findBySql($dql, $params, $hydrationMode); </td></tr> <tr><td>1163</td> <td class="orange"> } </td></tr> <tr><td>1164</td> <td class="normal"> </td></tr> <tr><td>1165</td> <td class="normal"> /** </td></tr> <tr><td>1166</td> <td class="normal"> * execute </td></tr> <tr><td>1167</td> <td class="normal"> * fetches data using the provided queryKey and </td></tr> <tr><td>1168</td> <td class="normal"> * the associated query in the query registry </td></tr> <tr><td>1169</td> <td class="normal"> * </td></tr> <tr><td>1170</td> <td class="normal"> * if no query for given queryKey is being found a </td></tr> <tr><td>1171</td> <td class="normal"> * Doctrine_Query_Registry exception is being thrown </td></tr> <tr><td>1172</td> <td class="normal"> * </td></tr> <tr><td>1173</td> <td class="normal"> * @param string $queryKey the query key </td></tr> <tr><td>1174</td> <td class="normal"> * @param array $params prepared statement params (if any) </td></tr> <tr><td>1175</td> <td class="normal"> * @return mixed the fetched data </td></tr> <tr><td>1176</td> <td class="normal"> */ </td></tr> <tr><td>1177</td> <td class="normal"> public function execute($queryKey, $params = array(), $hydrationMode = Doctrine::HYDRATE_RECORD) </td></tr> <tr><td>1178</td> <td class="normal"> { </td></tr> <tr><td>1179</td> <td class="covered"> return Doctrine_Manager::getInstance() </td></tr> <tr><td>1180</td> <td class="covered"> ->getQueryRegistry() </td></tr> <tr><td>1181</td> <td class="covered"> ->get($queryKey, $this->getComponentName()) </td></tr> <tr><td>1182</td> <td class="covered"> ->execute($params, $hydrationMode); </td></tr> <tr><td>1183</td> <td class="orange"> } </td></tr> <tr><td>1184</td> <td class="normal"> </td></tr> <tr><td>1185</td> <td class="normal"> /** </td></tr> <tr><td>1186</td> <td class="normal"> * executeOne </td></tr> <tr><td>1187</td> <td class="normal"> * fetches data using the provided queryKey and </td></tr> <tr><td>1188</td> <td class="normal"> * the associated query in the query registry </td></tr> <tr><td>1189</td> <td class="normal"> * </td></tr> <tr><td>1190</td> <td class="normal"> * if no query for given queryKey is being found a </td></tr> <tr><td>1191</td> <td class="normal"> * Doctrine_Query_Registry exception is being thrown </td></tr> <tr><td>1192</td> <td class="normal"> * </td></tr> <tr><td>1193</td> <td class="normal"> * @param string $queryKey the query key </td></tr> <tr><td>1194</td> <td class="normal"> * @param array $params prepared statement params (if any) </td></tr> <tr><td>1195</td> <td class="normal"> * @return mixed the fetched data </td></tr> <tr><td>1196</td> <td class="normal"> */ </td></tr> <tr><td>1197</td> <td class="normal"> public function executeOne($queryKey, $params = array(), $hydrationMode = Doctrine::HYDRATE_RECORD) </td></tr> <tr><td>1198</td> <td class="normal"> { </td></tr> <tr><td>1199</td> <td class="red"> return Doctrine_Manager::getInstance() </td></tr> <tr><td>1200</td> <td class="red"> ->getQueryRegistry() </td></tr> <tr><td>1201</td> <td class="red"> ->get($queryKey, $this->getComponentName()) </td></tr> <tr><td>1202</td> <td class="red"> ->fetchOne($params, $hydrationMode); </td></tr> <tr><td>1203</td> <td class="orange"> } </td></tr> <tr><td>1204</td> <td class="normal"> </td></tr> <tr><td>1205</td> <td class="normal"> /** </td></tr> <tr><td>1206</td> <td class="normal"> * clear </td></tr> <tr><td>1207</td> <td class="normal"> * clears the first level cache (identityMap) </td></tr> <tr><td>1208</td> <td class="normal"> * </td></tr> <tr><td>1209</td> <td class="normal"> * @return void </td></tr> <tr><td>1210</td> <td class="normal"> * @todo what about a more descriptive name? clearIdentityMap? </td></tr> <tr><td>1211</td> <td class="normal"> */ </td></tr> <tr><td>1212</td> <td class="normal"> public function clear() </td></tr> <tr><td>1213</td> <td class="normal"> { </td></tr> <tr><td>1214</td> <td class="covered"> $this->_identityMap = array(); </td></tr> <tr><td>1215</td> <td class="covered"> } </td></tr> <tr><td>1216</td> <td class="normal"> </td></tr> <tr><td>1217</td> <td class="normal"> /** </td></tr> <tr><td>1218</td> <td class="normal"> * addRecord </td></tr> <tr><td>1219</td> <td class="normal"> * adds a record to identity map </td></tr> <tr><td>1220</td> <td class="normal"> * </td></tr> <tr><td>1221</td> <td class="normal"> * @param Doctrine_Record $record record to be added </td></tr> <tr><td>1222</td> <td class="normal"> * @return boolean </td></tr> <tr><td>1223</td> <td class="normal"> * @todo Better name? registerRecord? </td></tr> <tr><td>1224</td> <td class="normal"> */ </td></tr> <tr><td>1225</td> <td class="normal"> public function addRecord(Doctrine_Record $record) </td></tr> <tr><td>1226</td> <td class="normal"> { </td></tr> <tr><td>1227</td> <td class="covered"> $id = implode(' ', $record->identifier()); </td></tr> <tr><td>1228</td> <td class="normal"> </td></tr> <tr><td>1229</td> <td class="covered"> if (isset($this->_identityMap[$id])) { </td></tr> <tr><td>1230</td> <td class="red"> return false; </td></tr> <tr><td>1231</td> <td class="orange"> } </td></tr> <tr><td>1232</td> <td class="normal"> </td></tr> <tr><td>1233</td> <td class="covered"> $this->_identityMap[$id] = $record; </td></tr> <tr><td>1234</td> <td class="normal"> </td></tr> <tr><td>1235</td> <td class="covered"> return true; </td></tr> <tr><td>1236</td> <td class="orange"> } </td></tr> <tr><td>1237</td> <td class="normal"> </td></tr> <tr><td>1238</td> <td class="normal"> /** </td></tr> <tr><td>1239</td> <td class="normal"> * removeRecord </td></tr> <tr><td>1240</td> <td class="normal"> * removes a record from the identity map, returning true if the record </td></tr> <tr><td>1241</td> <td class="normal"> * was found and removed and false if the record wasn't found. </td></tr> <tr><td>1242</td> <td class="normal"> * </td></tr> <tr><td>1243</td> <td class="normal"> * @param Doctrine_Record $record record to be removed </td></tr> <tr><td>1244</td> <td class="normal"> * @return boolean </td></tr> <tr><td>1245</td> <td class="normal"> */ </td></tr> <tr><td>1246</td> <td class="normal"> public function removeRecord(Doctrine_Record $record) </td></tr> <tr><td>1247</td> <td class="normal"> { </td></tr> <tr><td>1248</td> <td class="covered"> $id = implode(' ', $record->identifier()); </td></tr> <tr><td>1249</td> <td class="normal"> </td></tr> <tr><td>1250</td> <td class="covered"> if (isset($this->_identityMap[$id])) { </td></tr> <tr><td>1251</td> <td class="covered"> unset($this->_identityMap[$id]); </td></tr> <tr><td>1252</td> <td class="covered"> return true; </td></tr> <tr><td>1253</td> <td class="orange"> } </td></tr> <tr><td>1254</td> <td class="normal"> </td></tr> <tr><td>1255</td> <td class="red"> return false; </td></tr> <tr><td>1256</td> <td class="orange"> } </td></tr> <tr><td>1257</td> <td class="normal"> </td></tr> <tr><td>1258</td> <td class="normal"> /** </td></tr> <tr><td>1259</td> <td class="normal"> * getRecord </td></tr> <tr><td>1260</td> <td class="normal"> * first checks if record exists in identityMap, if not </td></tr> <tr><td>1261</td> <td class="normal"> * returns a new record </td></tr> <tr><td>1262</td> <td class="normal"> * </td></tr> <tr><td>1263</td> <td class="normal"> * @return Doctrine_Record </td></tr> <tr><td>1264</td> <td class="normal"> */ </td></tr> <tr><td>1265</td> <td class="normal"> public function getRecord() </td></tr> <tr><td>1266</td> <td class="normal"> { </td></tr> <tr><td>1267</td> <td class="covered"> if ( ! empty($this->_data)) { </td></tr> <tr><td>1268</td> <td class="normal"> </td></tr> <tr><td>1269</td> <td class="covered"> $identifierFieldNames = $this->getIdentifier(); </td></tr> <tr><td>1270</td> <td class="normal"> </td></tr> <tr><td>1271</td> <td class="covered"> if ( ! is_array($identifierFieldNames)) { </td></tr> <tr><td>1272</td> <td class="covered"> $identifierFieldNames = array($identifierFieldNames); </td></tr> <tr><td>1273</td> <td class="covered"> } </td></tr> <tr><td>1274</td> <td class="normal"> </td></tr> <tr><td>1275</td> <td class="covered"> $found = false; </td></tr> <tr><td>1276</td> <td class="covered"> foreach ($identifierFieldNames as $fieldName) { </td></tr> <tr><td>1277</td> <td class="covered"> if ( ! isset($this->_data[$fieldName])) { </td></tr> <tr><td>1278</td> <td class="normal"> // primary key column not found return new record </td></tr> <tr><td>1279</td> <td class="covered"> $found = true; </td></tr> <tr><td>1280</td> <td class="covered"> break; </td></tr> <tr><td>1281</td> <td class="orange"> } </td></tr> <tr><td>1282</td> <td class="covered"> $id[] = $this->_data[$fieldName]; </td></tr> <tr><td>1283</td> <td class="covered"> } </td></tr> <tr><td>1284</td> <td class="normal"> </td></tr> <tr><td>1285</td> <td class="covered"> if ($found) { </td></tr> <tr><td>1286</td> <td class="covered"> $recordName = $this->getClassnameToReturn(); </td></tr> <tr><td>1287</td> <td class="covered"> $record = new $recordName($this, true); </td></tr> <tr><td>1288</td> <td class="covered"> $this->_data = array(); </td></tr> <tr><td>1289</td> <td class="covered"> return $record; </td></tr> <tr><td>1290</td> <td class="orange"> } </td></tr> <tr><td>1291</td> <td class="normal"> </td></tr> <tr><td>1292</td> <td class="normal"> </td></tr> <tr><td>1293</td> <td class="covered"> $id = implode(' ', $id); </td></tr> <tr><td>1294</td> <td class="normal"> </td></tr> <tr><td>1295</td> <td class="covered"> if (isset($this->_identityMap[$id])) { </td></tr> <tr><td>1296</td> <td class="covered"> $record = $this->_identityMap[$id]; </td></tr> <tr><td>1297</td> <td class="covered"> $record->hydrate($this->_data); </td></tr> <tr><td>1298</td> <td class="covered"> } else { </td></tr> <tr><td>1299</td> <td class="covered"> $recordName = $this->getClassnameToReturn(); </td></tr> <tr><td>1300</td> <td class="covered"> $record = new $recordName($this); </td></tr> <tr><td>1301</td> <td class="covered"> $this->_identityMap[$id] = $record; </td></tr> <tr><td>1302</td> <td class="normal"> } </td></tr> <tr><td>1303</td> <td class="covered"> $this->_data = array(); </td></tr> <tr><td>1304</td> <td class="covered"> } else { </td></tr> <tr><td>1305</td> <td class="red"> $recordName = $this->getClassnameToReturn(); </td></tr> <tr><td>1306</td> <td class="red"> $record = new $recordName($this, true); </td></tr> <tr><td>1307</td> <td class="normal"> } </td></tr> <tr><td>1308</td> <td class="normal"> </td></tr> <tr><td>1309</td> <td class="covered"> return $record; </td></tr> <tr><td>1310</td> <td class="orange"> } </td></tr> <tr><td>1311</td> <td class="normal"> </td></tr> <tr><td>1312</td> <td class="normal"> /** </td></tr> <tr><td>1313</td> <td class="normal"> * Get the classname to return. Most often this is just the options['name'] </td></tr> <tr><td>1314</td> <td class="normal"> * </td></tr> <tr><td>1315</td> <td class="normal"> * Check the subclasses option and the inheritanceMap for each subclass to see </td></tr> <tr><td>1316</td> <td class="normal"> * if all the maps in a subclass is met. If this is the case return that </td></tr> <tr><td>1317</td> <td class="normal"> * subclass name. If no subclasses match or if there are no subclasses defined </td></tr> <tr><td>1318</td> <td class="normal"> * return the name of the class for this tables record. </td></tr> <tr><td>1319</td> <td class="normal"> * </td></tr> <tr><td>1320</td> <td class="normal"> * @todo this function could use reflection to check the first time it runs </td></tr> <tr><td>1321</td> <td class="normal"> * if the subclassing option is not set. </td></tr> <tr><td>1322</td> <td class="normal"> * </td></tr> <tr><td>1323</td> <td class="normal"> * @return string The name of the class to create </td></tr> <tr><td>1324</td> <td class="normal"> * </td></tr> <tr><td>1325</td> <td class="normal"> */ </td></tr> <tr><td>1326</td> <td class="normal"> public function getClassnameToReturn() </td></tr> <tr><td>1327</td> <td class="normal"> { </td></tr> <tr><td>1328</td> <td class="covered"> if ( ! isset($this->_options['subclasses'])) { </td></tr> <tr><td>1329</td> <td class="covered"> return $this->_options['name']; </td></tr> <tr><td>1330</td> <td class="orange"> } </td></tr> <tr><td>1331</td> <td class="covered"> foreach ($this->_options['subclasses'] as $subclass) { </td></tr> <tr><td>1332</td> <td class="covered"> $table = $this->_conn->getTable($subclass); </td></tr> <tr><td>1333</td> <td class="covered"> $inheritanceMap = $table->getOption('inheritanceMap'); </td></tr> <tr><td>1334</td> <td class="covered"> $nomatch = false; </td></tr> <tr><td>1335</td> <td class="covered"> foreach ($inheritanceMap as $key => $value) { </td></tr> <tr><td>1336</td> <td class="covered"> if ( ! isset($this->_data[$key]) || $this->_data[$key] != $value) { </td></tr> <tr><td>1337</td> <td class="covered"> $nomatch = true; </td></tr> <tr><td>1338</td> <td class="covered"> break; </td></tr> <tr><td>1339</td> <td class="orange"> } </td></tr> <tr><td>1340</td> <td class="covered"> } </td></tr> <tr><td>1341</td> <td class="covered"> if ( ! $nomatch) { </td></tr> <tr><td>1342</td> <td class="covered"> return $table->getComponentName(); </td></tr> <tr><td>1343</td> <td class="orange"> } </td></tr> <tr><td>1344</td> <td class="covered"> } </td></tr> <tr><td>1345</td> <td class="covered"> return $this->_options['name']; </td></tr> <tr><td>1346</td> <td class="orange"> } </td></tr> <tr><td>1347</td> <td class="normal"> </td></tr> <tr><td>1348</td> <td class="normal"> /** </td></tr> <tr><td>1349</td> <td class="normal"> * @param $id database row id </td></tr> <tr><td>1350</td> <td class="normal"> * @throws Doctrine_Find_Exception </td></tr> <tr><td>1351</td> <td class="normal"> */ </td></tr> <tr><td>1352</td> <td class="normal"> final public function getProxy($id = null) </td></tr> <tr><td>1353</td> <td class="normal"> { </td></tr> <tr><td>1354</td> <td class="covered"> if ($id !== null) { </td></tr> <tr><td>1355</td> <td class="covered"> $identifierColumnNames = $this->getIdentifierColumnNames(); </td></tr> <tr><td>1356</td> <td class="covered"> $query = 'SELECT ' . implode(', ', (array) $identifierColumnNames) </td></tr> <tr><td>1357</td> <td class="covered"> . ' FROM ' . $this->getTableName() </td></tr> <tr><td>1358</td> <td class="covered"> . ' WHERE ' . implode(' = ? && ', (array) $identifierColumnNames) . ' = ?'; </td></tr> <tr><td>1359</td> <td class="covered"> $query = $this->applyInheritance($query); </td></tr> <tr><td>1360</td> <td class="normal"> </td></tr> <tr><td>1361</td> <td class="covered"> $params = array_merge(array($id), array_values($this->_options['inheritanceMap'])); </td></tr> <tr><td>1362</td> <td class="normal"> </td></tr> <tr><td>1363</td> <td class="covered"> $this->_data = $this->_conn->execute($query, $params)->fetch(PDO::FETCH_ASSOC); </td></tr> <tr><td>1364</td> <td class="normal"> </td></tr> <tr><td>1365</td> <td class="covered"> if ($this->_data === false) </td></tr> <tr><td>1366</td> <td class="covered"> return false; </td></tr> <tr><td>1367</td> <td class="covered"> } </td></tr> <tr><td>1368</td> <td class="covered"> return $this->getRecord(); </td></tr> <tr><td>1369</td> <td class="orange"> } </td></tr> <tr><td>1370</td> <td class="normal"> </td></tr> <tr><td>1371</td> <td class="normal"> /** </td></tr> <tr><td>1372</td> <td class="normal"> * applyInheritance </td></tr> <tr><td>1373</td> <td class="normal"> * @param $where query where part to be modified </td></tr> <tr><td>1374</td> <td class="normal"> * @return string query where part with column aggregation inheritance added </td></tr> <tr><td>1375</td> <td class="normal"> */ </td></tr> <tr><td>1376</td> <td class="normal"> final public function applyInheritance($where) </td></tr> <tr><td>1377</td> <td class="normal"> { </td></tr> <tr><td>1378</td> <td class="covered"> if ( ! empty($this->_options['inheritanceMap'])) { </td></tr> <tr><td>1379</td> <td class="covered"> $a = array(); </td></tr> <tr><td>1380</td> <td class="covered"> foreach ($this->_options['inheritanceMap'] as $field => $value) { </td></tr> <tr><td>1381</td> <td class="covered"> $a[] = $this->getColumnName($field) . ' = ?'; </td></tr> <tr><td>1382</td> <td class="covered"> } </td></tr> <tr><td>1383</td> <td class="covered"> $i = implode(' AND ', $a); </td></tr> <tr><td>1384</td> <td class="covered"> $where .= ' AND ' . $i; </td></tr> <tr><td>1385</td> <td class="covered"> } </td></tr> <tr><td>1386</td> <td class="covered"> return $where; </td></tr> <tr><td>1387</td> <td class="orange"> } </td></tr> <tr><td>1388</td> <td class="normal"> </td></tr> <tr><td>1389</td> <td class="normal"> /** </td></tr> <tr><td>1390</td> <td class="normal"> * count </td></tr> <tr><td>1391</td> <td class="normal"> * </td></tr> <tr><td>1392</td> <td class="normal"> * @return integer </td></tr> <tr><td>1393</td> <td class="normal"> */ </td></tr> <tr><td>1394</td> <td class="normal"> public function count() </td></tr> <tr><td>1395</td> <td class="normal"> { </td></tr> <tr><td>1396</td> <td class="red"> $a = $this->_conn->execute('SELECT COUNT(1) FROM ' . $this->_options['tableName'])->fetch(Doctrine::FETCH_NUM); </td></tr> <tr><td>1397</td> <td class="red"> return current($a); </td></tr> <tr><td>1398</td> <td class="orange"> } </td></tr> <tr><td>1399</td> <td class="normal"> </td></tr> <tr><td>1400</td> <td class="normal"> /** </td></tr> <tr><td>1401</td> <td class="normal"> * @return Doctrine_Query a Doctrine_Query object </td></tr> <tr><td>1402</td> <td class="normal"> */ </td></tr> <tr><td>1403</td> <td class="normal"> public function getQueryObject() </td></tr> <tr><td>1404</td> <td class="normal"> { </td></tr> <tr><td>1405</td> <td class="red"> $graph = new Doctrine_Query($this->getConnection()); </td></tr> <tr><td>1406</td> <td class="red"> $graph->load($this->getComponentName()); </td></tr> <tr><td>1407</td> <td class="red"> return $graph; </td></tr> <tr><td>1408</td> <td class="orange"> } </td></tr> <tr><td>1409</td> <td class="normal"> </td></tr> <tr><td>1410</td> <td class="normal"> /** </td></tr> <tr><td>1411</td> <td class="normal"> * @param string $fieldName </td></tr> <tr><td>1412</td> <td class="normal"> * @return array </td></tr> <tr><td>1413</td> <td class="normal"> */ </td></tr> <tr><td>1414</td> <td class="normal"> public function getEnumValues($fieldName) </td></tr> <tr><td>1415</td> <td class="normal"> { </td></tr> <tr><td>1416</td> <td class="covered"> $columnName = $this->getColumnName($fieldName); </td></tr> <tr><td>1417</td> <td class="covered"> if (isset($this->_columns[$columnName]['values'])) { </td></tr> <tr><td>1418</td> <td class="covered"> return $this->_columns[$columnName]['values']; </td></tr> <tr><td>1419</td> <td class="orange"> } else { </td></tr> <tr><td>1420</td> <td class="covered"> return array(); </td></tr> <tr><td>1421</td> <td class="normal"> } </td></tr> <tr><td>1422</td> <td class="orange"> } </td></tr> <tr><td>1423</td> <td class="normal"> </td></tr> <tr><td>1424</td> <td class="normal"> /** </td></tr> <tr><td>1425</td> <td class="normal"> * enumValue </td></tr> <tr><td>1426</td> <td class="normal"> * </td></tr> <tr><td>1427</td> <td class="normal"> * @param string $field </td></tr> <tr><td>1428</td> <td class="normal"> * @param integer $index </td></tr> <tr><td>1429</td> <td class="normal"> * @return mixed </td></tr> <tr><td>1430</td> <td class="normal"> */ </td></tr> <tr><td>1431</td> <td class="normal"> public function enumValue($fieldName, $index) </td></tr> <tr><td>1432</td> <td class="normal"> { </td></tr> <tr><td>1433</td> <td class="covered"> if ($index instanceof Doctrine_Null) { </td></tr> <tr><td>1434</td> <td class="red"> return $index; </td></tr> <tr><td>1435</td> <td class="orange"> } </td></tr> <tr><td>1436</td> <td class="normal"> </td></tr> <tr><td>1437</td> <td class="covered"> $columnName = $this->getColumnName($fieldName); </td></tr> <tr><td>1438</td> <td class="covered"> if ( ! $this->_conn->getAttribute(Doctrine::ATTR_USE_NATIVE_ENUM) </td></tr> <tr><td>1439</td> <td class="red"> && isset($this->_columns[$columnName]['values'][$index]) </td></tr> <tr><td>1440</td> <td class="covered"> ) { </td></tr> <tr><td>1441</td> <td class="covered"> return $this->_columns[$columnName]['values'][$index]; </td></tr> <tr><td>1442</td> <td class="orange"> } </td></tr> <tr><td>1443</td> <td class="normal"> </td></tr> <tr><td>1444</td> <td class="red"> return $index; </td></tr> <tr><td>1445</td> <td class="orange"> } </td></tr> <tr><td>1446</td> <td class="normal"> </td></tr> <tr><td>1447</td> <td class="normal"> /** </td></tr> <tr><td>1448</td> <td class="normal"> * enumIndex </td></tr> <tr><td>1449</td> <td class="normal"> * </td></tr> <tr><td>1450</td> <td class="normal"> * @param string $field </td></tr> <tr><td>1451</td> <td class="normal"> * @param mixed $value </td></tr> <tr><td>1452</td> <td class="normal"> * @return mixed </td></tr> <tr><td>1453</td> <td class="normal"> */ </td></tr> <tr><td>1454</td> <td class="normal"> public function enumIndex($fieldName, $value) </td></tr> <tr><td>1455</td> <td class="normal"> { </td></tr> <tr><td>1456</td> <td class="covered"> $values = $this->getEnumValues($fieldName); </td></tr> <tr><td>1457</td> <td class="normal"> </td></tr> <tr><td>1458</td> <td class="covered"> $index = array_search($value, $values); </td></tr> <tr><td>1459</td> <td class="covered"> if ($index === false || !$this->_conn->getAttribute(Doctrine::ATTR_USE_NATIVE_ENUM)) { </td></tr> <tr><td>1460</td> <td class="covered"> return $index; </td></tr> <tr><td>1461</td> <td class="orange"> } </td></tr> <tr><td>1462</td> <td class="red"> return $value; </td></tr> <tr><td>1463</td> <td class="orange"> } </td></tr> <tr><td>1464</td> <td class="normal"> </td></tr> <tr><td>1465</td> <td class="normal"> /** </td></tr> <tr><td>1466</td> <td class="normal"> * getColumnCount </td></tr> <tr><td>1467</td> <td class="normal"> * </td></tr> <tr><td>1468</td> <td class="normal"> * @return integer the number of columns in this table </td></tr> <tr><td>1469</td> <td class="normal"> */ </td></tr> <tr><td>1470</td> <td class="normal"> public function getColumnCount() </td></tr> <tr><td>1471</td> <td class="normal"> { </td></tr> <tr><td>1472</td> <td class="covered"> return $this->columnCount; </td></tr> <tr><td>1473</td> <td class="orange"> } </td></tr> <tr><td>1474</td> <td class="normal"> </td></tr> <tr><td>1475</td> <td class="normal"> /** </td></tr> <tr><td>1476</td> <td class="normal"> * returns all columns and their definitions </td></tr> <tr><td>1477</td> <td class="normal"> * </td></tr> <tr><td>1478</td> <td class="normal"> * @return array </td></tr> <tr><td>1479</td> <td class="normal"> */ </td></tr> <tr><td>1480</td> <td class="normal"> public function getColumns() </td></tr> <tr><td>1481</td> <td class="normal"> { </td></tr> <tr><td>1482</td> <td class="covered"> return $this->_columns; </td></tr> <tr><td>1483</td> <td class="orange"> } </td></tr> <tr><td>1484</td> <td class="normal"> </td></tr> <tr><td>1485</td> <td class="normal"> /** </td></tr> <tr><td>1486</td> <td class="normal"> * removeColumn </td></tr> <tr><td>1487</td> <td class="normal"> * removes given column </td></tr> <tr><td>1488</td> <td class="normal"> * </td></tr> <tr><td>1489</td> <td class="normal"> * @return boolean </td></tr> <tr><td>1490</td> <td class="normal"> */ </td></tr> <tr><td>1491</td> <td class="normal"> public function removeColumn($fieldName) </td></tr> <tr><td>1492</td> <td class="normal"> { </td></tr> <tr><td>1493</td> <td class="covered"> $columnName = array_search($fieldName, $this->_fieldNames); </td></tr> <tr><td>1494</td> <td class="normal"> </td></tr> <tr><td>1495</td> <td class="covered"> unset($this->_fieldNames[$columnName]); </td></tr> <tr><td>1496</td> <td class="normal"> </td></tr> <tr><td>1497</td> <td class="covered"> if (isset($this->_columns[$columnName])) { </td></tr> <tr><td>1498</td> <td class="covered"> unset($this->_columns[$columnName]); </td></tr> <tr><td>1499</td> <td class="covered"> return true; </td></tr> <tr><td>1500</td> <td class="orange"> } </td></tr> <tr><td>1501</td> <td class="red"> $this->columnCount--; </td></tr> <tr><td>1502</td> <td class="normal"> </td></tr> <tr><td>1503</td> <td class="red"> return false; </td></tr> <tr><td>1504</td> <td class="orange"> } </td></tr> <tr><td>1505</td> <td class="normal"> </td></tr> <tr><td>1506</td> <td class="normal"> /** </td></tr> <tr><td>1507</td> <td class="normal"> * returns an array containing all the column names. </td></tr> <tr><td>1508</td> <td class="normal"> * </td></tr> <tr><td>1509</td> <td class="normal"> * @return array </td></tr> <tr><td>1510</td> <td class="normal"> */ </td></tr> <tr><td>1511</td> <td class="normal"> public function getColumnNames(array $fieldNames = null) </td></tr> <tr><td>1512</td> <td class="normal"> { </td></tr> <tr><td>1513</td> <td class="covered"> if ($fieldNames === null) { </td></tr> <tr><td>1514</td> <td class="covered"> return array_keys($this->_columns); </td></tr> <tr><td>1515</td> <td class="orange"> } else { </td></tr> <tr><td>1516</td> <td class="covered"> $columnNames = array(); </td></tr> <tr><td>1517</td> <td class="covered"> foreach ($fieldNames as $fieldName) { </td></tr> <tr><td>1518</td> <td class="covered"> $columnNames[] = $this->getColumnName($fieldName); </td></tr> <tr><td>1519</td> <td class="covered"> } </td></tr> <tr><td>1520</td> <td class="covered"> return $columnNames; </td></tr> <tr><td>1521</td> <td class="normal"> } </td></tr> <tr><td>1522</td> <td class="orange"> } </td></tr> <tr><td>1523</td> <td class="normal"> </td></tr> <tr><td>1524</td> <td class="normal"> /** </td></tr> <tr><td>1525</td> <td class="normal"> * returns an array with all the identifier column names. </td></tr> <tr><td>1526</td> <td class="normal"> * </td></tr> <tr><td>1527</td> <td class="normal"> * @return array </td></tr> <tr><td>1528</td> <td class="normal"> */ </td></tr> <tr><td>1529</td> <td class="normal"> public function getIdentifierColumnNames() </td></tr> <tr><td>1530</td> <td class="normal"> { </td></tr> <tr><td>1531</td> <td class="covered"> return $this->getColumnNames((array) $this->getIdentifier()); </td></tr> <tr><td>1532</td> <td class="orange"> } </td></tr> <tr><td>1533</td> <td class="normal"> </td></tr> <tr><td>1534</td> <td class="normal"> /** </td></tr> <tr><td>1535</td> <td class="normal"> * returns an array containing all the field names. </td></tr> <tr><td>1536</td> <td class="normal"> * </td></tr> <tr><td>1537</td> <td class="normal"> * @return array </td></tr> <tr><td>1538</td> <td class="normal"> */ </td></tr> <tr><td>1539</td> <td class="normal"> public function getFieldNames() </td></tr> <tr><td>1540</td> <td class="normal"> { </td></tr> <tr><td>1541</td> <td class="covered"> return array_values($this->_fieldNames); </td></tr> <tr><td>1542</td> <td class="orange"> } </td></tr> <tr><td>1543</td> <td class="normal"> </td></tr> <tr><td>1544</td> <td class="normal"> /** </td></tr> <tr><td>1545</td> <td class="normal"> * getDefinitionOf </td></tr> <tr><td>1546</td> <td class="normal"> * </td></tr> <tr><td>1547</td> <td class="normal"> * @return mixed array on success, false on failure </td></tr> <tr><td>1548</td> <td class="normal"> */ </td></tr> <tr><td>1549</td> <td class="normal"> public function getDefinitionOf($fieldName) </td></tr> <tr><td>1550</td> <td class="normal"> { </td></tr> <tr><td>1551</td> <td class="covered"> $columnName = $this->getColumnName($fieldName); </td></tr> <tr><td>1552</td> <td class="covered"> return $this->getColumnDefinition($columnName); </td></tr> <tr><td>1553</td> <td class="orange"> } </td></tr> <tr><td>1554</td> <td class="normal"> </td></tr> <tr><td>1555</td> <td class="normal"> /** </td></tr> <tr><td>1556</td> <td class="normal"> * getTypeOf </td></tr> <tr><td>1557</td> <td class="normal"> * </td></tr> <tr><td>1558</td> <td class="normal"> * @return mixed string on success, false on failure </td></tr> <tr><td>1559</td> <td class="normal"> */ </td></tr> <tr><td>1560</td> <td class="normal"> public function getTypeOf($fieldName) </td></tr> <tr><td>1561</td> <td class="normal"> { </td></tr> <tr><td>1562</td> <td class="covered"> $columnName = $this->getColumnName($fieldName); </td></tr> <tr><td>1563</td> <td class="covered"> if (isset($this->_columns[$columnName])) { </td></tr> <tr><td>1564</td> <td class="covered"> return $this->_columns[$columnName]['type']; </td></tr> <tr><td>1565</td> <td class="orange"> } </td></tr> <tr><td>1566</td> <td class="covered"> return false; </td></tr> <tr><td>1567</td> <td class="orange"> } </td></tr> <tr><td>1568</td> <td class="normal"> </td></tr> <tr><td>1569</td> <td class="normal"> /** </td></tr> <tr><td>1570</td> <td class="normal"> * setData </td></tr> <tr><td>1571</td> <td class="normal"> * doctrine uses this function internally </td></tr> <tr><td>1572</td> <td class="normal"> * users are strongly discouraged to use this function </td></tr> <tr><td>1573</td> <td class="normal"> * </td></tr> <tr><td>1574</td> <td class="normal"> * @param array $data internal data </td></tr> <tr><td>1575</td> <td class="normal"> * @return void </td></tr> <tr><td>1576</td> <td class="normal"> */ </td></tr> <tr><td>1577</td> <td class="normal"> public function setData(array $data) </td></tr> <tr><td>1578</td> <td class="normal"> { </td></tr> <tr><td>1579</td> <td class="covered"> $this->_data = $data; </td></tr> <tr><td>1580</td> <td class="covered"> } </td></tr> <tr><td>1581</td> <td class="normal"> </td></tr> <tr><td>1582</td> <td class="normal"> /** </td></tr> <tr><td>1583</td> <td class="normal"> * returns internal data, used by Doctrine_Record instances </td></tr> <tr><td>1584</td> <td class="normal"> * when retrieving data from database </td></tr> <tr><td>1585</td> <td class="normal"> * </td></tr> <tr><td>1586</td> <td class="normal"> * @return array </td></tr> <tr><td>1587</td> <td class="normal"> */ </td></tr> <tr><td>1588</td> <td class="normal"> public function getData() </td></tr> <tr><td>1589</td> <td class="normal"> { </td></tr> <tr><td>1590</td> <td class="covered"> return $this->_data; </td></tr> <tr><td>1591</td> <td class="orange"> } </td></tr> <tr><td>1592</td> <td class="normal"> </td></tr> <tr><td>1593</td> <td class="normal"> /** </td></tr> <tr><td>1594</td> <td class="normal"> * prepareValue </td></tr> <tr><td>1595</td> <td class="normal"> * this method performs special data preparation depending on </td></tr> <tr><td>1596</td> <td class="normal"> * the type of the given column </td></tr> <tr><td>1597</td> <td class="normal"> * </td></tr> <tr><td>1598</td> <td class="normal"> * 1. It unserializes array and object typed columns </td></tr> <tr><td>1599</td> <td class="normal"> * 2. Uncompresses gzip typed columns </td></tr> <tr><td>1600</td> <td class="normal"> * 3. Gets the appropriate enum values for enum typed columns </td></tr> <tr><td>1601</td> <td class="normal"> * 4. Initializes special null object pointer for null values (for fast column existence checking purposes) </td></tr> <tr><td>1602</td> <td class="normal"> * </td></tr> <tr><td>1603</td> <td class="normal"> * example: </td></tr> <tr><td>1604</td> <td class="normal"> * <code type='php'> </td></tr> <tr><td>1605</td> <td class="normal"> * $field = 'name'; </td></tr> <tr><td>1606</td> <td class="normal"> * $value = null; </td></tr> <tr><td>1607</td> <td class="normal"> * $table->prepareValue($field, $value); // Doctrine_Null </td></tr> <tr><td>1608</td> <td class="normal"> * </code> </td></tr> <tr><td>1609</td> <td class="normal"> * </td></tr> <tr><td>1610</td> <td class="normal"> * @throws Doctrine_Table_Exception if unserialization of array/object typed column fails or </td></tr> <tr><td>1611</td> <td class="normal"> * @throws Doctrine_Table_Exception if uncompression of gzip typed column fails * </td></tr> <tr><td>1612</td> <td class="normal"> * @param string $field the name of the field </td></tr> <tr><td>1613</td> <td class="normal"> * @param string $value field value </td></tr> <tr><td>1614</td> <td class="normal"> * @return mixed prepared value </td></tr> <tr><td>1615</td> <td class="normal"> */ </td></tr> <tr><td>1616</td> <td class="normal"> public function prepareValue($fieldName, $value) </td></tr> <tr><td>1617</td> <td class="normal"> { </td></tr> <tr><td>1618</td> <td class="covered"> if ($value === self::$_null) { </td></tr> <tr><td>1619</td> <td class="red"> return self::$_null; </td></tr> <tr><td>1620</td> <td class="covered"> } else if ($value === null) { </td></tr> <tr><td>1621</td> <td class="covered"> return null; </td></tr> <tr><td>1622</td> <td class="orange"> } else { </td></tr> <tr><td>1623</td> <td class="covered"> $type = $this->getTypeOf($fieldName); </td></tr> <tr><td>1624</td> <td class="normal"> </td></tr> <tr><td>1625</td> <td class="normal"> switch ($type) { </td></tr> <tr><td>1626</td> <td class="covered"> case 'array': </td></tr> <tr><td>1627</td> <td class="covered"> case 'object': </td></tr> <tr><td>1628</td> <td class="covered"> if (is_string($value)) { </td></tr> <tr><td>1629</td> <td class="covered"> $value = unserialize($value); </td></tr> <tr><td>1630</td> <td class="normal"> </td></tr> <tr><td>1631</td> <td class="covered"> if ($value === false) { </td></tr> <tr><td>1632</td> <td class="red"> throw new Doctrine_Table_Exception('Unserialization of ' . $fieldName . ' failed.'); </td></tr> <tr><td>1633</td> <td class="orange"> } </td></tr> <tr><td>1634</td> <td class="covered"> return $value; </td></tr> <tr><td>1635</td> <td class="orange"> } </td></tr> <tr><td>1636</td> <td class="red"> break; </td></tr> <tr><td>1637</td> <td class="covered"> case 'gzip': </td></tr> <tr><td>1638</td> <td class="covered"> $value = gzuncompress($value); </td></tr> <tr><td>1639</td> <td class="normal"> </td></tr> <tr><td>1640</td> <td class="covered"> if ($value === false) { </td></tr> <tr><td>1641</td> <td class="red"> throw new Doctrine_Table_Exception('Uncompressing of ' . $fieldName . ' failed.'); </td></tr> <tr><td>1642</td> <td class="orange"> } </td></tr> <tr><td>1643</td> <td class="covered"> return $value; </td></tr> <tr><td>1644</td> <td class="orange"> break; </td></tr> <tr><td>1645</td> <td class="covered"> case 'enum': </td></tr> <tr><td>1646</td> <td class="covered"> return $this->enumValue($fieldName, $value); </td></tr> <tr><td>1647</td> <td class="orange"> break; </td></tr> <tr><td>1648</td> <td class="covered"> case 'boolean': </td></tr> <tr><td>1649</td> <td class="covered"> return (boolean) $value; </td></tr> <tr><td>1650</td> <td class="orange"> break; </td></tr> <tr><td>1651</td> <td class="covered"> case 'integer': </td></tr> <tr><td>1652</td> <td class="normal"> // don't do any casting here PHP INT_MAX is smaller than what the databases support </td></tr> <tr><td>1653</td> <td class="covered"> break; </td></tr> <tr><td>1654</td> <td class="orange"> } </td></tr> <tr><td>1655</td> <td class="normal"> } </td></tr> <tr><td>1656</td> <td class="covered"> return $value; </td></tr> <tr><td>1657</td> <td class="orange"> } </td></tr> <tr><td>1658</td> <td class="normal"> </td></tr> <tr><td>1659</td> <td class="normal"> /** </td></tr> <tr><td>1660</td> <td class="normal"> * getTree </td></tr> <tr><td>1661</td> <td class="normal"> * </td></tr> <tr><td>1662</td> <td class="normal"> * getter for associated tree </td></tr> <tr><td>1663</td> <td class="normal"> * </td></tr> <tr><td>1664</td> <td class="normal"> * @return mixed if tree return instance of Doctrine_Tree, otherwise returns false </td></tr> <tr><td>1665</td> <td class="normal"> */ </td></tr> <tr><td>1666</td> <td class="normal"> public function getTree() </td></tr> <tr><td>1667</td> <td class="normal"> { </td></tr> <tr><td>1668</td> <td class="covered"> if (isset($this->_options['treeImpl'])) { </td></tr> <tr><td>1669</td> <td class="covered"> if ( ! $this->_tree) { </td></tr> <tr><td>1670</td> <td class="covered"> $options = isset($this->_options['treeOptions']) ? $this->_options['treeOptions'] : array(); </td></tr> <tr><td>1671</td> <td class="covered"> $this->_tree = Doctrine_Tree::factory($this, </td></tr> <tr><td>1672</td> <td class="covered"> $this->_options['treeImpl'], </td></tr> <tr><td>1673</td> <td class="normal"> $options </td></tr> <tr><td>1674</td> <td class="covered"> ); </td></tr> <tr><td>1675</td> <td class="covered"> } </td></tr> <tr><td>1676</td> <td class="covered"> return $this->_tree; </td></tr> <tr><td>1677</td> <td class="orange"> } </td></tr> <tr><td>1678</td> <td class="red"> return false; </td></tr> <tr><td>1679</td> <td class="orange"> } </td></tr> <tr><td>1680</td> <td class="normal"> </td></tr> <tr><td>1681</td> <td class="normal"> /** </td></tr> <tr><td>1682</td> <td class="normal"> * getComponentName </td></tr> <tr><td>1683</td> <td class="normal"> * </td></tr> <tr><td>1684</td> <td class="normal"> * @return void </td></tr> <tr><td>1685</td> <td class="normal"> */ </td></tr> <tr><td>1686</td> <td class="normal"> public function getComponentName() </td></tr> <tr><td>1687</td> <td class="normal"> { </td></tr> <tr><td>1688</td> <td class="covered"> return $this->_options['name']; </td></tr> <tr><td>1689</td> <td class="orange"> } </td></tr> <tr><td>1690</td> <td class="normal"> </td></tr> <tr><td>1691</td> <td class="normal"> /** </td></tr> <tr><td>1692</td> <td class="normal"> * getTableName </td></tr> <tr><td>1693</td> <td class="normal"> * </td></tr> <tr><td>1694</td> <td class="normal"> * @return void </td></tr> <tr><td>1695</td> <td class="normal"> */ </td></tr> <tr><td>1696</td> <td class="normal"> public function getTableName() </td></tr> <tr><td>1697</td> <td class="normal"> { </td></tr> <tr><td>1698</td> <td class="covered"> return $this->_options['tableName']; </td></tr> <tr><td>1699</td> <td class="orange"> } </td></tr> <tr><td>1700</td> <td class="normal"> </td></tr> <tr><td>1701</td> <td class="normal"> /** </td></tr> <tr><td>1702</td> <td class="normal"> * setTableName </td></tr> <tr><td>1703</td> <td class="normal"> * </td></tr> <tr><td>1704</td> <td class="normal"> * @param string $tableName </td></tr> <tr><td>1705</td> <td class="normal"> * @return void </td></tr> <tr><td>1706</td> <td class="normal"> */ </td></tr> <tr><td>1707</td> <td class="normal"> public function setTableName($tableName) </td></tr> <tr><td>1708</td> <td class="normal"> { </td></tr> <tr><td>1709</td> <td class="covered"> $this->setOption('tableName', $this->_conn->formatter->getTableName($tableName)); </td></tr> <tr><td>1710</td> <td class="covered"> } </td></tr> <tr><td>1711</td> <td class="normal"> </td></tr> <tr><td>1712</td> <td class="normal"> /** </td></tr> <tr><td>1713</td> <td class="normal"> * isTree </td></tr> <tr><td>1714</td> <td class="normal"> * </td></tr> <tr><td>1715</td> <td class="normal"> * determine if table acts as tree </td></tr> <tr><td>1716</td> <td class="normal"> * </td></tr> <tr><td>1717</td> <td class="normal"> * @return mixed if tree return true, otherwise returns false </td></tr> <tr><td>1718</td> <td class="normal"> */ </td></tr> <tr><td>1719</td> <td class="normal"> public function isTree() </td></tr> <tr><td>1720</td> <td class="normal"> { </td></tr> <tr><td>1721</td> <td class="covered"> return ( ! is_null($this->_options['treeImpl'])) ? true : false; </td></tr> <tr><td>1722</td> <td class="orange"> } </td></tr> <tr><td>1723</td> <td class="normal"> </td></tr> <tr><td>1724</td> <td class="normal"> /** </td></tr> <tr><td>1725</td> <td class="normal"> * getTemplate </td></tr> <tr><td>1726</td> <td class="normal"> * </td></tr> <tr><td>1727</td> <td class="normal"> * @param string $template </td></tr> <tr><td>1728</td> <td class="normal"> * @return void </td></tr> <tr><td>1729</td> <td class="normal"> */ </td></tr> <tr><td>1730</td> <td class="normal"> public function getTemplate($template) </td></tr> <tr><td>1731</td> <td class="normal"> { </td></tr> <tr><td>1732</td> <td class="covered"> if ( ! isset($this->_templates[$template])) { </td></tr> <tr><td>1733</td> <td class="red"> throw new Doctrine_Table_Exception('Template ' . $template . ' not loaded'); </td></tr> <tr><td>1734</td> <td class="orange"> } </td></tr> <tr><td>1735</td> <td class="normal"> </td></tr> <tr><td>1736</td> <td class="covered"> return $this->_templates[$template]; </td></tr> <tr><td>1737</td> <td class="orange"> } </td></tr> <tr><td>1738</td> <td class="normal"> </td></tr> <tr><td>1739</td> <td class="normal"> public function hasTemplate($template) </td></tr> <tr><td>1740</td> <td class="normal"> { </td></tr> <tr><td>1741</td> <td class="red"> return isset($this->_templates[$template]); </td></tr> <tr><td>1742</td> <td class="orange"> } </td></tr> <tr><td>1743</td> <td class="normal"> </td></tr> <tr><td>1744</td> <td class="normal"> public function addTemplate($template, Doctrine_Template $impl) </td></tr> <tr><td>1745</td> <td class="normal"> { </td></tr> <tr><td>1746</td> <td class="covered"> $this->_templates[$template] = $impl; </td></tr> <tr><td>1747</td> <td class="normal"> </td></tr> <tr><td>1748</td> <td class="covered"> return $this; </td></tr> <tr><td>1749</td> <td class="orange"> } </td></tr> <tr><td>1750</td> <td class="normal"> </td></tr> <tr><td>1751</td> <td class="normal"> /** </td></tr> <tr><td>1752</td> <td class="normal"> * bindQueryParts </td></tr> <tr><td>1753</td> <td class="normal"> * binds query parts to given component </td></tr> <tr><td>1754</td> <td class="normal"> * </td></tr> <tr><td>1755</td> <td class="normal"> * @param array $queryParts an array of pre-bound query parts </td></tr> <tr><td>1756</td> <td class="normal"> * @return Doctrine_Record this object </td></tr> <tr><td>1757</td> <td class="normal"> */ </td></tr> <tr><td>1758</td> <td class="normal"> public function bindQueryParts(array $queryParts) </td></tr> <tr><td>1759</td> <td class="normal"> { </td></tr> <tr><td>1760</td> <td class="red"> $this->_options['queryParts'] = $queryParts; </td></tr> <tr><td>1761</td> <td class="normal"> </td></tr> <tr><td>1762</td> <td class="red"> return $this; </td></tr> <tr><td>1763</td> <td class="orange"> } </td></tr> <tr><td>1764</td> <td class="normal"> </td></tr> <tr><td>1765</td> <td class="normal"> /** </td></tr> <tr><td>1766</td> <td class="normal"> * bindQueryPart </td></tr> <tr><td>1767</td> <td class="normal"> * binds given value to given query part </td></tr> <tr><td>1768</td> <td class="normal"> * </td></tr> <tr><td>1769</td> <td class="normal"> * @param string $queryPart </td></tr> <tr><td>1770</td> <td class="normal"> * @param mixed $value </td></tr> <tr><td>1771</td> <td class="normal"> * @return Doctrine_Record this object </td></tr> <tr><td>1772</td> <td class="normal"> */ </td></tr> <tr><td>1773</td> <td class="normal"> public function bindQueryPart($queryPart, $value) </td></tr> <tr><td>1774</td> <td class="normal"> { </td></tr> <tr><td>1775</td> <td class="covered"> $this->_options['queryParts'][$queryPart] = $value; </td></tr> <tr><td>1776</td> <td class="normal"> </td></tr> <tr><td>1777</td> <td class="covered"> return $this; </td></tr> <tr><td>1778</td> <td class="orange"> } </td></tr> <tr><td>1779</td> <td class="normal"> </td></tr> <tr><td>1780</td> <td class="normal"> /** </td></tr> <tr><td>1781</td> <td class="normal"> * getBoundQueryPart </td></tr> <tr><td>1782</td> <td class="normal"> * </td></tr> <tr><td>1783</td> <td class="normal"> * @param string $queryPart </td></tr> <tr><td>1784</td> <td class="normal"> * @return string $queryPart </td></tr> <tr><td>1785</td> <td class="normal"> */ </td></tr> <tr><td>1786</td> <td class="normal"> public function getBoundQueryPart($queryPart) </td></tr> <tr><td>1787</td> <td class="normal"> { </td></tr> <tr><td>1788</td> <td class="covered"> if ( ! isset($this->_options['queryParts'][$queryPart])) { </td></tr> <tr><td>1789</td> <td class="covered"> return null; </td></tr> <tr><td>1790</td> <td class="orange"> } </td></tr> <tr><td>1791</td> <td class="normal"> </td></tr> <tr><td>1792</td> <td class="covered"> return $this->_options['queryParts'][$queryPart]; </td></tr> <tr><td>1793</td> <td class="orange"> } </td></tr> <tr><td>1794</td> <td class="normal"> </td></tr> <tr><td>1795</td> <td class="normal"> /** </td></tr> <tr><td>1796</td> <td class="normal"> * unshiftFilter </td></tr> <tr><td>1797</td> <td class="normal"> * </td></tr> <tr><td>1798</td> <td class="normal"> * @param object Doctrine_Record_Filter $filter </td></tr> <tr><td>1799</td> <td class="normal"> * @return object $this </td></tr> <tr><td>1800</td> <td class="normal"> */ </td></tr> <tr><td>1801</td> <td class="normal"> public function unshiftFilter(Doctrine_Record_Filter $filter) </td></tr> <tr><td>1802</td> <td class="normal"> { </td></tr> <tr><td>1803</td> <td class="covered"> $filter->setTable($this); </td></tr> <tr><td>1804</td> <td class="normal"> </td></tr> <tr><td>1805</td> <td class="covered"> $filter->init(); </td></tr> <tr><td>1806</td> <td class="normal"> </td></tr> <tr><td>1807</td> <td class="covered"> array_unshift($this->_filters, $filter); </td></tr> <tr><td>1808</td> <td class="normal"> </td></tr> <tr><td>1809</td> <td class="covered"> return $this; </td></tr> <tr><td>1810</td> <td class="orange"> } </td></tr> <tr><td>1811</td> <td class="normal"> </td></tr> <tr><td>1812</td> <td class="normal"> /** </td></tr> <tr><td>1813</td> <td class="normal"> * getFilters </td></tr> <tr><td>1814</td> <td class="normal"> * </td></tr> <tr><td>1815</td> <td class="normal"> * @return array $filters </td></tr> <tr><td>1816</td> <td class="normal"> */ </td></tr> <tr><td>1817</td> <td class="normal"> public function getFilters() </td></tr> <tr><td>1818</td> <td class="normal"> { </td></tr> <tr><td>1819</td> <td class="covered"> return $this->_filters; </td></tr> <tr><td>1820</td> <td class="orange"> } </td></tr> <tr><td>1821</td> <td class="normal"> </td></tr> <tr><td>1822</td> <td class="normal"> /** </td></tr> <tr><td>1823</td> <td class="normal"> * returns a string representation of this object </td></tr> <tr><td>1824</td> <td class="normal"> * </td></tr> <tr><td>1825</td> <td class="normal"> * @return string </td></tr> <tr><td>1826</td> <td class="normal"> */ </td></tr> <tr><td>1827</td> <td class="normal"> public function __toString() </td></tr> <tr><td>1828</td> <td class="normal"> { </td></tr> <tr><td>1829</td> <td class="red"> return Doctrine_Lib::getTableAsString($this); </td></tr> <tr><td>1830</td> <td class="orange"> } </td></tr> <tr><td>1831</td> <td class="normal"> </td></tr> <tr><td>1832</td> <td class="normal"> /** </td></tr> <tr><td>1833</td> <td class="normal"> * findBy </td></tr> <tr><td>1834</td> <td class="normal"> * </td></tr> <tr><td>1835</td> <td class="normal"> * @param string $column </td></tr> <tr><td>1836</td> <td class="normal"> * @param string $value </td></tr> <tr><td>1837</td> <td class="normal"> * @param string $hydrationMode </td></tr> <tr><td>1838</td> <td class="normal"> * @return void </td></tr> <tr><td>1839</td> <td class="normal"> */ </td></tr> <tr><td>1840</td> <td class="normal"> protected function findBy($fieldName, $value, $hydrationMode = null) </td></tr> <tr><td>1841</td> <td class="normal"> { </td></tr> <tr><td>1842</td> <td class="red"> return $this->createQuery()->where($fieldName . ' = ?')->execute(array($value), $hydrationMode); </td></tr> <tr><td>1843</td> <td class="orange"> } </td></tr> <tr><td>1844</td> <td class="normal"> </td></tr> <tr><td>1845</td> <td class="normal"> /** </td></tr> <tr><td>1846</td> <td class="normal"> * findOneBy </td></tr> <tr><td>1847</td> <td class="normal"> * </td></tr> <tr><td>1848</td> <td class="normal"> * @param string $column </td></tr> <tr><td>1849</td> <td class="normal"> * @param string $value </td></tr> <tr><td>1850</td> <td class="normal"> * @param string $hydrationMode </td></tr> <tr><td>1851</td> <td class="normal"> * @return void </td></tr> <tr><td>1852</td> <td class="normal"> */ </td></tr> <tr><td>1853</td> <td class="normal"> protected function findOneBy($fieldName, $value, $hydrationMode = null) </td></tr> <tr><td>1854</td> <td class="normal"> { </td></tr> <tr><td>1855</td> <td class="red"> $results = $this->createQuery()->where($fieldName . ' = ?')->limit(1)->execute(array($value), $hydrationMode); </td></tr> <tr><td>1856</td> <td class="normal"> </td></tr> <tr><td>1857</td> <td class="red"> return $hydrationMode === Doctrine::FETCH_ARRAY ? $results[0] : $results->getFirst(); </td></tr> <tr><td>1858</td> <td class="orange"> } </td></tr> <tr><td>1859</td> <td class="normal"> </td></tr> <tr><td>1860</td> <td class="normal"> /** </td></tr> <tr><td>1861</td> <td class="normal"> * __call </td></tr> <tr><td>1862</td> <td class="normal"> * </td></tr> <tr><td>1863</td> <td class="normal"> * Adds support for magic finders. </td></tr> <tr><td>1864</td> <td class="normal"> * findByColumnName, findByRelationAlias </td></tr> <tr><td>1865</td> <td class="normal"> * findById, findByContactId, etc. </td></tr> <tr><td>1866</td> <td class="normal"> * </td></tr> <tr><td>1867</td> <td class="normal"> * @return void </td></tr> <tr><td>1868</td> <td class="normal"> */ </td></tr> <tr><td>1869</td> <td class="normal"> public function __call($method, $arguments) </td></tr> <tr><td>1870</td> <td class="normal"> { </td></tr> <tr><td>1871</td> <td class="red"> if (substr($method, 0, 6) == 'findBy') { </td></tr> <tr><td>1872</td> <td class="red"> $by = substr($method, 6, strlen($method)); </td></tr> <tr><td>1873</td> <td class="red"> $method = 'findBy'; </td></tr> <tr><td>1874</td> <td class="red"> } else if (substr($method, 0, 9) == 'findOneBy') { </td></tr> <tr><td>1875</td> <td class="red"> $by = substr($method, 9, strlen($method)); </td></tr> <tr><td>1876</td> <td class="red"> $method = 'findOneBy'; </td></tr> <tr><td>1877</td> <td class="red"> } </td></tr> <tr><td>1878</td> <td class="normal"> </td></tr> <tr><td>1879</td> <td class="red"> if (isset($by)) { </td></tr> <tr><td>1880</td> <td class="red"> if ( ! isset($arguments[0])) { </td></tr> <tr><td>1881</td> <td class="red"> throw new Doctrine_Table_Exception('You must specify the value to findBy'); </td></tr> <tr><td>1882</td> <td class="orange"> } </td></tr> <tr><td>1883</td> <td class="normal"> </td></tr> <tr><td>1884</td> <td class="red"> $fieldName = Doctrine::tableize($by); </td></tr> <tr><td>1885</td> <td class="red"> $hydrationMode = isset($arguments[1]) ? $arguments[1]:null; </td></tr> <tr><td>1886</td> <td class="normal"> </td></tr> <tr><td>1887</td> <td class="red"> if ($this->hasColumn($fieldName)) { </td></tr> <tr><td>1888</td> <td class="red"> return $this->$method($fieldName, $arguments[0], $hydrationMode); </td></tr> <tr><td>1889</td> <td class="red"> } else if ($this->hasRelation($by)) { </td></tr> <tr><td>1890</td> <td class="red"> $relation = $this->getRelation($by); </td></tr> <tr><td>1891</td> <td class="normal"> </td></tr> <tr><td>1892</td> <td class="red"> if ($relation['type'] === Doctrine_Relation::MANY) { </td></tr> <tr><td>1893</td> <td class="red"> throw new Doctrine_Table_Exception('Cannot findBy many relationship.'); </td></tr> <tr><td>1894</td> <td class="orange"> } </td></tr> <tr><td>1895</td> <td class="normal"> </td></tr> <tr><td>1896</td> <td class="red"> return $this->$method($relation['local'], $arguments[0], $hydrationMode); </td></tr> <tr><td>1897</td> <td class="orange"> } else { </td></tr> <tr><td>1898</td> <td class="red"> throw new Doctrine_Table_Exception('Cannot find by: ' . $by . '. Invalid column or relationship alias.'); </td></tr> <tr><td>1899</td> <td class="normal"> } </td></tr> <tr><td>1900</td> <td class="orange"> } </td></tr> <tr><td>1901</td> <td class="red"> } </td></tr> <tr><td>1902</td> <td class="normal">} </td></tr> </table></body></html>