1371 lines
59 KiB
HTML
1371 lines
59 KiB
HTML
<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 3184 2007-11-18 16:42:33Z 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="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: 3184 $
|
|
</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"> * @todo What about a more verbose name? $invalidRecords?
|
|
</td></tr>
|
|
<tr><td>60</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>61</td>
|
|
<td class="normal"> protected $invalid = array();
|
|
</td></tr>
|
|
<tr><td>62</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>63</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>64</td>
|
|
<td class="normal"> * @var array $savepoints an array containing all savepoints
|
|
</td></tr>
|
|
<tr><td>65</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>66</td>
|
|
<td class="normal"> protected $savePoints = array();
|
|
</td></tr>
|
|
<tr><td>67</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>68</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>69</td>
|
|
<td class="normal"> * @var array $_collections an array of Doctrine_Collection objects that were affected during the Transaction
|
|
</td></tr>
|
|
<tr><td>70</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>71</td>
|
|
<td class="normal"> protected $_collections = array();
|
|
</td></tr>
|
|
<tr><td>72</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>73</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>74</td>
|
|
<td class="normal"> * addCollection
|
|
</td></tr>
|
|
<tr><td>75</td>
|
|
<td class="normal"> * adds a collection in the internal array of collections
|
|
</td></tr>
|
|
<tr><td>76</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>77</td>
|
|
<td class="normal"> * at the end of each commit this array is looped over and
|
|
</td></tr>
|
|
<tr><td>78</td>
|
|
<td class="normal"> * of every collection Doctrine then takes a snapshot in order
|
|
</td></tr>
|
|
<tr><td>79</td>
|
|
<td class="normal"> * to keep the collections up to date with the database
|
|
</td></tr>
|
|
<tr><td>80</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>81</td>
|
|
<td class="normal"> * @param Doctrine_Collection $coll a collection to be added
|
|
</td></tr>
|
|
<tr><td>82</td>
|
|
<td class="normal"> * @return Doctrine_Transaction this object
|
|
</td></tr>
|
|
<tr><td>83</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>84</td>
|
|
<td class="normal"> public function addCollection(Doctrine_Collection $coll)
|
|
</td></tr>
|
|
<tr><td>85</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>86</td>
|
|
<td class="covered"> $this->_collections[] = $coll;
|
|
</td></tr>
|
|
<tr><td>87</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>88</td>
|
|
<td class="covered"> return $this;
|
|
</td></tr>
|
|
<tr><td>89</td>
|
|
<td class="orange"> }
|
|
</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"> * getState
|
|
</td></tr>
|
|
<tr><td>93</td>
|
|
<td class="normal"> * returns the state of this connection
|
|
</td></tr>
|
|
<tr><td>94</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>95</td>
|
|
<td class="normal"> * @see Doctrine_Connection_Transaction::STATE_* constants
|
|
</td></tr>
|
|
<tr><td>96</td>
|
|
<td class="normal"> * @return integer the connection state
|
|
</td></tr>
|
|
<tr><td>97</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>98</td>
|
|
<td class="normal"> public function getState()
|
|
</td></tr>
|
|
<tr><td>99</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>100</td>
|
|
<td class="covered"> switch ($this->transactionLevel) {
|
|
</td></tr>
|
|
<tr><td>101</td>
|
|
<td class="covered"> case 0:
|
|
</td></tr>
|
|
<tr><td>102</td>
|
|
<td class="covered"> return Doctrine_Transaction::STATE_SLEEP;
|
|
</td></tr>
|
|
<tr><td>103</td>
|
|
<td class="orange"> break;
|
|
</td></tr>
|
|
<tr><td>104</td>
|
|
<td class="covered"> case 1:
|
|
</td></tr>
|
|
<tr><td>105</td>
|
|
<td class="covered"> return Doctrine_Transaction::STATE_ACTIVE;
|
|
</td></tr>
|
|
<tr><td>106</td>
|
|
<td class="orange"> break;
|
|
</td></tr>
|
|
<tr><td>107</td>
|
|
<td class="covered"> default:
|
|
</td></tr>
|
|
<tr><td>108</td>
|
|
<td class="covered"> return Doctrine_Transaction::STATE_BUSY;
|
|
</td></tr>
|
|
<tr><td>109</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>110</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>111</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>112</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>113</td>
|
|
<td class="normal"> * addInvalid
|
|
</td></tr>
|
|
<tr><td>114</td>
|
|
<td class="normal"> * adds record into invalid records list
|
|
</td></tr>
|
|
<tr><td>115</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>116</td>
|
|
<td class="normal"> * @param Doctrine_Record $record
|
|
</td></tr>
|
|
<tr><td>117</td>
|
|
<td class="normal"> * @return boolean false if record already existed in invalid records list,
|
|
</td></tr>
|
|
<tr><td>118</td>
|
|
<td class="normal"> * otherwise true
|
|
</td></tr>
|
|
<tr><td>119</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>120</td>
|
|
<td class="normal"> public function addInvalid(Doctrine_Record $record)
|
|
</td></tr>
|
|
<tr><td>121</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>122</td>
|
|
<td class="covered"> if (in_array($record, $this->invalid, true)) {
|
|
</td></tr>
|
|
<tr><td>123</td>
|
|
<td class="covered"> return false;
|
|
</td></tr>
|
|
<tr><td>124</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>125</td>
|
|
<td class="covered"> $this->invalid[] = $record;
|
|
</td></tr>
|
|
<tr><td>126</td>
|
|
<td class="covered"> return true;
|
|
</td></tr>
|
|
<tr><td>127</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>128</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>129</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>130</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>131</td>
|
|
<td class="normal"> * Return the invalid records
|
|
</td></tr>
|
|
<tr><td>132</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>133</td>
|
|
<td class="normal"> * @return array An array of invalid records
|
|
</td></tr>
|
|
<tr><td>134</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>135</td>
|
|
<td class="normal"> public function getInvalid(){
|
|
</td></tr>
|
|
<tr><td>136</td>
|
|
<td class="covered"> return $this->invalid;
|
|
</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"> * get the current transaction nesting level
|
|
</td></tr>
|
|
<tr><td>142</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>143</td>
|
|
<td class="normal"> * @return integer
|
|
</td></tr>
|
|
<tr><td>144</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>145</td>
|
|
<td class="normal"> public function getTransactionLevel()
|
|
</td></tr>
|
|
<tr><td>146</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>147</td>
|
|
<td class="covered"> return $this->transactionLevel;
|
|
</td></tr>
|
|
<tr><td>148</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>149</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>150</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>151</td>
|
|
<td class="normal"> * getTransactionLevel
|
|
</td></tr>
|
|
<tr><td>152</td>
|
|
<td class="normal"> * set the current transaction nesting level
|
|
</td></tr>
|
|
<tr><td>153</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>154</td>
|
|
<td class="normal"> * @return Doctrine_Transaction this object
|
|
</td></tr>
|
|
<tr><td>155</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>156</td>
|
|
<td class="normal"> public function setTransactionLevel($level)
|
|
</td></tr>
|
|
<tr><td>157</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>158</td>
|
|
<td class="covered"> $this->transactionLevel = $level;
|
|
</td></tr>
|
|
<tr><td>159</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>160</td>
|
|
<td class="covered"> return $this;
|
|
</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="normal"> /**
|
|
</td></tr>
|
|
<tr><td>164</td>
|
|
<td class="normal"> * beginTransaction
|
|
</td></tr>
|
|
<tr><td>165</td>
|
|
<td class="normal"> * Start a transaction or set a savepoint.
|
|
</td></tr>
|
|
<tr><td>166</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>167</td>
|
|
<td class="normal"> * if trying to set a savepoint and there is no active transaction
|
|
</td></tr>
|
|
<tr><td>168</td>
|
|
<td class="normal"> * a new transaction is being started
|
|
</td></tr>
|
|
<tr><td>169</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>170</td>
|
|
<td class="normal"> * Listeners: onPreTransactionBegin, onTransactionBegin
|
|
</td></tr>
|
|
<tr><td>171</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>172</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to set
|
|
</td></tr>
|
|
<tr><td>173</td>
|
|
<td class="normal"> * @throws Doctrine_Transaction_Exception if the transaction fails at database level
|
|
</td></tr>
|
|
<tr><td>174</td>
|
|
<td class="normal"> * @return integer current transaction nesting level
|
|
</td></tr>
|
|
<tr><td>175</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>176</td>
|
|
<td class="normal"> public function beginTransaction($savepoint = null)
|
|
</td></tr>
|
|
<tr><td>177</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>178</td>
|
|
<td class="covered"> $this->conn->connect();
|
|
</td></tr>
|
|
<tr><td>179</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>180</td>
|
|
<td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER);
|
|
</td></tr>
|
|
<tr><td>181</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>182</td>
|
|
<td class="covered"> if ( ! is_null($savepoint)) {
|
|
</td></tr>
|
|
<tr><td>183</td>
|
|
<td class="covered"> $this->savePoints[] = $savepoint;
|
|
</td></tr>
|
|
<tr><td>184</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>185</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_CREATE);
|
|
</td></tr>
|
|
<tr><td>186</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>187</td>
|
|
<td class="covered"> $listener->preSavepointCreate($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="covered"> $this->createSavePoint($savepoint);
|
|
</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="covered"> $listener->postSavepointCreate($event);
|
|
</td></tr>
|
|
<tr><td>194</td>
|
|
<td class="covered"> } else {
|
|
</td></tr>
|
|
<tr><td>195</td>
|
|
<td class="covered"> if ($this->transactionLevel == 0) {
|
|
</td></tr>
|
|
<tr><td>196</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_BEGIN);
|
|
</td></tr>
|
|
<tr><td>197</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>198</td>
|
|
<td class="covered"> $listener->preTransactionBegin($event);
|
|
</td></tr>
|
|
<tr><td>199</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>200</td>
|
|
<td class="covered"> if ( ! $event->skipOperation) {
|
|
</td></tr>
|
|
<tr><td>201</td>
|
|
<td class="normal"> try {
|
|
</td></tr>
|
|
<tr><td>202</td>
|
|
<td class="covered"> $this->conn->getDbh()->beginTransaction();
|
|
</td></tr>
|
|
<tr><td>203</td>
|
|
<td class="covered"> } catch(Exception $e) {
|
|
</td></tr>
|
|
<tr><td>204</td>
|
|
<td class="orange"> throw new Doctrine_Transaction_Exception($e->getMessage());
|
|
</td></tr>
|
|
<tr><td>205</td>
|
|
<td class="normal"> }
|
|
</td></tr>
|
|
<tr><td>206</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>207</td>
|
|
<td class="covered"> $listener->postTransactionBegin($event);
|
|
</td></tr>
|
|
<tr><td>208</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>209</td>
|
|
<td class="normal"> }
|
|
</td></tr>
|
|
<tr><td>210</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>211</td>
|
|
<td class="covered"> $level = ++$this->transactionLevel;
|
|
</td></tr>
|
|
<tr><td>212</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>213</td>
|
|
<td class="covered"> return $level;
|
|
</td></tr>
|
|
<tr><td>214</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>215</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>216</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>217</td>
|
|
<td class="normal"> * commit
|
|
</td></tr>
|
|
<tr><td>218</td>
|
|
<td class="normal"> * Commit the database changes done during a transaction that is in
|
|
</td></tr>
|
|
<tr><td>219</td>
|
|
<td class="normal"> * progress or release a savepoint. This function may only be called when
|
|
</td></tr>
|
|
<tr><td>220</td>
|
|
<td class="normal"> * auto-committing is disabled, otherwise it will fail.
|
|
</td></tr>
|
|
<tr><td>221</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>222</td>
|
|
<td class="normal"> * Listeners: preTransactionCommit, postTransactionCommit
|
|
</td></tr>
|
|
<tr><td>223</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>224</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to release
|
|
</td></tr>
|
|
<tr><td>225</td>
|
|
<td class="normal"> * @throws Doctrine_Transaction_Exception if the transaction fails at database level
|
|
</td></tr>
|
|
<tr><td>226</td>
|
|
<td class="normal"> * @throws Doctrine_Validator_Exception if the transaction fails due to record validations
|
|
</td></tr>
|
|
<tr><td>227</td>
|
|
<td class="normal"> * @return boolean false if commit couldn't be performed, true otherwise
|
|
</td></tr>
|
|
<tr><td>228</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>229</td>
|
|
<td class="normal"> public function commit($savepoint = null)
|
|
</td></tr>
|
|
<tr><td>230</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>231</td>
|
|
<td class="covered"> $this->conn->connect();
|
|
</td></tr>
|
|
<tr><td>232</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>233</td>
|
|
<td class="covered"> if ($this->transactionLevel == 0) {
|
|
</td></tr>
|
|
<tr><td>234</td>
|
|
<td class="covered"> return false;
|
|
</td></tr>
|
|
<tr><td>235</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>236</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>237</td>
|
|
<td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER);
|
|
</td></tr>
|
|
<tr><td>238</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>239</td>
|
|
<td class="covered"> if ( ! is_null($savepoint)) {
|
|
</td></tr>
|
|
<tr><td>240</td>
|
|
<td class="covered"> $this->transactionLevel -= $this->removeSavePoints($savepoint);
|
|
</td></tr>
|
|
<tr><td>241</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>242</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_COMMIT);
|
|
</td></tr>
|
|
<tr><td>243</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>244</td>
|
|
<td class="covered"> $listener->preSavepointCommit($event);
|
|
</td></tr>
|
|
<tr><td>245</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>246</td>
|
|
<td class="covered"> if ( ! $event->skipOperation) {
|
|
</td></tr>
|
|
<tr><td>247</td>
|
|
<td class="covered"> $this->releaseSavePoint($savepoint);
|
|
</td></tr>
|
|
<tr><td>248</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>249</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>250</td>
|
|
<td class="covered"> $listener->postSavepointCommit($event);
|
|
</td></tr>
|
|
<tr><td>251</td>
|
|
<td class="covered"> } else {
|
|
</td></tr>
|
|
<tr><td>252</td>
|
|
<td class="covered"> if ($this->transactionLevel == 1) {
|
|
</td></tr>
|
|
<tr><td>253</td>
|
|
<td class="covered"> if ( ! empty($this->invalid)) {
|
|
</td></tr>
|
|
<tr><td>254</td>
|
|
<td class="covered"> $this->rollback();
|
|
</td></tr>
|
|
<tr><td>255</td>
|
|
<td class="covered"> $tmp = $this->invalid;
|
|
</td></tr>
|
|
<tr><td>256</td>
|
|
<td class="covered"> $this->invalid = array();
|
|
</td></tr>
|
|
<tr><td>257</td>
|
|
<td class="covered"> throw new Doctrine_Validator_Exception($tmp);
|
|
</td></tr>
|
|
<tr><td>258</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>259</td>
|
|
<td class="normal"> // take snapshots of all collections used within this transaction
|
|
</td></tr>
|
|
<tr><td>260</td>
|
|
<td class="covered"> foreach ($this->_collections as $coll) {
|
|
</td></tr>
|
|
<tr><td>261</td>
|
|
<td class="covered"> $coll->takeSnapshot();
|
|
</td></tr>
|
|
<tr><td>262</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>263</td>
|
|
<td class="covered"> $this->_collections = array();
|
|
</td></tr>
|
|
<tr><td>264</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>265</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_COMMIT);
|
|
</td></tr>
|
|
<tr><td>266</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>267</td>
|
|
<td class="covered"> $listener->preTransactionCommit($event);
|
|
</td></tr>
|
|
<tr><td>268</td>
|
|
<td class="covered"> if ( ! $event->skipOperation) {
|
|
</td></tr>
|
|
<tr><td>269</td>
|
|
<td class="covered"> $this->conn->getDbh()->commit();
|
|
</td></tr>
|
|
<tr><td>270</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>271</td>
|
|
<td class="covered"> $listener->postTransactionCommit($event);
|
|
</td></tr>
|
|
<tr><td>272</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>273</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>274</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>275</td>
|
|
<td class="covered"> $this->transactionLevel--;
|
|
</td></tr>
|
|
<tr><td>276</td>
|
|
<td class="normal"> }
|
|
</td></tr>
|
|
<tr><td>277</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>278</td>
|
|
<td class="covered"> return true;
|
|
</td></tr>
|
|
<tr><td>279</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>280</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>281</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>282</td>
|
|
<td class="normal"> * rollback
|
|
</td></tr>
|
|
<tr><td>283</td>
|
|
<td class="normal"> * Cancel any database changes done during a transaction or since a specific
|
|
</td></tr>
|
|
<tr><td>284</td>
|
|
<td class="normal"> * savepoint that is in progress. This function may only be called when
|
|
</td></tr>
|
|
<tr><td>285</td>
|
|
<td class="normal"> * auto-committing is disabled, otherwise it will fail. Therefore, a new
|
|
</td></tr>
|
|
<tr><td>286</td>
|
|
<td class="normal"> * transaction is implicitly started after canceling the pending changes.
|
|
</td></tr>
|
|
<tr><td>287</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>288</td>
|
|
<td class="normal"> * this method can be listened with onPreTransactionRollback and onTransactionRollback
|
|
</td></tr>
|
|
<tr><td>289</td>
|
|
<td class="normal"> * eventlistener methods
|
|
</td></tr>
|
|
<tr><td>290</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>291</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to rollback to
|
|
</td></tr>
|
|
<tr><td>292</td>
|
|
<td class="normal"> * @throws Doctrine_Transaction_Exception if the rollback operation fails at database level
|
|
</td></tr>
|
|
<tr><td>293</td>
|
|
<td class="normal"> * @return boolean false if rollback couldn't be performed, true otherwise
|
|
</td></tr>
|
|
<tr><td>294</td>
|
|
<td class="normal"> * @todo Shouldnt this method only commit a rollback if the transactionLevel is 1
|
|
</td></tr>
|
|
<tr><td>295</td>
|
|
<td class="normal"> * (STATE_ACTIVE)? Explanation: Otherwise a rollback that is triggered from inside doctrine
|
|
</td></tr>
|
|
<tr><td>296</td>
|
|
<td class="normal"> * in an (emulated) nested transaction would lead to a complete database level
|
|
</td></tr>
|
|
<tr><td>297</td>
|
|
<td class="normal"> * rollback even though the client code did not yet want to do that.
|
|
</td></tr>
|
|
<tr><td>298</td>
|
|
<td class="normal"> * In other words: if the user starts a transaction doctrine shouldnt roll it back.
|
|
</td></tr>
|
|
<tr><td>299</td>
|
|
<td class="normal"> * Doctrine should only roll back transactions started by doctrine. Thoughts?
|
|
</td></tr>
|
|
<tr><td>300</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>301</td>
|
|
<td class="normal"> public function rollback($savepoint = null)
|
|
</td></tr>
|
|
<tr><td>302</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>303</td>
|
|
<td class="covered"> $this->conn->connect();
|
|
</td></tr>
|
|
<tr><td>304</td>
|
|
<td class="covered"> $currentState = $this->getState();
|
|
</td></tr>
|
|
<tr><td>305</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>306</td>
|
|
<td class="covered"> if ($currentState != self::STATE_ACTIVE && $currentState != self::STATE_BUSY) {
|
|
</td></tr>
|
|
<tr><td>307</td>
|
|
<td class="covered"> return false;
|
|
</td></tr>
|
|
<tr><td>308</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>309</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>310</td>
|
|
<td class="covered"> $listener = $this->conn->getAttribute(Doctrine::ATTR_LISTENER);
|
|
</td></tr>
|
|
<tr><td>311</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>312</td>
|
|
<td class="covered"> if ( ! is_null($savepoint)) {
|
|
</td></tr>
|
|
<tr><td>313</td>
|
|
<td class="covered"> $this->transactionLevel -= $this->removeSavePoints($savepoint);
|
|
</td></tr>
|
|
<tr><td>314</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>315</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::SAVEPOINT_ROLLBACK);
|
|
</td></tr>
|
|
<tr><td>316</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>317</td>
|
|
<td class="covered"> $listener->preSavepointRollback($event);
|
|
</td></tr>
|
|
<tr><td>318</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>319</td>
|
|
<td class="covered"> if ( ! $event->skipOperation) {
|
|
</td></tr>
|
|
<tr><td>320</td>
|
|
<td class="covered"> $this->rollbackSavePoint($savepoint);
|
|
</td></tr>
|
|
<tr><td>321</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>322</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>323</td>
|
|
<td class="covered"> $listener->postSavepointRollback($event);
|
|
</td></tr>
|
|
<tr><td>324</td>
|
|
<td class="covered"> } else {
|
|
</td></tr>
|
|
<tr><td>325</td>
|
|
<td class="covered"> $event = new Doctrine_Event($this, Doctrine_Event::TX_ROLLBACK);
|
|
</td></tr>
|
|
<tr><td>326</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>327</td>
|
|
<td class="covered"> $listener->preTransactionRollback($event);
|
|
</td></tr>
|
|
<tr><td>328</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>329</td>
|
|
<td class="covered"> if ( ! $event->skipOperation) {
|
|
</td></tr>
|
|
<tr><td>330</td>
|
|
<td class="covered"> $this->transactionLevel = 0;
|
|
</td></tr>
|
|
<tr><td>331</td>
|
|
<td class="normal"> try {
|
|
</td></tr>
|
|
<tr><td>332</td>
|
|
<td class="covered"> $this->conn->getDbh()->rollback();
|
|
</td></tr>
|
|
<tr><td>333</td>
|
|
<td class="covered"> } catch (Exception $e) {
|
|
</td></tr>
|
|
<tr><td>334</td>
|
|
<td class="orange"> throw new Doctrine_Transaction_Exception($e->getMessage());
|
|
</td></tr>
|
|
<tr><td>335</td>
|
|
<td class="normal"> }
|
|
</td></tr>
|
|
<tr><td>336</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>337</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>338</td>
|
|
<td class="covered"> $listener->postTransactionRollback($event);
|
|
</td></tr>
|
|
<tr><td>339</td>
|
|
<td class="normal"> }
|
|
</td></tr>
|
|
<tr><td>340</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>341</td>
|
|
<td class="covered"> return true;
|
|
</td></tr>
|
|
<tr><td>342</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>343</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>344</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>345</td>
|
|
<td class="normal"> * releaseSavePoint
|
|
</td></tr>
|
|
<tr><td>346</td>
|
|
<td class="normal"> * creates a new savepoint
|
|
</td></tr>
|
|
<tr><td>347</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>348</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to create
|
|
</td></tr>
|
|
<tr><td>349</td>
|
|
<td class="normal"> * @return void
|
|
</td></tr>
|
|
<tr><td>350</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>351</td>
|
|
<td class="normal"> protected function createSavePoint($savepoint)
|
|
</td></tr>
|
|
<tr><td>352</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>353</td>
|
|
<td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.');
|
|
</td></tr>
|
|
<tr><td>354</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>355</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>356</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>357</td>
|
|
<td class="normal"> * releaseSavePoint
|
|
</td></tr>
|
|
<tr><td>358</td>
|
|
<td class="normal"> * releases given savepoint
|
|
</td></tr>
|
|
<tr><td>359</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>360</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to release
|
|
</td></tr>
|
|
<tr><td>361</td>
|
|
<td class="normal"> * @return void
|
|
</td></tr>
|
|
<tr><td>362</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>363</td>
|
|
<td class="normal"> protected function releaseSavePoint($savepoint)
|
|
</td></tr>
|
|
<tr><td>364</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>365</td>
|
|
<td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.');
|
|
</td></tr>
|
|
<tr><td>366</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>367</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>368</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>369</td>
|
|
<td class="normal"> * rollbackSavePoint
|
|
</td></tr>
|
|
<tr><td>370</td>
|
|
<td class="normal"> * releases given savepoint
|
|
</td></tr>
|
|
<tr><td>371</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>372</td>
|
|
<td class="normal"> * @param string $savepoint name of a savepoint to rollback to
|
|
</td></tr>
|
|
<tr><td>373</td>
|
|
<td class="normal"> * @return void
|
|
</td></tr>
|
|
<tr><td>374</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>375</td>
|
|
<td class="normal"> protected function rollbackSavePoint($savepoint)
|
|
</td></tr>
|
|
<tr><td>376</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>377</td>
|
|
<td class="covered"> throw new Doctrine_Transaction_Exception('Savepoints not supported by this driver.');
|
|
</td></tr>
|
|
<tr><td>378</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>379</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>380</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>381</td>
|
|
<td class="normal"> * removeSavePoints
|
|
</td></tr>
|
|
<tr><td>382</td>
|
|
<td class="normal"> * removes a savepoint from the internal savePoints array of this transaction object
|
|
</td></tr>
|
|
<tr><td>383</td>
|
|
<td class="normal"> * and all its children savepoints
|
|
</td></tr>
|
|
<tr><td>384</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>385</td>
|
|
<td class="normal"> * @param sring $savepoint name of the savepoint to remove
|
|
</td></tr>
|
|
<tr><td>386</td>
|
|
<td class="normal"> * @return integer removed savepoints
|
|
</td></tr>
|
|
<tr><td>387</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>388</td>
|
|
<td class="normal"> private function removeSavePoints($savepoint)
|
|
</td></tr>
|
|
<tr><td>389</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>390</td>
|
|
<td class="covered"> $this->savePoints = array_values($this->savePoints);
|
|
</td></tr>
|
|
<tr><td>391</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>392</td>
|
|
<td class="covered"> $found = false;
|
|
</td></tr>
|
|
<tr><td>393</td>
|
|
<td class="covered"> $i = 0;
|
|
</td></tr>
|
|
<tr><td>394</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>395</td>
|
|
<td class="covered"> foreach ($this->savePoints as $key => $sp) {
|
|
</td></tr>
|
|
<tr><td>396</td>
|
|
<td class="covered"> if ( ! $found) {
|
|
</td></tr>
|
|
<tr><td>397</td>
|
|
<td class="covered"> if ($sp === $savepoint) {
|
|
</td></tr>
|
|
<tr><td>398</td>
|
|
<td class="covered"> $found = true;
|
|
</td></tr>
|
|
<tr><td>399</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>400</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>401</td>
|
|
<td class="covered"> if ($found) {
|
|
</td></tr>
|
|
<tr><td>402</td>
|
|
<td class="covered"> $i++;
|
|
</td></tr>
|
|
<tr><td>403</td>
|
|
<td class="covered"> unset($this->savePoints[$key]);
|
|
</td></tr>
|
|
<tr><td>404</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>405</td>
|
|
<td class="covered"> }
|
|
</td></tr>
|
|
<tr><td>406</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>407</td>
|
|
<td class="covered"> return $i;
|
|
</td></tr>
|
|
<tr><td>408</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>409</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>410</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>411</td>
|
|
<td class="normal"> * setIsolation
|
|
</td></tr>
|
|
<tr><td>412</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>413</td>
|
|
<td class="normal"> * Set the transacton isolation level.
|
|
</td></tr>
|
|
<tr><td>414</td>
|
|
<td class="normal"> * (implemented by the connection drivers)
|
|
</td></tr>
|
|
<tr><td>415</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>416</td>
|
|
<td class="normal"> * example:
|
|
</td></tr>
|
|
<tr><td>417</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>418</td>
|
|
<td class="normal"> * <code>
|
|
</td></tr>
|
|
<tr><td>419</td>
|
|
<td class="normal"> * $tx->setIsolation('READ UNCOMMITTED');
|
|
</td></tr>
|
|
<tr><td>420</td>
|
|
<td class="normal"> * </code>
|
|
</td></tr>
|
|
<tr><td>421</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>422</td>
|
|
<td class="normal"> * @param string standard isolation level
|
|
</td></tr>
|
|
<tr><td>423</td>
|
|
<td class="normal"> * READ UNCOMMITTED (allows dirty reads)
|
|
</td></tr>
|
|
<tr><td>424</td>
|
|
<td class="normal"> * READ COMMITTED (prevents dirty reads)
|
|
</td></tr>
|
|
<tr><td>425</td>
|
|
<td class="normal"> * REPEATABLE READ (prevents nonrepeatable reads)
|
|
</td></tr>
|
|
<tr><td>426</td>
|
|
<td class="normal"> * SERIALIZABLE (prevents phantom reads)
|
|
</td></tr>
|
|
<tr><td>427</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>428</td>
|
|
<td class="normal"> * @throws Doctrine_Transaction_Exception if the feature is not supported by the driver
|
|
</td></tr>
|
|
<tr><td>429</td>
|
|
<td class="normal"> * @throws PDOException if something fails at the PDO level
|
|
</td></tr>
|
|
<tr><td>430</td>
|
|
<td class="normal"> * @return void
|
|
</td></tr>
|
|
<tr><td>431</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>432</td>
|
|
<td class="normal"> public function setIsolation($isolation)
|
|
</td></tr>
|
|
<tr><td>433</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>434</td>
|
|
<td class="covered"> throw new Doctrine_Transaction_Exception('Transaction isolation levels not supported by this driver.');
|
|
</td></tr>
|
|
<tr><td>435</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>436</td>
|
|
<td class="normal">
|
|
</td></tr>
|
|
<tr><td>437</td>
|
|
<td class="normal"> /**
|
|
</td></tr>
|
|
<tr><td>438</td>
|
|
<td class="normal"> * getTransactionIsolation
|
|
</td></tr>
|
|
<tr><td>439</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>440</td>
|
|
<td class="normal"> * fetches the current session transaction isolation level
|
|
</td></tr>
|
|
<tr><td>441</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>442</td>
|
|
<td class="normal"> * note: some drivers may support setting the transaction isolation level
|
|
</td></tr>
|
|
<tr><td>443</td>
|
|
<td class="normal"> * but not fetching it
|
|
</td></tr>
|
|
<tr><td>444</td>
|
|
<td class="normal"> *
|
|
</td></tr>
|
|
<tr><td>445</td>
|
|
<td class="normal"> * @throws Doctrine_Transaction_Exception if the feature is not supported by the driver
|
|
</td></tr>
|
|
<tr><td>446</td>
|
|
<td class="normal"> * @throws PDOException if something fails at the PDO level
|
|
</td></tr>
|
|
<tr><td>447</td>
|
|
<td class="normal"> * @return string returns the current session transaction isolation level
|
|
</td></tr>
|
|
<tr><td>448</td>
|
|
<td class="normal"> */
|
|
</td></tr>
|
|
<tr><td>449</td>
|
|
<td class="normal"> public function getIsolation()
|
|
</td></tr>
|
|
<tr><td>450</td>
|
|
<td class="normal"> {
|
|
</td></tr>
|
|
<tr><td>451</td>
|
|
<td class="covered"> throw new Doctrine_Transaction_Exception('Fetching transaction isolation level not supported by this driver.');
|
|
</td></tr>
|
|
<tr><td>452</td>
|
|
<td class="orange"> }
|
|
</td></tr>
|
|
<tr><td>453</td>
|
|
<td class="normal">}
|
|
</td></tr>
|
|
</table></body></html> |