<html> <head> <title>Coverage for Doctrine_Transaction</title> <style type="text/css"> .covered{ background: green;} .normal{ background: white;} .red{ background: red;} .orange{ background: #f90;} </style> </head> <body><h1>Coverage for Doctrine_Transaction</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: Transaction.php 2963 2007-10-21 06:23:59Z Jonathan.Wage $ </td></tr> <tr><td>4</td> <td class="normal"> * </td></tr> <tr><td>5</td> <td class="normal"> * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS </td></tr> <tr><td>6</td> <td class="normal"> * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT </td></tr> <tr><td>7</td> <td class="normal"> * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR </td></tr> <tr><td>8</td> <td class="normal"> * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT </td></tr> <tr><td>9</td> <td class="normal"> * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, </td></tr> <tr><td>10</td> <td class="normal"> * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT </td></tr> <tr><td>11</td> <td class="normal"> * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, </td></tr> <tr><td>12</td> <td class="normal"> * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY </td></tr> <tr><td>13</td> <td class="normal"> * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT </td></tr> <tr><td>14</td> <td class="normal"> * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE </td></tr> <tr><td>15</td> <td class="normal"> * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. </td></tr> <tr><td>16</td> <td class="normal"> * </td></tr> <tr><td>17</td> <td class="normal"> * This software consists of voluntary contributions made by many individuals </td></tr> <tr><td>18</td> <td class="normal"> * and is licensed under the LGPL. For more information, see </td></tr> <tr><td>19</td> <td class="normal"> * <http://www.phpdoctrine.com>. </td></tr> <tr><td>20</td> <td class="normal"> */ </td></tr> <tr><td>21</td> <td class="covered">Doctrine::autoload('Doctrine_Connection_Module'); </td></tr> <tr><td>22</td> <td class="normal">/** </td></tr> <tr><td>23</td> <td class="normal"> * Doctrine_Transaction </td></tr> <tr><td>24</td> <td class="normal"> * Handles transaction savepoint and isolation abstraction </td></tr> <tr><td>25</td> <td class="normal"> * </td></tr> <tr><td>26</td> <td class="normal"> * @author Konsta Vesterinen <kvesteri@cc.hut.fi> </td></tr> <tr><td>27</td> <td class="normal"> * @author Lukas Smith <smith@pooteeweet.org> (PEAR MDB2 library) </td></tr> <tr><td>28</td> <td class="normal"> * @license http://www.opensource.org/licenses/lgpl-license.php LGPL </td></tr> <tr><td>29</td> <td class="normal"> * @package Doctrine </td></tr> <tr><td>30</td> <td class="normal"> * @subpackage Transaction </td></tr> <tr><td>31</td> <td class="normal"> * @link www.phpdoctrine.com </td></tr> <tr><td>32</td> <td class="normal"> * @since 1.0 </td></tr> <tr><td>33</td> <td class="normal"> * @version $Revision: 2963 $ </td></tr> <tr><td>34</td> <td class="normal"> */ </td></tr> <tr><td>35</td> <td class="covered">class Doctrine_Transaction extends Doctrine_Connection_Module </td></tr> <tr><td>36</td> <td class="normal">{ </td></tr> <tr><td>37</td> <td class="normal"> /** </td></tr> <tr><td>38</td> <td class="normal"> * Doctrine_Transaction is in sleep state when it has no active transactions </td></tr> <tr><td>39</td> <td class="normal"> */ </td></tr> <tr><td>40</td> <td class="normal"> const STATE_SLEEP = 0; </td></tr> <tr><td>41</td> <td class="normal"> </td></tr> <tr><td>42</td> <td class="normal"> /** </td></tr> <tr><td>43</td> <td class="normal"> * Doctrine_Transaction is in active state when it has one active transaction </td></tr> <tr><td>44</td> <td class="normal"> */ </td></tr> <tr><td>45</td> <td class="normal"> const STATE_ACTIVE = 1; </td></tr> <tr><td>46</td> <td class="normal"> </td></tr> <tr><td>47</td> <td class="normal"> /** </td></tr> <tr><td>48</td> <td class="normal"> * Doctrine_Transaction is in busy state when it has multiple active transactions </td></tr> <tr><td>49</td> <td class="normal"> */ </td></tr> <tr><td>50</td> <td class="normal"> const STATE_BUSY = 2; </td></tr> <tr><td>51</td> <td class="normal"> </td></tr> <tr><td>52</td> <td class="normal"> /** </td></tr> <tr><td>53</td> <td class="normal"> * @var integer $transactionLevel the nesting level of transactions, used by transaction methods </td></tr> <tr><td>54</td> <td class="normal"> */ </td></tr> <tr><td>55</td> <td class="normal"> protected $transactionLevel = 0; </td></tr> <tr><td>56</td> <td class="normal"> </td></tr> <tr><td>57</td> <td class="normal"> /** </td></tr> <tr><td>58</td> <td class="normal"> * @var array $invalid an array containing all invalid records within this transaction </td></tr> <tr><td>59</td> <td class="normal"> */ </td></tr> <tr><td>60</td> <td class="normal"> protected $invalid = array(); </td></tr> <tr><td>61</td> <td class="normal"> </td></tr> <tr><td>62</td> <td class="normal"> /** </td></tr> <tr><td>63</td> <td class="normal"> * @var array $savepoints an array containing all savepoints </td></tr> <tr><td>64</td> <td class="normal"> */ </td></tr> <tr><td>65</td> <td class="normal"> protected $savePoints = array(); </td></tr> <tr><td>66</td> <td class="normal"> </td></tr> <tr><td>67</td> <td class="normal"> /** </td></tr> <tr><td>68</td> <td class="normal"> * @var array $_collections an array of Doctrine_Collection objects that were affected during the Transaction </td></tr> <tr><td>69</td> <td class="normal"> */ </td></tr> <tr><td>70</td> <td class="normal"> protected $_collections = array(); </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"> * addCollection </td></tr> <tr><td>74</td> <td class="normal"> * adds a collection in the internal array of collections </td></tr> <tr><td>75</td> <td class="normal"> * </td></tr> <tr><td>76</td> <td class="normal"> * at the end of each commit this array is looped over and </td></tr> <tr><td>77</td> <td class="normal"> * of every collection Doctrine then takes a snapshot in order </td></tr> <tr><td>78</td> <td class="normal"> * to keep the collections up to date with the database </td></tr> <tr><td>79</td> <td class="normal"> * </td></tr> <tr><td>80</td> <td class="normal"> * @param Doctrine_Collection $coll a collection to be added </td></tr> <tr><td>81</td> <td class="normal"> * @return Doctrine_Transaction this object </td></tr> <tr><td>82</td> <td class="normal"> */ </td></tr> <tr><td>83</td> <td class="normal"> public function addCollection(Doctrine_Collection $coll) </td></tr> <tr><td>84</td> <td class="normal"> { </td></tr> <tr><td>85</td> <td class="covered"> $this->_collections[] = $coll; </td></tr> <tr><td>86</td> <td class="normal"> </td></tr> <tr><td>87</td> <td class="covered"> return $this; </td></tr> <tr><td>88</td> <td class="orange"> } </td></tr> <tr><td>89</td> <td class="normal"> </td></tr> <tr><td>90</td> <td class="normal"> /** </td></tr> <tr><td>91</td> <td class="normal"> * getState </td></tr> <tr><td>92</td> <td class="normal"> * returns the state of this connection </td></tr> <tr><td>93</td> <td class="normal"> * </td></tr> <tr><td>94</td> <td class="normal"> * @see Doctrine_Connection_Transaction::STATE_* constants </td></tr> <tr><td>95</td> <td class="normal"> * @return integer the connection state </td></tr> <tr><td>96</td> <td class="normal"> */ </td></tr> <tr><td>97</td> <td class="normal"> public function getState() </td></tr> <tr><td>98</td> <td class="normal"> { </td></tr> <tr><td>99</td> <td class="covered"> switch ($this->transactionLevel) { </td></tr> <tr><td>100</td> <td class="covered"> case 0: </td></tr> <tr><td>101</td> <td class="covered"> return Doctrine_Transaction::STATE_SLEEP; </td></tr> <tr><td>102</td> <td class="orange"> break; </td></tr> <tr><td>103</td> <td class="covered"> case 1: </td></tr> <tr><td>104</td> <td class="covered"> return Doctrine_Transaction::STATE_ACTIVE; </td></tr> <tr><td>105</td> <td class="orange"> break; </td></tr> <tr><td>106</td> <td class="covered"> default: </td></tr> <tr><td>107</td> <td class="covered"> return Doctrine_Transaction::STATE_BUSY; </td></tr> <tr><td>108</td> <td class="covered"> } </td></tr> <tr><td>109</td> <td class="orange"> } </td></tr> <tr><td>110</td> <td class="normal"> </td></tr> <tr><td>111</td> <td class="normal"> /** </td></tr> <tr><td>112</td> <td class="normal"> * addInvalid </td></tr> <tr><td>113</td> <td class="normal"> * adds record into invalid records list </td></tr> <tr><td>114</td> <td class="normal"> * </td></tr> <tr><td>115</td> <td class="normal"> * @param Doctrine_Record $record </td></tr> <tr><td>116</td> <td class="normal"> * @return boolean false if record already existed in invalid records list, </td></tr> <tr><td>117</td> <td class="normal"> * otherwise true </td></tr> <tr><td>118</td> <td class="normal"> */ </td></tr> <tr><td>119</td> <td class="normal"> public function addInvalid(Doctrine_Record $record) </td></tr> <tr><td>120</td> <td class="normal"> { </td></tr> <tr><td>121</td> <td class="covered"> if (in_array($record, $this->invalid, true)) { </td></tr> <tr><td>122</td> <td class="red"> return false; </td></tr> <tr><td>123</td> <td class="orange"> } </td></tr> <tr><td>124</td> <td class="covered"> $this->invalid[] = $record; </td></tr> <tr><td>125</td> <td class="covered"> return true; </td></tr> <tr><td>126</td> <td class="orange"> } </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"> * getTransactionLevel </td></tr> <tr><td>130</td> <td class="normal"> * get the current transaction nesting level </td></tr> <tr><td>131</td> <td class="normal"> * </td></tr> <tr><td>132</td> <td class="normal"> * @return integer </td></tr> <tr><td>133</td> <td class="normal"> */ </td></tr> <tr><td>134</td> <td class="normal"> public function getTransactionLevel() </td></tr> <tr><td>135</td> <td class="normal"> { </td></tr> <tr><td>136</td> <td class="covered"> return $this->transactionLevel; </td></tr> <tr><td>137</td> <td class="orange"> } </td></tr> <tr><td>138</td> <td class="normal"> </td></tr> <tr><td>139</td> <td class="normal"> /** </td></tr> <tr><td>140</td> <td class="normal"> * getTransactionLevel </td></tr> <tr><td>141</td> <td class="normal"> * set the current transaction nesting level </td></tr> <tr><td>142</td> <td class="normal"> * </td></tr> <tr><td>143</td> <td class="normal"> * @return Doctrine_Transaction this object </td></tr> <tr><td>144</td> <td class="normal"> */ </td></tr> <tr><td>145</td> <td class="normal"> public function setTransactionLevel($level) </td></tr> <tr><td>146</td> <td class="normal"> { </td></tr> <tr><td>147</td> <td class="covered"> $this->transactionLevel = $level; </td></tr> <tr><td>148</td> <td class="normal"> </td></tr> <tr><td>149</td> <td class="covered"> return $this; </td></tr> <tr><td>150</td> <td class="orange"> } </td></tr> <tr><td>151</td> <td class="normal"> </td></tr> <tr><td>152</td> <td class="normal"> /** </td></tr> <tr><td>153</td> <td class="normal"> * beginTransaction </td></tr> <tr><td>154</td> <td class="normal"> * Start a transaction or set a savepoint. </td></tr> <tr><td>155</td> <td class="normal"> * </td></tr> <tr><td>156</td> <td class="normal"> * if trying to set a savepoint and there is no active transaction </td></tr> <tr><td>157</td> <td class="normal"> * a new transaction is being started </td></tr> <tr><td>158</td> <td class="normal"> * </td></tr> <tr><td>159</td> <td class="normal"> * Listeners: onPreTransactionBegin, onTransactionBegin </td></tr> <tr><td>160</td> <td class="normal"> * </td></tr> <tr><td>161</td> <td class="normal"> * @param string $savepoint name of a savepoint to set </td></tr> <tr><td>162</td> <td class="normal"> * @throws Doctrine_Transaction_Exception if the transaction fails at database level </td></tr> <tr><td>163</td> <td class="normal"> * @return integer current transaction nesting level </td></tr> <tr><td>164</td> <td class="normal"> */ </td></tr> <tr><td>165</td> <td class="normal"> public function beginTransaction($savepoint = null) </td></tr> <tr><td>166</td> <td class="normal"> { </td></tr> <tr><td>167</td> <td class="covered"> $this->conn->connect(); </td></tr> <tr><td>168</td> <td class="normal"> </td></tr> <tr><td>169</td> <td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER); </td></tr> <tr><td>170</td> <td class="normal"> </td></tr> <tr><td>171</td> <td class="covered"> if ( ! is_null($savepoint)) { </td></tr> <tr><td>172</td> <td class="covered"> $this->savePoints[] = $savepoint; </td></tr> <tr><td>173</td> <td class="normal"> </td></tr> <tr><td>174</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_CREATE); </td></tr> <tr><td>175</td> <td class="normal"> </td></tr> <tr><td>176</td> <td class="covered"> $listener->preSavepointCreate($event); </td></tr> <tr><td>177</td> <td class="normal"> </td></tr> <tr><td>178</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>179</td> <td class="covered"> $this->createSavePoint($savepoint); </td></tr> <tr><td>180</td> <td class="covered"> } </td></tr> <tr><td>181</td> <td class="normal"> </td></tr> <tr><td>182</td> <td class="covered"> $listener->postSavepointCreate($event); </td></tr> <tr><td>183</td> <td class="covered"> } else { </td></tr> <tr><td>184</td> <td class="covered"> if ($this->transactionLevel == 0) { </td></tr> <tr><td>185</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_BEGIN); </td></tr> <tr><td>186</td> <td class="normal"> </td></tr> <tr><td>187</td> <td class="covered"> $listener->preTransactionBegin($event); </td></tr> <tr><td>188</td> <td class="normal"> </td></tr> <tr><td>189</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>190</td> <td class="normal"> try { </td></tr> <tr><td>191</td> <td class="covered"> $this->conn->getDbh()->beginTransaction(); </td></tr> <tr><td>192</td> <td class="covered"> } catch(Exception $e) { </td></tr> <tr><td>193</td> <td class="orange"> throw new Doctrine_Transaction_Exception($e->getMessage()); </td></tr> <tr><td>194</td> <td class="normal"> } </td></tr> <tr><td>195</td> <td class="covered"> } </td></tr> <tr><td>196</td> <td class="covered"> $listener->postTransactionBegin($event); </td></tr> <tr><td>197</td> <td class="covered"> } </td></tr> <tr><td>198</td> <td class="normal"> } </td></tr> <tr><td>199</td> <td class="normal"> </td></tr> <tr><td>200</td> <td class="covered"> $level = ++$this->transactionLevel; </td></tr> <tr><td>201</td> <td class="normal"> </td></tr> <tr><td>202</td> <td class="covered"> return $level; </td></tr> <tr><td>203</td> <td class="orange"> } </td></tr> <tr><td>204</td> <td class="normal"> </td></tr> <tr><td>205</td> <td class="normal"> /** </td></tr> <tr><td>206</td> <td class="normal"> * commit </td></tr> <tr><td>207</td> <td class="normal"> * Commit the database changes done during a transaction that is in </td></tr> <tr><td>208</td> <td class="normal"> * progress or release a savepoint. This function may only be called when </td></tr> <tr><td>209</td> <td class="normal"> * auto-committing is disabled, otherwise it will fail. </td></tr> <tr><td>210</td> <td class="normal"> * </td></tr> <tr><td>211</td> <td class="normal"> * Listeners: preTransactionCommit, postTransactionCommit </td></tr> <tr><td>212</td> <td class="normal"> * </td></tr> <tr><td>213</td> <td class="normal"> * @param string $savepoint name of a savepoint to release </td></tr> <tr><td>214</td> <td class="normal"> * @throws Doctrine_Transaction_Exception if the transaction fails at database level </td></tr> <tr><td>215</td> <td class="normal"> * @throws Doctrine_Validator_Exception if the transaction fails due to record validations </td></tr> <tr><td>216</td> <td class="normal"> * @return boolean false if commit couldn't be performed, true otherwise </td></tr> <tr><td>217</td> <td class="normal"> */ </td></tr> <tr><td>218</td> <td class="normal"> public function commit($savepoint = null) </td></tr> <tr><td>219</td> <td class="normal"> { </td></tr> <tr><td>220</td> <td class="covered"> $this->conn->connect(); </td></tr> <tr><td>221</td> <td class="normal"> </td></tr> <tr><td>222</td> <td class="covered"> if ($this->transactionLevel == 0) { </td></tr> <tr><td>223</td> <td class="covered"> return false; </td></tr> <tr><td>224</td> <td class="orange"> } </td></tr> <tr><td>225</td> <td class="normal"> </td></tr> <tr><td>226</td> <td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER); </td></tr> <tr><td>227</td> <td class="normal"> </td></tr> <tr><td>228</td> <td class="covered"> if ( ! is_null($savepoint)) { </td></tr> <tr><td>229</td> <td class="covered"> $this->transactionLevel -= $this->removeSavePoints($savepoint); </td></tr> <tr><td>230</td> <td class="normal"> </td></tr> <tr><td>231</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_COMMIT); </td></tr> <tr><td>232</td> <td class="normal"> </td></tr> <tr><td>233</td> <td class="covered"> $listener->preSavepointCommit($event); </td></tr> <tr><td>234</td> <td class="normal"> </td></tr> <tr><td>235</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>236</td> <td class="covered"> $this->releaseSavePoint($savepoint); </td></tr> <tr><td>237</td> <td class="covered"> } </td></tr> <tr><td>238</td> <td class="normal"> </td></tr> <tr><td>239</td> <td class="covered"> $listener->postSavepointCommit($event); </td></tr> <tr><td>240</td> <td class="covered"> } else { </td></tr> <tr><td>241</td> <td class="normal"> </td></tr> <tr><td>242</td> <td class="covered"> if ($this->transactionLevel == 1) { </td></tr> <tr><td>243</td> <td class="covered"> if ( ! empty($this->invalid)) { </td></tr> <tr><td>244</td> <td class="covered"> $this->rollback(); </td></tr> <tr><td>245</td> <td class="normal"> </td></tr> <tr><td>246</td> <td class="covered"> $tmp = $this->invalid; </td></tr> <tr><td>247</td> <td class="covered"> $this->invalid = array(); </td></tr> <tr><td>248</td> <td class="normal"> </td></tr> <tr><td>249</td> <td class="covered"> throw new Doctrine_Validator_Exception($tmp); </td></tr> <tr><td>250</td> <td class="orange"> } </td></tr> <tr><td>251</td> <td class="normal"> </td></tr> <tr><td>252</td> <td class="normal"> // take snapshots of all collections used within this transaction </td></tr> <tr><td>253</td> <td class="covered"> foreach ($this->_collections as $coll) { </td></tr> <tr><td>254</td> <td class="covered"> $coll->takeSnapshot(); </td></tr> <tr><td>255</td> <td class="covered"> } </td></tr> <tr><td>256</td> <td class="covered"> $this->_collections = array(); </td></tr> <tr><td>257</td> <td class="normal"> </td></tr> <tr><td>258</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_COMMIT); </td></tr> <tr><td>259</td> <td class="normal"> </td></tr> <tr><td>260</td> <td class="covered"> $listener->preTransactionCommit($event); </td></tr> <tr><td>261</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>262</td> <td class="covered"> $this->conn->getDbh()->commit(); </td></tr> <tr><td>263</td> <td class="covered"> } </td></tr> <tr><td>264</td> <td class="covered"> $listener->postTransactionCommit($event); </td></tr> <tr><td>265</td> <td class="normal"> </td></tr> <tr><td>266</td> <td class="covered"> } </td></tr> <tr><td>267</td> <td class="normal"> </td></tr> <tr><td>268</td> <td class="covered"> $this->transactionLevel--; </td></tr> <tr><td>269</td> <td class="normal"> } </td></tr> <tr><td>270</td> <td class="normal"> </td></tr> <tr><td>271</td> <td class="covered"> return true; </td></tr> <tr><td>272</td> <td class="orange"> } </td></tr> <tr><td>273</td> <td class="normal"> </td></tr> <tr><td>274</td> <td class="normal"> /** </td></tr> <tr><td>275</td> <td class="normal"> * rollback </td></tr> <tr><td>276</td> <td class="normal"> * Cancel any database changes done during a transaction or since a specific </td></tr> <tr><td>277</td> <td class="normal"> * savepoint that is in progress. This function may only be called when </td></tr> <tr><td>278</td> <td class="normal"> * auto-committing is disabled, otherwise it will fail. Therefore, a new </td></tr> <tr><td>279</td> <td class="normal"> * transaction is implicitly started after canceling the pending changes. </td></tr> <tr><td>280</td> <td class="normal"> * </td></tr> <tr><td>281</td> <td class="normal"> * this method can be listened with onPreTransactionRollback and onTransactionRollback </td></tr> <tr><td>282</td> <td class="normal"> * eventlistener methods </td></tr> <tr><td>283</td> <td class="normal"> * </td></tr> <tr><td>284</td> <td class="normal"> * @param string $savepoint name of a savepoint to rollback to </td></tr> <tr><td>285</td> <td class="normal"> * @throws Doctrine_Transaction_Exception if the rollback operation fails at database level </td></tr> <tr><td>286</td> <td class="normal"> * @return boolean false if rollback couldn't be performed, true otherwise </td></tr> <tr><td>287</td> <td class="normal"> */ </td></tr> <tr><td>288</td> <td class="normal"> public function rollback($savepoint = null) </td></tr> <tr><td>289</td> <td class="normal"> { </td></tr> <tr><td>290</td> <td class="covered"> $this->conn->connect(); </td></tr> <tr><td>291</td> <td class="normal"> </td></tr> <tr><td>292</td> <td class="covered"> if ($this->transactionLevel == 0) { </td></tr> <tr><td>293</td> <td class="covered"> return false; </td></tr> <tr><td>294</td> <td class="orange"> } </td></tr> <tr><td>295</td> <td class="normal"> </td></tr> <tr><td>296</td> <td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER); </td></tr> <tr><td>297</td> <td class="normal"> </td></tr> <tr><td>298</td> <td class="covered"> if ( ! is_null($savepoint)) { </td></tr> <tr><td>299</td> <td class="covered"> $this->transactionLevel -= $this->removeSavePoints($savepoint); </td></tr> <tr><td>300</td> <td class="normal"> </td></tr> <tr><td>301</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_ROLLBACK); </td></tr> <tr><td>302</td> <td class="normal"> </td></tr> <tr><td>303</td> <td class="covered"> $listener->preSavepointRollback($event); </td></tr> <tr><td>304</td> <td class="normal"> </td></tr> <tr><td>305</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>306</td> <td class="covered"> $this->rollbackSavePoint($savepoint); </td></tr> <tr><td>307</td> <td class="covered"> } </td></tr> <tr><td>308</td> <td class="normal"> </td></tr> <tr><td>309</td> <td class="covered"> $listener->postSavepointRollback($event); </td></tr> <tr><td>310</td> <td class="covered"> } else { </td></tr> <tr><td>311</td> <td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_ROLLBACK); </td></tr> <tr><td>312</td> <td class="normal"> </td></tr> <tr><td>313</td> <td class="covered"> $listener->preTransactionRollback($event); </td></tr> <tr><td>314</td> <td class="normal"> </td></tr> <tr><td>315</td> <td class="covered"> if ( ! $event->skipOperation) { </td></tr> <tr><td>316</td> <td class="covered"> $this->transactionLevel = 0; </td></tr> <tr><td>317</td> <td class="normal"> try { </td></tr> <tr><td>318</td> <td class="covered"> $this->conn->getDbh()->rollback(); </td></tr> <tr><td>319</td> <td class="covered"> } catch (Exception $e) { </td></tr> <tr><td>320</td> <td class="orange"> throw new Doctrine_Transaction_Exception($e->getMessage()); </td></tr> <tr><td>321</td> <td class="normal"> } </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="covered"> $listener->postTransactionRollback($event); </td></tr> <tr><td>325</td> <td class="normal"> } </td></tr> <tr><td>326</td> <td class="normal"> </td></tr> <tr><td>327</td> <td class="covered"> return true; </td></tr> <tr><td>328</td> <td class="orange"> } </td></tr> <tr><td>329</td> <td class="normal"> </td></tr> <tr><td>330</td> <td class="normal"> /** </td></tr> <tr><td>331</td> <td class="normal"> * releaseSavePoint </td></tr> <tr><td>332</td> <td class="normal"> * creates a new savepoint </td></tr> <tr><td>333</td> <td class="normal"> * </td></tr> <tr><td>334</td> <td class="normal"> * @param string $savepoint name of a savepoint to create </td></tr> <tr><td>335</td> <td class="normal"> * @return void </td></tr> <tr><td>336</td> <td class="normal"> */ </td></tr> <tr><td>337</td> <td class="normal"> protected function createSavePoint($savepoint) </td></tr> <tr><td>338</td> <td class="normal"> { </td></tr> <tr><td>339</td> <td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.'); </td></tr> <tr><td>340</td> <td class="orange"> } </td></tr> <tr><td>341</td> <td class="normal"> </td></tr> <tr><td>342</td> <td class="normal"> /** </td></tr> <tr><td>343</td> <td class="normal"> * releaseSavePoint </td></tr> <tr><td>344</td> <td class="normal"> * releases given savepoint </td></tr> <tr><td>345</td> <td class="normal"> * </td></tr> <tr><td>346</td> <td class="normal"> * @param string $savepoint name of a savepoint to release </td></tr> <tr><td>347</td> <td class="normal"> * @return void </td></tr> <tr><td>348</td> <td class="normal"> */ </td></tr> <tr><td>349</td> <td class="normal"> protected function releaseSavePoint($savepoint) </td></tr> <tr><td>350</td> <td class="normal"> { </td></tr> <tr><td>351</td> <td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.'); </td></tr> <tr><td>352</td> <td class="orange"> } </td></tr> <tr><td>353</td> <td class="normal"> </td></tr> <tr><td>354</td> <td class="normal"> /** </td></tr> <tr><td>355</td> <td class="normal"> * rollbackSavePoint </td></tr> <tr><td>356</td> <td class="normal"> * releases given savepoint </td></tr> <tr><td>357</td> <td class="normal"> * </td></tr> <tr><td>358</td> <td class="normal"> * @param string $savepoint name of a savepoint to rollback to </td></tr> <tr><td>359</td> <td class="normal"> * @return void </td></tr> <tr><td>360</td> <td class="normal"> */ </td></tr> <tr><td>361</td> <td class="normal"> protected function rollbackSavePoint($savepoint) </td></tr> <tr><td>362</td> <td class="normal"> { </td></tr> <tr><td>363</td> <td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.'); </td></tr> <tr><td>364</td> <td class="orange"> } </td></tr> <tr><td>365</td> <td class="normal"> </td></tr> <tr><td>366</td> <td class="normal"> /** </td></tr> <tr><td>367</td> <td class="normal"> * removeSavePoints </td></tr> <tr><td>368</td> <td class="normal"> * removes a savepoint from the internal savePoints array of this transaction object </td></tr> <tr><td>369</td> <td class="normal"> * and all its children savepoints </td></tr> <tr><td>370</td> <td class="normal"> * </td></tr> <tr><td>371</td> <td class="normal"> * @param sring $savepoint name of the savepoint to remove </td></tr> <tr><td>372</td> <td class="normal"> * @return integer removed savepoints </td></tr> <tr><td>373</td> <td class="normal"> */ </td></tr> <tr><td>374</td> <td class="normal"> private function removeSavePoints($savepoint) </td></tr> <tr><td>375</td> <td class="normal"> { </td></tr> <tr><td>376</td> <td class="covered"> $this->savePoints = array_values($this->savePoints); </td></tr> <tr><td>377</td> <td class="normal"> </td></tr> <tr><td>378</td> <td class="covered"> $found = false; </td></tr> <tr><td>379</td> <td class="covered"> $i = 0; </td></tr> <tr><td>380</td> <td class="normal"> </td></tr> <tr><td>381</td> <td class="covered"> foreach ($this->savePoints as $key => $sp) { </td></tr> <tr><td>382</td> <td class="covered"> if ( ! $found) { </td></tr> <tr><td>383</td> <td class="covered"> if ($sp === $savepoint) { </td></tr> <tr><td>384</td> <td class="covered"> $found = true; </td></tr> <tr><td>385</td> <td class="covered"> } </td></tr> <tr><td>386</td> <td class="covered"> } </td></tr> <tr><td>387</td> <td class="covered"> if ($found) { </td></tr> <tr><td>388</td> <td class="covered"> $i++; </td></tr> <tr><td>389</td> <td class="covered"> unset($this->savePoints[$key]); </td></tr> <tr><td>390</td> <td class="covered"> } </td></tr> <tr><td>391</td> <td class="covered"> } </td></tr> <tr><td>392</td> <td class="normal"> </td></tr> <tr><td>393</td> <td class="covered"> return $i; </td></tr> <tr><td>394</td> <td class="orange"> } </td></tr> <tr><td>395</td> <td class="normal"> </td></tr> <tr><td>396</td> <td class="normal"> /** </td></tr> <tr><td>397</td> <td class="normal"> * setIsolation </td></tr> <tr><td>398</td> <td class="normal"> * </td></tr> <tr><td>399</td> <td class="normal"> * Set the transacton isolation level. </td></tr> <tr><td>400</td> <td class="normal"> * (implemented by the connection drivers) </td></tr> <tr><td>401</td> <td class="normal"> * </td></tr> <tr><td>402</td> <td class="normal"> * example: </td></tr> <tr><td>403</td> <td class="normal"> * </td></tr> <tr><td>404</td> <td class="normal"> * <code> </td></tr> <tr><td>405</td> <td class="normal"> * $tx->setIsolation('READ UNCOMMITTED'); </td></tr> <tr><td>406</td> <td class="normal"> * </code> </td></tr> <tr><td>407</td> <td class="normal"> * </td></tr> <tr><td>408</td> <td class="normal"> * @param string standard isolation level </td></tr> <tr><td>409</td> <td class="normal"> * READ UNCOMMITTED (allows dirty reads) </td></tr> <tr><td>410</td> <td class="normal"> * READ COMMITTED (prevents dirty reads) </td></tr> <tr><td>411</td> <td class="normal"> * REPEATABLE READ (prevents nonrepeatable reads) </td></tr> <tr><td>412</td> <td class="normal"> * SERIALIZABLE (prevents phantom reads) </td></tr> <tr><td>413</td> <td class="normal"> * </td></tr> <tr><td>414</td> <td class="normal"> * @throws Doctrine_Transaction_Exception if the feature is not supported by the driver </td></tr> <tr><td>415</td> <td class="normal"> * @throws PDOException if something fails at the PDO level </td></tr> <tr><td>416</td> <td class="normal"> * @return void </td></tr> <tr><td>417</td> <td class="normal"> */ </td></tr> <tr><td>418</td> <td class="normal"> public function setIsolation($isolation) </td></tr> <tr><td>419</td> <td class="normal"> { </td></tr> <tr><td>420</td> <td class="covered"> throw new Doctrine_Transaction_Exception('Transaction isolation levels not supported by this driver.'); </td></tr> <tr><td>421</td> <td class="orange"> } </td></tr> <tr><td>422</td> <td class="normal"> </td></tr> <tr><td>423</td> <td class="normal"> /** </td></tr> <tr><td>424</td> <td class="normal"> * getTransactionIsolation </td></tr> <tr><td>425</td> <td class="normal"> * </td></tr> <tr><td>426</td> <td class="normal"> * fetches the current session transaction isolation level </td></tr> <tr><td>427</td> <td class="normal"> * </td></tr> <tr><td>428</td> <td class="normal"> * note: some drivers may support setting the transaction isolation level </td></tr> <tr><td>429</td> <td class="normal"> * but not fetching it </td></tr> <tr><td>430</td> <td class="normal"> * </td></tr> <tr><td>431</td> <td class="normal"> * @throws Doctrine_Transaction_Exception if the feature is not supported by the driver </td></tr> <tr><td>432</td> <td class="normal"> * @throws PDOException if something fails at the PDO level </td></tr> <tr><td>433</td> <td class="normal"> * @return string returns the current session transaction isolation level </td></tr> <tr><td>434</td> <td class="normal"> */ </td></tr> <tr><td>435</td> <td class="normal"> public function getIsolation() </td></tr> <tr><td>436</td> <td class="normal"> { </td></tr> <tr><td>437</td> <td class="covered"> throw new Doctrine_Transaction_Exception('Fetching transaction isolation level not supported by this driver.'); </td></tr> <tr><td>438</td> <td class="orange"> } </td></tr> <tr><td>439</td> <td class="covered">}</td></tr> </table></body></html>