<html>
<head>
<title>Coverage for Doctrine_Record</title>
<style type="text/css">
.covered{ background: green;}
.normal{ background: white;}
.red{ background: red;}
.orange{ background: #f90;}
</style>
</head>
<body><h1>Coverage for Doctrine_Record</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: Record.php 3192 2007-11-19 17:55:23Z romanb $
</td></tr>
<tr><td>4</td>
<td class="normal"> *
</td></tr>
<tr><td>5</td>
<td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
</td></tr>
<tr><td>6</td>
<td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
</td></tr>
<tr><td>7</td>
<td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
</td></tr>
<tr><td>8</td>
<td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
</td></tr>
<tr><td>9</td>
<td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
</td></tr>
<tr><td>10</td>
<td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
</td></tr>
<tr><td>11</td>
<td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
</td></tr>
<tr><td>12</td>
<td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
</td></tr>
<tr><td>13</td>
<td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
</td></tr>
<tr><td>14</td>
<td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
</td></tr>
<tr><td>15</td>
<td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
</td></tr>
<tr><td>16</td>
<td class="normal"> *
</td></tr>
<tr><td>17</td>
<td class="normal"> * This software consists of voluntary contributions made by many individuals
</td></tr>
<tr><td>18</td>
<td class="normal"> * and is licensed under the LGPL. For more information, see
</td></tr>
<tr><td>19</td>
<td class="normal"> * <http://www.phpdoctrine.com>.
</td></tr>
<tr><td>20</td>
<td class="normal"> */
</td></tr>
<tr><td>21</td>
<td class="normal">Doctrine::autoload('Doctrine_Record_Abstract');
</td></tr>
<tr><td>22</td>
<td class="normal">/**
</td></tr>
<tr><td>23</td>
<td class="normal"> * Doctrine_Record
</td></tr>
<tr><td>24</td>
<td class="normal"> * All record classes should inherit this super class
</td></tr>
<tr><td>25</td>
<td class="normal"> *
</td></tr>
<tr><td>26</td>
<td class="normal"> * @package Doctrine
</td></tr>
<tr><td>27</td>
<td class="normal"> * @subpackage Record
</td></tr>
<tr><td>28</td>
<td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi>
</td></tr>
<tr><td>29</td>
<td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL
</td></tr>
<tr><td>30</td>
<td class="normal"> * @link www.phpdoctrine.com
</td></tr>
<tr><td>31</td>
<td class="normal"> * @since 1.0
</td></tr>
<tr><td>32</td>
<td class="normal"> * @version $Revision: 3192 $
</td></tr>
<tr><td>33</td>
<td class="normal"> */
</td></tr>
<tr><td>34</td>
<td class="normal">abstract class Doctrine_Record extends Doctrine_Record_Abstract implements Countable, IteratorAggregate, Serializable
</td></tr>
<tr><td>35</td>
<td class="normal">{
</td></tr>
<tr><td>36</td>
<td class="normal"> /**
</td></tr>
<tr><td>37</td>
<td class="normal"> * STATE CONSTANTS
</td></tr>
<tr><td>38</td>
<td class="normal"> */
</td></tr>
<tr><td>39</td>
<td class="normal">
</td></tr>
<tr><td>40</td>
<td class="normal"> /**
</td></tr>
<tr><td>41</td>
<td class="normal"> * DIRTY STATE
</td></tr>
<tr><td>42</td>
<td class="normal"> * a Doctrine_Record is in dirty state when its properties are changed
</td></tr>
<tr><td>43</td>
<td class="normal"> */
</td></tr>
<tr><td>44</td>
<td class="normal"> const STATE_DIRTY = 1;
</td></tr>
<tr><td>45</td>
<td class="normal">
</td></tr>
<tr><td>46</td>
<td class="normal"> /**
</td></tr>
<tr><td>47</td>
<td class="normal"> * TDIRTY STATE
</td></tr>
<tr><td>48</td>
<td class="normal"> * a Doctrine_Record is in transient dirty state when it is created
</td></tr>
<tr><td>49</td>
<td class="normal"> * and some of its fields are modified but it is NOT yet persisted into database
</td></tr>
<tr><td>50</td>
<td class="normal"> */
</td></tr>
<tr><td>51</td>
<td class="normal"> const STATE_TDIRTY = 2;
</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"> * CLEAN STATE
</td></tr>
<tr><td>55</td>
<td class="normal"> * a Doctrine_Record is in clean state when all of its properties are loaded from the database
</td></tr>
<tr><td>56</td>
<td class="normal"> * and none of its properties are changed
</td></tr>
<tr><td>57</td>
<td class="normal"> */
</td></tr>
<tr><td>58</td>
<td class="normal"> const STATE_CLEAN = 3;
</td></tr>
<tr><td>59</td>
<td class="normal">
</td></tr>
<tr><td>60</td>
<td class="normal"> /**
</td></tr>
<tr><td>61</td>
<td class="normal"> * PROXY STATE
</td></tr>
<tr><td>62</td>
<td class="normal"> * a Doctrine_Record is in proxy state when its properties are not fully loaded
</td></tr>
<tr><td>63</td>
<td class="normal"> */
</td></tr>
<tr><td>64</td>
<td class="normal"> const STATE_PROXY = 4;
</td></tr>
<tr><td>65</td>
<td class="normal">
</td></tr>
<tr><td>66</td>
<td class="normal"> /**
</td></tr>
<tr><td>67</td>
<td class="normal"> * NEW TCLEAN
</td></tr>
<tr><td>68</td>
<td class="normal"> * a Doctrine_Record is in transient clean state when it is created and none of its fields are modified
</td></tr>
<tr><td>69</td>
<td class="normal"> */
</td></tr>
<tr><td>70</td>
<td class="normal"> const STATE_TCLEAN = 5;
</td></tr>
<tr><td>71</td>
<td class="normal">
</td></tr>
<tr><td>72</td>
<td class="normal"> /**
</td></tr>
<tr><td>73</td>
<td class="normal"> * LOCKED STATE
</td></tr>
<tr><td>74</td>
<td class="normal"> * a Doctrine_Record is temporarily locked during deletes and saves
</td></tr>
<tr><td>75</td>
<td class="normal"> *
</td></tr>
<tr><td>76</td>
<td class="normal"> * This state is used internally to ensure that circular deletes
</td></tr>
<tr><td>77</td>
<td class="normal"> * and saves will not cause infinite loops
</td></tr>
<tr><td>78</td>
<td class="normal"> */
</td></tr>
<tr><td>79</td>
<td class="normal"> const STATE_LOCKED = 6;
</td></tr>
<tr><td>80</td>
<td class="normal">
</td></tr>
<tr><td>81</td>
<td class="normal"> /**
</td></tr>
<tr><td>82</td>
<td class="normal"> * @var Doctrine_Node_<TreeImpl> node object
</td></tr>
<tr><td>83</td>
<td class="normal"> */
</td></tr>
<tr><td>84</td>
<td class="normal"> protected $_node;
</td></tr>
<tr><td>85</td>
<td class="normal">
</td></tr>
<tr><td>86</td>
<td class="normal"> /**
</td></tr>
<tr><td>87</td>
<td class="normal"> * @var integer $_id the primary keys of this object
</td></tr>
<tr><td>88</td>
<td class="normal"> */
</td></tr>
<tr><td>89</td>
<td class="normal"> protected $_id = array();
</td></tr>
<tr><td>90</td>
<td class="normal">
</td></tr>
<tr><td>91</td>
<td class="normal"> /**
</td></tr>
<tr><td>92</td>
<td class="normal"> * @var array $_data the record data
</td></tr>
<tr><td>93</td>
<td class="normal"> */
</td></tr>
<tr><td>94</td>
<td class="normal"> protected $_data = array();
</td></tr>
<tr><td>95</td>
<td class="normal">
</td></tr>
<tr><td>96</td>
<td class="normal"> /**
</td></tr>
<tr><td>97</td>
<td class="normal"> * @var array $_values the values array, aggregate values and such are mapped into this array
</td></tr>
<tr><td>98</td>
<td class="normal"> */
</td></tr>
<tr><td>99</td>
<td class="normal"> protected $_values = 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 $_state the state of this record
</td></tr>
<tr><td>103</td>
<td class="normal"> * @see STATE_* constants
</td></tr>
<tr><td>104</td>
<td class="normal"> */
</td></tr>
<tr><td>105</td>
<td class="normal"> protected $_state;
</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 array $_modified an array containing field names that have been modified
</td></tr>
<tr><td>109</td>
<td class="normal"> * @todo Better name? $_modifiedFields?
</td></tr>
<tr><td>110</td>
<td class="normal"> */
</td></tr>
<tr><td>111</td>
<td class="normal"> protected $_modified = array();
</td></tr>
<tr><td>112</td>
<td class="normal">
</td></tr>
<tr><td>113</td>
<td class="normal"> /**
</td></tr>
<tr><td>114</td>
<td class="normal"> * @var Doctrine_Validator_ErrorStack error stack object
</td></tr>
<tr><td>115</td>
<td class="normal"> */
</td></tr>
<tr><td>116</td>
<td class="normal"> protected $_errorStack;
</td></tr>
<tr><td>117</td>
<td class="normal">
</td></tr>
<tr><td>118</td>
<td class="normal"> /**
</td></tr>
<tr><td>119</td>
<td class="normal"> * @var array $_references an array containing all the references
</td></tr>
<tr><td>120</td>
<td class="normal"> */
</td></tr>
<tr><td>121</td>
<td class="normal"> protected $_references = array();
</td></tr>
<tr><td>122</td>
<td class="normal">
</td></tr>
<tr><td>123</td>
<td class="normal"> /**
</td></tr>
<tr><td>124</td>
<td class="normal"> * @var integer $index this index is used for creating object identifiers
</td></tr>
<tr><td>125</td>
<td class="normal"> */
</td></tr>
<tr><td>126</td>
<td class="normal"> private static $_index = 1;
</td></tr>
<tr><td>127</td>
<td class="normal">
</td></tr>
<tr><td>128</td>
<td class="normal"> /**
</td></tr>
<tr><td>129</td>
<td class="normal"> * @var integer $oid object identifier, each Record object has a unique object identifier
</td></tr>
<tr><td>130</td>
<td class="normal"> */
</td></tr>
<tr><td>131</td>
<td class="normal"> private $_oid;
</td></tr>
<tr><td>132</td>
<td class="normal">
</td></tr>
<tr><td>133</td>
<td class="normal"> /**
</td></tr>
<tr><td>134</td>
<td class="normal"> * constructor
</td></tr>
<tr><td>135</td>
<td class="normal"> * @param Doctrine_Table|null $table a Doctrine_Table object or null,
</td></tr>
<tr><td>136</td>
<td class="normal"> * if null the table object is retrieved from current connection
</td></tr>
<tr><td>137</td>
<td class="normal"> *
</td></tr>
<tr><td>138</td>
<td class="normal"> * @param boolean $isNewEntry whether or not this record is transient
</td></tr>
<tr><td>139</td>
<td class="normal"> *
</td></tr>
<tr><td>140</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if object is created using the new operator and there are no
</td></tr>
<tr><td>141</td>
<td class="normal"> * open connections
</td></tr>
<tr><td>142</td>
<td class="normal"> * @throws Doctrine_Record_Exception if the cleanData operation fails somehow
</td></tr>
<tr><td>143</td>
<td class="normal"> */
</td></tr>
<tr><td>144</td>
<td class="normal"> public function __construct($table = null, $isNewEntry = false)
</td></tr>
<tr><td>145</td>
<td class="normal"> {
</td></tr>
<tr><td>146</td>
<td class="covered"> if (isset($table) && $table instanceof Doctrine_Table) {
</td></tr>
<tr><td>147</td>
<td class="covered"> $this->_table = $table;
</td></tr>
<tr><td>148</td>
<td class="covered"> $exists = ( ! $isNewEntry);
</td></tr>
<tr><td>149</td>
<td class="covered"> } else {
</td></tr>
<tr><td>150</td>
<td class="covered"> $class = get_class($this);
</td></tr>
<tr><td>151</td>
<td class="normal"> // get the table of this class
</td></tr>
<tr><td>152</td>
<td class="covered"> $this->_table = Doctrine_Manager::getInstance()->getTable($class);
</td></tr>
<tr><td>153</td>
<td class="covered"> $exists = false;
</td></tr>
<tr><td>154</td>
<td class="normal"> }
</td></tr>
<tr><td>155</td>
<td class="normal">
</td></tr>
<tr><td>156</td>
<td class="normal"> // Check if the current connection has the records table in its registry
</td></tr>
<tr><td>157</td>
<td class="normal"> // If not this record is only used for creating table definition and setting up
</td></tr>
<tr><td>158</td>
<td class="normal"> // relations.
</td></tr>
<tr><td>159</td>
<td class="covered"> if ( ! $this->_table->getConnection()->hasTable($this->_table->getComponentName())) {
</td></tr>
<tr><td>160</td>
<td class="covered"> return;
</td></tr>
<tr><td>161</td>
<td class="orange"> }
</td></tr>
<tr><td>162</td>
<td class="normal">
</td></tr>
<tr><td>163</td>
<td class="covered"> $this->_oid = self::$_index;
</td></tr>
<tr><td>164</td>
<td class="normal">
</td></tr>
<tr><td>165</td>
<td class="covered"> self::$_index++;
</td></tr>
<tr><td>166</td>
<td class="normal">
</td></tr>
<tr><td>167</td>
<td class="normal"> // get the data array
</td></tr>
<tr><td>168</td>
<td class="covered"> $this->_data = $this->_table->getData();
</td></tr>
<tr><td>169</td>
<td class="normal">
</td></tr>
<tr><td>170</td>
<td class="normal"> // get the column count
</td></tr>
<tr><td>171</td>
<td class="covered"> $count = count($this->_data);
</td></tr>
<tr><td>172</td>
<td class="normal">
</td></tr>
<tr><td>173</td>
<td class="covered"> $this->_values = $this->cleanData($this->_data);
</td></tr>
<tr><td>174</td>
<td class="normal">
</td></tr>
<tr><td>175</td>
<td class="covered"> $this->prepareIdentifiers($exists);
</td></tr>
<tr><td>176</td>
<td class="normal">
</td></tr>
<tr><td>177</td>
<td class="covered"> if ( ! $exists) {
</td></tr>
<tr><td>178</td>
<td class="covered"> if ($count > count($this->_values)) {
</td></tr>
<tr><td>179</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_TDIRTY;
</td></tr>
<tr><td>180</td>
<td class="covered"> } else {
</td></tr>
<tr><td>181</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_TCLEAN;
</td></tr>
<tr><td>182</td>
<td class="normal"> }
</td></tr>
<tr><td>183</td>
<td class="normal">
</td></tr>
<tr><td>184</td>
<td class="normal"> // set the default values for this record
</td></tr>
<tr><td>185</td>
<td class="covered"> $this->assignDefaultValues();
</td></tr>
<tr><td>186</td>
<td class="covered"> } else {
</td></tr>
<tr><td>187</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_CLEAN;
</td></tr>
<tr><td>188</td>
<td class="normal">
</td></tr>
<tr><td>189</td>
<td class="covered"> if ($count < $this->_table->getColumnCount()) {
</td></tr>
<tr><td>190</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_PROXY;
</td></tr>
<tr><td>191</td>
<td class="covered"> }
</td></tr>
<tr><td>192</td>
<td class="normal"> }
</td></tr>
<tr><td>193</td>
<td class="normal">
</td></tr>
<tr><td>194</td>
<td class="covered"> $this->_errorStack = new Doctrine_Validator_ErrorStack(get_class($this));
</td></tr>
<tr><td>195</td>
<td class="normal">
</td></tr>
<tr><td>196</td>
<td class="covered"> $repository = $this->_table->getRepository();
</td></tr>
<tr><td>197</td>
<td class="covered"> $repository->add($this);
</td></tr>
<tr><td>198</td>
<td class="normal">
</td></tr>
<tr><td>199</td>
<td class="covered"> $this->construct();
</td></tr>
<tr><td>200</td>
<td class="normal">
</td></tr>
<tr><td>201</td>
<td class="covered"> }
</td></tr>
<tr><td>202</td>
<td class="normal">
</td></tr>
<tr><td>203</td>
<td class="normal"> /**
</td></tr>
<tr><td>204</td>
<td class="normal"> * _index
</td></tr>
<tr><td>205</td>
<td class="normal"> *
</td></tr>
<tr><td>206</td>
<td class="normal"> * @return integer
</td></tr>
<tr><td>207</td>
<td class="normal"> */
</td></tr>
<tr><td>208</td>
<td class="normal"> public static function _index()
</td></tr>
<tr><td>209</td>
<td class="normal"> {
</td></tr>
<tr><td>210</td>
<td class="red"> return self::$_index;
</td></tr>
<tr><td>211</td>
<td class="orange"> }
</td></tr>
<tr><td>212</td>
<td class="normal">
</td></tr>
<tr><td>213</td>
<td class="normal"> /**
</td></tr>
<tr><td>214</td>
<td class="normal"> * setUp
</td></tr>
<tr><td>215</td>
<td class="normal"> * this method is used for setting up relations and attributes
</td></tr>
<tr><td>216</td>
<td class="normal"> * it should be implemented by child classes
</td></tr>
<tr><td>217</td>
<td class="normal"> *
</td></tr>
<tr><td>218</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>219</td>
<td class="normal"> */
</td></tr>
<tr><td>220</td>
<td class="normal"> public function setUp()
</td></tr>
<tr><td>221</td>
<td class="covered"> { }
</td></tr>
<tr><td>222</td>
<td class="normal"> /**
</td></tr>
<tr><td>223</td>
<td class="normal"> * construct
</td></tr>
<tr><td>224</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>225</td>
<td class="normal"> * to hook into the constructor procedure
</td></tr>
<tr><td>226</td>
<td class="normal"> *
</td></tr>
<tr><td>227</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>228</td>
<td class="normal"> */
</td></tr>
<tr><td>229</td>
<td class="normal"> public function construct()
</td></tr>
<tr><td>230</td>
<td class="covered"> { }
</td></tr>
<tr><td>231</td>
<td class="normal"> /**
</td></tr>
<tr><td>232</td>
<td class="normal"> * getOid
</td></tr>
<tr><td>233</td>
<td class="normal"> * returns the object identifier
</td></tr>
<tr><td>234</td>
<td class="normal"> *
</td></tr>
<tr><td>235</td>
<td class="normal"> * @return integer
</td></tr>
<tr><td>236</td>
<td class="normal"> */
</td></tr>
<tr><td>237</td>
<td class="normal"> public function getOid()
</td></tr>
<tr><td>238</td>
<td class="normal"> {
</td></tr>
<tr><td>239</td>
<td class="covered"> return $this->_oid;
</td></tr>
<tr><td>240</td>
<td class="orange"> }
</td></tr>
<tr><td>241</td>
<td class="normal"> public function oid()
</td></tr>
<tr><td>242</td>
<td class="normal"> {
</td></tr>
<tr><td>243</td>
<td class="red"> return $this->_oid;
</td></tr>
<tr><td>244</td>
<td class="orange"> }
</td></tr>
<tr><td>245</td>
<td class="normal">
</td></tr>
<tr><td>246</td>
<td class="normal"> /**
</td></tr>
<tr><td>247</td>
<td class="normal"> * isValid
</td></tr>
<tr><td>248</td>
<td class="normal"> *
</td></tr>
<tr><td>249</td>
<td class="normal"> * @return boolean whether or not this record is valid
</td></tr>
<tr><td>250</td>
<td class="normal"> */
</td></tr>
<tr><td>251</td>
<td class="normal"> public function isValid()
</td></tr>
<tr><td>252</td>
<td class="normal"> {
</td></tr>
<tr><td>253</td>
<td class="covered"> if ( ! $this->_table->getAttribute(Doctrine::ATTR_VALIDATE)) {
</td></tr>
<tr><td>254</td>
<td class="covered"> return true;
</td></tr>
<tr><td>255</td>
<td class="orange"> }
</td></tr>
<tr><td>256</td>
<td class="normal"> // Clear the stack from any previous errors.
</td></tr>
<tr><td>257</td>
<td class="covered"> $this->_errorStack->clear();
</td></tr>
<tr><td>258</td>
<td class="normal">
</td></tr>
<tr><td>259</td>
<td class="normal"> // Run validation process
</td></tr>
<tr><td>260</td>
<td class="covered"> $validator = new Doctrine_Validator();
</td></tr>
<tr><td>261</td>
<td class="covered"> $validator->validateRecord($this);
</td></tr>
<tr><td>262</td>
<td class="covered"> $this->validate();
</td></tr>
<tr><td>263</td>
<td class="covered"> if ($this->_state == self::STATE_TDIRTY || $this->_state == self::STATE_TCLEAN) {
</td></tr>
<tr><td>264</td>
<td class="covered"> $this->validateOnInsert();
</td></tr>
<tr><td>265</td>
<td class="covered"> } else {
</td></tr>
<tr><td>266</td>
<td class="covered"> $this->validateOnUpdate();
</td></tr>
<tr><td>267</td>
<td class="normal"> }
</td></tr>
<tr><td>268</td>
<td class="normal">
</td></tr>
<tr><td>269</td>
<td class="covered"> return $this->_errorStack->count() == 0 ? true : false;
</td></tr>
<tr><td>270</td>
<td class="orange"> }
</td></tr>
<tr><td>271</td>
<td class="normal">
</td></tr>
<tr><td>272</td>
<td class="normal"> /**
</td></tr>
<tr><td>273</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>274</td>
<td class="normal"> * to hook into the validation procedure, doing any custom / specialized
</td></tr>
<tr><td>275</td>
<td class="normal"> * validations that are neccessary.
</td></tr>
<tr><td>276</td>
<td class="normal"> */
</td></tr>
<tr><td>277</td>
<td class="normal"> protected function validate()
</td></tr>
<tr><td>278</td>
<td class="covered"> { }
</td></tr>
<tr><td>279</td>
<td class="normal"> /**
</td></tr>
<tr><td>280</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>281</td>
<td class="normal"> * to hook into the validation procedure only when the record is going to be
</td></tr>
<tr><td>282</td>
<td class="normal"> * updated.
</td></tr>
<tr><td>283</td>
<td class="normal"> */
</td></tr>
<tr><td>284</td>
<td class="normal"> protected function validateOnUpdate()
</td></tr>
<tr><td>285</td>
<td class="covered"> { }
</td></tr>
<tr><td>286</td>
<td class="normal"> /**
</td></tr>
<tr><td>287</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>288</td>
<td class="normal"> * to hook into the validation procedure only when the record is going to be
</td></tr>
<tr><td>289</td>
<td class="normal"> * inserted into the data store the first time.
</td></tr>
<tr><td>290</td>
<td class="normal"> */
</td></tr>
<tr><td>291</td>
<td class="normal"> protected function validateOnInsert()
</td></tr>
<tr><td>292</td>
<td class="covered"> { }
</td></tr>
<tr><td>293</td>
<td class="normal"> /**
</td></tr>
<tr><td>294</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>295</td>
<td class="normal"> * to hook into the serializing procedure.
</td></tr>
<tr><td>296</td>
<td class="normal"> */
</td></tr>
<tr><td>297</td>
<td class="normal"> public function preSerialize($event)
</td></tr>
<tr><td>298</td>
<td class="covered"> { }
</td></tr>
<tr><td>299</td>
<td class="normal"> /**
</td></tr>
<tr><td>300</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>301</td>
<td class="normal"> * to hook into the serializing procedure.
</td></tr>
<tr><td>302</td>
<td class="normal"> */
</td></tr>
<tr><td>303</td>
<td class="normal"> public function postSerialize($event)
</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="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>307</td>
<td class="normal"> * to hook into the serializing procedure.
</td></tr>
<tr><td>308</td>
<td class="normal"> */
</td></tr>
<tr><td>309</td>
<td class="normal"> public function preUnserialize($event)
</td></tr>
<tr><td>310</td>
<td class="covered"> { }
</td></tr>
<tr><td>311</td>
<td class="normal"> /**
</td></tr>
<tr><td>312</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>313</td>
<td class="normal"> * to hook into the serializing procedure.
</td></tr>
<tr><td>314</td>
<td class="normal"> */
</td></tr>
<tr><td>315</td>
<td class="normal"> public function postUnserialize($event)
</td></tr>
<tr><td>316</td>
<td class="covered"> { }
</td></tr>
<tr><td>317</td>
<td class="normal"> /**
</td></tr>
<tr><td>318</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>319</td>
<td class="normal"> * to hook into the saving procedure.
</td></tr>
<tr><td>320</td>
<td class="normal"> */
</td></tr>
<tr><td>321</td>
<td class="normal"> public function preSave($event)
</td></tr>
<tr><td>322</td>
<td class="covered"> { }
</td></tr>
<tr><td>323</td>
<td class="normal"> /**
</td></tr>
<tr><td>324</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>325</td>
<td class="normal"> * to hook into the saving procedure.
</td></tr>
<tr><td>326</td>
<td class="normal"> */
</td></tr>
<tr><td>327</td>
<td class="normal"> public function postSave($event)
</td></tr>
<tr><td>328</td>
<td class="covered"> { }
</td></tr>
<tr><td>329</td>
<td class="normal"> /**
</td></tr>
<tr><td>330</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>331</td>
<td class="normal"> * to hook into the deletion procedure.
</td></tr>
<tr><td>332</td>
<td class="normal"> */
</td></tr>
<tr><td>333</td>
<td class="normal"> public function preDelete($event)
</td></tr>
<tr><td>334</td>
<td class="covered"> { }
</td></tr>
<tr><td>335</td>
<td class="normal"> /**
</td></tr>
<tr><td>336</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>337</td>
<td class="normal"> * to hook into the deletion procedure.
</td></tr>
<tr><td>338</td>
<td class="normal"> */
</td></tr>
<tr><td>339</td>
<td class="normal"> public function postDelete($event)
</td></tr>
<tr><td>340</td>
<td class="covered"> { }
</td></tr>
<tr><td>341</td>
<td class="normal"> /**
</td></tr>
<tr><td>342</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>343</td>
<td class="normal"> * to hook into the saving procedure only when the record is going to be
</td></tr>
<tr><td>344</td>
<td class="normal"> * updated.
</td></tr>
<tr><td>345</td>
<td class="normal"> */
</td></tr>
<tr><td>346</td>
<td class="normal"> public function preUpdate($event)
</td></tr>
<tr><td>347</td>
<td class="covered"> { }
</td></tr>
<tr><td>348</td>
<td class="normal"> /**
</td></tr>
<tr><td>349</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>350</td>
<td class="normal"> * to hook into the saving procedure only when the record is going to be
</td></tr>
<tr><td>351</td>
<td class="normal"> * updated.
</td></tr>
<tr><td>352</td>
<td class="normal"> */
</td></tr>
<tr><td>353</td>
<td class="normal"> public function postUpdate($event)
</td></tr>
<tr><td>354</td>
<td class="covered"> { }
</td></tr>
<tr><td>355</td>
<td class="normal"> /**
</td></tr>
<tr><td>356</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>357</td>
<td class="normal"> * to hook into the saving procedure only when the record is going to be
</td></tr>
<tr><td>358</td>
<td class="normal"> * inserted into the data store the first time.
</td></tr>
<tr><td>359</td>
<td class="normal"> */
</td></tr>
<tr><td>360</td>
<td class="normal"> public function preInsert($event)
</td></tr>
<tr><td>361</td>
<td class="covered"> { }
</td></tr>
<tr><td>362</td>
<td class="normal"> /**
</td></tr>
<tr><td>363</td>
<td class="normal"> * Empty template method to provide concrete Record classes with the possibility
</td></tr>
<tr><td>364</td>
<td class="normal"> * to hook into the saving procedure only when the record is going to be
</td></tr>
<tr><td>365</td>
<td class="normal"> * inserted into the data store the first time.
</td></tr>
<tr><td>366</td>
<td class="normal"> */
</td></tr>
<tr><td>367</td>
<td class="normal"> public function postInsert($event)
</td></tr>
<tr><td>368</td>
<td class="covered"> { }
</td></tr>
<tr><td>369</td>
<td class="normal"> /**
</td></tr>
<tr><td>370</td>
<td class="normal"> * getErrorStack
</td></tr>
<tr><td>371</td>
<td class="normal"> *
</td></tr>
<tr><td>372</td>
<td class="normal"> * @return Doctrine_Validator_ErrorStack returns the errorStack associated with this record
</td></tr>
<tr><td>373</td>
<td class="normal"> */
</td></tr>
<tr><td>374</td>
<td class="normal"> public function getErrorStack()
</td></tr>
<tr><td>375</td>
<td class="normal"> {
</td></tr>
<tr><td>376</td>
<td class="covered"> return $this->_errorStack;
</td></tr>
<tr><td>377</td>
<td class="orange"> }
</td></tr>
<tr><td>378</td>
<td class="normal">
</td></tr>
<tr><td>379</td>
<td class="normal"> /**
</td></tr>
<tr><td>380</td>
<td class="normal"> * errorStack
</td></tr>
<tr><td>381</td>
<td class="normal"> * assigns / returns record errorStack
</td></tr>
<tr><td>382</td>
<td class="normal"> *
</td></tr>
<tr><td>383</td>
<td class="normal"> * @param Doctrine_Validator_ErrorStack errorStack to be assigned for this record
</td></tr>
<tr><td>384</td>
<td class="normal"> * @return void|Doctrine_Validator_ErrorStack returns the errorStack associated with this record
</td></tr>
<tr><td>385</td>
<td class="normal"> */
</td></tr>
<tr><td>386</td>
<td class="normal"> public function errorStack($stack = null)
</td></tr>
<tr><td>387</td>
<td class="normal"> {
</td></tr>
<tr><td>388</td>
<td class="covered"> if ($stack !== null) {
</td></tr>
<tr><td>389</td>
<td class="red"> if ( ! ($stack instanceof Doctrine_Validator_ErrorStack)) {
</td></tr>
<tr><td>390</td>
<td class="red"> throw new Doctrine_Record_Exception('Argument should be an instance of Doctrine_Validator_ErrorStack.');
</td></tr>
<tr><td>391</td>
<td class="orange"> }
</td></tr>
<tr><td>392</td>
<td class="red"> $this->_errorStack = $stack;
</td></tr>
<tr><td>393</td>
<td class="red"> } else {
</td></tr>
<tr><td>394</td>
<td class="covered"> return $this->_errorStack;
</td></tr>
<tr><td>395</td>
<td class="normal"> }
</td></tr>
<tr><td>396</td>
<td class="red"> }
</td></tr>
<tr><td>397</td>
<td class="normal">
</td></tr>
<tr><td>398</td>
<td class="normal"> /**
</td></tr>
<tr><td>399</td>
<td class="normal"> * setDefaultValues
</td></tr>
<tr><td>400</td>
<td class="normal"> * sets the default values for records internal data
</td></tr>
<tr><td>401</td>
<td class="normal"> *
</td></tr>
<tr><td>402</td>
<td class="normal"> * @param boolean $overwrite whether or not to overwrite the already set values
</td></tr>
<tr><td>403</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>404</td>
<td class="normal"> */
</td></tr>
<tr><td>405</td>
<td class="normal"> public function assignDefaultValues($overwrite = false)
</td></tr>
<tr><td>406</td>
<td class="normal"> {
</td></tr>
<tr><td>407</td>
<td class="covered"> if ( ! $this->_table->hasDefaultValues()) {
</td></tr>
<tr><td>408</td>
<td class="covered"> return false;
</td></tr>
<tr><td>409</td>
<td class="orange"> }
</td></tr>
<tr><td>410</td>
<td class="covered"> foreach ($this->_data as $column => $value) {
</td></tr>
<tr><td>411</td>
<td class="covered"> $default = $this->_table->getDefaultValueOf($column);
</td></tr>
<tr><td>412</td>
<td class="normal">
</td></tr>
<tr><td>413</td>
<td class="covered"> if ($default === null) {
</td></tr>
<tr><td>414</td>
<td class="covered"> continue;
</td></tr>
<tr><td>415</td>
<td class="orange"> }
</td></tr>
<tr><td>416</td>
<td class="normal">
</td></tr>
<tr><td>417</td>
<td class="covered"> if ($value === self::$_null || $overwrite) {
</td></tr>
<tr><td>418</td>
<td class="covered"> $this->_data[$column] = $default;
</td></tr>
<tr><td>419</td>
<td class="covered"> $this->_modified[] = $column;
</td></tr>
<tr><td>420</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_TDIRTY;
</td></tr>
<tr><td>421</td>
<td class="covered"> }
</td></tr>
<tr><td>422</td>
<td class="covered"> }
</td></tr>
<tr><td>423</td>
<td class="covered"> }
</td></tr>
<tr><td>424</td>
<td class="normal">
</td></tr>
<tr><td>425</td>
<td class="normal"> /**
</td></tr>
<tr><td>426</td>
<td class="normal"> * cleanData
</td></tr>
<tr><td>427</td>
<td class="normal"> *
</td></tr>
<tr><td>428</td>
<td class="normal"> * @param array $data data array to be cleaned
</td></tr>
<tr><td>429</td>
<td class="normal"> * @return integer
</td></tr>
<tr><td>430</td>
<td class="normal"> * @todo Better description. What exactly does this "cleaning" involve?
</td></tr>
<tr><td>431</td>
<td class="normal"> */
</td></tr>
<tr><td>432</td>
<td class="normal"> public function cleanData(&$data)
</td></tr>
<tr><td>433</td>
<td class="normal"> {
</td></tr>
<tr><td>434</td>
<td class="covered"> $tmp = $data;
</td></tr>
<tr><td>435</td>
<td class="covered"> $data = array();
</td></tr>
<tr><td>436</td>
<td class="normal">
</td></tr>
<tr><td>437</td>
<td class="covered"> foreach ($this->getTable()->getFieldNames() as $fieldName) {
</td></tr>
<tr><td>438</td>
<td class="covered"> if ( ! isset($tmp[$fieldName])) {
</td></tr>
<tr><td>439</td>
<td class="covered"> $data[$fieldName] = self::$_null;
</td></tr>
<tr><td>440</td>
<td class="covered"> } else {
</td></tr>
<tr><td>441</td>
<td class="covered"> $data[$fieldName] = $tmp[$fieldName];
</td></tr>
<tr><td>442</td>
<td class="normal"> }
</td></tr>
<tr><td>443</td>
<td class="covered"> unset($tmp[$fieldName]);
</td></tr>
<tr><td>444</td>
<td class="covered"> }
</td></tr>
<tr><td>445</td>
<td class="normal">
</td></tr>
<tr><td>446</td>
<td class="covered"> return $tmp;
</td></tr>
<tr><td>447</td>
<td class="orange"> }
</td></tr>
<tr><td>448</td>
<td class="normal">
</td></tr>
<tr><td>449</td>
<td class="normal"> /**
</td></tr>
<tr><td>450</td>
<td class="normal"> * hydrate
</td></tr>
<tr><td>451</td>
<td class="normal"> * hydrates this object from given array
</td></tr>
<tr><td>452</td>
<td class="normal"> *
</td></tr>
<tr><td>453</td>
<td class="normal"> * @param array $data
</td></tr>
<tr><td>454</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>455</td>
<td class="normal"> */
</td></tr>
<tr><td>456</td>
<td class="normal"> public function hydrate(array $data)
</td></tr>
<tr><td>457</td>
<td class="normal"> {
</td></tr>
<tr><td>458</td>
<td class="covered"> $this->_values = array_merge($this->_values, $this->cleanData($data));
</td></tr>
<tr><td>459</td>
<td class="covered"> $this->_data = array_merge($this->_data, $data);
</td></tr>
<tr><td>460</td>
<td class="covered"> $this->prepareIdentifiers(true);
</td></tr>
<tr><td>461</td>
<td class="covered"> }
</td></tr>
<tr><td>462</td>
<td class="normal">
</td></tr>
<tr><td>463</td>
<td class="normal"> /**
</td></tr>
<tr><td>464</td>
<td class="normal"> * prepareIdentifiers
</td></tr>
<tr><td>465</td>
<td class="normal"> * prepares identifiers for later use
</td></tr>
<tr><td>466</td>
<td class="normal"> *
</td></tr>
<tr><td>467</td>
<td class="normal"> * @param boolean $exists whether or not this record exists in persistent data store
</td></tr>
<tr><td>468</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>469</td>
<td class="normal"> */
</td></tr>
<tr><td>470</td>
<td class="normal"> private function prepareIdentifiers($exists = true)
</td></tr>
<tr><td>471</td>
<td class="normal"> {
</td></tr>
<tr><td>472</td>
<td class="covered"> switch ($this->_table->getIdentifierType()) {
</td></tr>
<tr><td>473</td>
<td class="covered"> case Doctrine::IDENTIFIER_AUTOINC:
</td></tr>
<tr><td>474</td>
<td class="covered"> case Doctrine::IDENTIFIER_SEQUENCE:
</td></tr>
<tr><td>475</td>
<td class="covered"> case Doctrine::IDENTIFIER_NATURAL:
</td></tr>
<tr><td>476</td>
<td class="covered"> $name = $this->_table->getIdentifier();
</td></tr>
<tr><td>477</td>
<td class="covered"> if (is_array($name)) {
</td></tr>
<tr><td>478</td>
<td class="covered"> $name = $name[0];
</td></tr>
<tr><td>479</td>
<td class="covered"> }
</td></tr>
<tr><td>480</td>
<td class="covered"> if ($exists) {
</td></tr>
<tr><td>481</td>
<td class="covered"> if (isset($this->_data[$name]) && $this->_data[$name] !== self::$_null) {
</td></tr>
<tr><td>482</td>
<td class="covered"> $this->_id[$name] = $this->_data[$name];
</td></tr>
<tr><td>483</td>
<td class="covered"> }
</td></tr>
<tr><td>484</td>
<td class="covered"> }
</td></tr>
<tr><td>485</td>
<td class="covered"> break;
</td></tr>
<tr><td>486</td>
<td class="covered"> case Doctrine::IDENTIFIER_COMPOSITE:
</td></tr>
<tr><td>487</td>
<td class="covered"> $names = $this->_table->getIdentifier();
</td></tr>
<tr><td>488</td>
<td class="normal">
</td></tr>
<tr><td>489</td>
<td class="covered"> foreach ($names as $name) {
</td></tr>
<tr><td>490</td>
<td class="covered"> if ($this->_data[$name] === self::$_null) {
</td></tr>
<tr><td>491</td>
<td class="covered"> $this->_id[$name] = null;
</td></tr>
<tr><td>492</td>
<td class="covered"> } else {
</td></tr>
<tr><td>493</td>
<td class="covered"> $this->_id[$name] = $this->_data[$name];
</td></tr>
<tr><td>494</td>
<td class="normal"> }
</td></tr>
<tr><td>495</td>
<td class="covered"> }
</td></tr>
<tr><td>496</td>
<td class="covered"> break;
</td></tr>
<tr><td>497</td>
<td class="red"> }
</td></tr>
<tr><td>498</td>
<td class="covered"> }
</td></tr>
<tr><td>499</td>
<td class="normal">
</td></tr>
<tr><td>500</td>
<td class="normal"> /**
</td></tr>
<tr><td>501</td>
<td class="normal"> * serialize
</td></tr>
<tr><td>502</td>
<td class="normal"> * this method is automatically called when this Doctrine_Record is serialized
</td></tr>
<tr><td>503</td>
<td class="normal"> *
</td></tr>
<tr><td>504</td>
<td class="normal"> * @return array
</td></tr>
<tr><td>505</td>
<td class="normal"> */
</td></tr>
<tr><td>506</td>
<td class="normal"> public function serialize()
</td></tr>
<tr><td>507</td>
<td class="normal"> {
</td></tr>
<tr><td>508</td>
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::RECORD_SERIALIZE);
</td></tr>
<tr><td>509</td>
<td class="normal">
</td></tr>
<tr><td>510</td>
<td class="covered"> $this->preSerialize($event);
</td></tr>
<tr><td>511</td>
<td class="normal">
</td></tr>
<tr><td>512</td>
<td class="covered"> $vars = get_object_vars($this);
</td></tr>
<tr><td>513</td>
<td class="normal">
</td></tr>
<tr><td>514</td>
<td class="covered"> unset($vars['_references']);
</td></tr>
<tr><td>515</td>
<td class="covered"> unset($vars['_table']);
</td></tr>
<tr><td>516</td>
<td class="covered"> unset($vars['_errorStack']);
</td></tr>
<tr><td>517</td>
<td class="covered"> unset($vars['_filter']);
</td></tr>
<tr><td>518</td>
<td class="covered"> unset($vars['_node']);
</td></tr>
<tr><td>519</td>
<td class="normal">
</td></tr>
<tr><td>520</td>
<td class="covered"> $name = $this->_table->getIdentifier();
</td></tr>
<tr><td>521</td>
<td class="covered"> $this->_data = array_merge($this->_data, $this->_id);
</td></tr>
<tr><td>522</td>
<td class="normal">
</td></tr>
<tr><td>523</td>
<td class="covered"> foreach ($this->_data as $k => $v) {
</td></tr>
<tr><td>524</td>
<td class="covered"> if ($v instanceof Doctrine_Record && $this->_table->getTypeOf($k) != 'object') {
</td></tr>
<tr><td>525</td>
<td class="red"> unset($vars['_data'][$k]);
</td></tr>
<tr><td>526</td>
<td class="covered"> } elseif ($v === self::$_null) {
</td></tr>
<tr><td>527</td>
<td class="covered"> unset($vars['_data'][$k]);
</td></tr>
<tr><td>528</td>
<td class="covered"> } else {
</td></tr>
<tr><td>529</td>
<td class="covered"> switch ($this->_table->getTypeOf($k)) {
</td></tr>
<tr><td>530</td>
<td class="covered"> case 'array':
</td></tr>
<tr><td>531</td>
<td class="covered"> case 'object':
</td></tr>
<tr><td>532</td>
<td class="covered"> $vars['_data'][$k] = serialize($vars['_data'][$k]);
</td></tr>
<tr><td>533</td>
<td class="covered"> break;
</td></tr>
<tr><td>534</td>
<td class="covered"> case 'gzip':
</td></tr>
<tr><td>535</td>
<td class="covered"> $vars['_data'][$k] = gzcompress($vars['_data'][$k]);
</td></tr>
<tr><td>536</td>
<td class="covered"> break;
</td></tr>
<tr><td>537</td>
<td class="covered"> case 'enum':
</td></tr>
<tr><td>538</td>
<td class="covered"> $vars['_data'][$k] = $this->_table->enumIndex($k, $vars['_data'][$k]);
</td></tr>
<tr><td>539</td>
<td class="covered"> break;
</td></tr>
<tr><td>540</td>
<td class="red"> }
</td></tr>
<tr><td>541</td>
<td class="normal"> }
</td></tr>
<tr><td>542</td>
<td class="covered"> }
</td></tr>
<tr><td>543</td>
<td class="normal">
</td></tr>
<tr><td>544</td>
<td class="covered"> $str = serialize($vars);
</td></tr>
<tr><td>545</td>
<td class="normal">
</td></tr>
<tr><td>546</td>
<td class="covered"> $this->postSerialize($event);
</td></tr>
<tr><td>547</td>
<td class="normal">
</td></tr>
<tr><td>548</td>
<td class="covered"> return $str;
</td></tr>
<tr><td>549</td>
<td class="orange"> }
</td></tr>
<tr><td>550</td>
<td class="normal">
</td></tr>
<tr><td>551</td>
<td class="normal"> /**
</td></tr>
<tr><td>552</td>
<td class="normal"> * unseralize
</td></tr>
<tr><td>553</td>
<td class="normal"> * this method is automatically called everytime a Doctrine_Record object is unserialized
</td></tr>
<tr><td>554</td>
<td class="normal"> *
</td></tr>
<tr><td>555</td>
<td class="normal"> * @param string $serialized Doctrine_Record as serialized string
</td></tr>
<tr><td>556</td>
<td class="normal"> * @throws Doctrine_Record_Exception if the cleanData operation fails somehow
</td></tr>
<tr><td>557</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>558</td>
<td class="normal"> */
</td></tr>
<tr><td>559</td>
<td class="normal"> public function unserialize($serialized)
</td></tr>
<tr><td>560</td>
<td class="normal"> {
</td></tr>
<tr><td>561</td>
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::RECORD_UNSERIALIZE);
</td></tr>
<tr><td>562</td>
<td class="normal">
</td></tr>
<tr><td>563</td>
<td class="covered"> $this->preUnserialize($event);
</td></tr>
<tr><td>564</td>
<td class="normal">
</td></tr>
<tr><td>565</td>
<td class="covered"> $manager = Doctrine_Manager::getInstance();
</td></tr>
<tr><td>566</td>
<td class="covered"> $connection = $manager->getConnectionForComponent(get_class($this));
</td></tr>
<tr><td>567</td>
<td class="normal">
</td></tr>
<tr><td>568</td>
<td class="covered"> $this->_oid = self::$_index;
</td></tr>
<tr><td>569</td>
<td class="covered"> self::$_index++;
</td></tr>
<tr><td>570</td>
<td class="normal">
</td></tr>
<tr><td>571</td>
<td class="covered"> $this->_table = $connection->getTable(get_class($this));
</td></tr>
<tr><td>572</td>
<td class="normal">
</td></tr>
<tr><td>573</td>
<td class="covered"> $array = unserialize($serialized);
</td></tr>
<tr><td>574</td>
<td class="normal">
</td></tr>
<tr><td>575</td>
<td class="covered"> foreach($array as $k => $v) {
</td></tr>
<tr><td>576</td>
<td class="covered"> $this->$k = $v;
</td></tr>
<tr><td>577</td>
<td class="covered"> }
</td></tr>
<tr><td>578</td>
<td class="normal">
</td></tr>
<tr><td>579</td>
<td class="covered"> foreach ($this->_data as $k => $v) {
</td></tr>
<tr><td>580</td>
<td class="normal">
</td></tr>
<tr><td>581</td>
<td class="covered"> switch ($this->_table->getTypeOf($k)) {
</td></tr>
<tr><td>582</td>
<td class="covered"> case 'array':
</td></tr>
<tr><td>583</td>
<td class="covered"> case 'object':
</td></tr>
<tr><td>584</td>
<td class="covered"> $this->_data[$k] = unserialize($this->_data[$k]);
</td></tr>
<tr><td>585</td>
<td class="covered"> break;
</td></tr>
<tr><td>586</td>
<td class="covered"> case 'gzip':
</td></tr>
<tr><td>587</td>
<td class="covered"> $this->_data[$k] = gzuncompress($this->_data[$k]);
</td></tr>
<tr><td>588</td>
<td class="covered"> break;
</td></tr>
<tr><td>589</td>
<td class="covered"> case 'enum':
</td></tr>
<tr><td>590</td>
<td class="covered"> $this->_data[$k] = $this->_table->enumValue($k, $this->_data[$k]);
</td></tr>
<tr><td>591</td>
<td class="covered"> break;
</td></tr>
<tr><td>592</td>
<td class="normal">
</td></tr>
<tr><td>593</td>
<td class="red"> }
</td></tr>
<tr><td>594</td>
<td class="covered"> }
</td></tr>
<tr><td>595</td>
<td class="normal">
</td></tr>
<tr><td>596</td>
<td class="covered"> $this->_table->getRepository()->add($this);
</td></tr>
<tr><td>597</td>
<td class="normal">
</td></tr>
<tr><td>598</td>
<td class="covered"> $this->cleanData($this->_data);
</td></tr>
<tr><td>599</td>
<td class="normal">
</td></tr>
<tr><td>600</td>
<td class="covered"> $this->prepareIdentifiers($this->exists());
</td></tr>
<tr><td>601</td>
<td class="normal">
</td></tr>
<tr><td>602</td>
<td class="covered"> $this->postUnserialize($event);
</td></tr>
<tr><td>603</td>
<td class="covered"> }
</td></tr>
<tr><td>604</td>
<td class="normal">
</td></tr>
<tr><td>605</td>
<td class="normal"> /**
</td></tr>
<tr><td>606</td>
<td class="normal"> * state
</td></tr>
<tr><td>607</td>
<td class="normal"> * returns / assigns the state of this record
</td></tr>
<tr><td>608</td>
<td class="normal"> *
</td></tr>
<tr><td>609</td>
<td class="normal"> * @param integer|string $state if set, this method tries to set the record state to $state
</td></tr>
<tr><td>610</td>
<td class="normal"> * @see Doctrine_Record::STATE_* constants
</td></tr>
<tr><td>611</td>
<td class="normal"> *
</td></tr>
<tr><td>612</td>
<td class="normal"> * @throws Doctrine_Record_State_Exception if trying to set an unknown state
</td></tr>
<tr><td>613</td>
<td class="normal"> * @return null|integer
</td></tr>
<tr><td>614</td>
<td class="normal"> */
</td></tr>
<tr><td>615</td>
<td class="normal"> public function state($state = null)
</td></tr>
<tr><td>616</td>
<td class="normal"> {
</td></tr>
<tr><td>617</td>
<td class="covered"> if ($state == null) {
</td></tr>
<tr><td>618</td>
<td class="covered"> return $this->_state;
</td></tr>
<tr><td>619</td>
<td class="orange"> }
</td></tr>
<tr><td>620</td>
<td class="covered"> $err = false;
</td></tr>
<tr><td>621</td>
<td class="covered"> if (is_integer($state)) {
</td></tr>
<tr><td>622</td>
<td class="covered"> if ($state >= 1 && $state <= 6) {
</td></tr>
<tr><td>623</td>
<td class="covered"> $this->_state = $state;
</td></tr>
<tr><td>624</td>
<td class="covered"> } else {
</td></tr>
<tr><td>625</td>
<td class="red"> $err = true;
</td></tr>
<tr><td>626</td>
<td class="normal"> }
</td></tr>
<tr><td>627</td>
<td class="covered"> } else if (is_string($state)) {
</td></tr>
<tr><td>628</td>
<td class="red"> $upper = strtoupper($state);
</td></tr>
<tr><td>629</td>
<td class="normal">
</td></tr>
<tr><td>630</td>
<td class="red"> $const = 'Doctrine_Record::STATE_' . $upper;
</td></tr>
<tr><td>631</td>
<td class="red"> if (defined($const)) {
</td></tr>
<tr><td>632</td>
<td class="red"> $this->_state = constant($const);
</td></tr>
<tr><td>633</td>
<td class="red"> } else {
</td></tr>
<tr><td>634</td>
<td class="red"> $err = true;
</td></tr>
<tr><td>635</td>
<td class="normal"> }
</td></tr>
<tr><td>636</td>
<td class="red"> }
</td></tr>
<tr><td>637</td>
<td class="normal">
</td></tr>
<tr><td>638</td>
<td class="covered"> if ($this->_state === Doctrine_Record::STATE_TCLEAN ||
</td></tr>
<tr><td>639</td>
<td class="covered"> $this->_state === Doctrine_Record::STATE_CLEAN) {
</td></tr>
<tr><td>640</td>
<td class="covered"> $this->_modified = array();
</td></tr>
<tr><td>641</td>
<td class="covered"> }
</td></tr>
<tr><td>642</td>
<td class="normal">
</td></tr>
<tr><td>643</td>
<td class="covered"> if ($err) {
</td></tr>
<tr><td>644</td>
<td class="red"> throw new Doctrine_Record_State_Exception('Unknown record state ' . $state);
</td></tr>
<tr><td>645</td>
<td class="orange"> }
</td></tr>
<tr><td>646</td>
<td class="covered"> }
</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"> * refresh
</td></tr>
<tr><td>650</td>
<td class="normal"> * refresh internal data from the database
</td></tr>
<tr><td>651</td>
<td class="normal"> *
</td></tr>
<tr><td>652</td>
<td class="normal"> * @throws Doctrine_Record_Exception When the refresh operation fails (when the database row
</td></tr>
<tr><td>653</td>
<td class="normal"> * this record represents does not exist anymore)
</td></tr>
<tr><td>654</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>655</td>
<td class="normal"> */
</td></tr>
<tr><td>656</td>
<td class="normal"> public function refresh()
</td></tr>
<tr><td>657</td>
<td class="normal"> {
</td></tr>
<tr><td>658</td>
<td class="covered"> $id = $this->identifier();
</td></tr>
<tr><td>659</td>
<td class="covered"> if ( ! is_array($id)) {
</td></tr>
<tr><td>660</td>
<td class="red"> $id = array($id);
</td></tr>
<tr><td>661</td>
<td class="red"> }
</td></tr>
<tr><td>662</td>
<td class="covered"> if (empty($id)) {
</td></tr>
<tr><td>663</td>
<td class="red"> return false;
</td></tr>
<tr><td>664</td>
<td class="orange"> }
</td></tr>
<tr><td>665</td>
<td class="covered"> $id = array_values($id);
</td></tr>
<tr><td>666</td>
<td class="normal">
</td></tr>
<tr><td>667</td>
<td class="normal"> // Use FETCH_ARRAY to avoid clearing object relations
</td></tr>
<tr><td>668</td>
<td class="covered"> $record = $this->getTable()->find($id, Doctrine::FETCH_ARRAY);
</td></tr>
<tr><td>669</td>
<td class="normal">
</td></tr>
<tr><td>670</td>
<td class="covered"> if ($record === false) {
</td></tr>
<tr><td>671</td>
<td class="covered"> throw new Doctrine_Record_Exception('Failed to refresh. Record does not exist.');
</td></tr>
<tr><td>672</td>
<td class="orange"> }
</td></tr>
<tr><td>673</td>
<td class="normal">
</td></tr>
<tr><td>674</td>
<td class="covered"> $this->hydrate($record);
</td></tr>
<tr><td>675</td>
<td class="normal">
</td></tr>
<tr><td>676</td>
<td class="covered"> $this->_modified = array();
</td></tr>
<tr><td>677</td>
<td class="normal">
</td></tr>
<tr><td>678</td>
<td class="covered"> $this->prepareIdentifiers();
</td></tr>
<tr><td>679</td>
<td class="normal">
</td></tr>
<tr><td>680</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_CLEAN;
</td></tr>
<tr><td>681</td>
<td class="normal">
</td></tr>
<tr><td>682</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>683</td>
<td class="orange"> }
</td></tr>
<tr><td>684</td>
<td class="normal">
</td></tr>
<tr><td>685</td>
<td class="normal"> /**
</td></tr>
<tr><td>686</td>
<td class="normal"> * refresh
</td></tr>
<tr><td>687</td>
<td class="normal"> * refres data of related objects from the database
</td></tr>
<tr><td>688</td>
<td class="normal"> *
</td></tr>
<tr><td>689</td>
<td class="normal"> * @param string $name name of a related component.
</td></tr>
<tr><td>690</td>
<td class="normal"> * if set, this method only refreshes the specified related component
</td></tr>
<tr><td>691</td>
<td class="normal"> *
</td></tr>
<tr><td>692</td>
<td class="normal"> * @return Doctrine_Record this object
</td></tr>
<tr><td>693</td>
<td class="normal"> */
</td></tr>
<tr><td>694</td>
<td class="normal"> public function refreshRelated($name = null)
</td></tr>
<tr><td>695</td>
<td class="normal"> {
</td></tr>
<tr><td>696</td>
<td class="covered"> if (is_null($name)) {
</td></tr>
<tr><td>697</td>
<td class="covered"> foreach ($this->_table->getRelations() as $rel) {
</td></tr>
<tr><td>698</td>
<td class="covered"> $this->_references[$rel->getAlias()] = $rel->fetchRelatedFor($this);
</td></tr>
<tr><td>699</td>
<td class="covered"> }
</td></tr>
<tr><td>700</td>
<td class="covered"> } else {
</td></tr>
<tr><td>701</td>
<td class="covered"> $rel = $this->_table->getRelation($name);
</td></tr>
<tr><td>702</td>
<td class="covered"> $this->_references[$name] = $rel->fetchRelatedFor($this);
</td></tr>
<tr><td>703</td>
<td class="normal"> }
</td></tr>
<tr><td>704</td>
<td class="covered"> }
</td></tr>
<tr><td>705</td>
<td class="normal">
</td></tr>
<tr><td>706</td>
<td class="normal"> /**
</td></tr>
<tr><td>707</td>
<td class="normal"> * clearRelated
</td></tr>
<tr><td>708</td>
<td class="normal"> * unsets all the relationships this object has
</td></tr>
<tr><td>709</td>
<td class="normal"> *
</td></tr>
<tr><td>710</td>
<td class="normal"> * (references to related objects still remain on Table objects)
</td></tr>
<tr><td>711</td>
<td class="normal"> */
</td></tr>
<tr><td>712</td>
<td class="normal"> public function clearRelated()
</td></tr>
<tr><td>713</td>
<td class="normal"> {
</td></tr>
<tr><td>714</td>
<td class="covered"> $this->_references = array();
</td></tr>
<tr><td>715</td>
<td class="covered"> }
</td></tr>
<tr><td>716</td>
<td class="normal">
</td></tr>
<tr><td>717</td>
<td class="normal"> /**
</td></tr>
<tr><td>718</td>
<td class="normal"> * getTable
</td></tr>
<tr><td>719</td>
<td class="normal"> * returns the table object for this record
</td></tr>
<tr><td>720</td>
<td class="normal"> *
</td></tr>
<tr><td>721</td>
<td class="normal"> * @return Doctrine_Table a Doctrine_Table object
</td></tr>
<tr><td>722</td>
<td class="normal"> */
</td></tr>
<tr><td>723</td>
<td class="normal"> public function getTable()
</td></tr>
<tr><td>724</td>
<td class="normal"> {
</td></tr>
<tr><td>725</td>
<td class="covered"> return $this->_table;
</td></tr>
<tr><td>726</td>
<td class="orange"> }
</td></tr>
<tr><td>727</td>
<td class="normal">
</td></tr>
<tr><td>728</td>
<td class="normal"> /**
</td></tr>
<tr><td>729</td>
<td class="normal"> * getData
</td></tr>
<tr><td>730</td>
<td class="normal"> * return all the internal data
</td></tr>
<tr><td>731</td>
<td class="normal"> *
</td></tr>
<tr><td>732</td>
<td class="normal"> * @return array an array containing all the properties
</td></tr>
<tr><td>733</td>
<td class="normal"> */
</td></tr>
<tr><td>734</td>
<td class="normal"> public function getData()
</td></tr>
<tr><td>735</td>
<td class="normal"> {
</td></tr>
<tr><td>736</td>
<td class="covered"> return $this->_data;
</td></tr>
<tr><td>737</td>
<td class="orange"> }
</td></tr>
<tr><td>738</td>
<td class="normal">
</td></tr>
<tr><td>739</td>
<td class="normal"> /**
</td></tr>
<tr><td>740</td>
<td class="normal"> * rawGet
</td></tr>
<tr><td>741</td>
<td class="normal"> * returns the value of a property, if the property is not yet loaded
</td></tr>
<tr><td>742</td>
<td class="normal"> * this method does NOT load it
</td></tr>
<tr><td>743</td>
<td class="normal"> *
</td></tr>
<tr><td>744</td>
<td class="normal"> * @param $name name of the property
</td></tr>
<tr><td>745</td>
<td class="normal"> * @throws Doctrine_Record_Exception if trying to get an unknown property
</td></tr>
<tr><td>746</td>
<td class="normal"> * @return mixed
</td></tr>
<tr><td>747</td>
<td class="normal"> */
</td></tr>
<tr><td>748</td>
<td class="normal"> public function rawGet($fieldName)
</td></tr>
<tr><td>749</td>
<td class="normal"> {
</td></tr>
<tr><td>750</td>
<td class="covered"> if ( ! isset($this->_data[$fieldName])) {
</td></tr>
<tr><td>751</td>
<td class="red"> throw new Doctrine_Record_Exception('Unknown property '. $fieldName);
</td></tr>
<tr><td>752</td>
<td class="orange"> }
</td></tr>
<tr><td>753</td>
<td class="covered"> if ($this->_data[$fieldName] === self::$_null) {
</td></tr>
<tr><td>754</td>
<td class="red"> return null;
</td></tr>
<tr><td>755</td>
<td class="orange"> }
</td></tr>
<tr><td>756</td>
<td class="normal">
</td></tr>
<tr><td>757</td>
<td class="covered"> return $this->_data[$fieldName];
</td></tr>
<tr><td>758</td>
<td class="orange"> }
</td></tr>
<tr><td>759</td>
<td class="normal">
</td></tr>
<tr><td>760</td>
<td class="normal"> /**
</td></tr>
<tr><td>761</td>
<td class="normal"> * load
</td></tr>
<tr><td>762</td>
<td class="normal"> * loads all the uninitialized properties from the database
</td></tr>
<tr><td>763</td>
<td class="normal"> *
</td></tr>
<tr><td>764</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>765</td>
<td class="normal"> */
</td></tr>
<tr><td>766</td>
<td class="normal"> public function load()
</td></tr>
<tr><td>767</td>
<td class="normal"> {
</td></tr>
<tr><td>768</td>
<td class="normal"> // only load the data from database if the Doctrine_Record is in proxy state
</td></tr>
<tr><td>769</td>
<td class="covered"> if ($this->_state == Doctrine_Record::STATE_PROXY) {
</td></tr>
<tr><td>770</td>
<td class="red"> $this->refresh();
</td></tr>
<tr><td>771</td>
<td class="red"> $this->_state = Doctrine_Record::STATE_CLEAN;
</td></tr>
<tr><td>772</td>
<td class="red"> return true;
</td></tr>
<tr><td>773</td>
<td class="orange"> }
</td></tr>
<tr><td>774</td>
<td class="covered"> return false;
</td></tr>
<tr><td>775</td>
<td class="orange"> }
</td></tr>
<tr><td>776</td>
<td class="normal">
</td></tr>
<tr><td>777</td>
<td class="normal"> /**
</td></tr>
<tr><td>778</td>
<td class="normal"> * get
</td></tr>
<tr><td>779</td>
<td class="normal"> * returns a value of a property or a related component
</td></tr>
<tr><td>780</td>
<td class="normal"> *
</td></tr>
<tr><td>781</td>
<td class="normal"> * @param mixed $name name of the property or related component
</td></tr>
<tr><td>782</td>
<td class="normal"> * @param boolean $load whether or not to invoke the loading procedure
</td></tr>
<tr><td>783</td>
<td class="normal"> * @throws Doctrine_Record_Exception if trying to get a value of unknown property / related component
</td></tr>
<tr><td>784</td>
<td class="normal"> * @return mixed
</td></tr>
<tr><td>785</td>
<td class="normal"> */
</td></tr>
<tr><td>786</td>
<td class="normal"> public function get($fieldName, $load = true)
</td></tr>
<tr><td>787</td>
<td class="normal"> {
</td></tr>
<tr><td>788</td>
<td class="covered"> $value = self::$_null;
</td></tr>
<tr><td>789</td>
<td class="normal">
</td></tr>
<tr><td>790</td>
<td class="covered"> if (isset($this->_data[$fieldName])) {
</td></tr>
<tr><td>791</td>
<td class="normal"> // check if the value is the Doctrine_Null object located in self::$_null)
</td></tr>
<tr><td>792</td>
<td class="covered"> if ($this->_data[$fieldName] === self::$_null && $load) {
</td></tr>
<tr><td>793</td>
<td class="covered"> $this->load();
</td></tr>
<tr><td>794</td>
<td class="covered"> }
</td></tr>
<tr><td>795</td>
<td class="normal">
</td></tr>
<tr><td>796</td>
<td class="covered"> if ($this->_data[$fieldName] === self::$_null) {
</td></tr>
<tr><td>797</td>
<td class="covered"> $value = null;
</td></tr>
<tr><td>798</td>
<td class="covered"> } else {
</td></tr>
<tr><td>799</td>
<td class="covered"> $value = $this->_data[$fieldName];
</td></tr>
<tr><td>800</td>
<td class="normal"> }
</td></tr>
<tr><td>801</td>
<td class="covered"> return $value;
</td></tr>
<tr><td>802</td>
<td class="orange"> }
</td></tr>
<tr><td>803</td>
<td class="normal">
</td></tr>
<tr><td>804</td>
<td class="covered"> if (isset($this->_values[$fieldName])) {
</td></tr>
<tr><td>805</td>
<td class="covered"> return $this->_values[$fieldName];
</td></tr>
<tr><td>806</td>
<td class="orange"> }
</td></tr>
<tr><td>807</td>
<td class="normal">
</td></tr>
<tr><td>808</td>
<td class="normal"> try {
</td></tr>
<tr><td>809</td>
<td class="covered"> if ( ! isset($this->_references[$fieldName]) && $load) {
</td></tr>
<tr><td>810</td>
<td class="normal">
</td></tr>
<tr><td>811</td>
<td class="covered"> $rel = $this->_table->getRelation($fieldName);
</td></tr>
<tr><td>812</td>
<td class="normal">
</td></tr>
<tr><td>813</td>
<td class="covered"> $this->_references[$fieldName] = $rel->fetchRelatedFor($this);
</td></tr>
<tr><td>814</td>
<td class="covered"> }
</td></tr>
<tr><td>815</td>
<td class="covered"> return $this->_references[$fieldName];
</td></tr>
<tr><td>816</td>
<td class="normal">
</td></tr>
<tr><td>817</td>
<td class="covered"> } catch (Doctrine_Table_Exception $e) {
</td></tr>
<tr><td>818</td>
<td class="covered"> foreach ($this->_table->getFilters() as $filter) {
</td></tr>
<tr><td>819</td>
<td class="covered"> if (($value = $filter->filterGet($this, $fieldName, $value)) !== null) {
</td></tr>
<tr><td>820</td>
<td class="covered"> return $value;
</td></tr>
<tr><td>821</td>
<td class="orange"> }
</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="orange"> }
</td></tr>
<tr><td>825</td>
<td class="normal">
</td></tr>
<tr><td>826</td>
<td class="normal"> /**
</td></tr>
<tr><td>827</td>
<td class="normal"> * mapValue
</td></tr>
<tr><td>828</td>
<td class="normal"> * This simple method is used for mapping values to $values property.
</td></tr>
<tr><td>829</td>
<td class="normal"> * Usually this method is used internally by Doctrine for the mapping of
</td></tr>
<tr><td>830</td>
<td class="normal"> * aggregate values.
</td></tr>
<tr><td>831</td>
<td class="normal"> *
</td></tr>
<tr><td>832</td>
<td class="normal"> * @param string $name the name of the mapped value
</td></tr>
<tr><td>833</td>
<td class="normal"> * @param mixed $value mixed value to be mapped
</td></tr>
<tr><td>834</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>835</td>
<td class="normal"> */
</td></tr>
<tr><td>836</td>
<td class="normal"> public function mapValue($name, $value)
</td></tr>
<tr><td>837</td>
<td class="normal"> {
</td></tr>
<tr><td>838</td>
<td class="covered"> $this->_values[$name] = $value;
</td></tr>
<tr><td>839</td>
<td class="covered"> }
</td></tr>
<tr><td>840</td>
<td class="normal">
</td></tr>
<tr><td>841</td>
<td class="normal"> /**
</td></tr>
<tr><td>842</td>
<td class="normal"> * set
</td></tr>
<tr><td>843</td>
<td class="normal"> * method for altering properties and Doctrine_Record references
</td></tr>
<tr><td>844</td>
<td class="normal"> * if the load parameter is set to false this method will not try to load uninitialized record data
</td></tr>
<tr><td>845</td>
<td class="normal"> *
</td></tr>
<tr><td>846</td>
<td class="normal"> * @param mixed $name name of the property or reference
</td></tr>
<tr><td>847</td>
<td class="normal"> * @param mixed $value value of the property or reference
</td></tr>
<tr><td>848</td>
<td class="normal"> * @param boolean $load whether or not to refresh / load the uninitialized record data
</td></tr>
<tr><td>849</td>
<td class="normal"> *
</td></tr>
<tr><td>850</td>
<td class="normal"> * @throws Doctrine_Record_Exception if trying to set a value for unknown property / related component
</td></tr>
<tr><td>851</td>
<td class="normal"> * @throws Doctrine_Record_Exception if trying to set a value of wrong type for related component
</td></tr>
<tr><td>852</td>
<td class="normal"> *
</td></tr>
<tr><td>853</td>
<td class="normal"> * @return Doctrine_Record
</td></tr>
<tr><td>854</td>
<td class="normal"> */
</td></tr>
<tr><td>855</td>
<td class="normal"> public function set($fieldName, $value, $load = true)
</td></tr>
<tr><td>856</td>
<td class="normal"> {
</td></tr>
<tr><td>857</td>
<td class="covered"> if (isset($this->_data[$fieldName])) {
</td></tr>
<tr><td>858</td>
<td class="covered"> if ($value instanceof Doctrine_Record) {
</td></tr>
<tr><td>859</td>
<td class="covered"> $type = $this->_table->getTypeOf($fieldName);
</td></tr>
<tr><td>860</td>
<td class="normal">
</td></tr>
<tr><td>861</td>
<td class="covered"> $id = $value->getIncremented();
</td></tr>
<tr><td>862</td>
<td class="normal">
</td></tr>
<tr><td>863</td>
<td class="covered"> if ($id !== null && $type !== 'object') {
</td></tr>
<tr><td>864</td>
<td class="covered"> $value = $id;
</td></tr>
<tr><td>865</td>
<td class="covered"> }
</td></tr>
<tr><td>866</td>
<td class="covered"> }
</td></tr>
<tr><td>867</td>
<td class="normal">
</td></tr>
<tr><td>868</td>
<td class="covered"> if ($load) {
</td></tr>
<tr><td>869</td>
<td class="covered"> $old = $this->get($fieldName, $load);
</td></tr>
<tr><td>870</td>
<td class="covered"> } else {
</td></tr>
<tr><td>871</td>
<td class="covered"> $old = $this->_data[$fieldName];
</td></tr>
<tr><td>872</td>
<td class="normal"> }
</td></tr>
<tr><td>873</td>
<td class="normal">
</td></tr>
<tr><td>874</td>
<td class="covered"> if ($old !== $value) {
</td></tr>
<tr><td>875</td>
<td class="covered"> if ($value === null) {
</td></tr>
<tr><td>876</td>
<td class="covered"> $value = self::$_null;
</td></tr>
<tr><td>877</td>
<td class="covered"> }
</td></tr>
<tr><td>878</td>
<td class="normal">
</td></tr>
<tr><td>879</td>
<td class="covered"> $this->_data[$fieldName] = $value;
</td></tr>
<tr><td>880</td>
<td class="covered"> $this->_modified[] = $fieldName;
</td></tr>
<tr><td>881</td>
<td class="covered"> switch ($this->_state) {
</td></tr>
<tr><td>882</td>
<td class="covered"> case Doctrine_Record::STATE_CLEAN:
</td></tr>
<tr><td>883</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_DIRTY;
</td></tr>
<tr><td>884</td>
<td class="covered"> break;
</td></tr>
<tr><td>885</td>
<td class="covered"> case Doctrine_Record::STATE_TCLEAN:
</td></tr>
<tr><td>886</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_TDIRTY;
</td></tr>
<tr><td>887</td>
<td class="covered"> break;
</td></tr>
<tr><td>888</td>
<td class="red"> }
</td></tr>
<tr><td>889</td>
<td class="covered"> }
</td></tr>
<tr><td>890</td>
<td class="covered"> } else {
</td></tr>
<tr><td>891</td>
<td class="normal"> try {
</td></tr>
<tr><td>892</td>
<td class="covered"> $this->coreSetRelated($fieldName, $value);
</td></tr>
<tr><td>893</td>
<td class="covered"> } catch (Doctrine_Table_Exception $e) {
</td></tr>
<tr><td>894</td>
<td class="covered"> foreach ($this->_table->getFilters() as $filter) {
</td></tr>
<tr><td>895</td>
<td class="covered"> if (($value = $filter->filterSet($this, $fieldName, $value)) !== null) {
</td></tr>
<tr><td>896</td>
<td class="covered"> return $value;
</td></tr>
<tr><td>897</td>
<td class="orange"> }
</td></tr>
<tr><td>898</td>
<td class="orange"> }
</td></tr>
<tr><td>899</td>
<td class="normal"> }
</td></tr>
<tr><td>900</td>
<td class="normal"> }
</td></tr>
<tr><td>901</td>
<td class="covered"> }
</td></tr>
<tr><td>902</td>
<td class="normal">
</td></tr>
<tr><td>903</td>
<td class="normal"> /**
</td></tr>
<tr><td>904</td>
<td class="normal"> * DESCRIBE WHAT THIS METHOD DOES, PLEASE!
</td></tr>
<tr><td>905</td>
<td class="normal"> * @todo Refactor. What about composite keys?
</td></tr>
<tr><td>906</td>
<td class="normal"> */
</td></tr>
<tr><td>907</td>
<td class="normal"> public function coreSetRelated($name, $value)
</td></tr>
<tr><td>908</td>
<td class="normal"> {
</td></tr>
<tr><td>909</td>
<td class="covered"> $rel = $this->_table->getRelation($name);
</td></tr>
<tr><td>910</td>
<td class="normal">
</td></tr>
<tr><td>911</td>
<td class="normal"> // one-to-many or one-to-one relation
</td></tr>
<tr><td>912</td>
<td class="covered"> if ($rel instanceof Doctrine_Relation_ForeignKey ||
</td></tr>
<tr><td>913</td>
<td class="covered"> $rel instanceof Doctrine_Relation_LocalKey) {
</td></tr>
<tr><td>914</td>
<td class="covered"> if ( ! $rel->isOneToOne()) {
</td></tr>
<tr><td>915</td>
<td class="normal"> // one-to-many relation found
</td></tr>
<tr><td>916</td>
<td class="covered"> if ( ! ($value instanceof Doctrine_Collection)) {
</td></tr>
<tr><td>917</td>
<td class="red"> throw new Doctrine_Record_Exception("Couldn't call Doctrine::set(), second argument should be an instance of Doctrine_Collection when setting one-to-many references.");
</td></tr>
<tr><td>918</td>
<td class="orange"> }
</td></tr>
<tr><td>919</td>
<td class="covered"> if (isset($this->_references[$name])) {
</td></tr>
<tr><td>920</td>
<td class="covered"> $this->_references[$name]->setData($value->getData());
</td></tr>
<tr><td>921</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>922</td>
<td class="orange"> }
</td></tr>
<tr><td>923</td>
<td class="red"> } else {
</td></tr>
<tr><td>924</td>
<td class="covered"> if ($value !== self::$_null) {
</td></tr>
<tr><td>925</td>
<td class="covered"> $relatedTable = $value->getTable();
</td></tr>
<tr><td>926</td>
<td class="covered"> $foreignFieldName = $relatedTable->getFieldName($rel->getForeign());
</td></tr>
<tr><td>927</td>
<td class="covered"> $localFieldName = $this->_table->getFieldName($rel->getLocal());
</td></tr>
<tr><td>928</td>
<td class="normal">
</td></tr>
<tr><td>929</td>
<td class="normal"> // one-to-one relation found
</td></tr>
<tr><td>930</td>
<td class="covered"> if ( ! ($value instanceof Doctrine_Record)) {
</td></tr>
<tr><td>931</td>
<td class="red"> throw new Doctrine_Record_Exception("Couldn't call Doctrine::set(), second argument should be an instance of Doctrine_Record or Doctrine_Null when setting one-to-one references.");
</td></tr>
<tr><td>932</td>
<td class="orange"> }
</td></tr>
<tr><td>933</td>
<td class="covered"> if ($rel instanceof Doctrine_Relation_LocalKey) {
</td></tr>
<tr><td>934</td>
<td class="covered"> if ( ! empty($foreignFieldName) && $foreignFieldName != $value->getTable()->getIdentifier()) {
</td></tr>
<tr><td>935</td>
<td class="covered"> $this->set($localFieldName, $value->rawGet($foreignFieldName), false);
</td></tr>
<tr><td>936</td>
<td class="covered"> } else {
</td></tr>
<tr><td>937</td>
<td class="covered"> $this->set($localFieldName, $value, false);
</td></tr>
<tr><td>938</td>
<td class="normal"> }
</td></tr>
<tr><td>939</td>
<td class="covered"> } else {
</td></tr>
<tr><td>940</td>
<td class="covered"> $value->set($foreignFieldName, $this, false);
</td></tr>
<tr><td>941</td>
<td class="normal"> }
</td></tr>
<tr><td>942</td>
<td class="covered"> }
</td></tr>
<tr><td>943</td>
<td class="normal"> }
</td></tr>
<tr><td>944</td>
<td class="normal">
</td></tr>
<tr><td>945</td>
<td class="covered"> } else if ($rel instanceof Doctrine_Relation_Association) {
</td></tr>
<tr><td>946</td>
<td class="normal"> // join table relation found
</td></tr>
<tr><td>947</td>
<td class="covered"> if ( ! ($value instanceof Doctrine_Collection)) {
</td></tr>
<tr><td>948</td>
<td class="red"> throw new Doctrine_Record_Exception("Couldn't call Doctrine::set(), second argument should be an instance of Doctrine_Collection when setting many-to-many references.");
</td></tr>
<tr><td>949</td>
<td class="orange"> }
</td></tr>
<tr><td>950</td>
<td class="covered"> }
</td></tr>
<tr><td>951</td>
<td class="normal">
</td></tr>
<tr><td>952</td>
<td class="covered"> $this->_references[$name] = $value;
</td></tr>
<tr><td>953</td>
<td class="covered"> }
</td></tr>
<tr><td>954</td>
<td class="normal">
</td></tr>
<tr><td>955</td>
<td class="normal"> /**
</td></tr>
<tr><td>956</td>
<td class="normal"> * contains
</td></tr>
<tr><td>957</td>
<td class="normal"> *
</td></tr>
<tr><td>958</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>959</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>960</td>
<td class="normal"> */
</td></tr>
<tr><td>961</td>
<td class="normal"> public function contains($fieldName)
</td></tr>
<tr><td>962</td>
<td class="normal"> {
</td></tr>
<tr><td>963</td>
<td class="covered"> if (isset($this->_data[$fieldName])) {
</td></tr>
<tr><td>964</td>
<td class="covered"> return true;
</td></tr>
<tr><td>965</td>
<td class="orange"> }
</td></tr>
<tr><td>966</td>
<td class="covered"> if (isset($this->_id[$fieldName])) {
</td></tr>
<tr><td>967</td>
<td class="red"> return true;
</td></tr>
<tr><td>968</td>
<td class="orange"> }
</td></tr>
<tr><td>969</td>
<td class="covered"> if (isset($this->_values[$fieldName])) {
</td></tr>
<tr><td>970</td>
<td class="red"> return true;
</td></tr>
<tr><td>971</td>
<td class="orange"> }
</td></tr>
<tr><td>972</td>
<td class="covered"> if (isset($this->_references[$fieldName]) &&
</td></tr>
<tr><td>973</td>
<td class="covered"> $this->_references[$fieldName] !== self::$_null) {
</td></tr>
<tr><td>974</td>
<td class="normal">
</td></tr>
<tr><td>975</td>
<td class="covered"> return true;
</td></tr>
<tr><td>976</td>
<td class="orange"> }
</td></tr>
<tr><td>977</td>
<td class="covered"> return false;
</td></tr>
<tr><td>978</td>
<td class="orange"> }
</td></tr>
<tr><td>979</td>
<td class="normal">
</td></tr>
<tr><td>980</td>
<td class="normal"> /**
</td></tr>
<tr><td>981</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>982</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>983</td>
<td class="normal"> */
</td></tr>
<tr><td>984</td>
<td class="normal"> public function __unset($fieldName)
</td></tr>
<tr><td>985</td>
<td class="normal"> {
</td></tr>
<tr><td>986</td>
<td class="red"> if (isset($this->_data[$fieldName])) {
</td></tr>
<tr><td>987</td>
<td class="red"> $this->_data[$fieldName] = array();
</td></tr>
<tr><td>988</td>
<td class="red"> }
</td></tr>
<tr><td>989</td>
<td class="normal"> // todo: what to do with references ?
</td></tr>
<tr><td>990</td>
<td class="red"> }
</td></tr>
<tr><td>991</td>
<td class="normal">
</td></tr>
<tr><td>992</td>
<td class="normal"> /**
</td></tr>
<tr><td>993</td>
<td class="normal"> * applies the changes made to this object into database
</td></tr>
<tr><td>994</td>
<td class="normal"> * this method is smart enough to know if any changes are made
</td></tr>
<tr><td>995</td>
<td class="normal"> * and whether to use INSERT or UPDATE statement
</td></tr>
<tr><td>996</td>
<td class="normal"> *
</td></tr>
<tr><td>997</td>
<td class="normal"> * this method also saves the related components
</td></tr>
<tr><td>998</td>
<td class="normal"> *
</td></tr>
<tr><td>999</td>
<td class="normal"> * @param Doctrine_Connection $conn optional connection parameter
</td></tr>
<tr><td>1000</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1001</td>
<td class="normal"> */
</td></tr>
<tr><td>1002</td>
<td class="normal"> public function save(Doctrine_Connection $conn = null)
</td></tr>
<tr><td>1003</td>
<td class="normal"> {
</td></tr>
<tr><td>1004</td>
<td class="covered"> if ($conn === null) {
</td></tr>
<tr><td>1005</td>
<td class="covered"> $conn = $this->_table->getConnection();
</td></tr>
<tr><td>1006</td>
<td class="covered"> }
</td></tr>
<tr><td>1007</td>
<td class="covered"> $conn->unitOfWork->saveGraph($this);
</td></tr>
<tr><td>1008</td>
<td class="covered"> }
</td></tr>
<tr><td>1009</td>
<td class="normal">
</td></tr>
<tr><td>1010</td>
<td class="normal"> /**
</td></tr>
<tr><td>1011</td>
<td class="normal"> * Tries to save the object and all its related components.
</td></tr>
<tr><td>1012</td>
<td class="normal"> * In contrast to Doctrine_Record::save(), this method does not
</td></tr>
<tr><td>1013</td>
<td class="normal"> * throw an exception when validation fails but returns TRUE on
</td></tr>
<tr><td>1014</td>
<td class="normal"> * success or FALSE on failure.
</td></tr>
<tr><td>1015</td>
<td class="normal"> *
</td></tr>
<tr><td>1016</td>
<td class="normal"> * @param Doctrine_Connection $conn optional connection parameter
</td></tr>
<tr><td>1017</td>
<td class="normal"> * @return TRUE if the record was saved sucessfully without errors, FALSE otherwise.
</td></tr>
<tr><td>1018</td>
<td class="normal"> */
</td></tr>
<tr><td>1019</td>
<td class="normal"> public function trySave(Doctrine_Connection $conn = null) {
</td></tr>
<tr><td>1020</td>
<td class="normal"> try {
</td></tr>
<tr><td>1021</td>
<td class="covered"> $this->save($conn);
</td></tr>
<tr><td>1022</td>
<td class="covered"> return true;
</td></tr>
<tr><td>1023</td>
<td class="covered"> } catch (Doctrine_Validator_Exception $ignored) {
</td></tr>
<tr><td>1024</td>
<td class="covered"> return false;
</td></tr>
<tr><td>1025</td>
<td class="normal"> }
</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"> * replace
</td></tr>
<tr><td>1030</td>
<td class="normal"> * Execute a SQL REPLACE query. A REPLACE query is identical to a INSERT
</td></tr>
<tr><td>1031</td>
<td class="normal"> * query, except that if there is already a row in the table with the same
</td></tr>
<tr><td>1032</td>
<td class="normal"> * key field values, the REPLACE query just updates its values instead of
</td></tr>
<tr><td>1033</td>
<td class="normal"> * inserting a new row.
</td></tr>
<tr><td>1034</td>
<td class="normal"> *
</td></tr>
<tr><td>1035</td>
<td class="normal"> * The REPLACE type of query does not make part of the SQL standards. Since
</td></tr>
<tr><td>1036</td>
<td class="normal"> * practically only MySQL and SQLIte implement it natively, this type of
</td></tr>
<tr><td>1037</td>
<td class="normal"> * query isemulated through this method for other DBMS using standard types
</td></tr>
<tr><td>1038</td>
<td class="normal"> * of queries inside a transaction to assure the atomicity of the operation.
</td></tr>
<tr><td>1039</td>
<td class="normal"> *
</td></tr>
<tr><td>1040</td>
<td class="normal"> * @param Doctrine_Connection $conn optional connection parameter
</td></tr>
<tr><td>1041</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if some of the key values was null
</td></tr>
<tr><td>1042</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if there were no key fields
</td></tr>
<tr><td>1043</td>
<td class="normal"> * @throws Doctrine_Connection_Exception if something fails at database level
</td></tr>
<tr><td>1044</td>
<td class="normal"> * @return integer number of rows affected
</td></tr>
<tr><td>1045</td>
<td class="normal"> */
</td></tr>
<tr><td>1046</td>
<td class="normal"> public function replace(Doctrine_Connection $conn = null)
</td></tr>
<tr><td>1047</td>
<td class="normal"> {
</td></tr>
<tr><td>1048</td>
<td class="red"> if ($conn === null) {
</td></tr>
<tr><td>1049</td>
<td class="red"> $conn = $this->_table->getConnection();
</td></tr>
<tr><td>1050</td>
<td class="red"> }
</td></tr>
<tr><td>1051</td>
<td class="normal">
</td></tr>
<tr><td>1052</td>
<td class="red"> return $conn->replace($this->_table, $this->getPrepared(), $this->_id);
</td></tr>
<tr><td>1053</td>
<td class="orange"> }
</td></tr>
<tr><td>1054</td>
<td class="normal">
</td></tr>
<tr><td>1055</td>
<td class="normal"> /**
</td></tr>
<tr><td>1056</td>
<td class="normal"> * returns an array of modified fields and associated values
</td></tr>
<tr><td>1057</td>
<td class="normal"> * @return array
</td></tr>
<tr><td>1058</td>
<td class="normal"> * @todo What about a better name? getModifiedFields?
</td></tr>
<tr><td>1059</td>
<td class="normal"> */
</td></tr>
<tr><td>1060</td>
<td class="normal"> public function getModified()
</td></tr>
<tr><td>1061</td>
<td class="normal"> {
</td></tr>
<tr><td>1062</td>
<td class="covered"> $a = array();
</td></tr>
<tr><td>1063</td>
<td class="normal">
</td></tr>
<tr><td>1064</td>
<td class="covered"> foreach ($this->_modified as $k => $v) {
</td></tr>
<tr><td>1065</td>
<td class="covered"> $a[$v] = $this->_data[$v];
</td></tr>
<tr><td>1066</td>
<td class="covered"> }
</td></tr>
<tr><td>1067</td>
<td class="covered"> return $a;
</td></tr>
<tr><td>1068</td>
<td class="orange"> }
</td></tr>
<tr><td>1069</td>
<td class="normal">
</td></tr>
<tr><td>1070</td>
<td class="normal"> /**
</td></tr>
<tr><td>1071</td>
<td class="normal"> * REDUNDANT?
</td></tr>
<tr><td>1072</td>
<td class="normal"> */
</td></tr>
<tr><td>1073</td>
<td class="normal"> public function modifiedFields()
</td></tr>
<tr><td>1074</td>
<td class="normal"> {
</td></tr>
<tr><td>1075</td>
<td class="red"> $a = array();
</td></tr>
<tr><td>1076</td>
<td class="normal">
</td></tr>
<tr><td>1077</td>
<td class="red"> foreach ($this->_modified as $k => $v) {
</td></tr>
<tr><td>1078</td>
<td class="red"> $a[$v] = $this->_data[$v];
</td></tr>
<tr><td>1079</td>
<td class="red"> }
</td></tr>
<tr><td>1080</td>
<td class="red"> return $a;
</td></tr>
<tr><td>1081</td>
<td class="orange"> }
</td></tr>
<tr><td>1082</td>
<td class="normal">
</td></tr>
<tr><td>1083</td>
<td class="normal"> /**
</td></tr>
<tr><td>1084</td>
<td class="normal"> * getPrepared
</td></tr>
<tr><td>1085</td>
<td class="normal"> *
</td></tr>
<tr><td>1086</td>
<td class="normal"> * returns an array of modified fields and values with data preparation
</td></tr>
<tr><td>1087</td>
<td class="normal"> * adds column aggregation inheritance and converts Records into primary key values
</td></tr>
<tr><td>1088</td>
<td class="normal"> *
</td></tr>
<tr><td>1089</td>
<td class="normal"> * @param array $array
</td></tr>
<tr><td>1090</td>
<td class="normal"> * @return array
</td></tr>
<tr><td>1091</td>
<td class="normal"> * @todo What about a little bit more expressive name? getPreparedData?
</td></tr>
<tr><td>1092</td>
<td class="normal"> */
</td></tr>
<tr><td>1093</td>
<td class="normal"> public function getPrepared(array $array = array())
</td></tr>
<tr><td>1094</td>
<td class="normal"> {
</td></tr>
<tr><td>1095</td>
<td class="covered"> $a = array();
</td></tr>
<tr><td>1096</td>
<td class="normal">
</td></tr>
<tr><td>1097</td>
<td class="covered"> if (empty($array)) {
</td></tr>
<tr><td>1098</td>
<td class="covered"> $modifiedFields = $this->_modified;
</td></tr>
<tr><td>1099</td>
<td class="covered"> }
</td></tr>
<tr><td>1100</td>
<td class="normal">
</td></tr>
<tr><td>1101</td>
<td class="covered"> foreach ($modifiedFields as $field) {
</td></tr>
<tr><td>1102</td>
<td class="covered"> $type = $this->_table->getTypeOf($field);
</td></tr>
<tr><td>1103</td>
<td class="normal">
</td></tr>
<tr><td>1104</td>
<td class="covered"> if ($this->_data[$field] === self::$_null) {
</td></tr>
<tr><td>1105</td>
<td class="covered"> $a[$field] = null;
</td></tr>
<tr><td>1106</td>
<td class="covered"> continue;
</td></tr>
<tr><td>1107</td>
<td class="orange"> }
</td></tr>
<tr><td>1108</td>
<td class="normal">
</td></tr>
<tr><td>1109</td>
<td class="normal"> switch ($type) {
</td></tr>
<tr><td>1110</td>
<td class="covered"> case 'array':
</td></tr>
<tr><td>1111</td>
<td class="covered"> case 'object':
</td></tr>
<tr><td>1112</td>
<td class="covered"> $a[$field] = serialize($this->_data[$field]);
</td></tr>
<tr><td>1113</td>
<td class="covered"> break;
</td></tr>
<tr><td>1114</td>
<td class="covered"> case 'gzip':
</td></tr>
<tr><td>1115</td>
<td class="covered"> $a[$field] = gzcompress($this->_data[$field],5);
</td></tr>
<tr><td>1116</td>
<td class="covered"> break;
</td></tr>
<tr><td>1117</td>
<td class="covered"> case 'boolean':
</td></tr>
<tr><td>1118</td>
<td class="covered"> $a[$field] = $this->getTable()->getConnection()->convertBooleans($this->_data[$field]);
</td></tr>
<tr><td>1119</td>
<td class="covered"> break;
</td></tr>
<tr><td>1120</td>
<td class="covered"> case 'enum':
</td></tr>
<tr><td>1121</td>
<td class="covered"> $a[$field] = $this->_table->enumIndex($field, $this->_data[$field]);
</td></tr>
<tr><td>1122</td>
<td class="covered"> break;
</td></tr>
<tr><td>1123</td>
<td class="covered"> default:
</td></tr>
<tr><td>1124</td>
<td class="covered"> if ($this->_data[$field] instanceof Doctrine_Record) {
</td></tr>
<tr><td>1125</td>
<td class="covered"> $this->_data[$field] = $this->_data[$field]->getIncremented();
</td></tr>
<tr><td>1126</td>
<td class="covered"> }
</td></tr>
<tr><td>1127</td>
<td class="normal"> /** TODO:
</td></tr>
<tr><td>1128</td>
<td class="normal"> if ($this->_data[$v] === null) {
</td></tr>
<tr><td>1129</td>
<td class="normal"> throw new Doctrine_Record_Exception('Unexpected null value.');
</td></tr>
<tr><td>1130</td>
<td class="normal"> }
</td></tr>
<tr><td>1131</td>
<td class="normal"> */
</td></tr>
<tr><td>1132</td>
<td class="normal">
</td></tr>
<tr><td>1133</td>
<td class="covered"> $a[$field] = $this->_data[$field];
</td></tr>
<tr><td>1134</td>
<td class="covered"> }
</td></tr>
<tr><td>1135</td>
<td class="covered"> }
</td></tr>
<tr><td>1136</td>
<td class="covered"> $map = $this->_table->inheritanceMap;
</td></tr>
<tr><td>1137</td>
<td class="covered"> foreach ($map as $k => $v) {
</td></tr>
<tr><td>1138</td>
<td class="covered"> $old = $this->get($k, false);
</td></tr>
<tr><td>1139</td>
<td class="normal">
</td></tr>
<tr><td>1140</td>
<td class="covered"> if ((string) $old !== (string) $v || $old === null) {
</td></tr>
<tr><td>1141</td>
<td class="covered"> $a[$k] = $v;
</td></tr>
<tr><td>1142</td>
<td class="covered"> $this->_data[$k] = $v;
</td></tr>
<tr><td>1143</td>
<td class="covered"> }
</td></tr>
<tr><td>1144</td>
<td class="covered"> }
</td></tr>
<tr><td>1145</td>
<td class="normal">
</td></tr>
<tr><td>1146</td>
<td class="covered"> return $a;
</td></tr>
<tr><td>1147</td>
<td class="orange"> }
</td></tr>
<tr><td>1148</td>
<td class="normal">
</td></tr>
<tr><td>1149</td>
<td class="normal"> /**
</td></tr>
<tr><td>1150</td>
<td class="normal"> * count
</td></tr>
<tr><td>1151</td>
<td class="normal"> * this class implements countable interface
</td></tr>
<tr><td>1152</td>
<td class="normal"> *
</td></tr>
<tr><td>1153</td>
<td class="normal"> * @return integer the number of columns in this record
</td></tr>
<tr><td>1154</td>
<td class="normal"> */
</td></tr>
<tr><td>1155</td>
<td class="normal"> public function count()
</td></tr>
<tr><td>1156</td>
<td class="normal"> {
</td></tr>
<tr><td>1157</td>
<td class="covered"> return count($this->_data);
</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"> /**
</td></tr>
<tr><td>1161</td>
<td class="normal"> * alias for count()
</td></tr>
<tr><td>1162</td>
<td class="normal"> *
</td></tr>
<tr><td>1163</td>
<td class="normal"> * @return integer the number of columns in this record
</td></tr>
<tr><td>1164</td>
<td class="normal"> */
</td></tr>
<tr><td>1165</td>
<td class="normal"> public function columnCount()
</td></tr>
<tr><td>1166</td>
<td class="normal"> {
</td></tr>
<tr><td>1167</td>
<td class="red"> return $this->count();
</td></tr>
<tr><td>1168</td>
<td class="orange"> }
</td></tr>
<tr><td>1169</td>
<td class="normal">
</td></tr>
<tr><td>1170</td>
<td class="normal"> /**
</td></tr>
<tr><td>1171</td>
<td class="normal"> * toArray
</td></tr>
<tr><td>1172</td>
<td class="normal"> * returns the record as an array
</td></tr>
<tr><td>1173</td>
<td class="normal"> *
</td></tr>
<tr><td>1174</td>
<td class="normal"> * @param boolean $deep - Return also the relations
</td></tr>
<tr><td>1175</td>
<td class="normal"> * @return array
</td></tr>
<tr><td>1176</td>
<td class="normal"> */
</td></tr>
<tr><td>1177</td>
<td class="normal"> public function toArray($deep = false, $prefixKey = false)
</td></tr>
<tr><td>1178</td>
<td class="normal"> {
</td></tr>
<tr><td>1179</td>
<td class="covered"> $a = array();
</td></tr>
<tr><td>1180</td>
<td class="normal">
</td></tr>
<tr><td>1181</td>
<td class="covered"> foreach ($this as $column => $value) {
</td></tr>
<tr><td>1182</td>
<td class="covered"> if ($value === self::$_null || is_object($value)) {
</td></tr>
<tr><td>1183</td>
<td class="covered"> $value = null;
</td></tr>
<tr><td>1184</td>
<td class="covered"> }
</td></tr>
<tr><td>1185</td>
<td class="covered"> $a[$column] = $value;
</td></tr>
<tr><td>1186</td>
<td class="covered"> }
</td></tr>
<tr><td>1187</td>
<td class="covered"> if ($this->_table->getIdentifierType() == Doctrine::IDENTIFIER_AUTOINC) {
</td></tr>
<tr><td>1188</td>
<td class="covered"> $i = $this->_table->getIdentifier();
</td></tr>
<tr><td>1189</td>
<td class="covered"> $a[$i] = $this->getIncremented();
</td></tr>
<tr><td>1190</td>
<td class="covered"> }
</td></tr>
<tr><td>1191</td>
<td class="covered"> if ($deep) {
</td></tr>
<tr><td>1192</td>
<td class="red"> foreach ($this->_references as $key => $relation) {
</td></tr>
<tr><td>1193</td>
<td class="red"> if ( ! $relation instanceof Doctrine_Null) {
</td></tr>
<tr><td>1194</td>
<td class="red"> $a[$key] = $relation->toArray($deep, $prefixKey);
</td></tr>
<tr><td>1195</td>
<td class="red"> }
</td></tr>
<tr><td>1196</td>
<td class="red"> }
</td></tr>
<tr><td>1197</td>
<td class="red"> }
</td></tr>
<tr><td>1198</td>
<td class="covered"> return array_merge($a, $this->_values);
</td></tr>
<tr><td>1199</td>
<td class="orange"> }
</td></tr>
<tr><td>1200</td>
<td class="normal"> public function fromArray($array)
</td></tr>
<tr><td>1201</td>
<td class="normal"> {
</td></tr>
<tr><td>1202</td>
<td class="covered"> if (is_array($array)) {
</td></tr>
<tr><td>1203</td>
<td class="covered"> foreach ($array as $key => $value) {
</td></tr>
<tr><td>1204</td>
<td class="covered"> if ($this->getTable()->hasRelation($key)) {
</td></tr>
<tr><td>1205</td>
<td class="red"> $this->$key->fromArray($value);
</td></tr>
<tr><td>1206</td>
<td class="covered"> } else if($this->getTable()->hasColumn($key)) {
</td></tr>
<tr><td>1207</td>
<td class="covered"> $this->set($key, $value);
</td></tr>
<tr><td>1208</td>
<td class="covered"> }
</td></tr>
<tr><td>1209</td>
<td class="covered"> }
</td></tr>
<tr><td>1210</td>
<td class="covered"> }
</td></tr>
<tr><td>1211</td>
<td class="covered"> }
</td></tr>
<tr><td>1212</td>
<td class="normal"> public function exportTo($type, $deep = false)
</td></tr>
<tr><td>1213</td>
<td class="normal"> {
</td></tr>
<tr><td>1214</td>
<td class="red"> if ($type == 'array') {
</td></tr>
<tr><td>1215</td>
<td class="red"> return $this->toArray($deep);
</td></tr>
<tr><td>1216</td>
<td class="orange"> } else {
</td></tr>
<tr><td>1217</td>
<td class="red"> return Doctrine_Parser::dump($this->toArray($deep, true), $type);
</td></tr>
<tr><td>1218</td>
<td class="normal"> }
</td></tr>
<tr><td>1219</td>
<td class="orange"> }
</td></tr>
<tr><td>1220</td>
<td class="normal"> public function importFrom($type, $data)
</td></tr>
<tr><td>1221</td>
<td class="normal"> {
</td></tr>
<tr><td>1222</td>
<td class="red"> if ($type == 'array') {
</td></tr>
<tr><td>1223</td>
<td class="red"> return $this->fromArray($data);
</td></tr>
<tr><td>1224</td>
<td class="orange"> } else {
</td></tr>
<tr><td>1225</td>
<td class="red"> return $this->fromArray(Doctrine_Parser::load($data, $type));
</td></tr>
<tr><td>1226</td>
<td class="normal"> }
</td></tr>
<tr><td>1227</td>
<td class="orange"> }
</td></tr>
<tr><td>1228</td>
<td class="normal">
</td></tr>
<tr><td>1229</td>
<td class="normal"> /**
</td></tr>
<tr><td>1230</td>
<td class="normal"> * exists
</td></tr>
<tr><td>1231</td>
<td class="normal"> * returns true if this record is persistent, otherwise false
</td></tr>
<tr><td>1232</td>
<td class="normal"> *
</td></tr>
<tr><td>1233</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>1234</td>
<td class="normal"> */
</td></tr>
<tr><td>1235</td>
<td class="normal"> public function exists()
</td></tr>
<tr><td>1236</td>
<td class="normal"> {
</td></tr>
<tr><td>1237</td>
<td class="covered"> return ($this->_state !== Doctrine_Record::STATE_TCLEAN &&
</td></tr>
<tr><td>1238</td>
<td class="covered"> $this->_state !== Doctrine_Record::STATE_TDIRTY);
</td></tr>
<tr><td>1239</td>
<td class="orange"> }
</td></tr>
<tr><td>1240</td>
<td class="normal">
</td></tr>
<tr><td>1241</td>
<td class="normal"> /**
</td></tr>
<tr><td>1242</td>
<td class="normal"> * isModified
</td></tr>
<tr><td>1243</td>
<td class="normal"> * returns true if this record was modified, otherwise false
</td></tr>
<tr><td>1244</td>
<td class="normal"> *
</td></tr>
<tr><td>1245</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>1246</td>
<td class="normal"> */
</td></tr>
<tr><td>1247</td>
<td class="normal"> public function isModified()
</td></tr>
<tr><td>1248</td>
<td class="normal"> {
</td></tr>
<tr><td>1249</td>
<td class="covered"> return ($this->_state === Doctrine_Record::STATE_DIRTY ||
</td></tr>
<tr><td>1250</td>
<td class="covered"> $this->_state === Doctrine_Record::STATE_TDIRTY);
</td></tr>
<tr><td>1251</td>
<td class="orange"> }
</td></tr>
<tr><td>1252</td>
<td class="normal">
</td></tr>
<tr><td>1253</td>
<td class="normal"> /**
</td></tr>
<tr><td>1254</td>
<td class="normal"> * method for checking existence of properties and Doctrine_Record references
</td></tr>
<tr><td>1255</td>
<td class="normal"> * @param mixed $name name of the property or reference
</td></tr>
<tr><td>1256</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>1257</td>
<td class="normal"> */
</td></tr>
<tr><td>1258</td>
<td class="normal"> public function hasRelation($fieldName)
</td></tr>
<tr><td>1259</td>
<td class="normal"> {
</td></tr>
<tr><td>1260</td>
<td class="red"> if (isset($this->_data[$fieldName]) || isset($this->_id[$fieldName])) {
</td></tr>
<tr><td>1261</td>
<td class="red"> return true;
</td></tr>
<tr><td>1262</td>
<td class="orange"> }
</td></tr>
<tr><td>1263</td>
<td class="red"> return $this->_table->hasRelation($fieldName);
</td></tr>
<tr><td>1264</td>
<td class="orange"> }
</td></tr>
<tr><td>1265</td>
<td class="normal">
</td></tr>
<tr><td>1266</td>
<td class="normal"> /**
</td></tr>
<tr><td>1267</td>
<td class="normal"> * getIterator
</td></tr>
<tr><td>1268</td>
<td class="normal"> * @return Doctrine_Record_Iterator a Doctrine_Record_Iterator that iterates through the data
</td></tr>
<tr><td>1269</td>
<td class="normal"> */
</td></tr>
<tr><td>1270</td>
<td class="normal"> public function getIterator()
</td></tr>
<tr><td>1271</td>
<td class="normal"> {
</td></tr>
<tr><td>1272</td>
<td class="covered"> return new Doctrine_Record_Iterator($this);
</td></tr>
<tr><td>1273</td>
<td class="orange"> }
</td></tr>
<tr><td>1274</td>
<td class="normal">
</td></tr>
<tr><td>1275</td>
<td class="normal"> /**
</td></tr>
<tr><td>1276</td>
<td class="normal"> * deletes this data access object and all the related composites
</td></tr>
<tr><td>1277</td>
<td class="normal"> * this operation is isolated by a transaction
</td></tr>
<tr><td>1278</td>
<td class="normal"> *
</td></tr>
<tr><td>1279</td>
<td class="normal"> * this event can be listened by the onPreDelete and onDelete listeners
</td></tr>
<tr><td>1280</td>
<td class="normal"> *
</td></tr>
<tr><td>1281</td>
<td class="normal"> * @return boolean true on success, false on failure
</td></tr>
<tr><td>1282</td>
<td class="normal"> */
</td></tr>
<tr><td>1283</td>
<td class="normal"> public function delete(Doctrine_Connection $conn = null)
</td></tr>
<tr><td>1284</td>
<td class="normal"> {
</td></tr>
<tr><td>1285</td>
<td class="covered"> if ($conn == null) {
</td></tr>
<tr><td>1286</td>
<td class="covered"> $conn = $this->_table->getConnection();
</td></tr>
<tr><td>1287</td>
<td class="covered"> }
</td></tr>
<tr><td>1288</td>
<td class="covered"> return $conn->unitOfWork->delete($this);
</td></tr>
<tr><td>1289</td>
<td class="orange"> }
</td></tr>
<tr><td>1290</td>
<td class="normal">
</td></tr>
<tr><td>1291</td>
<td class="normal"> /**
</td></tr>
<tr><td>1292</td>
<td class="normal"> * copy
</td></tr>
<tr><td>1293</td>
<td class="normal"> * returns a copy of this object
</td></tr>
<tr><td>1294</td>
<td class="normal"> *
</td></tr>
<tr><td>1295</td>
<td class="normal"> * @return Doctrine_Record
</td></tr>
<tr><td>1296</td>
<td class="normal"> */
</td></tr>
<tr><td>1297</td>
<td class="normal"> public function copy()
</td></tr>
<tr><td>1298</td>
<td class="normal"> {
</td></tr>
<tr><td>1299</td>
<td class="covered"> $data = $this->_data;
</td></tr>
<tr><td>1300</td>
<td class="normal">
</td></tr>
<tr><td>1301</td>
<td class="covered"> if ($this->_table->getIdentifierType() === Doctrine::IDENTIFIER_AUTOINC) {
</td></tr>
<tr><td>1302</td>
<td class="covered"> $id = $this->_table->getIdentifier();
</td></tr>
<tr><td>1303</td>
<td class="normal">
</td></tr>
<tr><td>1304</td>
<td class="covered"> unset($data[$id]);
</td></tr>
<tr><td>1305</td>
<td class="covered"> }
</td></tr>
<tr><td>1306</td>
<td class="normal">
</td></tr>
<tr><td>1307</td>
<td class="covered"> $ret = $this->_table->create($data);
</td></tr>
<tr><td>1308</td>
<td class="covered"> $modified = array();
</td></tr>
<tr><td>1309</td>
<td class="normal">
</td></tr>
<tr><td>1310</td>
<td class="covered"> foreach ($data as $key => $val) {
</td></tr>
<tr><td>1311</td>
<td class="covered"> if ( ! ($val instanceof Doctrine_Null)) {
</td></tr>
<tr><td>1312</td>
<td class="covered"> $ret->_modified[] = $key;
</td></tr>
<tr><td>1313</td>
<td class="covered"> }
</td></tr>
<tr><td>1314</td>
<td class="covered"> }
</td></tr>
<tr><td>1315</td>
<td class="normal">
</td></tr>
<tr><td>1316</td>
<td class="covered"> return $ret;
</td></tr>
<tr><td>1317</td>
<td class="orange"> }
</td></tr>
<tr><td>1318</td>
<td class="normal">
</td></tr>
<tr><td>1319</td>
<td class="normal"> /**
</td></tr>
<tr><td>1320</td>
<td class="normal"> * copyDeep
</td></tr>
<tr><td>1321</td>
<td class="normal"> * returns a copy of this object and all its related objects
</td></tr>
<tr><td>1322</td>
<td class="normal"> *
</td></tr>
<tr><td>1323</td>
<td class="normal"> * @return Doctrine_Record
</td></tr>
<tr><td>1324</td>
<td class="normal"> */
</td></tr>
<tr><td>1325</td>
<td class="normal"> public function copyDeep() {
</td></tr>
<tr><td>1326</td>
<td class="red"> $copy = $this->copy();
</td></tr>
<tr><td>1327</td>
<td class="normal">
</td></tr>
<tr><td>1328</td>
<td class="red"> foreach ($this->_references as $key => $value) {
</td></tr>
<tr><td>1329</td>
<td class="red"> if ($value instanceof Doctrine_Collection) {
</td></tr>
<tr><td>1330</td>
<td class="red"> foreach ($value as $record) {
</td></tr>
<tr><td>1331</td>
<td class="red"> $copy->{$key}[] = $record->copyDeep();
</td></tr>
<tr><td>1332</td>
<td class="red"> }
</td></tr>
<tr><td>1333</td>
<td class="red"> } else {
</td></tr>
<tr><td>1334</td>
<td class="red"> $copy->set($key, $value->copyDeep());
</td></tr>
<tr><td>1335</td>
<td class="normal"> }
</td></tr>
<tr><td>1336</td>
<td class="red"> }
</td></tr>
<tr><td>1337</td>
<td class="red"> return $copy;
</td></tr>
<tr><td>1338</td>
<td class="orange"> }
</td></tr>
<tr><td>1339</td>
<td class="normal">
</td></tr>
<tr><td>1340</td>
<td class="normal"> /**
</td></tr>
<tr><td>1341</td>
<td class="normal"> * assignIdentifier
</td></tr>
<tr><td>1342</td>
<td class="normal"> *
</td></tr>
<tr><td>1343</td>
<td class="normal"> * @param integer $id
</td></tr>
<tr><td>1344</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1345</td>
<td class="normal"> */
</td></tr>
<tr><td>1346</td>
<td class="normal"> public function assignIdentifier($id = false)
</td></tr>
<tr><td>1347</td>
<td class="normal"> {
</td></tr>
<tr><td>1348</td>
<td class="covered"> if ($id === false) {
</td></tr>
<tr><td>1349</td>
<td class="red"> $this->_id = array();
</td></tr>
<tr><td>1350</td>
<td class="red"> $this->_data = $this->cleanData($this->_data);
</td></tr>
<tr><td>1351</td>
<td class="red"> $this->_state = Doctrine_Record::STATE_TCLEAN;
</td></tr>
<tr><td>1352</td>
<td class="red"> $this->_modified = array();
</td></tr>
<tr><td>1353</td>
<td class="covered"> } elseif ($id === true) {
</td></tr>
<tr><td>1354</td>
<td class="covered"> $this->prepareIdentifiers(true);
</td></tr>
<tr><td>1355</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_CLEAN;
</td></tr>
<tr><td>1356</td>
<td class="covered"> $this->_modified = array();
</td></tr>
<tr><td>1357</td>
<td class="covered"> } else {
</td></tr>
<tr><td>1358</td>
<td class="covered"> $name = $this->_table->getIdentifier();
</td></tr>
<tr><td>1359</td>
<td class="covered"> $this->_id[$name] = $id;
</td></tr>
<tr><td>1360</td>
<td class="covered"> $this->_data[$name] = $id;
</td></tr>
<tr><td>1361</td>
<td class="covered"> $this->_state = Doctrine_Record::STATE_CLEAN;
</td></tr>
<tr><td>1362</td>
<td class="covered"> $this->_modified = array();
</td></tr>
<tr><td>1363</td>
<td class="normal"> }
</td></tr>
<tr><td>1364</td>
<td class="covered"> }
</td></tr>
<tr><td>1365</td>
<td class="normal">
</td></tr>
<tr><td>1366</td>
<td class="normal"> /**
</td></tr>
<tr><td>1367</td>
<td class="normal"> * returns the primary keys of this object
</td></tr>
<tr><td>1368</td>
<td class="normal"> *
</td></tr>
<tr><td>1369</td>
<td class="normal"> * @return array
</td></tr>
<tr><td>1370</td>
<td class="normal"> */
</td></tr>
<tr><td>1371</td>
<td class="normal"> public function identifier()
</td></tr>
<tr><td>1372</td>
<td class="normal"> {
</td></tr>
<tr><td>1373</td>
<td class="covered"> return $this->_id;
</td></tr>
<tr><td>1374</td>
<td class="orange"> }
</td></tr>
<tr><td>1375</td>
<td class="normal">
</td></tr>
<tr><td>1376</td>
<td class="normal"> /**
</td></tr>
<tr><td>1377</td>
<td class="normal"> * returns the value of autoincremented primary key of this object (if any)
</td></tr>
<tr><td>1378</td>
<td class="normal"> *
</td></tr>
<tr><td>1379</td>
<td class="normal"> * @return integer
</td></tr>
<tr><td>1380</td>
<td class="normal"> * @todo Better name?
</td></tr>
<tr><td>1381</td>
<td class="normal"> */
</td></tr>
<tr><td>1382</td>
<td class="normal"> final public function getIncremented()
</td></tr>
<tr><td>1383</td>
<td class="normal"> {
</td></tr>
<tr><td>1384</td>
<td class="covered"> $id = current($this->_id);
</td></tr>
<tr><td>1385</td>
<td class="covered"> if ($id === false) {
</td></tr>
<tr><td>1386</td>
<td class="covered"> return null;
</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="covered"> return $id;
</td></tr>
<tr><td>1390</td>
<td class="orange"> }
</td></tr>
<tr><td>1391</td>
<td class="normal">
</td></tr>
<tr><td>1392</td>
<td class="normal"> /**
</td></tr>
<tr><td>1393</td>
<td class="normal"> * getLast
</td></tr>
<tr><td>1394</td>
<td class="normal"> * this method is used internally be Doctrine_Query
</td></tr>
<tr><td>1395</td>
<td class="normal"> * it is needed to provide compatibility between
</td></tr>
<tr><td>1396</td>
<td class="normal"> * records and collections
</td></tr>
<tr><td>1397</td>
<td class="normal"> *
</td></tr>
<tr><td>1398</td>
<td class="normal"> * @return Doctrine_Record
</td></tr>
<tr><td>1399</td>
<td class="normal"> */
</td></tr>
<tr><td>1400</td>
<td class="normal"> public function getLast()
</td></tr>
<tr><td>1401</td>
<td class="normal"> {
</td></tr>
<tr><td>1402</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>1403</td>
<td class="orange"> }
</td></tr>
<tr><td>1404</td>
<td class="normal">
</td></tr>
<tr><td>1405</td>
<td class="normal"> /**
</td></tr>
<tr><td>1406</td>
<td class="normal"> * hasRefence
</td></tr>
<tr><td>1407</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>1408</td>
<td class="normal"> * @return boolean
</td></tr>
<tr><td>1409</td>
<td class="normal"> */
</td></tr>
<tr><td>1410</td>
<td class="normal"> public function hasReference($name)
</td></tr>
<tr><td>1411</td>
<td class="normal"> {
</td></tr>
<tr><td>1412</td>
<td class="covered"> return isset($this->_references[$name]);
</td></tr>
<tr><td>1413</td>
<td class="orange"> }
</td></tr>
<tr><td>1414</td>
<td class="normal">
</td></tr>
<tr><td>1415</td>
<td class="normal"> /**
</td></tr>
<tr><td>1416</td>
<td class="normal"> * reference
</td></tr>
<tr><td>1417</td>
<td class="normal"> *
</td></tr>
<tr><td>1418</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>1419</td>
<td class="normal"> */
</td></tr>
<tr><td>1420</td>
<td class="normal"> public function reference($name)
</td></tr>
<tr><td>1421</td>
<td class="normal"> {
</td></tr>
<tr><td>1422</td>
<td class="covered"> if (isset($this->_references[$name])) {
</td></tr>
<tr><td>1423</td>
<td class="covered"> return $this->_references[$name];
</td></tr>
<tr><td>1424</td>
<td class="orange"> }
</td></tr>
<tr><td>1425</td>
<td class="red"> }
</td></tr>
<tr><td>1426</td>
<td class="normal">
</td></tr>
<tr><td>1427</td>
<td class="normal"> /**
</td></tr>
<tr><td>1428</td>
<td class="normal"> * obtainReference
</td></tr>
<tr><td>1429</td>
<td class="normal"> *
</td></tr>
<tr><td>1430</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>1431</td>
<td class="normal"> * @throws Doctrine_Record_Exception if trying to get an unknown related component
</td></tr>
<tr><td>1432</td>
<td class="normal"> */
</td></tr>
<tr><td>1433</td>
<td class="normal"> public function obtainReference($name)
</td></tr>
<tr><td>1434</td>
<td class="normal"> {
</td></tr>
<tr><td>1435</td>
<td class="red"> if (isset($this->_references[$name])) {
</td></tr>
<tr><td>1436</td>
<td class="red"> return $this->_references[$name];
</td></tr>
<tr><td>1437</td>
<td class="orange"> }
</td></tr>
<tr><td>1438</td>
<td class="red"> throw new Doctrine_Record_Exception("Unknown reference $name");
</td></tr>
<tr><td>1439</td>
<td class="orange"> }
</td></tr>
<tr><td>1440</td>
<td class="normal">
</td></tr>
<tr><td>1441</td>
<td class="normal"> /**
</td></tr>
<tr><td>1442</td>
<td class="normal"> * getReferences
</td></tr>
<tr><td>1443</td>
<td class="normal"> * @return array all references
</td></tr>
<tr><td>1444</td>
<td class="normal"> */
</td></tr>
<tr><td>1445</td>
<td class="normal"> public function getReferences()
</td></tr>
<tr><td>1446</td>
<td class="normal"> {
</td></tr>
<tr><td>1447</td>
<td class="covered"> return $this->_references;
</td></tr>
<tr><td>1448</td>
<td class="orange"> }
</td></tr>
<tr><td>1449</td>
<td class="normal">
</td></tr>
<tr><td>1450</td>
<td class="normal"> /**
</td></tr>
<tr><td>1451</td>
<td class="normal"> * setRelated
</td></tr>
<tr><td>1452</td>
<td class="normal"> *
</td></tr>
<tr><td>1453</td>
<td class="normal"> * @param string $alias
</td></tr>
<tr><td>1454</td>
<td class="normal"> * @param Doctrine_Access $coll
</td></tr>
<tr><td>1455</td>
<td class="normal"> */
</td></tr>
<tr><td>1456</td>
<td class="normal"> final public function setRelated($alias, Doctrine_Access $coll)
</td></tr>
<tr><td>1457</td>
<td class="normal"> {
</td></tr>
<tr><td>1458</td>
<td class="red"> $this->_references[$alias] = $coll;
</td></tr>
<tr><td>1459</td>
<td class="red"> }
</td></tr>
<tr><td>1460</td>
<td class="normal">
</td></tr>
<tr><td>1461</td>
<td class="normal"> /**
</td></tr>
<tr><td>1462</td>
<td class="normal"> * loadReference
</td></tr>
<tr><td>1463</td>
<td class="normal"> * loads a related component
</td></tr>
<tr><td>1464</td>
<td class="normal"> *
</td></tr>
<tr><td>1465</td>
<td class="normal"> * @throws Doctrine_Table_Exception if trying to load an unknown related component
</td></tr>
<tr><td>1466</td>
<td class="normal"> * @param string $name
</td></tr>
<tr><td>1467</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1468</td>
<td class="normal"> */
</td></tr>
<tr><td>1469</td>
<td class="normal"> public function loadReference($name)
</td></tr>
<tr><td>1470</td>
<td class="normal"> {
</td></tr>
<tr><td>1471</td>
<td class="red"> $rel = $this->_table->getRelation($name);
</td></tr>
<tr><td>1472</td>
<td class="red"> $this->_references[$name] = $rel->fetchRelatedFor($this);
</td></tr>
<tr><td>1473</td>
<td class="red"> }
</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"> * merge
</td></tr>
<tr><td>1477</td>
<td class="normal"> * merges this record with an array of values
</td></tr>
<tr><td>1478</td>
<td class="normal"> *
</td></tr>
<tr><td>1479</td>
<td class="normal"> * @param array $values
</td></tr>
<tr><td>1480</td>
<td class="normal"> * @return void
</td></tr>
<tr><td>1481</td>
<td class="normal"> */
</td></tr>
<tr><td>1482</td>
<td class="normal"> public function merge(array $values)
</td></tr>
<tr><td>1483</td>
<td class="normal"> {
</td></tr>
<tr><td>1484</td>
<td class="covered"> foreach ($this->_table->getFieldNames() as $fieldName) {
</td></tr>
<tr><td>1485</td>
<td class="normal"> try {
</td></tr>
<tr><td>1486</td>
<td class="covered"> if (isset($values[$fieldName])) {
</td></tr>
<tr><td>1487</td>
<td class="covered"> $this->set($fieldName, $values[$fieldName]);
</td></tr>
<tr><td>1488</td>
<td class="covered"> }
</td></tr>
<tr><td>1489</td>
<td class="covered"> } catch (Doctrine_Exception $e) {
</td></tr>
<tr><td>1490</td>
<td class="normal"> // silence all exceptions
</td></tr>
<tr><td>1491</td>
<td class="normal"> }
</td></tr>
<tr><td>1492</td>
<td class="covered"> }
</td></tr>
<tr><td>1493</td>
<td class="covered"> }
</td></tr>
<tr><td>1494</td>
<td class="normal">
</td></tr>
<tr><td>1495</td>
<td class="normal"> /**
</td></tr>
<tr><td>1496</td>
<td class="normal"> * call
</td></tr>
<tr><td>1497</td>
<td class="normal"> *
</td></tr>
<tr><td>1498</td>
<td class="normal"> * @param string|array $callback valid callback
</td></tr>
<tr><td>1499</td>
<td class="normal"> * @param string $column column name
</td></tr>
<tr><td>1500</td>
<td class="normal"> * @param mixed arg1 ... argN optional callback arguments
</td></tr>
<tr><td>1501</td>
<td class="normal"> * @return Doctrine_Record
</td></tr>
<tr><td>1502</td>
<td class="normal"> */
</td></tr>
<tr><td>1503</td>
<td class="normal"> public function call($callback, $column)
</td></tr>
<tr><td>1504</td>
<td class="normal"> {
</td></tr>
<tr><td>1505</td>
<td class="covered"> $args = func_get_args();
</td></tr>
<tr><td>1506</td>
<td class="covered"> array_shift($args);
</td></tr>
<tr><td>1507</td>
<td class="normal">
</td></tr>
<tr><td>1508</td>
<td class="covered"> if (isset($args[0])) {
</td></tr>
<tr><td>1509</td>
<td class="covered"> $fieldName = $args[0];
</td></tr>
<tr><td>1510</td>
<td class="covered"> $args[0] = $this->get($fieldName);
</td></tr>
<tr><td>1511</td>
<td class="normal">
</td></tr>
<tr><td>1512</td>
<td class="covered"> $newvalue = call_user_func_array($callback, $args);
</td></tr>
<tr><td>1513</td>
<td class="normal">
</td></tr>
<tr><td>1514</td>
<td class="covered"> $this->_data[$fieldName] = $newvalue;
</td></tr>
<tr><td>1515</td>
<td class="covered"> }
</td></tr>
<tr><td>1516</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>1517</td>
<td class="orange"> }
</td></tr>
<tr><td>1518</td>
<td class="normal">
</td></tr>
<tr><td>1519</td>
<td class="normal"> /**
</td></tr>
<tr><td>1520</td>
<td class="normal"> * getter for node assciated with this record
</td></tr>
<tr><td>1521</td>
<td class="normal"> *
</td></tr>
<tr><td>1522</td>
<td class="normal"> * @return mixed if tree returns Doctrine_Node otherwise returns false
</td></tr>
<tr><td>1523</td>
<td class="normal"> */
</td></tr>
<tr><td>1524</td>
<td class="normal"> public function getNode()
</td></tr>
<tr><td>1525</td>
<td class="normal"> {
</td></tr>
<tr><td>1526</td>
<td class="covered"> if ( ! $this->_table->isTree()) {
</td></tr>
<tr><td>1527</td>
<td class="red"> return false;
</td></tr>
<tr><td>1528</td>
<td class="orange"> }
</td></tr>
<tr><td>1529</td>
<td class="normal">
</td></tr>
<tr><td>1530</td>
<td class="covered"> if ( ! isset($this->_node)) {
</td></tr>
<tr><td>1531</td>
<td class="covered"> $this->_node = Doctrine_Node::factory($this,
</td></tr>
<tr><td>1532</td>
<td class="covered"> $this->getTable()->getOption('treeImpl'),
</td></tr>
<tr><td>1533</td>
<td class="covered"> $this->getTable()->getOption('treeOptions')
</td></tr>
<tr><td>1534</td>
<td class="covered"> );
</td></tr>
<tr><td>1535</td>
<td class="covered"> }
</td></tr>
<tr><td>1536</td>
<td class="normal">
</td></tr>
<tr><td>1537</td>
<td class="covered"> return $this->_node;
</td></tr>
<tr><td>1538</td>
<td class="orange"> }
</td></tr>
<tr><td>1539</td>
<td class="normal"> /**
</td></tr>
<tr><td>1540</td>
<td class="normal"> * revert
</td></tr>
<tr><td>1541</td>
<td class="normal"> * reverts this record to given version, this method only works if versioning plugin
</td></tr>
<tr><td>1542</td>
<td class="normal"> * is enabled
</td></tr>
<tr><td>1543</td>
<td class="normal"> *
</td></tr>
<tr><td>1544</td>
<td class="normal"> * @throws Doctrine_Record_Exception if given version does not exist
</td></tr>
<tr><td>1545</td>
<td class="normal"> * @param integer $version an integer > 1
</td></tr>
<tr><td>1546</td>
<td class="normal"> * @return Doctrine_Record this object
</td></tr>
<tr><td>1547</td>
<td class="normal"> */
</td></tr>
<tr><td>1548</td>
<td class="normal"> public function revert($version)
</td></tr>
<tr><td>1549</td>
<td class="normal"> {
</td></tr>
<tr><td>1550</td>
<td class="covered"> $data = $this->_table
</td></tr>
<tr><td>1551</td>
<td class="covered"> ->getTemplate('Doctrine_Template_Versionable')
</td></tr>
<tr><td>1552</td>
<td class="covered"> ->getAuditLog()
</td></tr>
<tr><td>1553</td>
<td class="covered"> ->getVersion($this, $version);
</td></tr>
<tr><td>1554</td>
<td class="normal">
</td></tr>
<tr><td>1555</td>
<td class="covered"> if ( ! isset($data[0])) {
</td></tr>
<tr><td>1556</td>
<td class="covered"> throw new Doctrine_Record_Exception('Version ' . $version . ' does not exist!');
</td></tr>
<tr><td>1557</td>
<td class="orange"> }
</td></tr>
<tr><td>1558</td>
<td class="normal">
</td></tr>
<tr><td>1559</td>
<td class="covered"> $this->_data = $data[0];
</td></tr>
<tr><td>1560</td>
<td class="normal">
</td></tr>
<tr><td>1561</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>1562</td>
<td class="orange"> }
</td></tr>
<tr><td>1563</td>
<td class="normal"> public function unshiftFilter(Doctrine_Record_Filter $filter)
</td></tr>
<tr><td>1564</td>
<td class="normal"> {
</td></tr>
<tr><td>1565</td>
<td class="covered"> return $this->_table->unshiftFilter($filter);
</td></tr>
<tr><td>1566</td>
<td class="orange"> }
</td></tr>
<tr><td>1567</td>
<td class="normal"> /**
</td></tr>
<tr><td>1568</td>
<td class="normal"> * unlink
</td></tr>
<tr><td>1569</td>
<td class="normal"> * removes links from this record to given records
</td></tr>
<tr><td>1570</td>
<td class="normal"> * if no ids are given, it removes all links
</td></tr>
<tr><td>1571</td>
<td class="normal"> *
</td></tr>
<tr><td>1572</td>
<td class="normal"> * @param string $alias related component alias
</td></tr>
<tr><td>1573</td>
<td class="normal"> * @param array $ids the identifiers of the related records
</td></tr>
<tr><td>1574</td>
<td class="normal"> * @return Doctrine_Record this object
</td></tr>
<tr><td>1575</td>
<td class="normal"> */
</td></tr>
<tr><td>1576</td>
<td class="normal"> public function unlink($alias, $ids = array())
</td></tr>
<tr><td>1577</td>
<td class="normal"> {
</td></tr>
<tr><td>1578</td>
<td class="covered"> $ids = (array) $ids;
</td></tr>
<tr><td>1579</td>
<td class="normal">
</td></tr>
<tr><td>1580</td>
<td class="covered"> $q = new Doctrine_Query();
</td></tr>
<tr><td>1581</td>
<td class="normal">
</td></tr>
<tr><td>1582</td>
<td class="covered"> $rel = $this->getTable()->getRelation($alias);
</td></tr>
<tr><td>1583</td>
<td class="normal">
</td></tr>
<tr><td>1584</td>
<td class="covered"> if ($rel instanceof Doctrine_Relation_Association) {
</td></tr>
<tr><td>1585</td>
<td class="covered"> $q->delete()
</td></tr>
<tr><td>1586</td>
<td class="covered"> ->from($rel->getAssociationTable()->getComponentName())
</td></tr>
<tr><td>1587</td>
<td class="covered"> ->where($rel->getLocal() . ' = ?', array_values($this->identifier()));
</td></tr>
<tr><td>1588</td>
<td class="normal">
</td></tr>
<tr><td>1589</td>
<td class="covered"> if (count($ids) > 0) {
</td></tr>
<tr><td>1590</td>
<td class="covered"> $q->whereIn($rel->getForeign(), $ids);
</td></tr>
<tr><td>1591</td>
<td class="covered"> }
</td></tr>
<tr><td>1592</td>
<td class="normal">
</td></tr>
<tr><td>1593</td>
<td class="covered"> $q->execute();
</td></tr>
<tr><td>1594</td>
<td class="normal">
</td></tr>
<tr><td>1595</td>
<td class="covered"> } else if ($rel instanceof Doctrine_Relation_ForeignKey) {
</td></tr>
<tr><td>1596</td>
<td class="covered"> $q->update($rel->getTable()->getComponentName())
</td></tr>
<tr><td>1597</td>
<td class="covered"> ->set($rel->getForeign(), '?', array(null))
</td></tr>
<tr><td>1598</td>
<td class="covered"> ->addWhere($rel->getForeign() . ' = ?', array_values($this->identifier()));
</td></tr>
<tr><td>1599</td>
<td class="normal">
</td></tr>
<tr><td>1600</td>
<td class="covered"> if (count($ids) > 0) {
</td></tr>
<tr><td>1601</td>
<td class="covered"> $q->whereIn($rel->getTable()->getIdentifier(), $ids);
</td></tr>
<tr><td>1602</td>
<td class="covered"> }
</td></tr>
<tr><td>1603</td>
<td class="normal">
</td></tr>
<tr><td>1604</td>
<td class="covered"> $q->execute();
</td></tr>
<tr><td>1605</td>
<td class="covered"> }
</td></tr>
<tr><td>1606</td>
<td class="covered"> if (isset($this->_references[$alias])) {
</td></tr>
<tr><td>1607</td>
<td class="covered"> foreach ($this->_references[$alias] as $k => $record) {
</td></tr>
<tr><td>1608</td>
<td class="covered"> if (in_array(current($record->identifier()), $ids)) {
</td></tr>
<tr><td>1609</td>
<td class="covered"> $this->_references[$alias]->remove($k);
</td></tr>
<tr><td>1610</td>
<td class="covered"> }
</td></tr>
<tr><td>1611</td>
<td class="covered"> }
</td></tr>
<tr><td>1612</td>
<td class="covered"> $this->_references[$alias]->takeSnapshot();
</td></tr>
<tr><td>1613</td>
<td class="covered"> }
</td></tr>
<tr><td>1614</td>
<td class="covered"> return $this;
</td></tr>
<tr><td>1615</td>
<td class="orange"> }
</td></tr>
<tr><td>1616</td>
<td class="normal">
</td></tr>
<tr><td>1617</td>
<td class="normal"> /**
</td></tr>
<tr><td>1618</td>
<td class="normal"> * __call
</td></tr>
<tr><td>1619</td>
<td class="normal"> * this method is a magic method that is being used for method overloading
</td></tr>
<tr><td>1620</td>
<td class="normal"> *
</td></tr>
<tr><td>1621</td>
<td class="normal"> * the function of this method is to try to find given method from the templates
</td></tr>
<tr><td>1622</td>
<td class="normal"> * this record is using and if it finds given method it will execute it
</td></tr>
<tr><td>1623</td>
<td class="normal"> *
</td></tr>
<tr><td>1624</td>
<td class="normal"> * So, in sense, this method replicates the usage of mixins (as seen in some programming languages)
</td></tr>
<tr><td>1625</td>
<td class="normal"> *
</td></tr>
<tr><td>1626</td>
<td class="normal"> * @param string $method name of the method
</td></tr>
<tr><td>1627</td>
<td class="normal"> * @param array $args method arguments
</td></tr>
<tr><td>1628</td>
<td class="normal"> * @return mixed the return value of the given method
</td></tr>
<tr><td>1629</td>
<td class="normal"> */
</td></tr>
<tr><td>1630</td>
<td class="normal"> public function __call($method, $args)
</td></tr>
<tr><td>1631</td>
<td class="normal"> {
</td></tr>
<tr><td>1632</td>
<td class="covered"> if (($template = $this->_table->getMethodOwner($method)) !== false) {
</td></tr>
<tr><td>1633</td>
<td class="red"> $template->setInvoker($this);
</td></tr>
<tr><td>1634</td>
<td class="red"> return call_user_func_array(array($template, $method), $args);
</td></tr>
<tr><td>1635</td>
<td class="orange"> }
</td></tr>
<tr><td>1636</td>
<td class="normal">
</td></tr>
<tr><td>1637</td>
<td class="covered"> foreach ($this->_table->getTemplates() as $template) {
</td></tr>
<tr><td>1638</td>
<td class="covered"> if (method_exists($template, $method)) {
</td></tr>
<tr><td>1639</td>
<td class="covered"> $template->setInvoker($this);
</td></tr>
<tr><td>1640</td>
<td class="covered"> $this->_table->setMethodOwner($method, $template);
</td></tr>
<tr><td>1641</td>
<td class="normal">
</td></tr>
<tr><td>1642</td>
<td class="covered"> return call_user_func_array(array($template, $method), $args);
</td></tr>
<tr><td>1643</td>
<td class="orange"> }
</td></tr>
<tr><td>1644</td>
<td class="red"> }
</td></tr>
<tr><td>1645</td>
<td class="normal">
</td></tr>
<tr><td>1646</td>
<td class="red"> throw new Doctrine_Record_Exception('Unknown method ' . $method);
</td></tr>
<tr><td>1647</td>
<td class="orange"> }
</td></tr>
<tr><td>1648</td>
<td class="normal">
</td></tr>
<tr><td>1649</td>
<td class="normal"> /**
</td></tr>
<tr><td>1650</td>
<td class="normal"> * used to delete node from tree - MUST BE USE TO DELETE RECORD IF TABLE ACTS AS TREE
</td></tr>
<tr><td>1651</td>
<td class="normal"> *
</td></tr>
<tr><td>1652</td>
<td class="normal"> */
</td></tr>
<tr><td>1653</td>
<td class="normal"> public function deleteNode() {
</td></tr>
<tr><td>1654</td>
<td class="red"> $this->getNode()->delete();
</td></tr>
<tr><td>1655</td>
<td class="red"> }
</td></tr>
<tr><td>1656</td>
<td class="normal"> public function toString()
</td></tr>
<tr><td>1657</td>
<td class="normal"> {
</td></tr>
<tr><td>1658</td>
<td class="red"> return Doctrine::dump(get_object_vars($this));
</td></tr>
<tr><td>1659</td>
<td class="orange"> }
</td></tr>
<tr><td>1660</td>
<td class="normal">
</td></tr>
<tr><td>1661</td>
<td class="normal"> /**
</td></tr>
<tr><td>1662</td>
<td class="normal"> * returns a string representation of this object
</td></tr>
<tr><td>1663</td>
<td class="normal"> */
</td></tr>
<tr><td>1664</td>
<td class="normal"> public function __toString()
</td></tr>
<tr><td>1665</td>
<td class="normal"> {
</td></tr>
<tr><td>1666</td>
<td class="red"> return (string) $this->_oid;
</td></tr>
<tr><td>1667</td>
<td class="orange"> }
</td></tr>
<tr><td>1668</td>
<td class="normal">}
</td></tr>
</table></body></html>